Triển khai loại người dùng tuỳ chỉnh

Android 11 đã giới thiệu khái niệm về các loại người dùng được xác định rõ ràng, đại diện cho tất cả các loại người dùng mà tính năng Nhiều người dùng trên Android cho phép. Với tính năng này, OEM có thể tuỳ chỉnh các loại người dùng AOSP được xác định trước và xác định các loại hồ sơ mới. Hãy xem phần các loại người dùng để biết thêm thông tin.

Trang này trình bày chi tiết các nguyên tắc triển khai cần thiết để tuỳ chỉnh loại người dùng.

Tuỳ chỉnh

Để tuỳ chỉnh các loại người dùng AOSP và xác định các loại hồ sơ mới, OEM phải phủ config_user_types.xml bằng các tuỳ chỉnh ưu tiên. Tệp config_user_types.xml chứa cách triển khai tham chiếu và danh sách đầy đủ các tên có thể định cấu hình .

Mọi thuộc tính, chẳng hạn như default-restrictions, được chỉ định trong tệp config_user_types.xml, sẽ ghi đè thuộc tính mặc định của AOSP. Mọi thuộc tính không được chỉ định sẽ tuân theo giá trị mặc định của AOSP. Thay đổi hầu hết các thuộc tính, chẳng hạn như các thuộc tính huy hiệu của loại hồ sơ sẽ ảnh hưởng đến người dùng hiện có của loại người dùng đó. Tuy nhiên, vì default-restrictions chỉ được áp dụng tại thời điểm người dùng đã tạo, sửa đổi thuộc tính cụ thể này, trong trường hợp Tệp config_user_types.xml do OTA thay đổi, không ảnh hưởng đến các tệp có sẵn người dùng. Tương tự, việc chỉ định số người dùng tối đa chỉ áp dụng khi tạo người dùng mới; người dùng hiện tại không bị loại bỏ.

Sau đây là các hạn chế tuỳ chỉnh hiện tại cho từng kiểu người dùng:

  • Bạn có thể xác định và tuỳ chỉnh đầy đủ các hồ sơ. Trong trường hợp này, OEM chịu trách nhiệm điều chỉnh nền tảng theo yêu cầu đối với các chiến dịch được hỗ trợ trong Android, vì AOSP chỉ hỗ trợ định dạng được xác định trước Các kiểu người dùng AOSP (Dự án nguồn mở Android).
  • Không thể xác định người dùng đầy đủ và chỉ có thể tuỳ chỉnh thuộc tính default-restrictions của họ.
  • Không thể tuỳ chỉnh người dùng hệ thống bằng cơ chế này. Trong trường hợp này, bạn có thể đặt default-restrictions bằng com.android.internal.R.array.config_defaultFirstUserRestrictions. Vui lòng xem config.xml để biết thêm thông tin.

Sửa đổi loại người dùng hiện có

Bạn có thể tuỳ chỉnh các loại người dùng hiện có bằng cách ghi đè các thuộc tính của họ như trong mã mẫu sau:

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

Trong mã mẫu này, các loại người dùng AOSP sau đây được tuỳ chỉnh bằng cách sửa đổi các thuộc tính được hỗ trợ:

  • Người dùng có toàn quyền android.os.usertype.full.SECONDARY:

    • Quy tắc hạn chế mặc định của no_sms được đặt thành true bằng cách chỉ định default-restrictions no_sms="true".

  • Người dùng trên hồ sơ android.os.usertype.profile.MANAGED:

    • Mỗi người dùng chính được phép có hai hồ sơ bằng cách đặt max-allowed-per-parent='2'.
    • Thuộc tính huy hiệu được đặt thành giá trị đã chọn bằng icon-badge, badge-plain, badge-no-background, badge-labels, badge-colors.
    • Các quy định hạn chế mặc định của no_sms và no_outgoing_calls được đặt thành đúng bằng cách chỉ định default-restrictions no_sms="true" no_outgoing_calls="true".

Hãy tham khảo UserTypeFactory.java và UserTypeDetails.java để biết ý nghĩa và giá trị mặc định của các thuộc tính này.

Xác định loại hồ sơ tuỳ chỉnh

Mã mẫu sau đây cho biết cách xác định các loại hồ sơ tuỳ chỉnh, mới:

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

Trong mã mẫu này, loại hồ sơ com.example.profilename được định nghĩa như sau:

  • max-allowed-per-parents được đặt thành 2 cho hai hồ sơ trên mỗi người dùng chính.

  • change-user-type: chuyển đổi tất cả hồ sơ được quản lý hiện có thuộc loại android.os.usertype.profile.MANAGED sang loại com.example.profilename mới khi nâng cấp thiết bị từ phiên bản user-type của <= 1 thông qua OTA.