-### Create your sample Flutter app {:#create-app-android-studio}
+### Create a sample Flutter app {:#create-app-android-studio}
1. Launch the IDE.
-1. Click **New Flutter Project** at the top of the
+2. To be able to create flutter projects on Android Studio you will need to install the
+ [Flutter Plugin](https://plugins.jetbrains.com/plugin/9212-flutter) and for smart Dart
+ coding assistance that includes code completion, formatting, navigation, intentions,
+ refactorings, and more install the [Dart Plugin](https://plugins.jetbrains.com/plugin/6351-dart/).
+
+3. Head back to your IDE start page and Click **New Flutter Project** at the top of the
**Welcome to Android Studio** dialog.
-1. Under **Generators**, click **Flutter**.
+4. Under **Generators**, click **Flutter**.
-1. Verify the **Flutter SDK path** value against the Flutter SDK location
+5. Verify the **Flutter SDK path** value against the Flutter SDK location
on your development machine.
-1. Click **Next**.
+6. Click **Next**.
-1. Enter `test_drive` into the **Project name** field.
- This follows best practices for naming Flutter projects.
+7. Enter `test_drive` into the **Project name** field.
+ Your project name should be written in [snake case](https://developer.mozilla.org/en-US/docs/Glossary/Snake_case) and in lowercase. This follows the Flutter best practices for naming projects.
-1. Set the directory in the **Project location** field to
+8. Set the directory in the **Project location** field to
`C:\dev\test_drive` on Microsoft Windows or
`~/development/test_drive` on other platforms.
If you didn't create that directory before, Android Studio displays
a warning that the **Directory Does Not Exist**. Click **Create**.
-1. From **Project type** dropdown, select **Application**.
-
-1. Change the **Organization** to `com.example.flutter.testdrive`.
-
- Android Studio asks for a company domain name.
- Android uses the company domain name and project name together as its
- package name when you release the app. iOS uses its Bundle ID.
-
- Use `com.example.flutter.testdrive` to prevent future conflicts.
+9. From **Project type** dropdown, select **Application**.
-1. Ignore the remaining form fields. You don't need to change them for
- this test drive. Click **Create**.
+10. Ignore the remaining form fields. You don't need to change them for
+ this test drive. Click **Create**.
-1. Wait for Android Studio to create the project.
+11. Wait for Android Studio to create the project.
-1. Open the `lib` directory, then the `main.dart`.
+12. Open the `lib` directory, then the `main.dart`.
- To learn what each code block does, check out the comments in that Dart file.
+ To learn what each code block does, check out the comments in that Dart file.
The previous commands create a Flutter project directory
called `test_drive` that contains a simple demo app that
diff --git a/src/_includes/docs/install/test-drive/vscode.md b/src/_includes/docs/install/test-drive/vscode.md
index b9b8265f4a..9a4b1ba65e 100644
--- a/src/_includes/docs/install/test-drive/vscode.md
+++ b/src/_includes/docs/install/test-drive/vscode.md
@@ -1,29 +1,33 @@
-### Create your sample Flutter app {:#create-app-vs-code}
+### Create a sample Flutter app {:#create-app-vs-code}
-1. Open the Command Palette.
+1. To use the DevTools from VS Code, you need the [Dart extension](https://marketplace.visualstudio.com/items?itemName=Dart-Code.dart-code).
+ To easily debug your application you should also install
+ the [Flutter extension](https://marketplace.visualstudio.com/items?itemName=Dart-Code.flutter).
+
+2. Open the Command Palette.
Go to **View**
> **Command Palette** or
press
{{special}} +
Shift +
P.
-1. Type `flutter`
+3. Type `flutter`
-1. Select the **Flutter: New Project**.
+4. Select the **Flutter: New Project**.
-1. When prompted for **Which Flutter Project**, select **Application**.
+5. When prompted for **Which Flutter Project**, select **Application**.
-1. Create or select the parent directory for the new project folder.
+6. Create or select the parent directory for the new project folder.
-1. When prompted for a **Project Name**, enter `test_drive`.
+7. When prompted for a **Project Name**, enter `test_drive`.
-1. Press
Enter.
+8. Press
Enter.
-1. Wait for project creation to complete.
+9. Wait for project creation to complete.
-1. Open the `lib` directory, then the `main.dart`.
+10. Open the `lib` directory, then the `main.dart`.
- To learn what each code block does, check out the comments in that Dart file.
+ To learn what each code block does, check out the comments in that Dart file.
The previous commands create a Flutter project directory called `test_drive` that
contains a simple demo app that uses [Material Components][].
diff --git a/src/content/get-started/test-drive/index.md b/src/content/get-started/test-drive/index.md
index b4bec29d38..7dbae6224a 100644
--- a/src/content/get-started/test-drive/index.md
+++ b/src/content/get-started/test-drive/index.md
@@ -37,7 +37,6 @@ toc: false
1. How to run the new Flutter app.
1. How to use "hot reload" after you make changes to the app.
-## Guide depends on your IDE
These tasks depend on which integrated development environment (IDE) you use.
From 023adb4400c69c1dd1d406b112988b9f1d19db76 Mon Sep 17 00:00:00 2001
From: Brett Morgan
Date: Mon, 29 Apr 2024 12:52:17 +1000
Subject: [PATCH 013/109] Update a title in unreleased breaking changes list
(#10468)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
_Description of what this PR is changing or adding, and why:_ Adding
markdown code markers to a title
_Issues fixed by this PR (if any):_
## Presubmit checklist
- [x] This PR doesn’t contain automatically generated corrections
(Grammarly or similar).
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style) — for example, it
doesn’t use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first person).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
of 80 characters or fewer.
---
src/content/release/breaking-changes/index.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/src/content/release/breaking-changes/index.md b/src/content/release/breaking-changes/index.md
index 67f93505c3..f334f9518e 100644
--- a/src/content/release/breaking-changes/index.md
+++ b/src/content/release/breaking-changes/index.md
@@ -39,7 +39,7 @@ release, and listed in alphabetical order:
* [Stop generating `AssetManifest.json`][]
* [Rename `MemoryAllocations` to `FlutterMemoryAllocations`][]
* [Deprecate `TextField.canRequestFocus`][]
-* [Nullable PageView.controller][]
+* [Nullable `PageView.controller`][]
* [Deprecate `ButtonBar` in favor of `OverflowBar`][]
* [Deprecated API removed after v3.19][]
* [Dropping support for Android KitKat][]
@@ -50,7 +50,7 @@ release, and listed in alphabetical order:
[Stop generating `AssetManifest.json`]: /release/breaking-changes/asset-manifest-dot-json
[Rename `MemoryAllocations` to `FlutterMemoryAllocations`]: /release/breaking-changes/flutter-memory-allocations
[Deprecate `TextField.canRequestFocus`]: /release/breaking-changes/can-request-focus
-[Nullable PageView.controller]: /release/breaking-changes/pageview-controller
+[Nullable `PageView.controller`]: /release/breaking-changes/pageview-controller
[Deprecate `ButtonBar` in favor of `OverflowBar`]: /release/breaking-changes/deprecate-buttonbar
[Deprecated API removed after v3.19]: /release/breaking-changes/3-19-deprecations
[Dropping support for Android KitKat]: /release/breaking-changes/android-kitkat-deprecation
From 3c8f77b317720dda9a8858068063ece79a9db1dc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 29 Apr 2024 11:46:02 -0500
Subject: [PATCH 014/109] Bump examples/codelabs from `e0ea092` to `cad3558`
(#10470)
Bumps [examples/codelabs](https://github.com/flutter/codelabs) from
`e0ea092` to `cad3558`.
Commits
Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.
[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)
---
Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)
Signed-off-by: dependabot[bot]
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
examples/codelabs | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/examples/codelabs b/examples/codelabs
index e0ea0921ec..cad35585dc 160000
--- a/examples/codelabs
+++ b/examples/codelabs
@@ -1 +1 @@
-Subproject commit e0ea0921ecc5c06d991d116ee9e400b965faa089
+Subproject commit cad35585dcc159a89d6157cd3a56d82969d33a6c
From dbe5a2018a4080d892da82c38033ef41dae4f03d Mon Sep 17 00:00:00 2001
From: Amos
Date: Wed, 1 May 2024 02:43:26 +0800
Subject: [PATCH 015/109] Fix: Formatting in 'Configure your target iOS device'
guide (#10473)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
_Description of what this PR is changing or adding, and why:_
_Issues fixed by this PR (if any):_
None.
## Presubmit checklist
- [x] This PR doesn’t contain automatically generated corrections
(Grammarly or similar).
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style) — for example, it
doesn’t use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first person).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
of 80 characters or fewer.
---
.../docs/install/devices/ios-physical.md | 22 ++++++++++---------
1 file changed, 12 insertions(+), 10 deletions(-)
diff --git a/src/_includes/docs/install/devices/ios-physical.md b/src/_includes/docs/install/devices/ios-physical.md
index a98ff17de5..1e0ab1ffd5 100644
--- a/src/_includes/docs/install/devices/ios-physical.md
+++ b/src/_includes/docs/install/devices/ios-physical.md
@@ -82,13 +82,14 @@ Follow the Xcode signing flow to provision your project.
{: type="a"}
1. Go to **Xcode** >
- **Settings...*
+ **Settings...**
1. Click **Accounts**.
- . Click **+**.
- . Select **Apple ID** and click **Continue**.
- . When prompted, enter your **Apple ID** and **Password**.
- . Close the **Settings** dialog.
- Development and testing supports any Apple ID.
+ 1. Click **+**.
+ 1. Select **Apple ID** and click **Continue**.
+ 1. When prompted, enter your **Apple ID** and **Password**.
+ 1. Close the **Settings** dialog.
+
+ Development and testing supports any Apple ID.
1. Go to **File** > **Open...**
@@ -127,10 +128,11 @@ Follow the Xcode signing flow to provision your project.
1. Creates and downloads a Development Certificate
1. Registers your device with your account,
1. Creates and downloads a provisioning profile if needed
- If automatic signing fails in Xcode, verify that the project's
- **General** >
- **Identity** >
- **Bundle Identifier** value is unique.
+
+If automatic signing fails in Xcode, verify that the project's
+**General** >
+**Identity** >
+**Bundle Identifier** value is unique.
![Check the app's Bundle ID][]{:.mw-100}
From 88d3d7c31294a80873fb89d635ae4013ef16e186 Mon Sep 17 00:00:00 2001
From: Haroun El Omri
Date: Tue, 30 Apr 2024 21:46:09 +0200
Subject: [PATCH 016/109] Add the design document to add support for content://
URIs on Android (#10472)
See https://github.com/flutter/flutter/issues/147037.
---
firebase.json | 1 +
1 file changed, 1 insertion(+)
diff --git a/firebase.json b/firebase.json
index a7cb358eb4..f78d91e078 100644
--- a/firebase.json
+++ b/firebase.json
@@ -287,6 +287,7 @@
{ "source": "/go/colorscheme-m3", "destination": "https://docs.google.com/document/d/1mY1ahBQEMAfsawGJMX5S34pXb7c8dHGatyotClReeas/edit#heading=h.cnnhzna3pz6d", "type": 301 },
{ "source": "/go/configurable-autosubmit", "destination": "https://docs.google.com/document/d/14pf4jfBy1-PHYmJLVbeqrh1swTF01SZ2YD3DR_Qv3kM/edit?usp=sharing&resourcekey=0-AW7-kNNGmmpSUqyOvBdwRg", "type": 301 },
{ "source": "/go/contextual-menus", "destination": "https://docs.google.com/document/d/1F1itGgbSS3Cbq70hScSCNriDoux1sMGF9LHZsMdvU74/edit?resourcekey=0-RkHGwhe-tcoTGlaQyclPtQ", "type": 301 },
+ { "source": "/go/cross_file-content-uri-implementation", "destination": "https://docs.google.com/document/d/1-d7uWlB9ERPIOFRQ1nJGGiPDb9ALh7QxincEPOmGc3c", "type": 301 },
{ "source": "/go/cupertino-context-menu-action", "destination": "https://docs.google.com/document/d/1lCuPyAbIzAr0c2KIEZhREC_EnkTKBxNiqP6lGLT-KpU/edit", "type": 301 },
{ "source": "/go/cupertino-datepicker-redesign", "destination": "https://docs.google.com/document/d/1Ib5ztLzc19e1Uggz16BFlrJMg1TOdYLyP-WqtTpDltM/edit?usp=sharing&resourcekey=0-11oVmOsTHLD5fqxdAHZqNg", "type": 301 },
{ "source": "/go/cupertino-increase-contrast", "destination": "https://docs.google.com/document/d/1kePVlqWvJu5Ph0RL6wgg67F3SATmsJ8QY5N0S1MvaGg/edit#", "type": 301 },
From c8c47ac5fa640f93fd15e9609491996d7aa61043 Mon Sep 17 00:00:00 2001
From: "Shams Zakhour (ignore Sfshaza)"
<44418985+sfshaza2@users.noreply.github.com>
Date: Tue, 30 Apr 2024 13:51:04 -0700
Subject: [PATCH 017/109] Tweaking sidenav to clarify types of monetization
(#10476)
Partly addresses https://github.com/flutter/website/issues/10448
---
src/_data/sidenav.yml | 28 ++++++++++++++++++----------
1 file changed, 18 insertions(+), 10 deletions(-)
diff --git a/src/_data/sidenav.yml b/src/_data/sidenav.yml
index afbe229954..f6da7959f8 100644
--- a/src/_data/sidenav.yml
+++ b/src/_data/sidenav.yml
@@ -93,17 +93,25 @@
- title: Intro to Flame with Flutter
permalink: https://codelabs.developers.google.com/codelabs/flutter-flame-brick-breaker
- title: Monetization
+# - title: Overview
+# permalink: xxx
children:
- - title: Overview
- permalink: https://flutter.dev/monetization
- - title: Add in-app purchases
- permalink: https://codelabs.developers.google.com/codelabs/flutter-in-app-purchases
- - title: Add advertising
- permalink: /cookbook/plugins/google-mobile-ads
- - title: Add AdMob Ads to your Flutter app
- permalink: https://codelabs.developers.google.com/codelabs/admob-ads-in-flutter
- - title: Add an AdMob banner and native inline ads to a Flutter app
- permalink: https://codelabs.developers.google.com/codelabs/admob-inline-ads-in-flutter
+ - title: Advertising
+ children:
+ - title: Add advertising
+ permalink: /cookbook/plugins/google-mobile-ads
+ - title: Add AdMob ads to your Flutter app
+ permalink: https://codelabs.developers.google.com/codelabs/admob-ads-in-flutter
+ - title: Add an AdMob banner and native inline ads
+ permalink: https://codelabs.developers.google.com/codelabs/admob-inline-ads-in-flutter
+ - title: In-app purchases
+ children:
+ - title: Add in-app purchases
+ permalink: https://codelabs.developers.google.com/codelabs/flutter-in-app-purchases
+ - title: Payments
+ children:
+ - title: Google pay package
+ permalink: https://pub.dev/packages/pay
- title: Maps
children:
- title: Add maps to your app
From 5748cfefbffab884a00f6f40a30d0126e04c3445 Mon Sep 17 00:00:00 2001
From: John McCutchan
Date: Wed, 1 May 2024 08:27:46 -0700
Subject: [PATCH 018/109] Update plugin-api-migration.md (#10478)
Add a note at the top that this page does not apply to modern Flutter
code
---
src/content/release/breaking-changes/plugin-api-migration.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/src/content/release/breaking-changes/plugin-api-migration.md b/src/content/release/breaking-changes/plugin-api-migration.md
index e1bb1ae119..865663f15e 100644
--- a/src/content/release/breaking-changes/plugin-api-migration.md
+++ b/src/content/release/breaking-changes/plugin-api-migration.md
@@ -5,6 +5,10 @@ description: How to update a plugin using the old APIs to support the new APIs.
+:::note
+New plugins and all plugins that are compatible with Flutter 2 (March 2021) can ignore this page.
+:::
+
:::note
You might be directed to this page if the framework detects that
your app uses a plugin based on the old Android APIs.
From a0a2ec6fd0e18c769a890e2e7ff4136a435ef787 Mon Sep 17 00:00:00 2001
From: Parker Lougheed
Date: Thu, 2 May 2024 02:17:21 +0700
Subject: [PATCH 019/109] Avoid include shadowing issues in getting started
docs (#10475)
---
.../docs/install/compiler/android.md | 11 ++-----
src/_includes/docs/install/compiler/xcode.md | 18 +++++------
.../docs/install/devices/android-emulator.md | 7 +----
.../docs/install/devices/android-physical.md | 11 ++-----
src/_includes/docs/install/flutter-doctor.md | 18 +++++------
src/_includes/docs/install/flutter-sdk.md | 11 +++----
.../docs/install/flutter/download.md | 26 +++++++---------
src/_includes/docs/install/flutter/vscode.md | 16 +++++-----
src/_includes/docs/install/next-steps.md | 30 +++++++++----------
src/_includes/docs/install/reqs/add-web.md | 5 ++--
src/_includes/docs/install/reqs/linux/base.md | 18 +++++------
.../reqs/linux/install-desktop-tools.md | 7 ++---
.../docs/install/reqs/linux/set-path.md | 6 +---
.../docs/install/reqs/linux/software.md | 15 ++++------
.../docs/install/reqs/linux/unset-path.md | 6 ++--
src/_includes/docs/install/reqs/macos/base.md | 16 +++++-----
.../docs/install/reqs/macos/set-path.md | 5 +---
.../docs/install/reqs/macos/software.md | 3 +-
.../docs/install/reqs/macos/unset-path.md | 4 +--
.../docs/install/reqs/macos/zsh-config.md | 3 +-
.../docs/install/reqs/windows/base.md | 12 ++++----
.../docs/install/reqs/windows/set-path.md | 6 ++--
.../docs/install/reqs/windows/software.md | 12 ++++----
.../docs/install/reqs/windows/unset-path.md | 6 ++--
24 files changed, 109 insertions(+), 163 deletions(-)
diff --git a/src/_includes/docs/install/compiler/android.md b/src/_includes/docs/install/compiler/android.md
index 021b094388..a1cf670f72 100644
--- a/src/_includes/docs/install/compiler/android.md
+++ b/src/_includes/docs/install/compiler/android.md
@@ -1,12 +1,7 @@
## Configure Android development
-{% assign devos = include.devos %}
-{% assign target = include.target %}
-{% assign compiler = include.compiler %}
-{% assign attempt-time = include.attempt %}
-
-{% case devos %}
+{% case include.devos %}
{% when 'Windows' -%}
{% assign terminal='PowerShell' %}
{% assign prompt='C:\>' %}
@@ -155,13 +150,13 @@ Otherwise, you can skip to the [next section][check-dev].
-{% include docs/install/devices/android-emulator.md devos=devos %}
+{% include docs/install/devices/android-emulator.md devos=include.devos %}
-{% include docs/install/devices/android-physical.md devos=devos %}
+{% include docs/install/devices/android-physical.md devos=include.devos %}
diff --git a/src/_includes/docs/install/compiler/xcode.md b/src/_includes/docs/install/compiler/xcode.md
index 49e6cb8e61..9902302f7d 100644
--- a/src/_includes/docs/install/compiler/xcode.md
+++ b/src/_includes/docs/install/compiler/xcode.md
@@ -2,15 +2,12 @@
## Configure iOS development
{% assign prompt1='$' %}
-{% assign devos = include.devos %}
-{% assign target = include.target %}
-{% assign attempt = include.attempt %}
### Configure Xcode
-{% if attempt=="first" %}
+{% if include.attempt=="first" %}
-To develop Flutter apps for {{target}}, install Xcode to compile to native bytecode.
+To develop Flutter apps for {{include.target}}, install Xcode to compile to native bytecode.
1. To configure the command-line tools to use the installed version of Xcode,
run the following commands.
@@ -33,7 +30,7 @@ To develop Flutter apps for {{target}}, install Xcode to compile to native bytec
This section presumes you have installed and configured Xcode when you
installed Flutter for
-{%- case target %}
+{%- case include.target %}
{%- when 'iOS' %}
[macOS desktop][macos-install]
{%- when 'desktop' %}
@@ -48,7 +45,7 @@ installed Flutter for
Try to keep to the current version of Xcode.
-{% if target=='iOS' %}
+{% if include.target=='iOS' %}
### Configure your target iOS device
@@ -83,13 +80,14 @@ With Xcode, you can run Flutter apps on an iOS device or on the simulator.
{% endif %}
-{% if attempt=="first" %}
+{% if include.attempt=="first" %}
### Install CocoaPods
-If your apps depend on [Flutter plugins][] with native {{target}} code,
+If your apps depend on [Flutter plugins][] with native {{include.target}} code,
install [CocoaPods][cocoapods].
-This program bundles various dependencies across Flutter and {{target}} code.
+This program bundles various dependencies across
+Flutter and {{include.target}} code.
To install and set up CocoaPods, run the following commands:
diff --git a/src/_includes/docs/install/devices/android-emulator.md b/src/_includes/docs/install/devices/android-emulator.md
index e393c85f95..151dfd669e 100644
--- a/src/_includes/docs/install/devices/android-emulator.md
+++ b/src/_includes/docs/install/devices/android-emulator.md
@@ -2,12 +2,7 @@
{% include docs/help-link.md location='android-emulator' section='#android-setup' %}
-{% assign devos = include.devos %}
-{% assign target = include.target %}
-{% assign compiler = include.compiler %}
-{% assign attempt = include.attempt %}
-
-{% case devos %}
+{% case include.devos %}
{% when 'Windows','Linux' -%}
{% assign images = '**x86 Images**' -%}
{% when 'macOS' -%}
diff --git a/src/_includes/docs/install/devices/android-physical.md b/src/_includes/docs/install/devices/android-physical.md
index 904e0b918a..bade78cdf6 100644
--- a/src/_includes/docs/install/devices/android-physical.md
+++ b/src/_includes/docs/install/devices/android-physical.md
@@ -2,11 +2,6 @@
{% include docs/help-link.md location='android-device' section='#android-setup' %}
-{% assign devos = include.devos %}
-{% assign target = include.target %}
-{% assign compiler = include.compiler %}
-{% assign attempt = include.attempt %}
-
To configure your Flutter app to run on a physical Android device,
you need an Android device running {{site.targetmin.android}} or later.
@@ -18,18 +13,18 @@ you need an Android device running {{site.targetmin.android}} or later.
enable **Wireless debugging** on your device as described in the
[Android documentation]({{site.android-dev}}/studio/run/device#wireless).
-{%- if devos == 'Windows' %}
+{%- if include.devos == 'Windows' %}
1. Install the [Google USB Driver]({{site.android-dev}}/studio/run/win-usb).
{% endif %}
-1. Plug your device into your {{devos}} computer.
+1. Plug your device into your {{include.devos}} computer.
If your device prompts you, authorize your computer to access your device.
1. Verify that Flutter recognizes your connected Android device.
- {%- if devos == 'Windows' %}
+ {%- if include.devos == 'Windows' %}
In PowerShell, run:
diff --git a/src/_includes/docs/install/flutter-doctor.md b/src/_includes/docs/install/flutter-doctor.md
index 7fe34b64f6..6c11b9a3a9 100644
--- a/src/_includes/docs/install/flutter-doctor.md
+++ b/src/_includes/docs/install/flutter-doctor.md
@@ -3,11 +3,9 @@
{% include docs/help-link.md location='win-doctor' %}
-{% assign devos = include.devos %}
-{% assign target = include.target %}
{% assign compiler = include.compiler %}
-{% case devos %}
+{% case include.devos %}
{% when 'Windows' -%}
{% assign terminal='PowerShell' %}
{% assign prompt='C:\>' %}
@@ -18,13 +16,13 @@
{% assign terminal='a shell' %}
{% assign prompt='$' %}
{% endcase -%}
-{% case target %}
+{% case include.target %}
{% when 'macOS','Windows','Linux' %}
-{% assign work-target = target | append: ' desktop' %}
+{% assign work-target = include.target | append: ' desktop' %}
{% when 'desktop' %}
-{% assign work-target = devos | append: ' desktop' %}
+{% assign work-target = include.devos | append: ' desktop' %}
{% else %}
-{% assign work-target = target | append: ' on ' | append: devos %}
+{% assign work-target = include.target | append: ' on ' | append: include.devos %}
{% endcase %}
{% case work-target %}
{% when 'macOS desktop','Web on macOS','iOS on macOS' %}
@@ -40,7 +38,7 @@
### Run Flutter doctor
The `flutter doctor` command validates that all components of a
-complete Flutter development environment for {{devos}}.
+complete Flutter development environment for {{include.devos}}.
1. Open {{terminal}}.
@@ -51,11 +49,11 @@ complete Flutter development environment for {{devos}}.
{{prompt}} flutter doctor
```
-As you chose to develop for {{target}},
+As you chose to develop for {{include.target}},
you do not need _all_ components.
If you followed this guide, the result of your command should resemble:
-{% include docs/install/flutter-doctor-success.md config=include.config devos=devos -%}
+{% include docs/install/flutter-doctor-success.md config=include.config devos=include.devos -%}
### Troubleshoot Flutter doctor issues
diff --git a/src/_includes/docs/install/flutter-sdk.md b/src/_includes/docs/install/flutter-sdk.md
index d939088c9f..d879f7dcb5 100644
--- a/src/_includes/docs/install/flutter-sdk.md
+++ b/src/_includes/docs/install/flutter-sdk.md
@@ -1,13 +1,10 @@
-{% assign os=include.os %}
-{% assign target = include.target %}
-{% assign terminal=include.terminal %}
-{% case target %}
+{% case include.target %}
{% when 'mobile-ios' %}
{% assign v-target = 'iOS' %}
{% when 'mobile-android','mobile' %}
{% assign v-target = 'Android' %}
{% else %}
- {% assign v-target = target %}
+ {% assign v-target = include.target %}
{% endcase %}
## Install the Flutter SDK
@@ -30,13 +27,13 @@ or download and install the Flutter bundle yourself.
-{% include docs/install/flutter/vscode.md os=os terminal=terminal target=v-target %}
+{% include docs/install/flutter/vscode.md os=include.os terminal=include.terminal target=v-target %}
-{% include docs/install/flutter/download.md os=os terminal=terminal target=v-target%}
+{% include docs/install/flutter/download.md os=include.os terminal=include.terminal target=v-target%}
@@ -21,13 +19,13 @@ minimal hardware requirements.
| CPU Cores | 4 | 8 |
| Memory in GB | 8 | 16 |
| Display resolution in pixels | WXGA (1366 x 768) | FHD (1920 x 1080) |
-| Free disk space in GB | {% include docs/install/reqs/linux/storage.md target=target %}
+| Free disk space in GB | {% include docs/install/reqs/linux/storage.md target=include.target %}
{:.table .table-striped}
-{% if os == 'ChromeOS' and target == 'Android' %}
+{% if include.os == 'ChromeOS' and include.target == 'Android' %}
To discover which hardware devices ChromeOS recommends for Android development,
consult the [ChromeOS docs][chromeos-docs].
{% endif %}
@@ -36,13 +34,13 @@ consult the [ChromeOS docs][chromeos-docs].
### Software requirements
-To write and compile Flutter code for {{target}},
-you must have the following version of {{os}} and the listed
+To write and compile Flutter code for {{include.target}},
+you must have the following version of {{include.os}} and the listed
software packages.
#### Operating system
-{% if os == 'Linux' %}
+{% if include.os == 'Linux' %}
{%- capture supported-os %}
Debian Linux {{site.devmin.linux.debian}} or later
and Ubuntu Linux {{site.devmin.linux.ubuntu}} or later
@@ -55,7 +53,7 @@ Flutter supports {{supported-os}}.
#### Development tools {:.no_toc}
-{% include docs/install/reqs/linux/software.md target=target os=os %}
+{% include docs/install/reqs/linux/software.md target=include.target os=include.os %}
{% include docs/install/reqs/flutter-sdk/flutter-doctor-precedence.md %}
diff --git a/src/_includes/docs/install/reqs/linux/install-desktop-tools.md b/src/_includes/docs/install/reqs/linux/install-desktop-tools.md
index fae2ff09f7..40ea9cde6f 100644
--- a/src/_includes/docs/install/reqs/linux/install-desktop-tools.md
+++ b/src/_includes/docs/install/reqs/linux/install-desktop-tools.md
@@ -1,8 +1,5 @@
-{% assign devos = include.devos %}
-{% assign target = include.target %}
-
-1. To develop {{devos}} {{target}} apps, use the following command to install
- these packages:
+1. To develop {{include.devos}} {{include.target}} apps, use the
+ following command to install these packages:
[`clang`][clang],
[`cmake`][cmake],
[`ninja-build`][ninjabuild],
diff --git a/src/_includes/docs/install/reqs/linux/set-path.md b/src/_includes/docs/install/reqs/linux/set-path.md
index b9ff831bb1..124c592d2e 100644
--- a/src/_includes/docs/install/reqs/linux/set-path.md
+++ b/src/_includes/docs/install/reqs/linux/set-path.md
@@ -1,10 +1,6 @@
-{% assign terminal=include.terminal %}
-{% assign target = include.target %}
-{% assign dir = include.dir %}
-
### Add Flutter to your `PATH` {:.no_toc}
-To run Flutter commands in {{terminal}},
+To run Flutter commands in {{include.terminal}},
add Flutter to the `PATH` environment variable.
1. Check which shell starts when you open a new console window.
diff --git a/src/_includes/docs/install/reqs/linux/software.md b/src/_includes/docs/install/reqs/linux/software.md
index f8e8dc170d..429214a95e 100644
--- a/src/_includes/docs/install/reqs/linux/software.md
+++ b/src/_includes/docs/install/reqs/linux/software.md
@@ -1,9 +1,6 @@
-{% assign os = include.os %}
-{% assign target = include.target %}
+To develop Flutter on {{include.os}}:
-To develop Flutter on {{os}}:
-
-{% if os == "ChromeOS" %}
+{% if include.os == "ChromeOS" %}
1. Enable [Linux][] on your Chromebook.
@@ -29,17 +26,17 @@ To develop Flutter on {{os}}:
$ sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
```
-{% case target %}
+{% case include.target %}
{% when 'desktop' -%}
-{% include docs/install/reqs/linux/install-desktop-tools.md devos=os %}
+{% include docs/install/reqs/linux/install-desktop-tools.md devos=include.os %}
{% when 'Android' -%}
-1. To develop {{target}} apps:
+1. To develop {{include.target}} apps:
{:type="a"}
- 1. Install the following prequisite packages for Android Studio:
+ 1. Install the following prerequisite packages for Android Studio:
`libc6:i386`, `libncurses5:i386`, `libstdc++6:i386`, `lib32z1`, `libbz2-1.0:i386`
```console
diff --git a/src/_includes/docs/install/reqs/linux/unset-path.md b/src/_includes/docs/install/reqs/linux/unset-path.md
index f5fb72ef92..96ea8d54c5 100644
--- a/src/_includes/docs/install/reqs/linux/unset-path.md
+++ b/src/_includes/docs/install/reqs/linux/unset-path.md
@@ -1,8 +1,7 @@
-{% assign terminal=include.terminal %}
### Remove Flutter from your Windows Path variable {:.no_toc}
-To remove Flutter commands from {{terminal}},
+To remove Flutter commands from {{include.terminal}},
remove Flutter from the `PATH` environment variable.
{% include docs/install/reqs/windows/open-envvars.md %}
@@ -22,4 +21,5 @@ remove Flutter from the `PATH` environment variable.
1. Click **OK** three times.
1. To enable these changes,
- close and reopen any existing command prompts and {{terminal}} instances.
+ close and reopen any existing
+ command prompts and {{include.terminal}} instances.
diff --git a/src/_includes/docs/install/reqs/macos/base.md b/src/_includes/docs/install/reqs/macos/base.md
index ae70f6668c..6f6ac0c8c6 100644
--- a/src/_includes/docs/install/reqs/macos/base.md
+++ b/src/_includes/docs/install/reqs/macos/base.md
@@ -1,25 +1,23 @@
-{% assign target = include.target %}
-{% case target %}
+{% case include.target %}
{% when 'mobile-ios' %}
{% assign v-target = "iOS" %}
{% when 'mobile-android' %}
{% assign v-target = "Android" %}
{% else %}
-{% assign v-target = target %}
+{% assign v-target = include.target %}
{% endcase %}
-{% assign os = include.os %}
{% include docs/install/admonitions/install-in-order.md %}
## Verify system requirements
To install and run Flutter,
-your {{os}} environment must meet the following hardware
+your {{include.os}} environment must meet the following hardware
and software requirements.
### Hardware requirements
-Your {{os}} Flutter development environment must meet the following
+Your {{include.os}} Flutter development environment must meet the following
minimal hardware requirements.
@@ -29,7 +27,7 @@ minimal hardware requirements.
| CPU Cores | 4 | 8 |
| Memory in GB | 8 | 16 |
| Display resolution in pixels | WXGA (1366 x 768) | FHD (1920 x 1080) |
-| Free disk space in GB | {% include docs/install/reqs/macos/storage.md target=target %}
+| Free disk space in GB | {% include docs/install/reqs/macos/storage.md target=include.target %}
{:.table .table-striped}
@@ -45,7 +43,7 @@ install the following packages.
Flutter supports macOS {{site.devmin.macos}} or later.
This guide presumes your Mac runs the `zsh` as your default shell.
-{% include docs/install/reqs/macos/zsh-config.md target=target %}
+{% include docs/install/reqs/macos/zsh-config.md target=include.target %}
{% include docs/install/reqs/macos/apple-silicon.md %}
@@ -53,7 +51,7 @@ This guide presumes your Mac runs the `zsh` as your default shell.
Download and install the following packages.
-{% include docs/install/reqs/macos/software.md target=target %}
+{% include docs/install/reqs/macos/software.md target=include.target %}
The developers of the preceding software provide support for those products.
To troubleshoot installation issues, consult that product's documentation.
diff --git a/src/_includes/docs/install/reqs/macos/set-path.md b/src/_includes/docs/install/reqs/macos/set-path.md
index e0ae42f63e..3267379a9c 100644
--- a/src/_includes/docs/install/reqs/macos/set-path.md
+++ b/src/_includes/docs/install/reqs/macos/set-path.md
@@ -1,10 +1,7 @@
-{% assign terminal=include.terminal %}
-{% assign target = include.target %}
-{% assign dir = include.dir %}
### Add Flutter to your `PATH` {:.no_toc}
-To run Flutter commands in {{terminal}},
+To run Flutter commands in {{include.terminal}},
add Flutter to the `PATH` environment variable.
This guide presumes your [Mac runs the latest default shell][zsh-mac], `zsh`.
Zsh uses the `.zshenv` file for [environment variables][envvar].
diff --git a/src/_includes/docs/install/reqs/macos/software.md b/src/_includes/docs/install/reqs/macos/software.md
index af6d3f92e0..d33ed3d11f 100644
--- a/src/_includes/docs/install/reqs/macos/software.md
+++ b/src/_includes/docs/install/reqs/macos/software.md
@@ -1,4 +1,3 @@
-{% assign target = include.target %}
{% assign xcode = '[Xcode][] ' | append: site.appnow.xcode | append: ' to debug and compile native Swift or ObjectiveC code.' %}
{% assign cocoapods = '[CocoaPods][] ' | append: site.appnow.cocoapods | append: ' to compile enable Flutter plugins in your native apps.' %}
@@ -16,7 +15,7 @@ type `git version` in your Terminal.
If you need to install `git`, type `brew install git`.
{% endcapture %}
-{% case target %}
+{% case include.target %}
{% when 'desktop','iOS' %}
* {{xcode}} {{git-xcode}} {{git-main}}
diff --git a/src/_includes/docs/install/reqs/macos/unset-path.md b/src/_includes/docs/install/reqs/macos/unset-path.md
index cf859b842b..992fe95c55 100644
--- a/src/_includes/docs/install/reqs/macos/unset-path.md
+++ b/src/_includes/docs/install/reqs/macos/unset-path.md
@@ -1,8 +1,6 @@
-{% assign terminal=include.terminal %}
-
### Remove Flutter from your macOS PATH {:.no_toc}
-To remove Flutter commands from {{terminal}},
+To remove Flutter commands from {{include.terminal}},
remove Flutter to the `PATH` environment variable.
This guide presumes your [Mac runs the latest default shell][zsh-mac], `zsh`.
Zsh uses the `.zshenv` file for [environment variables][envvar].
diff --git a/src/_includes/docs/install/reqs/macos/zsh-config.md b/src/_includes/docs/install/reqs/macos/zsh-config.md
index f9487c0ab3..48ab454951 100644
--- a/src/_includes/docs/install/reqs/macos/zsh-config.md
+++ b/src/_includes/docs/install/reqs/macos/zsh-config.md
@@ -1,4 +1,3 @@
-{% assign target = include.target %}
To verify your shell configuration, expand this section
@@ -17,7 +16,7 @@ Zsh or `zsh` is the default shell for macOS.
$ dscl . -read ~/ UserShell
```
- {{terminal}} should print the following as its response.
+ The command should print the following as its response.
```console
UserShell: /bin/zsh
diff --git a/src/_includes/docs/install/reqs/windows/base.md b/src/_includes/docs/install/reqs/windows/base.md
index ca9296b4f1..a7db453279 100644
--- a/src/_includes/docs/install/reqs/windows/base.md
+++ b/src/_includes/docs/install/reqs/windows/base.md
@@ -1,17 +1,15 @@
-{% assign target = include.target %}
-{% assign os = include.os %}
{% include docs/install/admonitions/install-in-order.md %}
## Verify system requirements
To install and run Flutter,
-your {{os}} environment must meet the following hardware
+your {{include.os}} environment must meet the following hardware
and software requirements.
### Hardware requirements
-Your {{os}} Flutter development environment must meet the following
+Your {{include.os}} Flutter development environment must meet the following
minimal hardware requirements.
@@ -21,7 +19,7 @@ minimal hardware requirements.
| x86_64 CPU Cores | 4 | 8 |
| Memory in GB | 8 | 16 |
| Display resolution in pixels | WXGA (1366 x 768) | FHD (1920 x 1080) |
-| Free disk space in GB | {% include docs/install/reqs/windows/storage.md target=target %}
+| Free disk space in GB | {% include docs/install/reqs/windows/storage.md target=include.target %}
{:.table .table-striped}
@@ -29,7 +27,7 @@ minimal hardware requirements.
### Software requirements
-To write and compile Flutter code for {{target}},
+To write and compile Flutter code for {{include.target}},
you must have the following version of Windows and the listed
software packages.
@@ -44,7 +42,7 @@ These versions of Windows should include the required
Download and install the Windows version of the following packages:
* [Git for Windows][] {{site.appmin.git_win}} or later to manage source code.
-{% include docs/install/reqs/windows/software.md target=target %}
+{% include docs/install/reqs/windows/software.md target=include.target %}
The developers of the preceding software provide support for those products.
To troubleshoot installation issues, consult that product's documentation.
diff --git a/src/_includes/docs/install/reqs/windows/set-path.md b/src/_includes/docs/install/reqs/windows/set-path.md
index 37f3688d03..1063aceaf9 100644
--- a/src/_includes/docs/install/reqs/windows/set-path.md
+++ b/src/_includes/docs/install/reqs/windows/set-path.md
@@ -1,10 +1,9 @@
-{% assign terminal=include.terminal %}
### Update your Windows PATH variable {:.no_toc}
{% include docs/help-link.md location='win-path' section='#unable-to-find-the-flutter-command' %}
-To run Flutter commands in {{terminal}},
+To run Flutter commands in {{include.terminal}},
add Flutter to the `PATH` environment variable.
This section presumes that you installed the Flutter SDK in
`%USERPROFILE%\dev\flutter`.
@@ -44,4 +43,5 @@ This section presumes that you installed the Flutter SDK in
1. Click **OK** three times.
1. To enable these changes,
- close and reopen any existing command prompts and {{terminal}} instances.
+ close and reopen any existing
+ command prompts and {{include.terminal}} instances.
diff --git a/src/_includes/docs/install/reqs/windows/software.md b/src/_includes/docs/install/reqs/windows/software.md
index 4ba7ab7c3c..28a5b3bf10 100644
--- a/src/_includes/docs/install/reqs/windows/software.md
+++ b/src/_includes/docs/install/reqs/windows/software.md
@@ -1,29 +1,29 @@
{% if include.target == 'Android' %}
-{% assign target = 'mobile' %}
+{% assign mod-target = 'mobile' %}
{% else %}
-{% assign target = include.target %}
+{% assign mod-target = include.target %}
{% endif %}
-{% if target == 'desktop' -%}
+{% if mod-target == 'desktop' -%}
* [Visual Studio 2022][] to debug and compile native C++ Windows code.
Make sure to install the **Desktop development with C++** workload.
This enables building Windows app including all of its default components.
**Visual Studio** is an IDE separate from **[Visual Studio _Code_][]**.
-{% elsif target == 'mobile' -%}
+{% elsif mod-target == 'mobile' -%}
* [Android Studio][] {{site.appmin.android_studio}} or later
to debug and compile Java or Kotlin code for Android.
Flutter requires the full version of Android Studio.
-{% elsif target == 'web' -%}
+{% elsif mod-target == 'web' -%}
* [Google Chrome][] to debug JavaScript code for web apps.
{% else -%}
-* [Visual Studio 2022][] with the the **Desktop development with C++** workload
+* [Visual Studio 2022][] with the **Desktop development with C++** workload
or [Build Tools for Visual Studio 2022][].
This enables building Windows app including all of its default components.
**Visual Studio** is an IDE separate from **[Visual Studio _Code_][]**.
diff --git a/src/_includes/docs/install/reqs/windows/unset-path.md b/src/_includes/docs/install/reqs/windows/unset-path.md
index a6d4c6221b..d6f47784dc 100644
--- a/src/_includes/docs/install/reqs/windows/unset-path.md
+++ b/src/_includes/docs/install/reqs/windows/unset-path.md
@@ -1,8 +1,7 @@
-{% assign terminal=include.terminal %}
### Remove Flutter from your Windows Path variable {:.no_toc}
-To remove Flutter commands from {{terminal}},
+To remove Flutter commands from {{include.terminal}},
remove Flutter to the `PATH` environment variable.
{% include docs/install/reqs/windows/open-envvars.md %}
@@ -22,4 +21,5 @@ remove Flutter to the `PATH` environment variable.
1. Click **OK** three times.
1. To enable these changes,
- close and reopen any existing command prompts and {{terminal}} instances.
+ close and reopen any existing
+ command prompts and {{include.terminal}} instances.
From bbbd8d2befb53b5a521d1f9c1c99fe22e822f5f1 Mon Sep 17 00:00:00 2001
From: Anthony Sansone
Date: Wed, 1 May 2024 14:59:56 -0500
Subject: [PATCH 020/109] Fix formatting error (#10481)
Corrects small formatting error
---
src/_includes/docs/install/devices/ios-physical.md | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/src/_includes/docs/install/devices/ios-physical.md b/src/_includes/docs/install/devices/ios-physical.md
index 1e0ab1ffd5..23fef3652c 100644
--- a/src/_includes/docs/install/devices/ios-physical.md
+++ b/src/_includes/docs/install/devices/ios-physical.md
@@ -80,7 +80,6 @@ Follow the Xcode signing flow to provision your project.
1. Sign in to Xcode with your Apple ID.
- {: type="a"}
1. Go to **Xcode** >
**Settings...**
1. Click **Accounts**.
@@ -124,7 +123,6 @@ Follow the Xcode signing flow to provision your project.
After you select a team, Xcode performs the following tasks:
- {: type="a"}
1. Creates and downloads a Development Certificate
1. Registers your device with your account,
1. Creates and downloads a provisioning profile if needed
@@ -203,7 +201,8 @@ Enabling certificates varies in different versions of iOS.
1. When the dialog displays, tap **Trust**.