ملاحظات حول إصدار Android Management SDK

قد تتضمّن عملية إصدار حزمة تطوير البرامج (SDK) لواجهة برمجة التطبيقات Android Management مرحلة إصدار تجريبي كجزء من عملية الإصدار العادية.

ملاحظة مهمة: الإصدار المحتمل هو إصدار مستقبلي يتضمّن واجهة برمجة التطبيقات النهائية.

آخر تعديل

	الإصدار المستقر	إصدار محتمل
‫15 أبريل 2026	1.8.0

تحديد الاعتماديات

لإضافة اعتمادية على حزمة تطوير البرامج (SDK) لواجهة برمجة التطبيقات AMAPI، يجب إضافة مستودع Google Maven إلى مشروعك:

repositories {
  ...
  google()
}

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

dependencies {
    def amapi_version = "1.8.0"

    implementation "com.google.android.libraries.enterprise.amapi:amapi:$amapi_version"
}

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات الإصدار.

ملاحظة مهمة: استخدِم دائمًا أحدث إصدار ثابت من المكتبة للاستفادة من إصلاحات الأخطاء والتحسينات المتاحة.

الإصدار 1.8.0

‫15 أبريل 2026

يتيح هذا الإصدار للمصنّعين الأصليين للأجهزة التواصل بشكل ثنائي الاتجاه مع تطبيق Android Device Policy (ADP) بشأن تحديثات النظام، وذلك من خلال برامجهم التي تتيح التحديثات عبر شبكة غير سلكية (OTA).

يتضمّن هذا الإصدار التحديثات التالية:

• أضِف واجهة OemSystemUpdateClient التي تتيح لبرامج OTA الخاصة بالمصنّعين الأصليين للأجهزة إبلاغ ADP بالتحديثات والاستعلام عن التعليمات. تتضمّن الواجهة طرقًا لإجراء ما يلي:
  • إنشاء تحديثات النظام والحصول عليها وإدراجها (مثل createSystemUpdate وgetSystemUpdate وlistSystemUpdates)
  • الإبلاغ عن مراحل مختلفة من عملية التحديث (مثل reportSystemUpdateDownloading وreportSystemUpdateDownloaded وreportSystemUpdateApplied وreportSystemUpdateAborted)
  • تسجيل الإجراءات المتّخذة عند تجاهل تعليمات AMAPI أو عند منع اتّباعها (مثل reportSystemUpdateDownloadingWithOverride وreportSystemUpdateDownloadPrevented)
  • إدارة حالة التحكّم في التحديث والاستعلام عنها (مثلاً، updateUpdateControlState وgetUpdateControlState)
• أضِف واجهة OemSystemUpdateHandler التي يجب أن تنفّذها برامج OTA الخاصة بمصنّعي المعدات الأصلية لتلقّي عمليات رد الاتصال من ADP. ويشمل ذلك ما يلي:
  • onSystemUpdatesChanged: لإعلام عميل المصنّع الأصلي للجهاز بالتغييرات التي يجب إجراؤها على تعليمات التحديث.
  • ‫listPendingSystemUpdates: يتم استدعاؤها من خلال ADP لطلب قائمة التعديلات المعلقة.
  • ‫getUpdateControlState: تستدعيه ADP لاسترداد حالة التحكّم الحالية في التحديث لعميل المصنّع الأصلي للجهاز.

ملاحظة: لن يلبّي برنامج ADP الطلبات المقدَّمة من شركاء المصنّعين الأصليين للأجهزة في الوقت الحالي، لأنّه من المتوقّع أن يتم طرح وظائف النظام الأساسي ذات الصلة مع الإصدار Android 17. ومع ذلك، يمكن للشركاء البدء في الدمج الآن، إذ لن تكون هناك حاجة إلى إجراء أي تغييرات بعد أن تصبح الميزة متاحة بالكامل.

الإصدار 1.7.1

‫19 يناير 2026

يتضمّن هذا الإصدار التحديثات التالية:

• تم إصلاح خطأ كان يمنع التطبيقات من طلب prepareEnvironment على نظام التشغيل Android 8 أو الإصدارات الأقدم عند استخدام الدور DEVICE_POLICY_CONTROLLER. لا تزال الأدوار الأخرى تتطلّب الإصدار 10 أو إصدارًا أحدث من نظام التشغيل Android.
• تحسين تسجيل الدخول للحصول على بيانات تشخيص أفضل ننصح الشركاء باستخدام هذا الإصدار.

الإصدار 1.7.0

‫3 نوفمبر 2025

يتضمّن هذا الإصدار التحديثات التالية:

• أضِف إلى إشارات موثوقية الجهاز المتاحة ManagementProviderInfo، التي تحتوي على اسم نشاط تجاري يمكن قراءته لمزوّد الإدارة.
• أضِف الأمر REQUEST_DEVICE_INFO للسماح لتطبيقات وحدة التحكّم بسياسة الجهاز (DPC) بقراءة رقم التعريف EID الخاص بالجهاز. اتّصِل بالرقم IssueCommandRequest باستخدام النوع RequestDeviceInfo واذكر DeviceInfo.EID كمعرّف الجهاز المطلوب.
• يجب تحديث الاعتماديات لحلّ الثغرة الأمنية CVE-2023-2976.

الإصدار ‎1.7.0-rc01

‫29 سبتمبر 2025

يتضمّن هذا الإصدار التحديثات التالية:

