mirror of
https://github.com/flutter/flutter.git
synced 2025-06-03 00:51:18 +00:00
Update old wiki links (#149544)
Part of https://github.com/flutter/flutter/issues/145009 Finishes updating links in the repo that pointed to the old wiki
This commit is contained in:
parent
e80bbd929e
commit
62586dc09d
2
.github/ISSUE_TEMPLATE/7_cherry_pick.yml
vendored
2
.github/ISSUE_TEMPLATE/7_cherry_pick.yml
vendored
@ -38,7 +38,7 @@ body:
|
|||||||
label: Changelog Description
|
label: Changelog Description
|
||||||
description: >-
|
description: >-
|
||||||
Explain this CP in less than 80 characters that is accessible to most Flutter developers
|
Explain this CP in less than 80 characters that is accessible to most Flutter developers
|
||||||
See https://github.com/flutter/flutter/wiki/Hotfix-Documentation-Best-Practices for examples
|
See https://github.com/flutter/flutter/blob/main/docs/releases/Hotfix-Documentation-Best-Practices.md for examples
|
||||||
validations:
|
validations:
|
||||||
required: true
|
required: true
|
||||||
- type: input
|
- type: input
|
||||||
|
2
.github/ISSUE_TEMPLATE/8_design_doc.yml
vendored
2
.github/ISSUE_TEMPLATE/8_design_doc.yml
vendored
@ -8,7 +8,7 @@ body:
|
|||||||
Thank you for your interest in contributing to Flutter!
|
Thank you for your interest in contributing to Flutter!
|
||||||
|
|
||||||
Please ensure that you are following
|
Please ensure that you are following
|
||||||
https://github.com/flutter/flutter/wiki/Design-Documents
|
https://github.com/flutter/flutter/blob/main/docs/contributing/Design-Documents.md
|
||||||
when sharing a design document.
|
when sharing a design document.
|
||||||
|
|
||||||
Please fill out the sections below to the best of your ability.
|
Please fill out the sections below to the best of your ability.
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
This pull request is created by [automatic cherry pick workflow](https://github.com/flutter/flutter/wiki/Flutter-Cherrypick-Process#automatically-creates-a-cherry-pick-request)
|
This pull request is created by [automatic cherry pick workflow](https://github.com/flutter/flutter/blob/main/docs/releases/Flutter-Cherrypick-Process.md#automatically-creates-a-cherry-pick-request)
|
||||||
Please fill in the form below, and a flutter domain expert will evaluate this cherry pick request.
|
Please fill in the form below, and a flutter domain expert will evaluate this cherry pick request.
|
||||||
|
|
||||||
### Issue Link:
|
### Issue Link:
|
||||||
@ -7,7 +7,7 @@ What is the link to the issue this cherry-pick is addressing?
|
|||||||
< Replace with issue link here >
|
< Replace with issue link here >
|
||||||
|
|
||||||
### Changelog Description:
|
### Changelog Description:
|
||||||
Explain this cherry pick in one line that is accessible to most Flutter developers. See [best practices](https://github.com/flutter/flutter/wiki/Hotfix-Documentation-Best-Practices) for examples
|
Explain this cherry pick in one line that is accessible to most Flutter developers. See [best practices](https://github.com/flutter/flutter/blob/main/docs/releases/Hotfix-Documentation-Best-Practices.md) for examples
|
||||||
|
|
||||||
< Replace with changelog description here >
|
< Replace with changelog description here >
|
||||||
|
|
||||||
|
16
.github/PULL_REQUEST_TEMPLATE.md
vendored
16
.github/PULL_REQUEST_TEMPLATE.md
vendored
@ -19,13 +19,13 @@
|
|||||||
If you need help, consider asking for advice on the #hackers-new channel on [Discord].
|
If you need help, consider asking for advice on the #hackers-new channel on [Discord].
|
||||||
|
|
||||||
<!-- Links -->
|
<!-- Links -->
|
||||||
[Contributor Guide]: https://github.com/flutter/flutter/wiki/Tree-hygiene#overview
|
[Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview
|
||||||
[Tree Hygiene]: https://github.com/flutter/flutter/wiki/Tree-hygiene
|
[Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md
|
||||||
[test-exempt]: https://github.com/flutter/flutter/wiki/Tree-hygiene#tests
|
[test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests
|
||||||
[Flutter Style Guide]: https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo
|
[Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md
|
||||||
[Features we expect every widget to implement]: https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#features-we-expect-every-widget-to-implement
|
[Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement
|
||||||
[CLA]: https://cla.developers.google.com/
|
[CLA]: https://cla.developers.google.com/
|
||||||
[flutter/tests]: https://github.com/flutter/tests
|
[flutter/tests]: https://github.com/flutter/tests
|
||||||
[breaking change policy]: https://github.com/flutter/flutter/wiki/Tree-hygiene#handling-breaking-changes
|
[breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes
|
||||||
[Discord]: https://github.com/flutter/flutter/wiki/Chat
|
[Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md
|
||||||
[Data Driven Fixes]: https://github.com/flutter/flutter/wiki/Data-driven-Fixes
|
[Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md
|
||||||
|
2
.github/workflows/easy-cp.yml
vendored
2
.github/workflows/easy-cp.yml
vendored
@ -81,7 +81,7 @@ jobs:
|
|||||||
if: ${{ failure() && steps.attempt-cp.conclusion == 'failure' }}
|
if: ${{ failure() && steps.attempt-cp.conclusion == 'failure' }}
|
||||||
run: |
|
run: |
|
||||||
FAILURE_MSG="Failed to create CP due to merge conflicts.<br>"
|
FAILURE_MSG="Failed to create CP due to merge conflicts.<br>"
|
||||||
FAILURE_MSG+="You will need to create the PR manually. See [the cherrypick wiki](https://github.com/flutter/flutter/wiki/Flutter-Cherrypick-Process) for more info."
|
FAILURE_MSG+="You will need to create the PR manually. See [the cherrypick wiki](https://github.com/flutter/flutter/blob/main/docs/releases/Flutter-Cherrypick-Process.md) for more info."
|
||||||
gh pr comment ${{ github.event.pull_request.number }} -R flutter/flutter -b "${FAILURE_MSG}"
|
gh pr comment ${{ github.event.pull_request.number }} -R flutter/flutter -b "${FAILURE_MSG}"
|
||||||
env:
|
env:
|
||||||
GITHUB_TOKEN: ${{ secrets.FLUTTERACTIONSBOT_CP_TOKEN }}
|
GITHUB_TOKEN: ${{ secrets.FLUTTERACTIONSBOT_CP_TOKEN }}
|
||||||
|
@ -38,8 +38,7 @@ concerns. Be wary of agreement by compromise, where two good competing
|
|||||||
solutions are merged into one mediocre solution. A conflict is
|
solutions are merged into one mediocre solution. A conflict is
|
||||||
addressed when the participants agree that the final solution is
|
addressed when the participants agree that the final solution is
|
||||||
_better_ than all the conflicting proposals. Sometimes the solution is
|
_better_ than all the conflicting proposals. Sometimes the solution is
|
||||||
more work than either of the proposals. [Embrace the yak
|
more work than either of the proposals. [Embrace the yak shave](./docs/contributing/Style-guide-for-Flutter-repo.md#lazy-programming).
|
||||||
shave](https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#lazy-programming).
|
|
||||||
|
|
||||||
## Questions
|
## Questions
|
||||||
|
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
Contributing to Flutter
|
Contributing to Flutter
|
||||||
=======================
|
=======================
|
||||||
|
|
||||||
_tl;dr: join [Discord](https://github.com/flutter/flutter/wiki/Chat), be [courteous](CODE_OF_CONDUCT.md), follow the steps below to set up a development environment; if you stick around and contribute, you can [join the team](https://github.com/flutter/flutter/wiki/Contributor-access) and get commit access._
|
_tl;dr: join [Discord](./docs/contributing/Chat.md), be [courteous](CODE_OF_CONDUCT.md), follow the steps below to set up a development environment; if you stick around and contribute, you can [join the team](./docs/contributing/Contributor-access.md) and get commit access._
|
||||||
|
|
||||||
Welcome
|
Welcome
|
||||||
-------
|
-------
|
||||||
@ -17,10 +17,10 @@ doing outreach about Flutter, or helping out in any other way.
|
|||||||
We grant commit access (which includes full rights to the issue
|
We grant commit access (which includes full rights to the issue
|
||||||
database, such as being able to edit labels) to people who have gained
|
database, such as being able to edit labels) to people who have gained
|
||||||
our trust and demonstrated a commitment to Flutter. For more details
|
our trust and demonstrated a commitment to Flutter. For more details
|
||||||
see the [Contributor access](https://github.com/flutter/flutter/wiki/Contributor-access)
|
see the [Contributor access](./docs/contributing/Contributor-access.md)
|
||||||
page on our wiki.
|
page in our docs.
|
||||||
|
|
||||||
We communicate primarily over GitHub and [Discord](https://github.com/flutter/flutter/wiki/Chat).
|
We communicate primarily over GitHub and [Discord](./docs/contributing/Chat.md).
|
||||||
|
|
||||||
Before you get started, we encourage you to read these documents which describe some of our community norms:
|
Before you get started, we encourage you to read these documents which describe some of our community norms:
|
||||||
|
|
||||||
@ -29,7 +29,7 @@ Before you get started, we encourage you to read these documents which describe
|
|||||||
also documents our conflict resolution policy and encourages people
|
also documents our conflict resolution policy and encourages people
|
||||||
to ask questions.
|
to ask questions.
|
||||||
|
|
||||||
2. [Values](https://github.com/flutter/flutter/wiki/Values),
|
2. [Values](./docs/about/Values.md),
|
||||||
which talks about what we care most about.
|
which talks about what we care most about.
|
||||||
|
|
||||||
Helping out in the issue database
|
Helping out in the issue database
|
||||||
@ -41,27 +41,27 @@ useful for our engineers.
|
|||||||
|
|
||||||
If you want to help us triage, you are very welcome to do so!
|
If you want to help us triage, you are very welcome to do so!
|
||||||
|
|
||||||
1. Join the #hackers-triage [Discord channel](https://github.com/flutter/flutter/wiki/Chat).
|
1. Join the #hackers-triage [Discord channel](./docs/contributing/Chat.md).
|
||||||
|
|
||||||
2. Read [our code of conduct](CODE_OF_CONDUCT.md), which stipulates explicitly
|
2. Read [our code of conduct](CODE_OF_CONDUCT.md), which stipulates explicitly
|
||||||
that everyone must be gracious, respectful, and professional. If you're helping out
|
that everyone must be gracious, respectful, and professional. If you're helping out
|
||||||
with triage, you are representing the Flutter team, and so you want to make sure to
|
with triage, you are representing the Flutter team, and so you want to make sure to
|
||||||
make a good impression!
|
make a good impression!
|
||||||
|
|
||||||
3. Help out as described in our wiki: https://github.com/flutter/flutter/wiki/Triage
|
3. Help out as described in our [triage guide](./docs/triage/README.md)
|
||||||
You won't be able to add labels at first, so instead start by trying to
|
You won't be able to add labels at first, so instead start by trying to
|
||||||
do the other steps, e.g. trying to reproduce the problem and asking for people to
|
do the other steps, e.g. trying to reproduce the problem and asking for people to
|
||||||
provide enough details that you can reproduce the problem, pointing out duplicates,
|
provide enough details that you can reproduce the problem, pointing out duplicates,
|
||||||
and so on. Chat on the #hackers-triage channel to let us know what you're up to!
|
and so on. Chat on the #hackers-triage channel to let us know what you're up to!
|
||||||
|
|
||||||
4. Familiarize yourself with our
|
4. Familiarize yourself with our
|
||||||
[issue hygiene](https://github.com/flutter/flutter/wiki/Issue-hygiene) wiki page,
|
[issue hygiene](./docs/contributing/issue_hygiene/README.md) wiki page,
|
||||||
which covers the meanings of some important GitHub labels and
|
which covers the meanings of some important GitHub labels and
|
||||||
milestones.
|
milestones.
|
||||||
|
|
||||||
5. Once you've been doing this for a while, someone will invite you to the flutter-hackers
|
5. Once you've been doing this for a while, someone will invite you to the flutter-hackers
|
||||||
team on GitHub and you'll be able to add labels too. See the
|
team on GitHub and you'll be able to add labels too. See the
|
||||||
[contributor access](https://github.com/flutter/flutter/wiki/Contributor-access) wiki
|
[contributor access](./docs/contributing/Contributor-access.md) wiki
|
||||||
page for details.
|
page for details.
|
||||||
|
|
||||||
|
|
||||||
@ -75,9 +75,9 @@ that increase our test coverage, writing tests for issues others have filed, all
|
|||||||
are really valuable contributions to open source projects.
|
are really valuable contributions to open source projects.
|
||||||
|
|
||||||
If this interests you, you can jump in and submit bug reports without needing anyone's permission!
|
If this interests you, you can jump in and submit bug reports without needing anyone's permission!
|
||||||
The #quality-assurance channel on our [Discord server](https://github.com/flutter/flutter/wiki/Chat)
|
The #quality-assurance channel on our [Discord server](./docs/contributing/Chat.md)
|
||||||
is a good place to talk about what you're doing. We're especially eager for QA testing when
|
is a good place to talk about what you're doing. We're especially eager for QA testing when
|
||||||
we announce a beta release. See https://github.com/flutter/flutter/wiki/Quality-Assurance for
|
we announce a beta release. See [quality assurance](./docs/releases/Quality-Assurance.md) for
|
||||||
more details.
|
more details.
|
||||||
|
|
||||||
If you want to contribute test cases, you can also submit PRs. See the next section
|
If you want to contribute test cases, you can also submit PRs. See the next section
|
||||||
@ -101,35 +101,35 @@ that describe these methodologies. The following list is ordered: you
|
|||||||
are strongly recommended to go through these documents in the order
|
are strongly recommended to go through these documents in the order
|
||||||
presented.
|
presented.
|
||||||
|
|
||||||
1. [Setting up your engine development environment](https://github.com/flutter/flutter/wiki/Setting-up-the-Engine-development-environment),
|
1. [Setting up your engine development environment](./docs/engine/contributing/Setting-up-the-Engine-development-environment.md),
|
||||||
which describes the steps you need to configure your computer to
|
which describes the steps you need to configure your computer to
|
||||||
work on Flutter's engine. If you only want to write code for the
|
work on Flutter's engine. If you only want to write code for the
|
||||||
Flutter framework, you can skip this step. Flutter's engine mainly
|
Flutter framework, you can skip this step. Flutter's engine mainly
|
||||||
uses C++, Java, and Objective-C.
|
uses C++, Java, and Objective-C.
|
||||||
|
|
||||||
2. [Setting up your framework development environment](https://github.com/flutter/flutter/wiki/Setting-up-the-Framework-development-environment),
|
2. [Setting up your framework development environment](./docs/contributing/Setting-up-the-Framework-development-environment.md),
|
||||||
which describes the steps you need to configure your computer to
|
which describes the steps you need to configure your computer to
|
||||||
work on Flutter's framework. Flutter's framework mainly uses Dart.
|
work on Flutter's framework. Flutter's framework mainly uses Dart.
|
||||||
|
|
||||||
3. [Tree hygiene](https://github.com/flutter/flutter/wiki/Tree-hygiene),
|
3. [Tree hygiene](./docs/contributing/Tree-hygiene.md),
|
||||||
which covers how to land a PR, how to do code review, how to
|
which covers how to land a PR, how to do code review, how to
|
||||||
handle breaking changes, how to handle regressions, and how to
|
handle breaking changes, how to handle regressions, and how to
|
||||||
handle post-commit test failures.
|
handle post-commit test failures.
|
||||||
|
|
||||||
4. [Our style guide](https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo),
|
4. [Our style guide](./docs/contributing/Style-guide-for-Flutter-repo.md),
|
||||||
which includes advice for designing APIs for Flutter, and how to
|
which includes advice for designing APIs for Flutter, and how to
|
||||||
format code in the framework.
|
format code in the framework.
|
||||||
|
|
||||||
5. [Flutter design doc template](https://flutter.dev/go/template),
|
5. [Flutter design doc template](https://flutter.dev/go/template),
|
||||||
which should be used when proposing a new technical design. This is a good
|
which should be used when proposing a new technical design. This is a good
|
||||||
practice to do before coding more intricate changes.
|
practice to do before coding more intricate changes.
|
||||||
See also our [guidance for writing design docs](https://github.com/flutter/flutter/wiki/Design-Documents).
|
See also our [guidance for writing design docs](./docs/contributing/Design-Documents.md).
|
||||||
|
|
||||||
[](https://www.youtube.com/watch?v=4yBgOBAOx_A)
|
[](https://www.youtube.com/watch?v=4yBgOBAOx_A)
|
||||||
|
|
||||||
In addition to the documents, there is a video linked above on **How to contribute to Flutter**
|
In addition to the documents, there is a video linked above on **How to contribute to Flutter**
|
||||||
from the [Flutter](https://youtube.com/c/flutterdev) YouTube channel,
|
from the [Flutter](https://youtube.com/c/flutterdev) YouTube channel,
|
||||||
there are many pages on [our Wiki](https://github.com/flutter/flutter/wiki/),
|
there are many pages in [our docs](./docs/README.md),
|
||||||
and an article [Contributing to Flutter: Getting Started](https://medium.com/@ayushbherwani/contributing-to-flutter-getting-started-a0db68cbcd5b)
|
and an article [Contributing to Flutter: Getting Started](https://medium.com/@ayushbherwani/contributing-to-flutter-getting-started-a0db68cbcd5b)
|
||||||
on Medium that may be of interest. For a curated list of pages see the sidebar
|
on Medium that may be of interest. For a curated list of pages see the sidebar
|
||||||
on the wiki's home page. They are more or less listed in order of importance.
|
on the wiki's home page. They are more or less listed in order of importance.
|
||||||
@ -152,7 +152,7 @@ whether advocating for Flutter, answering questions in fora like
|
|||||||
or [Reddit](https://www.reddit.com/r/flutterhelp/new/?f=flair_name%3A%22OPEN%22),
|
or [Reddit](https://www.reddit.com/r/flutterhelp/new/?f=flair_name%3A%22OPEN%22),
|
||||||
or creating content for our [documentation](https://docs.flutter.dev/)
|
or creating content for our [documentation](https://docs.flutter.dev/)
|
||||||
or sites like [YouTube](https://www.youtube.com/results?search_query=flutter&sp=EgQIAxAB),
|
or sites like [YouTube](https://www.youtube.com/results?search_query=flutter&sp=EgQIAxAB),
|
||||||
the best starting point is to join the #hackers-devrel [Discord channel](https://github.com/flutter/flutter/wiki/Chat).
|
the best starting point is to join the #hackers-devrel [Discord channel](./docs/contributing/Chat.md).
|
||||||
From there, you can describe what you're interested in doing, and go ahead and do it!
|
From there, you can describe what you're interested in doing, and go ahead and do it!
|
||||||
As others become familiar with your work, they may have feedback, be interested in
|
As others become familiar with your work, they may have feedback, be interested in
|
||||||
collaborating, or want to coordinate their efforts with yours.
|
collaborating, or want to coordinate their efforts with yours.
|
||||||
@ -162,12 +162,12 @@ API documentation
|
|||||||
-----------------
|
-----------------
|
||||||
|
|
||||||
Another great area to contribute in is sample code and API documentation. If this is an area that interests you, join our
|
Another great area to contribute in is sample code and API documentation. If this is an area that interests you, join our
|
||||||
[Discord](https://github.com/flutter/flutter/wiki/Chat) server and introduce yourself on the #hackers-deverl, #hackers-framework,
|
[Discord](./docs/contributing/Chat.md) server and introduce yourself on the #hackers-deverl, #hackers-framework,
|
||||||
or #hackers-engine channels, describing your area of interest. As our API docs are integrated into our source code, see the
|
or #hackers-engine channels, describing your area of interest. As our API docs are integrated into our source code, see the
|
||||||
"developing for Flutter" section above for a guide on how to set up your developer environment.
|
"developing for Flutter" section above for a guide on how to set up your developer environment.
|
||||||
|
|
||||||
To contribute API documentation, an excellent command of the English language is particularly helpful, as is a careful attention to detail.
|
To contribute API documentation, an excellent command of the English language is particularly helpful, as is a careful attention to detail.
|
||||||
We have a [whole section in our style guide](https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#documentation-dartdocs-javadocs-etc)
|
We have a [whole section in our style guide](./docs/contributing/Style-guide-for-Flutter-repo.md#documentation-dartdocs-javadocs-etc)
|
||||||
that you should read before you write API documentation. It includes notes on the "Flutter Voice", such as our word and grammar conventions.
|
that you should read before you write API documentation. It includes notes on the "Flutter Voice", such as our word and grammar conventions.
|
||||||
|
|
||||||
In general, a really productive way to improve documentation is to use Flutter and stop any time you have a question: find the answer, then
|
In general, a really productive way to improve documentation is to use Flutter and stop any time you have a question: find the answer, then
|
||||||
@ -186,7 +186,7 @@ Releases
|
|||||||
|
|
||||||
If you are interested in participating in our release process, which may involve writing release notes and blog posts, coordinating the actual
|
If you are interested in participating in our release process, which may involve writing release notes and blog posts, coordinating the actual
|
||||||
generation of binaries, updating our release tooling, and other work of that nature, then reach out on the #hackers-releases
|
generation of binaries, updating our release tooling, and other work of that nature, then reach out on the #hackers-releases
|
||||||
channel of our [Discord](https://github.com/flutter/flutter/wiki/Chat) server.
|
channel of our [Discord](./docs/contributing/Chat.md) server.
|
||||||
|
|
||||||
|
|
||||||
Social events in the contributor community
|
Social events in the contributor community
|
||||||
@ -194,5 +194,5 @@ Social events in the contributor community
|
|||||||
|
|
||||||
Finally, one area where you could have a lot of impact is in contributing to social interactions among the Flutter contributor community itself.
|
Finally, one area where you could have a lot of impact is in contributing to social interactions among the Flutter contributor community itself.
|
||||||
This could take the form of organizing weekly video chats on our Discord, or planning tech talks from contributors, for example.
|
This could take the form of organizing weekly video chats on our Discord, or planning tech talks from contributors, for example.
|
||||||
If this is an area that is of interest to you, please join our [Discord](https://github.com/flutter/flutter/wiki/Chat) and ping Hixie on the #hackers
|
If this is an area that is of interest to you, please join our [Discord](./docs/contributing/Chat.md) and ping Hixie on the #hackers
|
||||||
channel!
|
channel!
|
||||||
|
@ -24,7 +24,7 @@ open source.
|
|||||||
|
|
||||||
* [Install Flutter](https://flutter.dev/get-started/)
|
* [Install Flutter](https://flutter.dev/get-started/)
|
||||||
* [Flutter documentation](https://docs.flutter.dev/)
|
* [Flutter documentation](https://docs.flutter.dev/)
|
||||||
* [Development wiki](https://github.com/flutter/flutter/wiki)
|
* [Development wiki](./docs/README.md)
|
||||||
* [Contributing to Flutter](https://github.com/flutter/flutter/blob/main/CONTRIBUTING.md)
|
* [Contributing to Flutter](https://github.com/flutter/flutter/blob/main/CONTRIBUTING.md)
|
||||||
|
|
||||||
For announcements about new releases, follow the
|
For announcements about new releases, follow the
|
||||||
@ -100,7 +100,7 @@ Information on how to get started can be found in our
|
|||||||
[contributor guide](CONTRIBUTING.md).
|
[contributor guide](CONTRIBUTING.md).
|
||||||
|
|
||||||
[flutter.dev]: https://flutter.dev
|
[flutter.dev]: https://flutter.dev
|
||||||
[Discord instructions]: https://github.com/flutter/flutter/wiki/Chat
|
[Discord instructions]: ./docs/contributing/Chat.md
|
||||||
[Discord badge]: https://img.shields.io/discord/608014603317936148?logo=discord
|
[Discord badge]: https://img.shields.io/discord/608014603317936148?logo=discord
|
||||||
[Twitter handle]: https://img.shields.io/twitter/follow/flutterdev.svg?style=social&label=Follow
|
[Twitter handle]: https://img.shields.io/twitter/follow/flutterdev.svg?style=social&label=Follow
|
||||||
[Twitter badge]: https://twitter.com/intent/follow?screen_name=flutterdev
|
[Twitter badge]: https://twitter.com/intent/follow?screen_name=flutterdev
|
||||||
|
@ -158,7 +158,7 @@ linter:
|
|||||||
# - prefer_constructors_over_static_methods # far too many false positives
|
# - prefer_constructors_over_static_methods # far too many false positives
|
||||||
- prefer_contains
|
- prefer_contains
|
||||||
# - prefer_double_quotes # opposite of prefer_single_quotes
|
# - prefer_double_quotes # opposite of prefer_single_quotes
|
||||||
# - prefer_expression_function_bodies # conflicts with https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#consider-using--for-short-functions-and-methods
|
# - prefer_expression_function_bodies # conflicts with ./docs/contributing/Style-guide-for-Flutter-repo.md#consider-using--for-short-functions-and-methods
|
||||||
- prefer_final_fields
|
- prefer_final_fields
|
||||||
- prefer_final_in_for_each
|
- prefer_final_in_for_each
|
||||||
- prefer_final_locals
|
- prefer_final_locals
|
||||||
@ -171,7 +171,7 @@ linter:
|
|||||||
- prefer_if_null_operators
|
- prefer_if_null_operators
|
||||||
- prefer_initializing_formals
|
- prefer_initializing_formals
|
||||||
- prefer_inlined_adds
|
- prefer_inlined_adds
|
||||||
# - prefer_int_literals # conflicts with https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#use-double-literals-for-double-constants
|
# - prefer_int_literals # conflicts with ./docs/contributing/Style-guide-for-Flutter-repo.md#use-double-literals-for-double-constants
|
||||||
- prefer_interpolation_to_compose_strings
|
- prefer_interpolation_to_compose_strings
|
||||||
- prefer_is_empty
|
- prefer_is_empty
|
||||||
- prefer_is_not_empty
|
- prefer_is_not_empty
|
||||||
|
@ -10,7 +10,7 @@ Flutter build results are available at:
|
|||||||
|
|
||||||
Flutter infra requires special permissions to retrigger builds on the
|
Flutter infra requires special permissions to retrigger builds on the
|
||||||
[build dashboard](https://flutter-dashboard.appspot.com/#/build). File an
|
[build dashboard](https://flutter-dashboard.appspot.com/#/build). File an
|
||||||
[infra ticket](https://github.com/flutter/flutter/wiki/Infra-Ticket-Queue) to
|
[infra ticket](../../docs/infra/Infra-Ticket-Queue.md) to
|
||||||
request permission.
|
request permission.
|
||||||
|
|
||||||
The [Cirrus](https://cirrus-ci.org)-based bots run the [`test.dart`](test.dart)
|
The [Cirrus](https://cirrus-ci.org)-based bots run the [`test.dart`](test.dart)
|
||||||
@ -28,7 +28,7 @@ The build dashboard includes post-commit testing run on physical devices. See
|
|||||||
A [set of infra scripts](https://flutter.googlesource.com/recipes/)
|
A [set of infra scripts](https://flutter.googlesource.com/recipes/)
|
||||||
run on Windows, Linux, and Mac machines. The configuration for how many
|
run on Windows, Linux, and Mac machines. The configuration for how many
|
||||||
machines and what kind are managed internally by Google. File an
|
machines and what kind are managed internally by Google. File an
|
||||||
[infra ticket](https://github.com/flutter/flutter/wiki/Infra-Ticket-Queue)
|
[infra ticket](../../docs/infra/Infra-Ticket-Queue.md)
|
||||||
to request new machine types to be added. Both of these technologies are highly
|
to request new machine types to be added. Both of these technologies are highly
|
||||||
specific to the [LUCI](https://github.com/luci) project, which is the successor
|
specific to the [LUCI](https://github.com/luci) project, which is the successor
|
||||||
to Chromium's infra and the foundation to Flutter's infrastructure.
|
to Chromium's infra and the foundation to Flutter's infrastructure.
|
||||||
|
@ -557,7 +557,7 @@ Future<void> verifyNoSyncAsyncStar(String workingDirectory, {int minimumMatches
|
|||||||
}
|
}
|
||||||
if (errors.isNotEmpty) {
|
if (errors.isNotEmpty) {
|
||||||
foundError(<String>[
|
foundError(<String>[
|
||||||
'${bold}Do not use sync*/async* methods. See https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#avoid-syncasync for details.$reset',
|
'${bold}Do not use sync*/async* methods. See https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#avoid-syncasync for details.$reset',
|
||||||
...errors,
|
...errors,
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
@ -624,7 +624,7 @@ Future<void> verifyGoldenTags(String workingDirectory, { int minimumMatches = 20
|
|||||||
if (errors.isNotEmpty) {
|
if (errors.isNotEmpty) {
|
||||||
foundError(<String>[
|
foundError(<String>[
|
||||||
...errors,
|
...errors,
|
||||||
'${bold}See: https://github.com/flutter/flutter/wiki/Writing-a-golden-file-test-for-package:flutter$reset',
|
'${bold}See: https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-a-golden-file-test-for-package-flutter.md$reset',
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -696,7 +696,7 @@ Future<void> verifyDeprecations(String workingDirectory, { int minimumMatches =
|
|||||||
message = messageMatch.namedGroup('message');
|
message = messageMatch.namedGroup('message');
|
||||||
final String firstChar = String.fromCharCode(message!.runes.first);
|
final String firstChar = String.fromCharCode(message!.runes.first);
|
||||||
if (firstChar.toUpperCase() != firstChar) {
|
if (firstChar.toUpperCase() != firstChar) {
|
||||||
throw 'Deprecation notice should be a grammatically correct sentence and start with a capital letter; see style guide: https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo';
|
throw 'Deprecation notice should be a grammatically correct sentence and start with a capital letter; see style guide: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md';
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
message += messageMatch.namedGroup('message')!;
|
message += messageMatch.namedGroup('message')!;
|
||||||
@ -743,7 +743,7 @@ Future<void> verifyDeprecations(String workingDirectory, { int minimumMatches =
|
|||||||
if (errors.isNotEmpty) {
|
if (errors.isNotEmpty) {
|
||||||
foundError(<String>[
|
foundError(<String>[
|
||||||
...errors,
|
...errors,
|
||||||
'${bold}See: https://github.com/flutter/flutter/wiki/Tree-hygiene#handling-breaking-changes$reset',
|
'${bold}See: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes$reset',
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -878,7 +878,7 @@ Future<void> verifySkipTestComments(String workingDirectory) async {
|
|||||||
if (errors.isNotEmpty) {
|
if (errors.isNotEmpty) {
|
||||||
foundError(<String>[
|
foundError(<String>[
|
||||||
...errors,
|
...errors,
|
||||||
'\n${bold}See: https://github.com/flutter/flutter/wiki/Tree-hygiene#skipped-tests$reset',
|
'\n${bold}See: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#skipped-tests$reset',
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -1818,7 +1818,7 @@ Future<void> verifyNoBinaries(String workingDirectory, { Set<Hash256>? legacyBin
|
|||||||
'to which you need access, you should consider how to fetch it from another repository;',
|
'to which you need access, you should consider how to fetch it from another repository;',
|
||||||
'for example, the "assets-for-api-docs" repository is used for images in API docs.',
|
'for example, the "assets-for-api-docs" repository is used for images in API docs.',
|
||||||
'To add assets to flutter_tools templates, see the instructions in the wiki:',
|
'To add assets to flutter_tools templates, see the instructions in the wiki:',
|
||||||
'https://github.com/flutter/flutter/wiki/Managing-template-image-assets',
|
'https://github.com/flutter/flutter/blob/main/docs/tool/Managing-template-image-assets.md',
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -2114,9 +2114,9 @@ Future<void> verifyTabooDocumentation(String workingDirectory, { int minimumMatc
|
|||||||
}
|
}
|
||||||
if (errors.isNotEmpty) {
|
if (errors.isNotEmpty) {
|
||||||
foundError(<String>[
|
foundError(<String>[
|
||||||
'${bold}Avoid the word "simply" in documentation. See https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#use-the-passive-voice-recommend-do-not-require-never-say-things-are-simple for details.$reset',
|
'${bold}Avoid the word "simply" in documentation. See https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#use-the-passive-voice-recommend-do-not-require-never-say-things-are-simple for details.$reset',
|
||||||
'${bold}In many cases these words can be omitted without loss of generality; in other cases it may require a bit of rewording to avoid implying that the task is simple.$reset',
|
'${bold}In many cases these words can be omitted without loss of generality; in other cases it may require a bit of rewording to avoid implying that the task is simple.$reset',
|
||||||
'${bold}Similarly, avoid using "note:" or the phrase "note that". See https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#avoid-empty-prose for details.$reset',
|
'${bold}Similarly, avoid using "note:" or the phrase "note that". See https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#avoid-empty-prose for details.$reset',
|
||||||
...errors,
|
...errors,
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
|
@ -9,7 +9,7 @@
|
|||||||
//
|
//
|
||||||
// For documentation on creating sample code, see ../../examples/api/README.md
|
// For documentation on creating sample code, see ../../examples/api/README.md
|
||||||
// See also our style guide's discussion on documentation and sample code:
|
// See also our style guide's discussion on documentation and sample code:
|
||||||
// https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#documentation-dartdocs-javadocs-etc
|
// https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md
|
||||||
//
|
//
|
||||||
// This tool is used to analyze smaller snippets of code in the API docs.
|
// This tool is used to analyze smaller snippets of code in the API docs.
|
||||||
// Such snippets are wrapped in ```dart ... ``` blocks, which may themselves
|
// Such snippets are wrapped in ```dart ... ``` blocks, which may themselves
|
||||||
|
@ -66,14 +66,14 @@ void main() {
|
|||||||
.map((String line) {
|
.map((String line) {
|
||||||
return line
|
return line
|
||||||
.replaceAll('/', Platform.isWindows ? r'\' : '/')
|
.replaceAll('/', Platform.isWindows ? r'\' : '/')
|
||||||
.replaceAll('STYLE_GUIDE_URL', 'https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo')
|
.replaceAll('STYLE_GUIDE_URL', 'https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md')
|
||||||
.replaceAll('RELEASES_URL', 'https://flutter.dev/docs/development/tools/sdk/releases');
|
.replaceAll('RELEASES_URL', 'https://flutter.dev/docs/development/tools/sdk/releases');
|
||||||
})
|
})
|
||||||
.join('\n');
|
.join('\n');
|
||||||
expect(result,
|
expect(result,
|
||||||
'╔═╡ERROR #1╞════════════════════════════════════════════════════════════════════\n'
|
'╔═╡ERROR #1╞════════════════════════════════════════════════════════════════════\n'
|
||||||
'$lines\n'
|
'$lines\n'
|
||||||
'║ See: https://github.com/flutter/flutter/wiki/Tree-hygiene#handling-breaking-changes\n'
|
'║ See: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes\n'
|
||||||
'╚═══════════════════════════════════════════════════════════════════════════════\n'
|
'╚═══════════════════════════════════════════════════════════════════════════════\n'
|
||||||
);
|
);
|
||||||
});
|
});
|
||||||
@ -92,7 +92,7 @@ void main() {
|
|||||||
expect(result.length, 4 + lines.length, reason: 'output had unexpected number of lines:\n${result.join('\n')}');
|
expect(result.length, 4 + lines.length, reason: 'output had unexpected number of lines:\n${result.join('\n')}');
|
||||||
expect(result[0], '╔═╡ERROR #1╞════════════════════════════════════════════════════════════════════');
|
expect(result[0], '╔═╡ERROR #1╞════════════════════════════════════════════════════════════════════');
|
||||||
expect(result.getRange(1, result.length - 3).toSet(), lines.toSet());
|
expect(result.getRange(1, result.length - 3).toSet(), lines.toSet());
|
||||||
expect(result[result.length - 3], '║ See: https://github.com/flutter/flutter/wiki/Writing-a-golden-file-test-for-package:flutter');
|
expect(result[result.length - 3], '║ See: https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-a-golden-file-test-for-package-flutter.md');
|
||||||
expect(result[result.length - 2], '╚═══════════════════════════════════════════════════════════════════════════════');
|
expect(result[result.length - 2], '╚═══════════════════════════════════════════════════════════════════════════════');
|
||||||
expect(result[result.length - 1], ''); // trailing newline
|
expect(result[result.length - 1], ''); // trailing newline
|
||||||
});
|
});
|
||||||
@ -187,7 +187,7 @@ void main() {
|
|||||||
'║ to which you need access, you should consider how to fetch it from another repository;\n'
|
'║ to which you need access, you should consider how to fetch it from another repository;\n'
|
||||||
'║ for example, the "assets-for-api-docs" repository is used for images in API docs.\n'
|
'║ for example, the "assets-for-api-docs" repository is used for images in API docs.\n'
|
||||||
'║ To add assets to flutter_tools templates, see the instructions in the wiki:\n'
|
'║ To add assets to flutter_tools templates, see the instructions in the wiki:\n'
|
||||||
'║ https://github.com/flutter/flutter/wiki/Managing-template-image-assets\n'
|
'║ https://github.com/flutter/flutter/blob/main/docs/tool/Managing-template-image-assets.md\n'
|
||||||
'╚═══════════════════════════════════════════════════════════════════════════════\n'
|
'╚═══════════════════════════════════════════════════════════════════════════════\n'
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
@ -271,7 +271,7 @@ void _printLoudly(String message) {
|
|||||||
|
|
||||||
// THE FOLLOWING CODE IS A VIOLATION OF OUR STYLE GUIDE
|
// THE FOLLOWING CODE IS A VIOLATION OF OUR STYLE GUIDE
|
||||||
// BECAUSE IT INTRODUCES A VERY FLAKY RACE CONDITION
|
// BECAUSE IT INTRODUCES A VERY FLAKY RACE CONDITION
|
||||||
// https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#never-check-if-a-port-is-available-before-using-it-never-add-timeouts-and-other-race-conditions
|
// https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#never-check-if-a-port-is-available-before-using-it-never-add-timeouts-and-other-race-conditions
|
||||||
// DO NOT USE THE FOLLOWING FUNCTIONS
|
// DO NOT USE THE FOLLOWING FUNCTIONS
|
||||||
// DO NOT WRITE CODE LIKE THE FOLLOWING FUNCTIONS
|
// DO NOT WRITE CODE LIKE THE FOLLOWING FUNCTIONS
|
||||||
// https://github.com/flutter/flutter/issues/109474
|
// https://github.com/flutter/flutter/issues/109474
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
# Flutter Conductor
|
# Flutter Conductor
|
||||||
|
|
||||||
Command-line tool for managing a release of the Flutter SDK. Also see
|
Command-line tool for managing a release of the Flutter SDK. Also see
|
||||||
https://github.com/flutter/flutter/wiki/Release-process for more information on
|
[Release Process](../../docs/releases/Release-process.md) for more information on
|
||||||
the release process.
|
the release process.
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
// Use of this source code is governed by a BSD-style license that can be
|
// Use of this source code is governed by a BSD-style license that can be
|
||||||
// found in the LICENSE file.
|
// found in the LICENSE file.
|
||||||
|
|
||||||
// See: https://github.com/flutter/flutter/wiki/Release-process
|
// See: https://github.com/flutter/flutter/blob/main/docs/releases/Release-process.md
|
||||||
|
|
||||||
import 'dart:io' as io;
|
import 'dart:io' as io;
|
||||||
|
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
// Use of this source code is governed by a BSD-style license that can be
|
// Use of this source code is governed by a BSD-style license that can be
|
||||||
// found in the LICENSE file.
|
// found in the LICENSE file.
|
||||||
|
|
||||||
// See: https://github.com/flutter/flutter/wiki/Release-process
|
// See: https://github.com/flutter/flutter/blob/main/docs/releases/Release-process.md
|
||||||
|
|
||||||
export 'src/candidates.dart';
|
export 'src/candidates.dart';
|
||||||
export 'src/clean.dart';
|
export 'src/clean.dart';
|
||||||
|
@ -16,7 +16,7 @@ const List<String> kBaseReleaseChannels = <String>['stable', 'beta'];
|
|||||||
|
|
||||||
const List<String> kReleaseChannels = <String>[...kBaseReleaseChannels, FrameworkRepository.defaultBranch];
|
const List<String> kReleaseChannels = <String>[...kBaseReleaseChannels, FrameworkRepository.defaultBranch];
|
||||||
|
|
||||||
const String kReleaseDocumentationUrl = 'https://github.com/flutter/flutter/wiki/Flutter-Cherrypick-Process';
|
const String kReleaseDocumentationUrl = 'https://github.com/flutter/flutter/blob/main/docs/releases/Flutter-Cherrypick-Process.md';
|
||||||
|
|
||||||
const String kLuciPackagingConsoleLink = 'https://ci.chromium.org/p/dart-internal/g/flutter_packaging/console';
|
const String kLuciPackagingConsoleLink = 'https://ci.chromium.org/p/dart-internal/g/flutter_packaging/console';
|
||||||
|
|
||||||
@ -29,13 +29,13 @@ const String flutterReleaseHotline =
|
|||||||
'https://mail.google.com/chat/u/0/#chat/space/AAAA6RKcK2k';
|
'https://mail.google.com/chat/u/0/#chat/space/AAAA6RKcK2k';
|
||||||
|
|
||||||
const String hotfixToStableWiki =
|
const String hotfixToStableWiki =
|
||||||
'https://github.com/flutter/flutter/wiki/Hotfixes-to-the-Stable-Channel';
|
'https://github.com/flutter/flutter/blob/main/docs/releases/Hotfixes-to-the-Stable-Channel.md';
|
||||||
|
|
||||||
const String flutterAnnounceGroup =
|
const String flutterAnnounceGroup =
|
||||||
'https://groups.google.com/g/flutter-announce';
|
'https://groups.google.com/g/flutter-announce';
|
||||||
|
|
||||||
const String hotfixDocumentationBestPractices =
|
const String hotfixDocumentationBestPractices =
|
||||||
'https://github.com/flutter/flutter/wiki/Hotfix-Documentation-Best-Practices';
|
'https://github.com/flutter/flutter/blob/main/docs/releases/Hotfix-Documentation-Best-Practices.md';
|
||||||
|
|
||||||
final RegExp releaseCandidateBranchRegex = RegExp(
|
final RegExp releaseCandidateBranchRegex = RegExp(
|
||||||
r'flutter-(\d+)\.(\d+)-candidate\.(\d+)',
|
r'flutter-(\d+)\.(\d+)-candidate\.(\d+)',
|
||||||
|
@ -32,7 +32,7 @@ renderer (`--web-renderer=html`).
|
|||||||
More resources:
|
More resources:
|
||||||
|
|
||||||
* chromedriver: https://chromedriver.chromium.org/getting-started
|
* chromedriver: https://chromedriver.chromium.org/getting-started
|
||||||
* FlutterDriver: https://github.com/flutter/flutter/wiki/Running-Flutter-Driver-tests-with-Web
|
* FlutterDriver: https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Running-Flutter-Driver-tests-with-Web.md
|
||||||
* `package:integration_test`: https://pub.dev/packages/integration_test
|
* `package:integration_test`: https://pub.dev/packages/integration_test
|
||||||
|
|
||||||
[1]: https://chromedriver.chromium.org/downloads
|
[1]: https://chromedriver.chromium.org/downloads
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
// found in the LICENSE file.
|
// found in the LICENSE file.
|
||||||
|
|
||||||
// Regenerates a Dart file with a class containing IconData constants.
|
// Regenerates a Dart file with a class containing IconData constants.
|
||||||
// See https://github.com/flutter/flutter/wiki/Updating-Material-Design-Fonts-&-Icons
|
// See https://github.com/flutter/flutter/blob/main/docs/libraries/material/Updating-Material-Design-Fonts-%26-Icons.md
|
||||||
// Should be idempotent with:
|
// Should be idempotent with:
|
||||||
// dart dev/tools/update_icons.dart --new-codepoints bin/cache/artifacts/material_fonts/codepoints
|
// dart dev/tools/update_icons.dart --new-codepoints bin/cache/artifacts/material_fonts/codepoints
|
||||||
|
|
||||||
|
@ -41,7 +41,7 @@ If the Flutter build is broken due to a golden file test failure, this typically
|
|||||||
Visit https://flutter-gold.skia.org/ to view and approve
|
Visit https://flutter-gold.skia.org/ to view and approve
|
||||||
the image(s), or revert the associated change. For more
|
the image(s), or revert the associated change. For more
|
||||||
information, visit the wiki:
|
information, visit the wiki:
|
||||||
https://github.com/flutter/flutter/wiki/Writing-a-golden-file-test-for-package:flutter
|
https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-a-golden-file-test-for-package-flutter.md
|
||||||
```
|
```
|
||||||
|
|
||||||
To resolve, visit the [Flutter Gold dashboard](https://flutter-gold.skia.org/) to view the batch of images in question. If they are intended changes, approve them by clicking the checkmark, and re-run the failing test to resolve. If the image changes are not intended, revert the associated change.
|
To resolve, visit the [Flutter Gold dashboard](https://flutter-gold.skia.org/) to view the batch of images in question. If they are intended changes, approve them by clicking the checkmark, and re-run the failing test to resolve. If the image changes are not intended, revert the associated change.
|
||||||
|
File diff suppressed because one or more lines are too long
@ -5,5 +5,5 @@ include: ../analysis_options.yaml
|
|||||||
|
|
||||||
linter:
|
linter:
|
||||||
rules:
|
rules:
|
||||||
- public_member_api_docs # see https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#documentation-dartdocs-javadocs-etc
|
- public_member_api_docs # see https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#documentation-dartdocs-javadocs-etc
|
||||||
- no_runtimeType_toString # use objectRuntimeType from package:foundation
|
- no_runtimeType_toString # use objectRuntimeType from package:foundation
|
||||||
|
@ -26,8 +26,7 @@ dart fix --compare-to-golden
|
|||||||
For more documentation about Data Driven Fixes, see
|
For more documentation about Data Driven Fixes, see
|
||||||
https://dart.dev/go/data-driven-fixes#test-folder.
|
https://dart.dev/go/data-driven-fixes#test-folder.
|
||||||
|
|
||||||
To learn more about how fixes are authored in package:flutter, see
|
To learn more about how fixes are authored in package:flutter, see [Data driven Fixes](../../../../docs/contributing/Data-driven-Fixes.md).
|
||||||
https://github.com/flutter/flutter/wiki/Data-driven-Fixes
|
|
||||||
|
|
||||||
## When making structural changes to this directory
|
## When making structural changes to this directory
|
||||||
|
|
||||||
|
@ -27,7 +27,7 @@ final class PlatformAdaptiveIcons implements Icons {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// Generated code: do not hand-edit.
|
// Generated code: do not hand-edit.
|
||||||
// See https://github.com/flutter/flutter/wiki/Updating-Material-Design-Fonts-&-Icons
|
// https://github.com/flutter/flutter/blob/main/docs/libraries/material/Updating-Material-Design-Fonts-%26-Icons.md
|
||||||
|
|
||||||
// BEGIN GENERATED PLATFORM ADAPTIVE ICONS
|
// BEGIN GENERATED PLATFORM ADAPTIVE ICONS
|
||||||
|
|
||||||
@ -178,7 +178,7 @@ abstract final class Icons {
|
|||||||
static PlatformAdaptiveIcons get adaptive => const PlatformAdaptiveIcons._();
|
static PlatformAdaptiveIcons get adaptive => const PlatformAdaptiveIcons._();
|
||||||
|
|
||||||
// Generated code: do not hand-edit.
|
// Generated code: do not hand-edit.
|
||||||
// See https://github.com/flutter/flutter/wiki/Updating-Material-Design-Fonts-&-Icons
|
// https://github.com/flutter/flutter/blob/main/docs/libraries/material/Updating-Material-Design-Fonts-%26-Icons.md
|
||||||
// BEGIN GENERATED ICONS
|
// BEGIN GENERATED ICONS
|
||||||
|
|
||||||
/// <i class="material-icons md-36">10k</i> — material icon named "10k".
|
/// <i class="material-icons md-36">10k</i> — material icon named "10k".
|
||||||
|
@ -9,7 +9,7 @@ dependencies:
|
|||||||
# To update these, use "flutter update-packages --force-upgrade".
|
# To update these, use "flutter update-packages --force-upgrade".
|
||||||
#
|
#
|
||||||
# For detailed instructions, refer to:
|
# For detailed instructions, refer to:
|
||||||
# https://github.com/flutter/flutter/wiki/Updating-dependencies-in-Flutter
|
# https://github.com/flutter/flutter/blob/main/docs/infra/Updating-dependencies-in-Flutter.md
|
||||||
characters: 1.3.0
|
characters: 1.3.0
|
||||||
collection: 1.18.0
|
collection: 1.18.0
|
||||||
material_color_utilities: 0.11.1
|
material_color_utilities: 0.11.1
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
|
|
||||||
// This file is run as part of a reduced test set in CI on Mac and Windows
|
// This file is run as part of a reduced test set in CI on Mac and Windows
|
||||||
// machines because it contains golden tests; see:
|
// machines because it contains golden tests; see:
|
||||||
// https://github.com/flutter/flutter/wiki/Writing-a-golden-file-test-for-package:flutter#reduced-test-set-tag
|
// https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-a-golden-file-test-for-package-flutter.md
|
||||||
@Tags(<String>['reduced-test-set'])
|
@Tags(<String>['reduced-test-set'])
|
||||||
library;
|
library;
|
||||||
|
|
||||||
|
@ -17,7 +17,7 @@ For more documentation about Data Driven Fixes, see
|
|||||||
https://dart.dev/go/data-driven-fixes#test-folder.
|
https://dart.dev/go/data-driven-fixes#test-folder.
|
||||||
|
|
||||||
To learn more about how fixes are authored in package:flutter, see
|
To learn more about how fixes are authored in package:flutter, see
|
||||||
https://github.com/flutter/flutter/wiki/Data-driven-Fixes
|
[Data driven fixes](../../../docs/contributing/Data-driven-Fixes.md).
|
||||||
|
|
||||||
## When making structural changes to this directory
|
## When making structural changes to this directory
|
||||||
|
|
||||||
|
@ -8,7 +8,7 @@ dependencies:
|
|||||||
# To update these, use "flutter update-packages --force-upgrade".
|
# To update these, use "flutter update-packages --force-upgrade".
|
||||||
#
|
#
|
||||||
# For detailed instructions, refer to:
|
# For detailed instructions, refer to:
|
||||||
# https://github.com/flutter/flutter/wiki/Updating-dependencies-in-Flutter
|
# https://github.com/flutter/flutter/blob/main/docs/infra/Updating-dependencies-in-Flutter.md
|
||||||
meta: 1.15.0
|
meta: 1.15.0
|
||||||
path: 1.9.0
|
path: 1.9.0
|
||||||
process: 5.0.2
|
process: 5.0.2
|
||||||
|
@ -7,7 +7,7 @@ dependencies:
|
|||||||
# To update these, use "flutter update-packages --force-upgrade".
|
# To update these, use "flutter update-packages --force-upgrade".
|
||||||
#
|
#
|
||||||
# For detailed instructions, refer to:
|
# For detailed instructions, refer to:
|
||||||
# https://github.com/flutter/flutter/wiki/Updating-dependencies-in-Flutter
|
# https://github.com/flutter/flutter/blob/main/docs/infra/Updating-dependencies-in-Flutter.md
|
||||||
flutter:
|
flutter:
|
||||||
sdk: flutter
|
sdk: flutter
|
||||||
flutter_test:
|
flutter_test:
|
||||||
|
@ -26,7 +26,7 @@ For more documentation about Data Driven Fixes, see
|
|||||||
https://dart.dev/go/data-driven-fixes#test-folder.
|
https://dart.dev/go/data-driven-fixes#test-folder.
|
||||||
|
|
||||||
To learn more about how fixes are authored in package:flutter_driver, see
|
To learn more about how fixes are authored in package:flutter_driver, see
|
||||||
https://github.com/flutter/flutter/wiki/Data-driven-Fixes
|
[Data driven fixes](../../../../docs/contributing/Data-driven-Fixes.md).
|
||||||
|
|
||||||
## When making structural changes to this directory
|
## When making structural changes to this directory
|
||||||
|
|
||||||
|
@ -17,7 +17,7 @@ For more documentation about Data Driven Fixes, see
|
|||||||
https://dart.dev/go/data-driven-fixes#test-folder.
|
https://dart.dev/go/data-driven-fixes#test-folder.
|
||||||
|
|
||||||
To learn more about how fixes are authored in package:flutter, see
|
To learn more about how fixes are authored in package:flutter, see
|
||||||
https://github.com/flutter/flutter/wiki/Data-driven-Fixes
|
[Data driven fixes](../../../docs/contributing/Data-driven-Fixes.md).
|
||||||
|
|
||||||
## When making structural changes to this directory
|
## When making structural changes to this directory
|
||||||
|
|
||||||
|
@ -17,7 +17,7 @@ export 'skia_client.dart';
|
|||||||
|
|
||||||
// If you are here trying to figure out how to use golden files in the Flutter
|
// If you are here trying to figure out how to use golden files in the Flutter
|
||||||
// repo itself, consider reading this wiki page:
|
// repo itself, consider reading this wiki page:
|
||||||
// https://github.com/flutter/flutter/wiki/Writing-a-golden-file-test-for-package%3Aflutter
|
// https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-a-golden-file-test-for-package-flutter.md
|
||||||
|
|
||||||
// If you are trying to debug this package, you may like to use the golden test
|
// If you are trying to debug this package, you may like to use the golden test
|
||||||
// titled "Inconsequential golden test" in this file:
|
// titled "Inconsequential golden test" in this file:
|
||||||
|
@ -13,7 +13,7 @@ import 'package:process/process.dart';
|
|||||||
|
|
||||||
// If you are here trying to figure out how to use golden files in the Flutter
|
// If you are here trying to figure out how to use golden files in the Flutter
|
||||||
// repo itself, consider reading this wiki page:
|
// repo itself, consider reading this wiki page:
|
||||||
// https://github.com/flutter/flutter/wiki/Writing-a-golden-file-test-for-package%3Aflutter
|
// https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-a-golden-file-test-for-package-flutter.md
|
||||||
|
|
||||||
const String _kFlutterRootKey = 'FLUTTER_ROOT';
|
const String _kFlutterRootKey = 'FLUTTER_ROOT';
|
||||||
const String _kGoldctlKey = 'GOLDCTL';
|
const String _kGoldctlKey = 'GOLDCTL';
|
||||||
@ -238,7 +238,7 @@ class SkiaGoldClient {
|
|||||||
..writeln('Visit https://flutter-gold.skia.org/ to view and approve ')
|
..writeln('Visit https://flutter-gold.skia.org/ to view and approve ')
|
||||||
..writeln('the image(s), or revert the associated change. For more ')
|
..writeln('the image(s), or revert the associated change. For more ')
|
||||||
..writeln('information, visit the wiki: ')
|
..writeln('information, visit the wiki: ')
|
||||||
..writeln('https://github.com/flutter/flutter/wiki/Writing-a-golden-file-test-for-package:flutter')
|
..writeln('https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-a-golden-file-test-for-package-flutter.md')
|
||||||
..writeln()
|
..writeln()
|
||||||
..writeln('Debug information for Gold --------------------------------')
|
..writeln('Debug information for Gold --------------------------------')
|
||||||
..writeln('stdout: ${result.stdout}')
|
..writeln('stdout: ${result.stdout}')
|
||||||
|
@ -7,7 +7,7 @@ dependencies:
|
|||||||
# To update these, use "flutter update-packages --force-upgrade".
|
# To update these, use "flutter update-packages --force-upgrade".
|
||||||
#
|
#
|
||||||
# For detailed instructions, refer to:
|
# For detailed instructions, refer to:
|
||||||
# https://github.com/flutter/flutter/wiki/Updating-dependencies-in-Flutter
|
# https://github.com/flutter/flutter/blob/main/docs/infra/Updating-dependencies-in-Flutter.md
|
||||||
flutter:
|
flutter:
|
||||||
sdk: flutter
|
sdk: flutter
|
||||||
flutter_test:
|
flutter_test:
|
||||||
|
@ -7,7 +7,7 @@ dependencies:
|
|||||||
# To update these, use "flutter update-packages --force-upgrade".
|
# To update these, use "flutter update-packages --force-upgrade".
|
||||||
#
|
#
|
||||||
# For detailed instructions, refer to:
|
# For detailed instructions, refer to:
|
||||||
# https://github.com/flutter/flutter/wiki/Updating-dependencies-in-Flutter
|
# https://github.com/flutter/flutter/blob/main/docs/infra/Updating-dependencies-in-Flutter.md
|
||||||
|
|
||||||
flutter:
|
flutter:
|
||||||
sdk: flutter
|
sdk: flutter
|
||||||
|
@ -26,7 +26,7 @@ For more documentation about Data Driven Fixes, see
|
|||||||
https://dart.dev/go/data-driven-fixes#test-folder.
|
https://dart.dev/go/data-driven-fixes#test-folder.
|
||||||
|
|
||||||
To learn more about how fixes are authored in package:flutter_test, see
|
To learn more about how fixes are authored in package:flutter_test, see
|
||||||
https://github.com/flutter/flutter/wiki/Data-driven-Fixes
|
[Data driven fixes](../../../../docs/contributing/Data-driven-Fixes.md).
|
||||||
|
|
||||||
## When making structural changes to this directory
|
## When making structural changes to this directory
|
||||||
|
|
||||||
|
@ -84,7 +84,7 @@ abstract class GoldenFileComparator {
|
|||||||
/// historical golden files.
|
/// historical golden files.
|
||||||
///
|
///
|
||||||
/// Version numbers are used in golden file tests for package:flutter. You can
|
/// Version numbers are used in golden file tests for package:flutter. You can
|
||||||
/// learn more about these tests [here](https://github.com/flutter/flutter/wiki/Writing-a-golden-file-test-for-package:flutter).
|
/// learn more about these tests [here](https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-a-golden-file-test-for-package-flutter.md).
|
||||||
Uri getTestUri(Uri key, int? version) {
|
Uri getTestUri(Uri key, int? version) {
|
||||||
if (version == null) {
|
if (version == null) {
|
||||||
return key;
|
return key;
|
||||||
@ -216,7 +216,7 @@ abstract class WebGoldenComparator {
|
|||||||
/// historical golden files.
|
/// historical golden files.
|
||||||
///
|
///
|
||||||
/// Version numbers are used in golden file tests for package:flutter. You can
|
/// Version numbers are used in golden file tests for package:flutter. You can
|
||||||
/// learn more about these tests [here](https://github.com/flutter/flutter/wiki/Writing-a-golden-file-test-for-package:flutter).
|
/// learn more about these tests [here](https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-a-golden-file-test-for-package-flutter.md).
|
||||||
Uri getTestUri(Uri key, int? version) {
|
Uri getTestUri(Uri key, int? version) {
|
||||||
if (version == null) {
|
if (version == null) {
|
||||||
return key;
|
return key;
|
||||||
|
@ -7,7 +7,7 @@ dependencies:
|
|||||||
# To update these, use "flutter update-packages --force-upgrade".
|
# To update these, use "flutter update-packages --force-upgrade".
|
||||||
#
|
#
|
||||||
# For detailed instructions, refer to:
|
# For detailed instructions, refer to:
|
||||||
# https://github.com/flutter/flutter/wiki/Updating-dependencies-in-Flutter
|
# https://github.com/flutter/flutter/blob/main/docs/infra/Updating-dependencies-in-Flutter.md
|
||||||
|
|
||||||
flutter:
|
flutter:
|
||||||
sdk: flutter
|
sdk: flutter
|
||||||
|
@ -7,7 +7,7 @@ for building Flutter applications.
|
|||||||
|
|
||||||
Be sure to follow the instructions on [CONTRIBUTING.md](../../CONTRIBUTING.md)
|
Be sure to follow the instructions on [CONTRIBUTING.md](../../CONTRIBUTING.md)
|
||||||
to set up your development environment. Further, familiarize yourself with the
|
to set up your development environment. Further, familiarize yourself with the
|
||||||
[style guide](https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo),
|
[style guide](../../docs/contributing/Style-guide-for-Flutter-repo.md),
|
||||||
which we follow.
|
which we follow.
|
||||||
|
|
||||||
### Setting up
|
### Setting up
|
||||||
@ -36,8 +36,8 @@ $ flutter analyze
|
|||||||
|
|
||||||
### Writing tests
|
### Writing tests
|
||||||
|
|
||||||
As with other parts of the Flutter repository, all changes in behavior [must be
|
As with other parts of the Flutter repository, all changes in behavior
|
||||||
tested](https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo#write-test-find-bug).
|
[must be tested](../../docs/contributing/Style-guide-for-Flutter-repo.md#write-test-find-bug).
|
||||||
Tests live under the `test/` subdirectory.
|
Tests live under the `test/` subdirectory.
|
||||||
|
|
||||||
- Hermetic unit tests of tool internals go under `test/general.shard`
|
- Hermetic unit tests of tool internals go under `test/general.shard`
|
||||||
|
@ -323,7 +323,7 @@ class EngineBuildPaths {
|
|||||||
|
|
||||||
/// Information about a local engine build (i.e. `--local-engine[-host]=...`).
|
/// Information about a local engine build (i.e. `--local-engine[-host]=...`).
|
||||||
///
|
///
|
||||||
/// See https://github.com/flutter/flutter/wiki/The-flutter-tool#using-a-locally-built-engine-with-the-flutter-tool
|
/// See https://github.com/flutter/flutter/blob/main/docs/tool/README.md#using-a-locally-built-engine-with-the-flutter-tool
|
||||||
/// for more information about local engine builds.
|
/// for more information about local engine builds.
|
||||||
class LocalEngineInfo {
|
class LocalEngineInfo {
|
||||||
/// Creates a reference to a local engine build.
|
/// Creates a reference to a local engine build.
|
||||||
|
@ -9,7 +9,7 @@ dependencies:
|
|||||||
# To update these, use "flutter update-packages --force-upgrade".
|
# To update these, use "flutter update-packages --force-upgrade".
|
||||||
#
|
#
|
||||||
# For detailed instructions, refer to:
|
# For detailed instructions, refer to:
|
||||||
# https://github.com/flutter/flutter/wiki/Updating-dependencies-in-Flutter
|
# https://github.com/flutter/flutter/blob/main/docs/infra/Updating-dependencies-in-Flutter.md
|
||||||
archive: 3.6.1
|
archive: 3.6.1
|
||||||
args: 2.5.0
|
args: 2.5.0
|
||||||
browser_launcher: 1.1.1
|
browser_launcher: 1.1.1
|
||||||
|
@ -923,7 +923,7 @@ void main() {
|
|||||||
// Import for the new embedding class.
|
// Import for the new embedding class.
|
||||||
expect(mainActivity.contains('import io.flutter.embedding.android.FlutterActivity'), true);
|
expect(mainActivity.contains('import io.flutter.embedding.android.FlutterActivity'), true);
|
||||||
|
|
||||||
expect(logger.statusText, isNot(contains('https://github.com/flutter/flutter/wiki/Upgrading-pre-1.12-Android-projects')));
|
expect(logger.statusText, isNot(contains('https://github.com/flutter/flutter/blob/main/docs/platforms/android/Upgrading-pre-1.12-Android-projects.md')));
|
||||||
}, overrides: <Type, Generator>{
|
}, overrides: <Type, Generator>{
|
||||||
Logger: () => logger,
|
Logger: () => logger,
|
||||||
});
|
});
|
||||||
|
@ -211,13 +211,13 @@ void main() {
|
|||||||
// android:name="flutterEmbedding" android:value="2" />.
|
// android:name="flutterEmbedding" android:value="2" />.
|
||||||
|
|
||||||
project.checkForDeprecation(deprecationBehavior: DeprecationBehavior.ignore);
|
project.checkForDeprecation(deprecationBehavior: DeprecationBehavior.ignore);
|
||||||
expect(testLogger.statusText, isNot(contains('https://github.com/flutter/flutter/wiki/Upgrading-pre-1.12-Android-projects')));
|
expect(testLogger.statusText, isNot(contains('https://github.com/flutter/flutter/blob/main/docs/platforms/android/Upgrading-pre-1.12-Android-projects.md')));
|
||||||
});
|
});
|
||||||
_testInMemory('Android plugin project does not throw v1 embedding deprecation warning', () async {
|
_testInMemory('Android plugin project does not throw v1 embedding deprecation warning', () async {
|
||||||
final FlutterProject project = await aPluginProject();
|
final FlutterProject project = await aPluginProject();
|
||||||
|
|
||||||
project.checkForDeprecation(deprecationBehavior: DeprecationBehavior.exit);
|
project.checkForDeprecation(deprecationBehavior: DeprecationBehavior.exit);
|
||||||
expect(testLogger.statusText, isNot(contains('https://github.com/flutter/flutter/wiki/Upgrading-pre-1.12-Android-projects')));
|
expect(testLogger.statusText, isNot(contains('https://github.com/flutter/flutter/blob/main/docs/platforms/android/Upgrading-pre-1.12-Android-projects.md')));
|
||||||
expect(testLogger.statusText, isNot(contains('No `<meta-data android:name="flutterEmbedding" android:value="2"/>` in ')));
|
expect(testLogger.statusText, isNot(contains('No `<meta-data android:name="flutterEmbedding" android:value="2"/>` in ')));
|
||||||
});
|
});
|
||||||
_testInMemory('Android plugin without example app does not show a warning', () async {
|
_testInMemory('Android plugin without example app does not show a warning', () async {
|
||||||
@ -225,7 +225,7 @@ void main() {
|
|||||||
project.example.directory.deleteSync();
|
project.example.directory.deleteSync();
|
||||||
|
|
||||||
await project.regeneratePlatformSpecificTooling();
|
await project.regeneratePlatformSpecificTooling();
|
||||||
expect(testLogger.statusText, isNot(contains('https://github.com/flutter/flutter/wiki/Upgrading-pre-1.12-Android-projects')));
|
expect(testLogger.statusText, isNot(contains('https://github.com/flutter/flutter/blob/main/docs/platforms/android/Upgrading-pre-1.12-Android-projects.md')));
|
||||||
});
|
});
|
||||||
_testInMemory('updates local properties for Android', () async {
|
_testInMemory('updates local properties for Android', () async {
|
||||||
final FlutterProject project = await someProject();
|
final FlutterProject project = await someProject();
|
||||||
|
@ -26,7 +26,7 @@ For more documentation about Data Driven Fixes, see
|
|||||||
https://dart.dev/go/data-driven-fixes#test-folder.
|
https://dart.dev/go/data-driven-fixes#test-folder.
|
||||||
|
|
||||||
To learn more about how fixes are authored in package:integration_test, see
|
To learn more about how fixes are authored in package:integration_test, see
|
||||||
https://github.com/flutter/flutter/wiki/Data-driven-Fixes
|
[Data driven fixes](../../../../docs/contributing/Data-driven-Fixes.md).
|
||||||
|
|
||||||
## When making structural changes to this directory
|
## When making structural changes to this directory
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user