Benutzerdefinierte Nutzertypen implementieren

In Android 11 wurde das Konzept von genau definierten Nutzertypen eingeführt, die alle verschiedenen Nutzertypen darstellen, die von der Android-Funktion für mehrere Nutzer zugelassen werden. Mit dieser Funktion können OEMs vordefinierte AOSP-Nutzertypen anpassen und neue Profiltypen definieren. Weitere Informationen finden Sie im Abschnitt Nutzertypen.

Auf dieser Seite finden Sie die Implementierungsrichtlinien, die für die Anpassung von Nutzertypen erforderlich sind.

Personalisierung

Um AOSP-Nutzertypen anzupassen und neue Profiltypen zu definieren, muss der OEM config_user_types.xml mit den gewünschten Anpassungen überschreiben. Die Datei config_user_types.xml enthält eine Referenzimplementierung und eine umfassende Liste konfigurierbarer Attribute.

Jedes Attribut, z. B. default-restrictions, das in der Datei config_user_types.xml angegeben ist, überschreibt den AOSP-Standardwert. Für alle Attribute, die nicht angegeben sind, wird der AOSP-Standardwert verwendet. Wenn Sie die meisten Attribute ändern, z. B. die Badge-Attribute eines Profiltyps, wirkt sich das auf bestehende Nutzer dieses Nutzertyp aus. Da default-restrictions jedoch nur bei der Erstellung eines Nutzers angewendet werden, hat die Änderung dieses Attributs keine Auswirkungen auf bestehende Nutzer, falls die config_user_types.xml-Datei per OTA geändert wird. Die Angabe der maximalen Anzahl von Nutzern gilt nur für das Erstellen neuer Nutzer. Vorhandene Nutzer werden nicht entfernt.

Die aktuellen Anpassungsbeschränkungen für die einzelnen Nutzertypen sind:

  • Profile können vollständig angepasst und definiert werden. In diesem Fall ist der OEM dafür verantwortlich, die erforderlichen Plattformänderungen vorzunehmen, damit sein benutzerdefiniertes Profil in Android unterstützt wird, da AOSP nur die vordefinierten AOSP-Nutzertypen unterstützt.
  • Vollständige Nutzer können nicht definiert werden. Nur ihr Attribut default-restrictions kann angepasst werden.
  • Der Systemnutzer kann mit diesem Mechanismus nicht angepasst werden. In diesem Fall kann default-restrictions mit com.android.internal.R.array.config_defaultFirstUserRestrictions festgelegt werden. Weitere Informationen finden Sie unter config.xml.

Vorhandene Nutzertypen ändern

Vorhandene Nutzertypen können angepasst werden, indem ihre Attribute überschrieben werden, wie im folgenden Codebeispiel gezeigt:

<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>

In diesem Codebeispiel werden die folgenden AOSP-Nutzertypen durch Ändern der unterstützten Eigenschaften angepasst:

  • Uneingeschränkter Nutzer android.os.usertype.full.SECONDARY:

    • Die Standardeinschränkung von no_sms wird durch die Angabe von default-restrictions no_sms="true" auf „true“ gesetzt.

  • Profilnutzer android.os.usertype.profile.MANAGED:

    • Für jeden übergeordneten Nutzer sind zwei Profile zulässig, wenn max-allowed-per-parent='2' festgelegt ist.
    • Kennzeichenattribute werden mit icon-badge, badge-plain, badge-no-background, badge-labels und badge-colors auf die ausgewählten Werte festgelegt.
    • Die Standardeinschränkungen von no_sms und no_outgoing_calls werden durch Angabe von default-restrictions no_sms="true" no_outgoing_calls="true" auf „true“ gesetzt.

Die Bedeutung und die Standardwerte dieser Attribute finden Sie unter UserTypeFactory.java und UserTypeDetails.java.

Benutzerdefinierte Profiltypen definieren

Im folgenden Codebeispiel sehen Sie, wie neue benutzerdefinierte Profiltypen definiert werden:

<user-types version="1">
    <profile-type
        name="com.example.profilename"
        max-allowed-per-parent="2" />

    <change-user-type
        from="android.os.usertype.profile.MANAGED"
        to="com.example.profilename"
        whenVersionLeq="1" />
</user-types>

In diesem Codebeispiel wird der Profiltyp com.example.profilename so definiert:

  • max-allowed-per-parents ist für zwei Profile pro Elternnutzer auf 2 festgelegt.

  • change-user-type: Konvertiert alle vorhandenen verwalteten Profile des Typs android.os.usertype.profile.MANAGED in den neuen Typ com.example.profilename, wenn das Gerät über OTA von einer user-type-Version von <= 1 aktualisiert wird.