diff --git a/.github/labeler.yml b/.github/labeler.yml index 34ccdc38b0..f9c40cc252 100644 --- a/.github/labeler.yml +++ b/.github/labeler.yml @@ -48,6 +48,11 @@ - any-glob-to-any-file: - examples/api/**/* +'d: docs/': + - changed-files: + - any-glob-to-any-file: + - docs/**/* + 'd: examples': - changed-files: - any-glob-to-any-file: @@ -126,6 +131,11 @@ package: - any-glob-to-any-file: - docs/ecosystem/**/* +platform-android: + - changed-files: + - any-glob-to-any-file: + - docs/platform/android/**/* + platform-ios: - changed-files: - any-glob-to-any-file: @@ -148,6 +158,11 @@ platform-web: - '**/*.expect' - '**/*test_fixes*' +team-android: + - changed-files: + - any-glob-to-any-file: + - docs/platform/android/**/* + team-ecosystem: - changed-files: - any-glob-to-any-file: diff --git a/docs/unsorted_wiki/Android-Multidex-support.md b/docs/platforms/android/Android-Multidex-support.md similarity index 100% rename from docs/unsorted_wiki/Android-Multidex-support.md rename to docs/platforms/android/Android-Multidex-support.md diff --git a/docs/unsorted_wiki/Android-Platform-Views.md b/docs/platforms/android/Android-Platform-Views.md similarity index 95% rename from docs/unsorted_wiki/Android-Platform-Views.md rename to docs/platforms/android/Android-Platform-Views.md index 8cc7ff86f8..2de5f70bc3 100644 --- a/docs/unsorted_wiki/Android-Platform-Views.md +++ b/docs/platforms/android/Android-Platform-Views.md @@ -29,9 +29,9 @@ within their Flutter UI. # Approaches There are currently three different implementations of Android platform views: -- [[Virtual Display]] (VD) -- [[Hybrid Composition]] (HC) -- [[Texture Layer Hybrid Composition]] (TLHC) +- [Virtual Display](Virtual_Display.md) (VD) +- [Hybrid Composition](https://github.com/flutter/flutter/wiki/Hybrid-Composition) (HC) +- [Texture Layer Hybrid Composition](Texture-Layer-Hybrid-Composition.md) (TLHC) Each has a different set of limitations and tradeoffs, as discussed below. The pages linked above give details about each implementation. @@ -39,7 +39,7 @@ Each has a different set of limitations and tradeoffs, as discussed below. The p This mode works by rendering the platform view into [a `VirtualDisplay`](https://developer.android.com/reference/android/hardware/display/VirtualDisplay), whose contents are connected to [a Flutter `Texture`](https://api.flutter.dev/flutter/widgets/Texture-class.html). -Because this renders to a `Texture`, it integrates well into the Flutter drawing system. However, the use of `VirtualDisplay` introduces a number of compatibility issues, including with text input, accessibility, and secondary views (see [[the Virtual Display page|Virtual Display]] for details). +Because this renders to a `Texture`, it integrates well into the Flutter drawing system. However, the use of `VirtualDisplay` introduces a number of compatibility issues, including with text input, accessibility, and secondary views (see [the Virtual Display page](Virtual-Display.md) for details). This display mode requires SDK 20 or later. diff --git a/docs/unsorted_wiki/How-Flutter-apps-are-compiled-with-Gradle-for-Android.md b/docs/platforms/android/How-Flutter-apps-are-compiled-with-Gradle-for-Android.md similarity index 100% rename from docs/unsorted_wiki/How-Flutter-apps-are-compiled-with-Gradle-for-Android.md rename to docs/platforms/android/How-Flutter-apps-are-compiled-with-Gradle-for-Android.md diff --git a/docs/unsorted_wiki/Resolving-common-build-failures.md b/docs/platforms/android/Resolving-common-build-failures.md similarity index 100% rename from docs/unsorted_wiki/Resolving-common-build-failures.md rename to docs/platforms/android/Resolving-common-build-failures.md diff --git a/docs/unsorted_wiki/Testing-Android-Changes-in-the-Devicelab-on-an-Emulator.md b/docs/platforms/android/Testing-Android-Changes-in-the-Devicelab-on-an-Emulator.md similarity index 100% rename from docs/unsorted_wiki/Testing-Android-Changes-in-the-Devicelab-on-an-Emulator.md rename to docs/platforms/android/Testing-Android-Changes-in-the-Devicelab-on-an-Emulator.md diff --git a/docs/unsorted_wiki/Texture-Layer-Hybrid-Composition.md b/docs/platforms/android/Texture-Layer-Hybrid-Composition.md similarity index 92% rename from docs/unsorted_wiki/Texture-Layer-Hybrid-Composition.md rename to docs/platforms/android/Texture-Layer-Hybrid-Composition.md index b8118629de..7e11669769 100644 --- a/docs/unsorted_wiki/Texture-Layer-Hybrid-Composition.md +++ b/docs/platforms/android/Texture-Layer-Hybrid-Composition.md @@ -1,8 +1,8 @@ -_See also: [[Hybrid Composition|Hybrid Composition#Android]]_ +_See also: [Hybrid Composition|Hybrid Composition#Android](https://github.com/flutter/flutter/wiki/Hybrid-Composition)_ # Background -Texture Layer Hybrid Composition (TLHC) is one of several modes for displaying platform views on Android. See [Android Platform Views](https://github.com/flutter/flutter/wiki/Android-Platform-Views) for an overview of modes. +Texture Layer Hybrid Composition (TLHC) is one of several modes for displaying platform views on Android. See [Android Platform Views](Android-Platform-Views.md) for an overview of modes. It was introduced in Flutter 3.0 to combine the best aspects of Virtual Display and Hybrid Composition while addressing their most significant issues. While it was originally intended to replace both, it turned out to have some limitations that prevented serving as a complete replacement, so is now a third option. diff --git a/docs/unsorted_wiki/Upgrading-Engine's-Android-API-version.md b/docs/platforms/android/Upgrading-Engine's-Android-API-version.md similarity index 100% rename from docs/unsorted_wiki/Upgrading-Engine's-Android-API-version.md rename to docs/platforms/android/Upgrading-Engine's-Android-API-version.md diff --git a/docs/unsorted_wiki/Upgrading-pre-1.12-Android-projects.md b/docs/platforms/android/Upgrading-pre-1.12-Android-projects.md similarity index 96% rename from docs/unsorted_wiki/Upgrading-pre-1.12-Android-projects.md rename to docs/platforms/android/Upgrading-pre-1.12-Android-projects.md index 831ed875b0..9c37e2fb32 100644 --- a/docs/unsorted_wiki/Upgrading-pre-1.12-Android-projects.md +++ b/docs/platforms/android/Upgrading-pre-1.12-Android-projects.md @@ -2,7 +2,7 @@ _If you `flutter create`d your project prior to version 1.12, this may apply to # Background -In order to better support the execution environments of adding Flutter to an existing project, the old Android platform-side wrappers hosting the Flutter runtime at [`io.flutter.app.FlutterActivity`](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/app/FlutterActivity.java) and their associated classes are now deprecated. New wrappers at [`io.flutter.embedding.android.FlutterActivity`](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/embedding/android/FlutterActivity.java) and associated classes now replace them. +In order to better support the execution environments of adding Flutter to an existing project, the old Android platform-side wrappers hosting the Flutter runtime at [`io.flutter.app.FlutterActivity`](https://github.com/flutter/engine/blob/main/shell/platform/android/io/flutter/app/FlutterActivity.java) and their associated classes are now deprecated. New wrappers at [`io.flutter.embedding.android.FlutterActivity`](https://github.com/flutter/engine/blob/main/shell/platform/android/io/flutter/embedding/android/FlutterActivity.java) and associated classes now replace them. Those classes better support real world scenarios where the FlutterActivity isn't the first and only Android Activity in an application. diff --git a/docs/unsorted_wiki/Virtual-Display.md b/docs/platforms/android/Virtual-Display.md similarity index 99% rename from docs/unsorted_wiki/Virtual-Display.md rename to docs/platforms/android/Virtual-Display.md index 5c0f09b792..049cfc52d7 100644 --- a/docs/unsorted_wiki/Virtual-Display.md +++ b/docs/platforms/android/Virtual-Display.md @@ -1,6 +1,6 @@ # Background -Virtual Display is one of several modes for displaying platform views on Android. See [[Android Platform Views]] for an overview of modes. +Virtual Display is one of several modes for displaying platform views on Android. See [Android Platform Views](Android-Platform-Views.md) for an overview of modes. # The approach