實作自訂使用者類型

Android 11 引入了明確定義的使用者類型概念，代表 Android 多使用者功能允許的所有不同類型使用者。有了這項功能，原始設備製造商 (OEM) 就能自訂預先定義的 AOSP 使用者類型，並定義新的設定檔類型。詳情請參閱「使用者類型」一節。

本頁面詳細說明自訂使用者類型所需的導入指南。

自訂

為了自訂 AOSP 使用者類型並定義新的設定檔類型，原始設備製造商必須將 config_user_types.xml 與偏好的自訂項目重疊。config_user_types.xml 檔案包含參考實作項目，以及可設定屬性的完整清單。

config_user_types.xml 檔案中指定的任何屬性 (例如 default-restrictions) 都會覆寫 Android 開放原始碼計畫的預設值。未指定的任何屬性都會遵循 AOSP 預設值。變更大部分屬性 (例如個人資料類型的徽章屬性) 會影響該使用者類型的現有使用者。不過，由於 default-restrictions 只會在建立使用者時套用，因此如果 OTA 變更 config_user_types.xml 檔案，修改這個特定屬性對現有使用者不會有任何影響。同樣地，指定使用者人數上限只會在建立新使用者時生效，不會移除現有使用者。

目前各使用者類型的自訂限制如下：

• 您可以完全自訂和定義設定檔。在這種情況下，由於 AOSP 僅支援預先定義的 AOSP 使用者類型，因此原始設備製造商 (OEM) 必須負責依需求修改平台，讓自訂設定檔在 Android 中獲得支援。
• 無法定義完整使用者，只能自訂其 default-restrictions 屬性。
• 系統使用者無法透過這項機制自訂。在這種情況下，您可以使用 com.android.internal.R.array.config_defaultFirstUserRestrictions 設定 default-restrictions。詳情請參閱 config.xml。

修改現有的使用者類型

您可以覆寫現有使用者類型的屬性，如以下程式碼範例所示，藉此自訂現有使用者類型：

<user-types version="0">
    <full-type name="android.os.usertype.full.SECONDARY" >
        <default-restrictions no_sms="true" />
    </full-type>

    <profile-type
        name='android.os.usertype.profile.MANAGED'
        max-allowed-per-parent='2'
        icon-badge='@android:drawable/ic_corp_icon_badge_case'
        badge-plain='@android:drawable/ic_corp_badge_case'
        badge-no-background='@android:drawable/ic_corp_badge_no_background' >
        <badge-labels>
            <item res='@android:string/managed_profile_label_badge' />
            <item res='@android:string/managed_profile_label_badge_2' />
        </badge-labels>
        <badge-colors>
            <item res='@android:color/profile_badge_1' />
            <item res='@android:color/profile_badge_2' />
        </badge-colors>
        <default-restrictions no_sms="true" no_outgoing_calls="true" />
    </profile-type>
</user-types>

在這個程式碼範例中，我們會透過修改支援的屬性，自訂下列 Android 開放原始碼計畫 (AOSP) 使用者類型：

• 擁有完整權限的使用者 android.os.usertype.full.SECONDARY：

  • 指定 default-restrictions no_sms="true" 時，no_sms 的預設限制會設為 true。

• 設定檔使用者 android.os.usertype.profile.MANAGED：

  • 設定 max-allowed-per-parent='2' 後，每位家長使用者可建立兩個設定檔。
  • 徽章屬性會使用 icon-badge、badge-plain、badge-no-background、badge-labels、badge-colors 設定為所選值。
  • 指定 default-restrictions no_sms="true" no_outgoing_calls="true" 後，系統會將 no_sms 和 no_outgoing_calls 的預設限制設為 true。

如要瞭解這些屬性的含義和預設值，請參閱 UserTypeFactory.java 和 UserTypeDetails.java。

定義自訂設定檔類型

以下程式碼範例說明如何定義新的自訂設定檔類型：

<user-types version=&qu>ot;1&<quot;
    profile-type
        name="com.example.profilename"
        max-allo>wed-pe<r-parent="2" /

    change-user-type
        from="android.os.usertype.profile.MANAGED"
        to="com.exam>p<le.profilen>ame"
        whenVersionLeq="1" /
/user-types

在這個程式碼範例中，com.example.profilename 設定檔類型定義如下：

• max-allowed-per-parents 會設為 2，以便每位家長使用者有兩個設定檔。

• change-user-type：透過 OTA 從 <= 1 的 user-type 版本升級裝置時，將所有 android.os.usertype.profile.MANAGED 類型的現有受管理設定檔轉換為新的 com.example.profilename 類型。