• أضِف إلى إشارات موثوقية الجهاز المتاحة ManagementProviderInfo، التي تحتوي على اسم نشاط تجاري يمكن قراءته لمزوّد الإدارة.
• أضِف الأمر REQUEST_DEVICE_INFO للسماح لتطبيقات وحدة التحكّم بسياسة الجهاز (DPC) بقراءة رقم التعريف EID الخاص بالجهاز. اتّصِل بالرقم IssueCommandRequest باستخدام النوع RequestDeviceInfo واذكر DeviceInfo.EID كمعرّف الجهاز المطلوب.

الإصدار 1.6.0

‫11 سبتمبر 2025

يتضمّن هذا الإصدار التحديثات التالية:

• إتاحة إمكانية تثبيت التطبيقات المخصّصة لمزوّدي خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM) الذين يستخدمون Android Management API يُرجى الاطّلاع على إدارة التطبيقات المخصّصة باستخدام AMAPI.
• إضافة نظام جديد لتعيين أدوار للتطبيقات راجِع مقالة إدارة أدوار التطبيق.
• زيادة قيمة minSDK إلى المستوى 23 من واجهة برمجة التطبيقات

الإصدار 1.6.0-rc01

‫28 أغسطس 2025

يتضمّن هذا الإصدار التحديثات التالية:

• إتاحة إمكانية تثبيت التطبيقات المخصّصة لمزوّدي خدمة إدارة الخدمات الجوّالة للمؤسسات (EMM) الذين يستخدمون Android Management API يُرجى الاطّلاع على إدارة التطبيقات المخصّصة باستخدام AMAPI.
• زيادة قيمة minSDK إلى المستوى 23 من واجهة برمجة التطبيقات

الإصدار 1.5.0

‫11 أغسطس 2025

يتضمّن هذا الإصدار التحديثات التالية:

• تحسين عملية تسجيل الأجهزة في وحدات التحكّم المخصّصة بسياسة الجهاز (DPC) يستخدم هذا الأسلوب المبسّط حزمة تطوير البرامج (SDK) الخاصة بواجهة برمجة تطبيقات إدارة Android (AMAPI) وتطبيق Android Device Policy (ADP) لتسهيل عملية تسجيل الأجهزة.
• تحسينات على مستوى الثبات والأداء مع توفّر معلومات إضافية في استثناءات موثوقية الجهاز، يُرجى الاطّلاع على AmapiSdkException.

الإصدار 1.5.0-rc01

‫24 يوليو 2025

يقدّم هذا الإصدار مسارًا محسّنًا لتسجيل الأجهزة في وحدات التحكّم المخصّصة في سياسة الجهاز (DPC). يستخدم هذا الأسلوب المبسّط حزمة تطوير البرامج (SDK) الخاصة بواجهة برمجة تطبيقات إدارة Android، وتطبيق Android Device Policy (ADP) لتبسيط عملية تسجيل الأجهزة.

الإصدار 1.4.0

‫18 يونيو 2025

يتضمّن هذا الإصدار الإشارة Device.WorkProfileState لتحديد حالة إدارة الجهاز.

لا توجد اختلافات مع الإصدار 1.4.0-rc01.

ملاحظة مهمة: يتم حصر الوصول إلى إشارات موثوقية الجهاز باستخدام قائمة بالسماح لمنع الاستخدام غير المصرَّح به. للحصول على معلومات إضافية، يُرجى الاطّلاع على: Device Trust من Android Enterprise - الوصول إلى واجهة برمجة التطبيقات.

الإصدار ‎1.4.0-rc01

‫02 يونيو 2025

يتضمّن هذا الإصدار الإشارة Device.WorkProfileState لتحديد حالة إدارة الجهاز.

الإصدار 1.3.0

‫14 أبريل 2025

يتضمّن هذا الإصدار الإصدار الأول من Device Trust من Android Enterprise.

لا توجد اختلافات مع الإصدار 1.3.0-rc01.

ملاحظة مهمة: يتم حصر الوصول إلى إشارات موثوقية الجهاز باستخدام قائمة بالسماح لمنع الاستخدام غير المصرَّح به. للحصول على معلومات إضافية، يُرجى الاطّلاع على: Device Trust من Android Enterprise - الوصول إلى واجهة برمجة التطبيقات.

الإصدار 1.3.0-rc01

‫18 فبراير 2025

يتضمّن هذا الإصدار أول إصدار محتمل لميزة Device Trust من Android Enterprise.

• حزمة إشارات ثقة الأجهزة الجديدة com.google.android.managementapi.device
• حزمة "بيئة جديدة" (New Environment) com.google.android.managementapi.environment لإعداد الجهاز لاستخدام ميزة "Device Trust من Android Enterprise"، ولتثبيت تطبيق Android Device Policy أو تحديثه إذا لزم الأمر.

الإصدار 1.1.5

‫13 مايو 2024

يتضمّن هذا الإصدار التحديثات التالية:

• إصلاح الأخطاء وإجراء تحسينات داخلية

الإصدار 1.1.4

‫24 يناير 2024

يتضمّن هذا الإصدار التحديثات التالية:

• حزمة نقل جديدة لوحدة التحكّم في سياسات الأجهزة (DPC) com.google.android.managementapi.dpcmigration لدعم نقل البيانات إلى واجهة برمجة التطبيقات Android Management API. للحصول على معلومات إضافية، يمكنك مراجعة الدليل نقل الأجهزة الحالية إلى AMAPI.

الإصدار 1.0.1

15 شباط (فبراير) 2022

يتضمّن هذا الإصدار التحديثات التالية:

• إصلاح الأخطاء وإجراء تحسينات داخلية

الإصدار 1.0.0

‫20 سبتمبر 2021

يتضمّن هذا الإصدار التحديثات التالية:

• الإصدار الأوّلي.