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

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

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

آخر تعديل

	الإصدار المستقر	إصدار محتمل
‫15 يوليو 2026	1.8.2

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

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

repositories {
  ...
  google()
}

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

dependencies {
    def amapi_version = "1.8.2"

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

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

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

الإصدار 1.8.2

‫15 يوليو 2026

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

• تم إصلاح المشكلة المتمثلة في تعذُّر تحديث "متجر Google Play" إلى الإصدار المطلوب عند استدعاء prepareEnvironment، ما يؤدي إلى تعذُّر تثبيت تطبيق Android Device Policy.

الإصدار 1.8.1

‫02 يونيو 2026

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

• تحسين الموثوقية والإبلاغ عن الأخطاء أثناء عملية تثبيت تطبيق Android Device Policy
• تم تحسين عملية إعداد البيئة لتحسين التوافق والموثوقية أثناء تحديثات "متجر Google Play".

الإصدار 1.8.0

‫15 أبريل 2026

يتيح هذا الإصدار للمصنّعين الأصليين للأجهزة إمكانية التواصل مع تطبيق "سياسة أجهزة Android" (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 للسماح لتطبيقات "سياسة الجهاز" بقراءة معرّف EID للجهاز. اتّصِل بالرقم IssueCommandRequest باستخدام النوع RequestDeviceInfo وحدِّد DeviceInfo.EID كمعرّف الجهاز المطلوب.
• يجب تحديث الاعتماديات لحلّ مشكلة CVE-2023-2976.

الإصدار ‎1.7.0-rc01

‫29 سبتمبر 2025

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

• أضِف إلى إشارات موثوقية الجهاز المتاحة ManagementProviderInfo، التي تحتوي على اسم مؤسسة يمكن قراءته.
• أضِف الأمر REQUEST_DEVICE_INFO للسماح لتطبيقات "سياسة الجهاز" بقراءة معرّف 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 (AMAPI) وتطبيق 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

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

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