ادغام با AMAPI SDK

SDK مدیریت API اندروید (AMAPI) به برنامه‌های خاص این امکان را می‌دهد که مستقیماً با Android Device Policy (ADP) ارتباط برقرار کنند. این SDK شامل پشتیبانی از موارد زیر است:

برای ادغام AMAPI SDK با برنامه شما، مراحل زیر باید انجام شود:

  1. کتابخانه AMAPI SDK را اضافه کنید .
  2. اگر SDK هدف >= 30 است، عنصر queries را اضافه کنید .

پیش‌نیازها

  • تأیید کنید که minSdkVersion برنامه شما حداقل روی سطح API 21 تنظیم شده باشد.
  • وابستگی‌های آخرین نسخه AMAPI SDK را به برنامه خود اضافه کنید. می‌توانید نسخه آخرین کتابخانه موجود و نحوه افزودن آن به برنامه خود را در صفحه یادداشت‌های انتشار AMAPI SDK بیابید.

عنصر پرس و جوها را اضافه کنید

اگر برنامه شما SDK 30 یا بالاتر را هدف قرار داده است، عنصر queries در AndroidManifest.xml برای مشخص کردن اینکه با ADP تعامل خواهد داشت، مورد نیاز است.

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

برای اطلاعات بیشتر به فیلتر کردن قابلیت مشاهده بسته‌ها در اندروید مراجعه کنید.

پیاده‌سازی یک سرویس دریافت اعلان (NotificationReceiverService)

برخی از ویژگی‌ها نیاز به ایجاد یک NotificationReceiverService دارند و برخی دیگر به صورت اختیاری از آن استفاده می‌کنند. برای استفاده از آن، یک کلاس از NotificationReceiverService را تعریف کنید، آن را به عنوان یک service به AndroidManifest.xml خود اضافه کنید و مطمئن شوید که صادر شده است.


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

شما باید ComponentName کلاس NotificationReceiverService خود را به برنامه ADP ارائه دهید. برای انجام این کار دو رویکرد وجود دارد. مستندات مربوط به هر ویژگی، رویکرد مورد استفاده را مشخص می‌کند.

API صریح

در این حالت، ComponentName از طریق یک API مناسب به برنامه ADP ارسال می‌شود. مستندات ویژگی مورد نظر جزئیات آن را دارد. در AndroidManifest.xml خود، موارد زیر را اضافه کنید:

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

کشف خودکار

با این رویکرد، شما باید سرویس خود را برچسب‌گذاری کنید تا بتواند به طور خودکار کشف شود. در AndroidManifest.xml خود، موارد زیر را اضافه کنید:

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

رشته‌ی خاصی که باید برای android:name meta-data استفاده شود، برای هر ویژگی که از این رویکرد استفاده می‌کند، مستند شده است (برای مثال به مدیریت نقش‌های برنامه مراجعه کنید). برای اینکه این برچسب‌گذاری معتبر باشد، برنامه‌ی شما باید دقیقاً یک سرویس فعال داشته باشد که دارای meta-data باشد که android:name آن رشته‌ی خاص و android:value یک رشته‌ی خالی باشد. می‌توانید چندین meta-data به یک سرویس اضافه کنید.