Tích hợp với SDK AMAPI

SDK Android Management API (AMAPI) cho phép các ứng dụng cụ thể giao tiếp trực tiếp với Android Device Policy (ADP). Thư viện này hỗ trợ:

• Thực thi Lệnh cục bộ
• Di chuyển các thiết bị được quản lý bằng DPC tuỳ chỉnh sang AMAPI
• Device Trust từ Android Enterprise
• Quy trình đăng ký thiết bị mới cũng hỗ trợ việc thêm Tài khoản Google do quản lý
• Quản lý ứng dụng tuỳ chỉnh bằng AMAPI
• Quản lý vai trò của ứng dụng.

Bạn phải thực hiện các bước sau để tích hợp AMAPI SDK với ứng dụng của mình:

1. Thêm thư viện AMAPI SDK.
2. Thêm phần tử truy vấn, nếu SDK mục tiêu >= 30.

Lưu ý: Nếu đang phát triển một ứng dụng tiện ích, bạn cũng cần cung cấp cho thiết bị một chính sách về khả năng mở rộng.

Điều kiện tiên quyết

• Xác minh để đảm bảo rằng minSdkVersion của ứng dụng được đặt thành ít nhất là API cấp 21.
• Thêm các phần phụ thuộc cho phiên bản mới nhất của AMAPI SDK vào ứng dụng của bạn. Bạn có thể xem phiên bản của thư viện mới nhất hiện có và cách thêm thư viện đó vào ứng dụng của mình trên trang ghi chú phát hành của SDK AMAPI.

Thêm phần tử truy vấn

Nếu ứng dụng của bạn nhắm đến SDK 30 trở lên, thì cần có phần tử truy vấn trong AndroidManifest.xml để chỉ định rằng ứng dụng sẽ tương tác với ADP.

<queries>
    <package android:name="com.google.android.apps.work.clouddpc" />
</queries>

Hãy xem bài viết Lọc chế độ hiển thị gói trên Android để biết thêm thông tin.

Triển khai NotificationReceiverService

Một số tính năng yêu cầu bạn tạo NotificationReceiverService, còn một số tính năng cho phép bạn sử dụng tuỳ chọn này. Để sử dụng, hãy xác định một lớp mở rộng NotificationReceiverService, thêm lớp đó dưới dạng service vào AndroidManifest.xml và đảm bảo lớp đó được xuất.

import com.google.android.managementapi.notification.NotificationReceiverService;

...

public final class MyAppNotificationReceiverService extends NotificationReceiverService {

  @Override
  protected void setupInjection() {
    // This method can be optionally used to inject dependencies at the
    // beginning of the service lifecycle.
  }
}

Bạn phải cung cấp ComponentName cho ứng dụng ADP của lớp NotificationReceiverService. Có 2 cách để thực hiện việc này. Tài liệu cho từng tính năng sẽ chỉ định phương pháp cần sử dụng.

API tường minh

Trong trường hợp này, ComponentName sẽ được truyền đến ứng dụng ADP thông qua một API phù hợp. Tài liệu về tính năng có liên quan sẽ có thông tin chi tiết. Trong AndroidManifest.xml, hãy thêm:

<service
 android:name = ".MyAppNotificationReceiverService"
 android:exported = "true" />

Tự động phát hiện

Với phương pháp này, bạn phải gắn thẻ cho dịch vụ của mình để dịch vụ đó có thể được tự động phát hiện. Trong AndroidManifest.xml, hãy thêm:

<service
 android:name = ".MyAppNotificationReceiverService"
 android:exported = "true" >
    <meta-data android:name="Insert name here" android:value=""/>
</service>

Chuỗi cụ thể cần dùng cho android:name của meta-data được ghi lại cho từng tính năng sử dụng phương pháp này (xem phần Quản lý vai trò của ứng dụng để biết ví dụ). Để hoạt động gắn thẻ này có hiệu lực, ứng dụng của bạn phải có chính xác một dịch vụ được bật và có meta-data mà android:name là chuỗi cụ thể này và android:value là một chuỗi trống. Bạn có thể thêm nhiều meta-data vào cùng một dịch vụ.

Lưu ý quan trọng: Trong cả hai trường hợp, dịch vụ phải có android:exported được đặt thành true.