تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

الدمج مع حزمة AMAPI SDK

تتيح حزمة تطوير البرامج (SDK) لواجهة Android Management API لتطبيقات معيّنة التواصل مباشرةً مع تطبيق Android Device Policy. ويشمل ذلك إتاحة ما يلي:

تنفيذ الأوامر محليًا
نقل الأجهزة المُدارة باستخدام وحدة التحكّم بسياسة الجهاز (DPC) المخصّصة إلى واجهة برمجة التطبيقات Android Management API
‫Device Trust من Android Enterprise
عملية جديدة لتسجيل الأجهزة تتيح أيضًا إضافة حسابات Google المُدارة
إدارة التطبيقات المخصّصة باستخدام واجهة برمجة التطبيقات لإدارة Android
إدارة أدوار التطبيق
إدارة التحديثات باستخدام "عناصر التحكّم الموحّدة في التحديثات"
قراءة معرّف شريحة SIM المضمّنة (EID) للجهاز

يجب اتّباع الخطوات التالية لدمج حزمة تطوير البرامج (SDK) لواجهة برمجة التطبيقات Android Management API مع تطبيقك:

أضِف مكتبة حزمة تطوير البرامج (SDK) لواجهة برمجة التطبيقات AMAPI.
أضِف عنصر طلبات البحث، إذا كان إصدار حزمة تطوير البرامج (SDK) المستهدَف أكبر من أو يساوي 30.

المتطلبات الأساسية

تأكَّد من ضبط minSdkVersion في تطبيقك على مستوى واجهة برمجة التطبيقات 21 على الأقل.
أضِف التبعيات لأحدث إصدار من حزمة تطوير البرامج (SDK) لواجهة برمجة التطبيقات Android Management API إلى تطبيقك. يمكنك العثور على إصدار أحدث مكتبة متاحة، وكيفية إضافتها إلى تطبيقك، في صفحة ملاحظات إصدار حزمة تطوير البرامج (SDK) لواجهة برمجة التطبيقات لإدارة Android.

إضافة عنصر طلبات البحث

إذا كان تطبيقك يستهدف الإصدار 30 من حزمة تطوير البرامج (SDK) أو إصدارًا أحدث، يجب إضافة عنصر طلبات البحث في 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.
  }
}

يجب تزويد تطبيق ADP بـ ComponentName من فئة NotificationReceiverService. هناك طريقتان لإجراء ذلك. تحدّد مستندات كل ميزة النهج الذي يجب استخدامه.

Explicit API

في هذه الحالة، يتم تمرير ComponentName إلى تطبيق 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 إلى الخدمة نفسها.