Skip to content

Commit 1fa6f56

Browse files
authored
[wiki migration] Android team pages (#148585)
This puts the wiki pages owned by the Android team into the docs/platforms/android directory as planned in [flutter.dev/go/migrate-flutter-wiki-spreadsheet](https://docs.google.com/spreadsheets/d/1x65189ZBdNiLRygpUYoU08pwvXD4M-Z157c6pm8deGI/edit?usp=sharing) It also adds the android team labels to the label bot for future PRs. Changes to the content were only updating cross links, or link to refer to the main branch rather than master. Remaining links to the wiki will be updated once all other pages have finished moving, they still work in the meantime. Part of flutter/flutter#145009
1 parent 654a5b3 commit 1fa6f56

10 files changed

+23
-8
lines changed

.github/labeler.yml

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,11 @@
4848
- any-glob-to-any-file:
4949
- examples/api/**/*
5050

51+
'd: docs/':
52+
- changed-files:
53+
- any-glob-to-any-file:
54+
- docs/**/*
55+
5156
'd: examples':
5257
- changed-files:
5358
- any-glob-to-any-file:
@@ -126,6 +131,11 @@ package:
126131
- any-glob-to-any-file:
127132
- docs/ecosystem/**/*
128133

134+
platform-android:
135+
- changed-files:
136+
- any-glob-to-any-file:
137+
- docs/platform/android/**/*
138+
129139
platform-ios:
130140
- changed-files:
131141
- any-glob-to-any-file:
@@ -148,6 +158,11 @@ platform-web:
148158
- '**/*.expect'
149159
- '**/*test_fixes*'
150160

161+
team-android:
162+
- changed-files:
163+
- any-glob-to-any-file:
164+
- docs/platform/android/**/*
165+
151166
team-ecosystem:
152167
- changed-files:
153168
- any-glob-to-any-file:
File renamed without changes.

docs/unsorted_wiki/Android-Platform-Views.md renamed to docs/platforms/android/Android-Platform-Views.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,17 +29,17 @@ within their Flutter UI.
2929
# Approaches
3030

3131
There are currently three different implementations of Android platform views:
32-
- [[Virtual Display]] (VD)
33-
- [[Hybrid Composition]] (HC)
34-
- [[Texture Layer Hybrid Composition]] (TLHC)
32+
- [Virtual Display](Virtual_Display.md) (VD)
33+
- [Hybrid Composition](https://github.com/flutter/flutter/wiki/Hybrid-Composition) (HC)
34+
- [Texture Layer Hybrid Composition](Texture-Layer-Hybrid-Composition.md) (TLHC)
3535

3636
Each has a different set of limitations and tradeoffs, as discussed below. The pages linked above give details about each implementation.
3737

3838
## Virtual Display
3939

4040
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).
4141

42-
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).
42+
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).
4343

4444
This display mode requires SDK 20 or later.
4545

docs/unsorted_wiki/How-Flutter-apps-are-compiled-with-Gradle-for-Android.md renamed to docs/platforms/android/How-Flutter-apps-are-compiled-with-Gradle-for-Android.md

File renamed without changes.

docs/unsorted_wiki/Resolving-common-build-failures.md renamed to docs/platforms/android/Resolving-common-build-failures.md

File renamed without changes.

docs/unsorted_wiki/Testing-Android-Changes-in-the-Devicelab-on-an-Emulator.md renamed to docs/platforms/android/Testing-Android-Changes-in-the-Devicelab-on-an-Emulator.md

File renamed without changes.

docs/unsorted_wiki/Texture-Layer-Hybrid-Composition.md renamed to docs/platforms/android/Texture-Layer-Hybrid-Composition.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
_See also: [[Hybrid Composition|Hybrid Composition#Android]]_
1+
_See also: [Hybrid Composition|Hybrid Composition#Android](https://github.com/flutter/flutter/wiki/Hybrid-Composition)_
22

33
# Background
44

5-
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.
5+
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.
66

77
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.
88

docs/unsorted_wiki/Upgrading-Engine's-Android-API-version.md renamed to docs/platforms/android/Upgrading-Engine's-Android-API-version.md

File renamed without changes.

docs/unsorted_wiki/Upgrading-pre-1.12-Android-projects.md renamed to docs/platforms/android/Upgrading-pre-1.12-Android-projects.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ _If you `flutter create`d your project prior to version 1.12, this may apply to
22

33
# Background
44

5-
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.
5+
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.
66

77
Those classes better support real world scenarios where the FlutterActivity isn't the first and only Android Activity in an application.
88

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Background
22

3-
Virtual Display is one of several modes for displaying platform views on Android. See [[Android Platform Views]] for an overview of modes.
3+
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.
44

55
# The approach
66

0 commit comments

Comments
 (0)