aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDennis Song <denniscy@google.com>2022-10-31 02:23:53 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>2022-10-31 02:23:53 +0000
commit31f94b53210194e6a4f5d694a7ed38b76b75092d (patch)
tree28f4d03d8646a7e82a076371a7d1cbb732632169
parent038675f3c94a5c8b565ffb201b28cff2ccd9a9d0 (diff)
parent0170eba51045fbb00eea6cbde146462dbc415f9a (diff)
downloadcommon-31f94b53210194e6a4f5d694a7ed38b76b75092d.tar.gz
Merge "Add document for GSI specific packages" am: 0170eba510
Original change: https://android-review.googlesource.com/c/device/generic/common/+/2266746 Change-Id: Id1c17d93c2d88f3ab421697cb87131e187892205 Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
-rw-r--r--README.md24
1 files changed, 24 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0938785
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# GSI
+
+This document introduces special GSI settings for facilitating xTS-on-GSI with
+a single image.
+
+## Changes in runtime resource overlays (RRO)
+
+### SystemUI overlays
+
+Some devices access the private android framework resource by `@*android:`
+while overlaying their SystemUI setting `status_bar_header_height_keyguard`.
+However, referencing private framework resource IDs from RRO packages in the
+vendor partition crashes on these devices when GSI is used. This is because
+private framework resource don't have a stable ID, and these vendor RRO
+packages would be referencing to dangling resource references after GSI is
+used (b/245806899).
+
+In order to prevent SystemUI crash, GSI adds a runtime resource overlay in
+the system_ext partition, which have higher overlay precedence than RROs on
+vendor partition, so the problematic vendor RROs would be overridden.
+
+Lifetime of this package:
+* Starts at: Android 14.
+* Deprecation plan: TBD, depends on b/254581880.