ادغام با AMAPI SDK

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

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

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

پیش نیازها

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

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

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

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

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

یک 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 به یک سرویس اضافه کنید.