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ư mục này hỗ trợ:

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

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

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

  • Xác minh 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 SDK AMAPI vào ứng dụng của bạn. Bạn có thể tìm thấy 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 bạn 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ì bạn 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 tạo NotificationReceiverService, và một số tính năng sử dụng không bắt buộc. Để 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 cho ứng dụng ADP ComponentName của lớp NotificationReceiverService. Có hai 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 rõ ràng

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

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

Tự động khám phá

Với phương pháp này, bạn phải gắn thẻ dịch vụ để 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 sử 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 ví dụ trong phần Quản lý vai trò của ứng dụng). Để việc gắn thẻ này hợp lệ, ứng dụng của bạn phải có đúng một dịch vụ được bật và có meta-data với 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ụ.