现在,汽车 UI 库组件和资源已集成到应用程序中,为了自定义这些应用程序,OEM 必须提供两个覆盖层:
构建时覆盖添加运行时资源覆盖 (RRO) 所需的任何资源。这包括:
- 绘图
- 样式(例如,文本外观)
- 共享资源(例如颜色)
RRO 覆盖文件夹包含用于为每个目标应用程序生成一个 RRO 的资源。这些资源只能参考:
- 在同一 RRO 中定义的值(例如,对于颜色,这将是十六进制值)。
- Android 框架资源(例如
@android:color/accent
)。 - 在上面的构建时覆盖中定义的资源。
总体结构
建议的定制覆盖结构如下:
<path-to-OEM-overlays>/
overlay/framework/base/core/res/
。构建时覆盖资源rro/
Android.mk
。 Makefile 用于根据此文件夹中包含的资源为每个目标包生成 RRO。AndroidManifest.xml
。上述 makefile 使用的清单文件模板。res/
。运行时覆盖适用于所有目标应用程序。
OEM 可能拥有多个这些结构,具体取决于他们想要在单个构建目标中处理的品牌数量(请参阅处理多个品牌)。
运行时资源覆盖
OEM 覆盖文件夹中的 RRO 文件夹应包含要应用于所有目标应用程序的资源。 RRO 存在一些限制,影响其覆盖复合资源的能力。总之,RRO:
无法引用目标 APK 或 RRO 本身中定义的资源标识符。这意味着 RRO 无法添加新的标识符,例如新的绘图、颜色或样式。
能 引用框架中定义的资源标识符,无论这些资源是在
/frameworks/base/core/res
中定义还是通过构建时覆盖定义。这些标识符必须使用android:
命名空间引用:对于公共DeviceDefault RRO,请使用
android
。
例如,@android:style/TextAppearance.DeviceDefault.Large
。对于所有其他资源(非公共资源或通过构建时覆盖添加的资源),请使用
*android
。
例如,@*android/style:TextAppearance.OEM.Brand1.Title
。
除了资源之外,RRO 文件夹还必须包含:
AndroidManifest.xml
。在下面的示例中,RRO_PACKAGE_NAME
和TARGET_PACKAGE_NAME
是 makefile 的占位符:<?xml version=“1.0” encoding=“utf-8”?> <manifest xmlns:android=“http://schemas.android.com/apk/res/android” package=“{{RRO_PACKAGE_NAME}}” /> <application android:hasCode=“false” /> <overlay android:priority=“10” android:targetPackage=“{{TARGET_PACKAGE_NAME}}” android:requiredSystemPropertyName=“ro.product.sku” android:requiredSystemPropertyValue=“<your-product-sku>” /> </manifest>
-
Android.mk
,其中以下 makefile 中的oem
定义所有生成的 RRO 将具有的前缀。LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) CAR_UI_RRO_SET_NAME := oem CAR_UI_RESOURCE_DIR := $(LOCAL_PATH)/res CAR_UI_RRO_TARGETS := $(CAR_UI_RRO_PACKAGE_NAMES) include packages/apps/Car/libs/car-ui-lib/generate_rros.mk
配置 RRO
支持新的配置文件, overlayable.xml
,您可以使用它来定义访问控制。例如,您可以指定谁可以覆盖资源以及可以覆盖哪些资源。因此,现在可以以不同的方式对资源进行分组,以便可以由不同的 RRO 覆盖。
设置 RRO 访问控制:
- 在
res/values
文件夹中,创建overlayable.xml
。 - 创建
<overlayable>
资源标签。 - 定义
<overlayable>
标签的name
属性,该属性在包中必须是唯一的。每个覆盖只能定位一个可覆盖组。 - 在
<overlayable>
内定义<policy>
标记。 - 定义可以叠加的资源组。例如:
<resources> <overlayable name="OverlayableResources"> <policy type="public"> <item type="string" name="app_title" /> </policy> </overlayable> </resources>
要将以下更改应用到您的 RRO 项目:
- 在
res/xml
文件夹中,创建overlays.xml
。请参阅下面代码示例中的overlay
条目。 - 定义要覆盖的资源。
- 将
android:resourcesMap="@xml/overlays"
添加到AndroidManifest.xml
中的<overlay>
标记。例如,在下面的代码示例中,请参阅<overlay>
条目。 - 设置
android:isStatic=”true”
为静态覆盖。每个覆盖只能定位可覆盖的组之一。
考虑以下示例。第一部分属于AndroidManifest.xml
,而第二部分属于overlays.xml
。
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.android.car.ui.rro" android:versionCode="1" android:versionName="1.0"> <overlay android:targetName="OverlayableResources" android:resourcesMap="@xml/overlays" android:targetPackage="com.android.car.ui" android:priority="1" android:isStatic="false" /> </manifest> <overlay> <item target="string/app_title" value="@ string/app_title" /> </overlay>
但有一点需要注意的是,以前存在的 RRO 可在 Android 10 中使用。需要注意的是,要与 PackageManagerRRO 一起安装,软件包必须预先安装或使用与目标应用程序相同的密钥进行签名。在Android 10中,布局文件可以叠加。但是,这样做需要在获取视图时使用requireViewById()
而不是findViewById()
。在 Android 10 中,此更改已在 car-ui-lib 中实现,以支持布局叠加。
Android 的下一个主要版本将使您能够覆盖布局文件并在 RRO 包中定义新资源并在内部引用它们。
添加 OEM 特定资源
要克服阻止添加 OEM 资源的 RRO 限制:
- 使用构建时覆盖扩展框架/基础,添加任何必要的资源。
- 使用
*android:
命名空间从 OEM RRO 引用这些资源。
例如,以下是添加 OEM 特定可绘制对象并在 RRO 中使用它的方法:
<path-to-OEM-overlays>
overlay/framework/base/core/res/res/drawable/
oem_background_drawable.xml
rro/res/values
drawables.xml
<resources> <item type="drawable" name="car_ui_toolbar_background"> @*android:drawable/oem_background_drawable </item> </resources>
经营多个品牌
RRO 清单文件具有允许根据系统属性有条件地应用它们的语法。要在单个系统映像中处理多个品牌,OEM 可以按如下方式使用它(请参阅一般结构)。
<?xml version=“1.0” encoding=“utf-8”?> <manifest xmlns:android=“http://schemas.android.com/apk/res/android” package=“{{RRO_PACKAGE_NAME}}”/> <application android:hasCode=“false”/> <overlay android:priority=“10” android:targetPackage=“{{TARGET_PACKAGE_NAME}}” android:requiredSystemPropertyName=“ro.product.sku” android:requiredSystemPropertyValue=“<your-product-sku>”/> </manifest>
android:requiredSystemPropertyName
和android:requiredSystemPropertyValue
语法将导致仅当相应的系统属性与提供的值匹配时启用此 RRO。然后,OEM 可以定义多个 RRO,所有这些 RRO 均静态启用,并且一次只有一个处于活动状态。
将汽车 UI 库添加到目标
要将 Car UI 库合并到 Android 目标中,您必须包含以下代码片段:
# Include build-time overlays PRODUCT_PACKAGE_OVERLAYS += \ <path-to-oem-overlays>/overlay # Define package names to generate RROs for CAR_UI_RRO_PACKAGE_NAMES += \ com.android.car.ui.paintbooth \ com.android.car.media \ com.android.car.dialer \ com.android.car.linkviewer \ com.android.car.settings \ com.android.car.systemupdater \ com.google.android.apps.automotive.inputmethod \ com.google.android.apps.automotive.templates.host \ ... # Include generated RROs PRODUCT_PACKAGES += \ oem-com-android-car-ui-paintbooth \ oem-com-android-car-media \ oem-com-android-car-dialer \ oem-com-android-car-linkviewer \ oem-com-android-car-settings \ oem-com-android-car-systemupdater \ oem-com-google-android-apps-automotive-inputmethod \ oem-com-google-android-apps-automotive-templates-host \ ...
导致
<path-to-OEM-overlays>/rro/Android.mk
为CAR_UI_RRO_PACKAGE_NAMES
中指定的每个包生成一个 RRO。将生成的 RRO 包含在
PRODUCT_PACKAGES
中。在
PRODUCT_PACKAGE_OVERLAYS
中包含构建时覆盖,以添加特定于 OEM 的资源。
要了解哪些软件包支持car-ui-lib
,请参阅包含 car-ui-lib 的软件包列表。