Benutzerdefinierte Nutzertypen implementieren

Mit Android 11 wurde das Konzept der klar definierten Nutzertypen eingeführt, die alle verschiedenen Nutzertypen repräsentieren, die von der Android-Mehrfachnutzerfunktion zulässig sind. 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 Sie zum Anpassen von Nutzertypen benötigen.

Personalisierung

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

Alle Attribute, z. B. default-restrictions, die in der Datei config_user_types.xml angegeben sind, überschreiben die AOSP-Standardeinstellungen. Für alle nicht angegebenen Attribute gilt der AOSP-Standard. Änderungen an den meisten Attributen, z. B. an den Kennzeichenattributen eines Profiltyps, wirken sich auf bereits vorhandene Nutzer dieses Nutzertyps aus. Da default-restrictions jedoch nur angewendet werden, wenn ein Nutzer und dieses Attribut ändern, falls der config_user_types.xml-Datei wurde vom OTA-Update geändert. Dies hat keine Auswirkungen auf bereits vorhandene. Nutzenden. Ebenso gilt die Angabe der maximalen Anzahl von Nutzern nur, wenn neue Nutzer zu erstellen, vorhandene Nutzer nicht entfernt.

Aktuelle Einschränkungen für die Anpassung der einzelnen Nutzertypen:

  • Profile können vollständig angepasst und definiert werden. In diesem Fall ist der OEM Plattformänderungen vornehmen, die für ihre benutzerdefinierten wird in Android unterstützt, da AOSP nur die vordefinierten AOSP-Nutzertypen.
  • Vollständige Nutzer können nicht definiert werden und nur ihr default-restrictions-Attribut 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 angepasst, indem die unterstützten Eigenschaften geändert werden:

  • Als Nutzer mit Vollzugriff android.os.usertype.full.SECONDARY:

    • Die Standardeinschränkung von no_sms ist auf „true“ festgelegt, indem Folgendes angegeben wird: default-restrictions no_sms="true".

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

    • Für jeden übergeordneten Nutzer sind zwei Profile zulässig, wenn folgende Einstellung festgelegt ist: max-allowed-per-parent='2'
    • Badge-Attribute werden mit icon-badge, badge-plain, badge-no-background, badge-labels und badge-colors auf ausgewählte 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 „wahr“ gesetzt.

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

Benutzerdefinierte Profiltypen definieren

Das folgende Codebeispiel zeigt, 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 ist der Profiltyp com.example.profilename so definiert:

  • max-allowed-per-parents ist für zwei Profile pro übergeordnetem Nutzer auf 2 gesetzt.

  • change-user-type: Konvertiert alle vorhandenen verwalteten Profile vom Typ 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 auf die neueste Version aktualisiert wird.