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

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

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

آخر تعديل

	الإصدار المستقر	إصدار محتمل
‫28 أكتوبر 2026	1.9.0

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

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

repositories {
  ...
  google()
}

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

dependencies {
    def amapi_version = "1.9.0"

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

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

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

الإصدار 1.9.0

‫28 أكتوبر 2026

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

• تمت إضافة واجهة PolicyClient وPolicy.UnifiedUpdatePolicy للسماح لوحدات التحكّم بسياسة الجهاز (DPC) المخصّصة بضبط سياسات عناصر التحكّم الموحّدة في التحديثات (UUC) واستردادها ومحوها على الأجهزة المملوكة للشركة من خلال تطبيق Android Device Policy ‏(ADP). يُرجى الاطّلاع على ضبط عناصر التحكّم الموحّدة في التحديثات باستخدام حزمة تطوير البرامج (SDK) لواجهة برمجة التطبيقات Android Management API.
• تم تقديم الأمر المحلي Wipe (IssueCommandRequest.Wipe) والإمكانية الإضافية LOCAL_DEVICE_WIPE_COMMAND_ALLOWED (Role.ExtraCapabilities)، ما يسمح للتطبيقات المصاحبة التي تم منحها دور COMPANION_APP بحجب بيانات جهاز مملوك للشركة أو ملف عمل على جهاز مملوك شخصيًا. يُرجى الاطّلاع على تطبيقات الإضافات والأوامر المحلية وإدارة أدوار التطبيقات.
• تم إصلاح مشكلة تعذُّر الاتصال بتطبيق Android Device Policy مع ظهور الخطأ PERMISSION_DENIED (على سبيل المثال، بعد تسجيل الجهاز مباشرةً أو بعد تحديث "خدمات Google Play") إلى أن تتم إعادة تشغيل الجهاز أو تطبيق العميل.
• تم توضيح المستندات المتعلّقة بالاستثناءات والتجاهل في ما يخص OemSystemUpdateClient وOemSystemUpdateHandler.

الإصدار 1.8.4

‫10 سبتمبر 2026

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

• تم تعديل التبعيات الانتقالية لحزمة SDK لتكون متوافقة مع الإصدار 2.4.0 من Kotlin. يؤدي ذلك إلى إصلاح عطل يحدث أثناء إشعار دور التطبيق، ويؤثر في الإصدارَين 1.8.2 و1.8.3، عندما لا يحدّد التطبيق المدمج kotlinx-coroutines-core الإصدار 1.11.0 أو إصدار أحدث.

• تم توضيح المستندات الخاصة بـ Instruction.InstructionType#FORCE.

الإصدار 1.8.3

‫12 أغسطس 2026

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

• تم إصلاح مشكلة احتمال عرض حزمة SDK لحالة قديمة "تم التثبيت ولكن غير جاهز" عند استخدام دور DEVICE_POLICY_CONTROLLER في حال إعادة تشغيل عملية العميل بعد إعداد البيئة بنجاح.
• أصبح الحدّ الأدنى لمستوى واجهة برمجة تطبيقات Android المتوافق الآن هو 24 (بعد أن كان 23).

الإصدار 1.8.2

‫15 يوليو 2026

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

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

الإصدار 1.8.1

‫2 يونيو 2026

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

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

الإصدار 1.8.0

‫15 أبريل 2026

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

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

• أضِف واجهة OemSystemUpdateClient التي تتيح لعملاء OTA التابعين للمصنّعين الأصليين للأجهزة إبلاغ ADP بالتحديثات وطلب التعليمات. تتضمّن الواجهة طرقًا لإجراء ما يلي:
  • إنشاء تحديثات النظام والحصول عليها وإدراجها (مثل createSystemUpdate وgetSystemUpdate وlistSystemUpdates)
  • الإبلاغ عن المراحل المختلفة لعملية التحديث (مثل reportSystemUpdateDownloading وreportSystemUpdateDownloaded وreportSystemUpdateApplied وreportSystemUpdateAborted)
  • يجب الإبلاغ عن الإجراءات التي تم اتخاذها عند تجاوز تعليمات واجهة برمجة التطبيقات لإدارة Android أو عند منعك من الالتزام بها (مثل 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. أما الأدوار الأخرى، فتتطلّب الإصدار Android 10 أو إصدارًا أحدث.
• تم تحسين التسجيل لإجراء عمليات تشخيص أفضل. ننصح الشركاء باعتماد هذا الإصدار.

الإصدار 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 للسماح لتطبيقات "وحدة التحكّم بسياسة الجهاز" بقراءة معرّف شريحة SIM المضمّنة (EID) للجهاز يُرجى الاتصال بالرقم IssueCommandRequest باستخدام نوع RequestDeviceInfo وتحديد DeviceInfo.EID كمعرّف الجهاز المطلوب.

الإصدار 1.6.0

‫11 سبتمبر 2025

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

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

الإصدار 1.6.0-rc01

‫28 أغسطس 2025

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

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

الإصدار 1.5.0

‫11 أغسطس 2025

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

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

الإصدار 1.5.0-rc01

‫24 يوليو 2025

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

الإصدار 1.4.0

‫18 يونيو 2025

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

ما مِن اختلافات مقارنةً بالإصدار v1.4.0-rc01.

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

الإصدار 1.4.0-rc01

‫2 يونيو 2025

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

الإصدار 1.3.0

‫14 أبريل 2025

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

لا توجد اختلافات مع الإصدار v1.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. لمزيد من المعلومات، يمكنك مراجعة دليل نقل الأجهزة الحالية إلى AMAPI.

الإصدار 1.0.1

‫15 فبراير 2022

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

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

الإصدار 1.0.0

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

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

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