本頁面由 Cloud Translation API 翻譯而成。

自訂應用程式

現在 Car UI 程式庫元件和資源會加入應用程式，以便自訂因此，原始設備製造商 (OEM) 必須提供兩種疊加元素：

建構時間疊加層：加入會在執行階段資源重疊 (RRO) 內顯示。這類功能包括：
- 可繪項目
- 樣式 (例如文字外觀)
- 共用資源 (例如顏色)
「RRO 疊加層」資料夾包含用來為每個 GCP 產生一個 RRO 的資源目標應用程式這些資源只能參照：
- 同一 RRO 內定義的值 (舉例來說，如果顏色的值就是十六進位值) 值)。
- Android 架構資源 (例如 @android:color/accent)。
- 上述建構時間疊加層中定義的資源。

一般結構

建議的自訂疊加層結構如下：

<path-to-OEM-overlays>/
- overlay/framework/base/core/res/。建構時間疊加層資源
- rro/
  - Android.mk。用於為每個目標套件產生 RRO 的 Makefile 依據這個資料夾包含的資源而定
  - AndroidManifest.xml。上述範例使用的資訊清單檔案範本 makefile，
  - res/。要套用至所有目標應用程式的執行階段重疊。

視所需品牌數量而定，原始設備製造商可能有多個結構物處理單一建構目標 (詳情請參閱處理多個品牌)。

執行階段資源重疊

原始設備製造商 (OEM) 疊加層資料夾中的 RRO 資料夾應包含要套用至所有目標應用程式的資源。 RRO 存在限制，因而影響了疊加複合資源的能力。總結來說，RRO：

「不得」參照目標 APK 或 RRO 本身。也就是說，RRO 無法新增 ID，例如新的可繪項目、顏色或。
「可以」參照無論這些資源是由 /frameworks/base/core/res 還是方法定義建構時間疊加層這類 ID 必須使用 android: 來參照命名空間：
- 如果是公開的裝置預設 RRO，請使用 android。
  例如 @android:style/TextAppearance.DeviceDefault.Large。
- 針對「所有」 (非公開，或透過建構時間疊加層)，請使用 *android。
  例如 @*android/style:TextAppearance.OEM.Brand1.Title。

除了資源之外，RRO 資料夾還須包含：

AndroidManifest.xml。在下方範例中，RRO_PACKAGE_NAME 和 TARGET_PACKAGE_NAME 是 makefiles 的預留位置：

<?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 的程式碼範例。
定義要覆寫的資源。
為 <overlay> 新增 android:resourcesMap="@xml/overlays" 標記在 AndroidManifest.xml 中。例如，在下列程式碼範例中，請參閱 <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 限制，請按照下列指示操作：

使用「建構時間」疊加擴充架構/基礎，並新增任何必要項目再複習一下，機構節點是所有 Google Cloud Platform 資源的根節點
請使用 *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 都會以靜態方式啟用，且一次只能使用一個。

將 Car 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 \
      ...

敬上

注意： oem- 前置字串必須與 CAR_UI_RRO_SET_NAME 相符 RRO Android.mk 中定義的變數。上述程式碼：

，瞭解如何調查及移除這項存取權。

因為 <path-to-OEM-overlays>/rro/Android.mk 會為每個類型產生一個 RRO 名稱為 CAR_UI_RRO_PACKAGE_NAMES 的套件。
包含在 PRODUCT_PACKAGES 中產生的 RRO。
在 PRODUCT_PACKAGE_OVERLAYS 中加入建構時間疊加層，新增原始設備製造商 (OEM) 專屬再複習一下，機構節點是所有 Google Cloud Platform 資源的根節點

如要瞭解哪些套件支援 car-ui-lib，請參閱包含 car-ui-lib 的套件清單。