ملاحظات حول إصدار 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 لاسترداد حالة التحكّم الحالية في التحديث الخاصة بجهاز العميل من المصنّع الأصلي.

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

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

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

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