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

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

آخر تعديل

الإصدار المستقر إصدار محتمل
‫2 يونيو 2026 1.8.1

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

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

repositories {
  ...
  google()
}

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

dependencies {
    def amapi_version = "1.8.1"

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

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

الإصدار 1.8.1

‫02 يونيو 2026

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

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

الإصدار 1.8.0

‫15 أبريل 2026

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

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

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

الإصدار 1.7.1

‫19 يناير 2026

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

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

الإصدار 1.7.0

‫3 نوفمبر 2025

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

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

الإصدار ‎1.7.0-rc01

‫29 سبتمبر 2025

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

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

الإصدار 1.6.0

‫11 سبتمبر 2025

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

الإصدار 1.6.0-rc01

‫28 أغسطس 2025

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

الإصدار 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.

الإصدار 1.4.0-rc01

‫02 يونيو 2025

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

الإصدار 1.3.0

‫14 أبريل 2025

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

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

الإصدار 1.3.0-rc01

‫18 فبراير 2025

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

الإصدار 1.1.5

‫13 مايو 2024

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

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

الإصدار 1.1.4

‫24 يناير 2024

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

الإصدار 1.0.1

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

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

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

الإصدار 1.0.0

‫20 أيلول (سبتمبر) 2021

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

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