یادداشت‌های انتشار کیت توسعه نرم‌افزار مدیریت Android

فرایند انتشار «کیت توسعه نرم‌افزار مدیریت Android» (AMAPI SDK) ممکن است شامل مرحله نامزد انتشار به‌عنوان بخشی از فرایند انتشار استاندارد باشد.

نکته کلیدی: نامزد انتشار یک نسخه احتمالی است که سطح نهایی میانای برنامه‌سازی کاربردی را پیاده‌سازی می‌کند.

جدیدترین به‌روزرسانی

	نسخه پایدار	نامزد انتشار
‫۲۸ اکتبر ۲۰۲۶	1.9.0

اعلام وابستگی‌ها

برای افزودن وابستگی به AMAPI SDK، باید مخزن Google Maven را به پروژه‌تان اضافه کنید:

repositories {
  ...
  google()
}

وابستگی‌های مصنوعات موردنیازتان را در فایل build.gradle برای برنامه یا واحدتان اضافه کنید:

dependencies {
    def amapi_version = "1.9.0"

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

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت مراجعه کنید.

نکته کلیدی: همیشه از جدیدترین نسخه پایدار دردسترس کتابخانه استفاده کنید تا از رفع اشکال‌ها و بهبودهای دردسترس بهره‌مند شوید.

نسخه ۱.۹.۰

‫۲۸ اکتبر ۲۰۲۶

این نسخه شامل به‌روزرسانی‌های زیر است:

• میانای PolicyClient و Policy.UnifiedUpdatePolicy اضافه شد تا به «کنترل‌کننده‌های خط‌مشی دستگاه» (DPC) سفارشی اجازه دهد خط‌مشی‌های کنترل‌های به‌روزرسانی یکپارچه (UUC) را در دستگاه‌های متعلق به شرکت ازطریق برنامه «خط‌مشی دستگاه Android» (ADP) پیکربندی، بازیابی، و پاک کنند. پیکربندی کنترل‌های به‌روزرسانی یکپارچه با AMAPI SDK را ببینید.
• فرمان محلی Wipe (IssueCommandRequest.Wipe) و قابلیت اضافی LOCAL_DEVICE_WIPE_COMMAND_ALLOWED (Role.ExtraCapabilities) معرفی شد که به برنامه‌های همراهی که نقش COMPANION_APP به آن‌ها اختصاص داده شده است اجازه می‌دهد دستگاه تحت مالکیت شرکت یا نمایه کاری در دستگاه تحت مالکیت شخصی را به‌صورت محلی پاک‌سازی کنند. برنامه‌های افزونه و فرمان‌های محلی و مدیریت نقش‌های برنامه را ببینید.
• مشکلی برطرف شد که در آن ارتباط با برنامه Android Device Policy ممکن بود با خطای PERMISSION_DENIED ناموفق شود (برای مثال، بلافاصله پس‌از ثبت‌نام دستگاه یا به‌روزرسانی خدمات Google Play) تا زمانی که دستگاه یا برنامه کارخواه بازراه‌اندازی شود.
• اسناد استثنا و لغو برای OemSystemUpdateClient و OemSystemUpdateHandler شفاف‌سازی شد.

نسخه ۱.۸.۴

۱۰ سپتامبر ۲۰۲۶

این نسخه شامل به‌روزرسانی‌های زیر است:

• وابستگی‌های انتقالی کیت توسعه نرم‌افزار به‌روز شد تا با Kotlin 2.4.0 سازگار شود. این به‌روزرسانی خرابی‌ای را که درطول اعلان نقش برنامه رخ می‌دهد و بر نسخه‌های ۱.۸.۲ و ۱.۸.۳ تأثیر می‌گذارد، برطرف می‌کند. این مشکل زمانی رخ می‌دهد که برنامه ادغام‌کننده نسخه kotlinx-coroutines-core ۱.۱۱.۰ یا جدیدتر را مشخص نمی‌کند.

• مستندات Instruction.InstructionType#FORCE شفاف‌سازی شد.

نسخه ۱.۸.۳

‫۱۲ اوت ۲۰۲۶

این نسخه شامل به‌روزرسانی‌های زیر است:

• مشکلی برطرف شد که در آن کیت توسعه نرم‌افزار می‌توانست هنگام استفاده از نقش DEVICE_POLICY_CONTROLLER، درصورتی‌که فرایند کارخواه پس‌از آماده‌سازی موفق محیط بازراه‌اندازی می‌شد، وضعیت قدیمی «نصب‌شده اما آماده نیست» را برگرداند.
• حداقل سطح میانای برنامه‌سازی کاربردی Android پشتیبانی‌شده اکنون ۲۴ است (از ۲۳ افزایش یافته است).

نسخه ۱.۸.۲

‫۱۵ ژوئیه ۲۰۲۶

این نسخه شامل به‌روزرسانی‌های زیر است:

• مشکلی برطرف شد که در آن فراخوانی prepareEnvironment نمی‌توانست «فروشگاه Google Play» را به نسخه لازم به‌روز کند و باعث می‌شد نصب «خط‌مشی دستگاه Android» ناموفق باشد.

نسخه ۱.۸.۱

‫۲ ژوئن ۲۰۲۶

این نسخه شامل به‌روزرسانی‌های زیر است:

• بهبود قابلیت اطمینان و گزارش خطا درطول فرایند نصب برنامه Android Device Policy.
• جریان آماده‌سازی محیط برای بهبود سازگاری و قابلیت اطمینان درطول به‌روزرسانی‌های «فروشگاه Google Play» بهبود یافته است.

نسخه ۱.۸.۰

‫۱۵ آوریل ۲۰۲۶

این نسخه پشتیبانی از شرکای سازنده اصلی محصول را معرفی می‌کند و به کارخواه‌های «بی‌سیم» (OTA) سازنده اصلی محصول اجازه می‌دهد تا درباره به‌روزرسانی‌های سیستم با برنامه Android Device Policy (ADP) ارتباط دوطرفه برقرار کنند.

این نسخه شامل به‌روزرسانی‌های زیر است:

• افزودن میانای OemSystemUpdateClient که به کارخواه‌های OEM OTA اجازه می‌دهد به ADP درباره به‌روزرسانی‌ها اطلاع دهند و دستورالعمل‌ها را پُرسمان کنند. میانای شامل روش‌هایی برای:
  • ایجاد، دریافت، و فهرست کردن به‌روزرسانی‌های سیستم (مثلاً createSystemUpdate، getSystemUpdate، listSystemUpdates).
  • مراحل مختلف فرایند به‌روزرسانی را گزارش می‌کند (برای مثال، reportSystemUpdateDownloading، reportSystemUpdateDownloaded، reportSystemUpdateApplied، reportSystemUpdateAborted).
  • گزارش کنش‌های انجام‌شده هنگام لغو دستورالعمل‌های AMAPI یا زمانی که از رعایت آن‌ها جلوگیری می‌شود (برای مثال، reportSystemUpdateDownloadingWithOverride، reportSystemUpdateDownloadPrevented).
  • مدیریت و پرسمان وضعیت کنترل به‌روزرسانی (برای مثال، updateUpdateControlState، getUpdateControlState).
• رابط OemSystemUpdateHandler را اضافه کنید که مشتریان OEM OTA باید برای دریافت فراخوانی‌های برگشتی از ADP پیاده‌سازی کنند. این شامل موارد زیر می‌شود:
  • onSystemUpdatesChanged: به کارخواه «سازنده تجهیزات اصلی» درباره تغییرات دستورالعمل‌های به‌روزرسانی اطلاع می‌دهد.
  • ‫listPendingSystemUpdates: توسط ADP برای درخواست فهرست به‌روزرسانی‌های معلقه فراخوانده شده است.
  • getUpdateControlState: توسط ADP برای بازیابی وضعیت کنترل به‌روزرسانی فعلی مشتری سازنده اصلی محصول فراخوانده شده است.

توجه: درحال‌حاضر، ADP درخواست‌های شرکای OEM را برآورده نمی‌کند، زیرا انتظار می‌رود عملکرد پلاتفرم مربوطه با Android 17 منتشر شود. بااین‌حال، شرکا می‌توانند از همین حالا ادغام با آن را شروع کنند، زیرا پس‌از پشتیبانی کامل از این ویژگی، نیازی به هیچ تغییری نخواهد بود.

نسخه ۱.۷.۱

‫۱۹ ژانویه ۲۰۲۶

این نسخه شامل به‌روزرسانی‌های زیر است:

• اشکالی که مانع از فراخوانی prepareEnvironment توسط برنامه‌ها در Android 8 یا پایین‌تر هنگام استفاده از نقش DEVICE_POLICY_CONTROLLER می‌شد برطرف شد. نقش‌های دیگر همچنان به Android نسخه ۱۰ یا بالاتر نیاز دارند.
• بهبود گزارش‌گیری برای تشخیص بهتر خرابی. توصیه می‌کنیم شرکا این نسخه را اتخاذ کنند.

نسخه ۱.۷.۰

‫۳ نوامبر ۲۰۲۵

این نسخه شامل به‌روزرسانی‌های زیر است:

• ManagementProviderInfo را به نشان‌های اعتماد دستگاه دردسترس اضافه کنید، که حاوی نام کسب‌وکار قابل‌خواندن برای انسان ارائه‌دهنده مدیریت است.
• معرفی فرمان REQUEST_DEVICE_INFO برای مجاز کردن برنامه‌های DPC به خواندن EID دستگاه. IssueCommandRequest را با نوع RequestDeviceInfo فراخوانی کنید و DeviceInfo.EID را به‌عنوان شناسه دستگاه درخواست‌شده مشخص کنید.
• برای رفع مشکل CVE-2023-2976، وابستگی‌ها را به‌روز کنید.

نسخه 1.7.0-rc01

‫۲۹ سپتامبر ۲۰۲۵

این نسخه شامل به‌روزرسانی‌های زیر است:

• ManagementProviderInfo را به نشان‌های اعتماد دستگاه دردسترس اضافه کنید، که حاوی نام کسب‌وکار قابل‌خواندن برای انسان ارائه‌دهنده مدیریت است.
• معرفی فرمان REQUEST_DEVICE_INFO برای اینکه برنامه‌های DPC بتوانند EID دستگاه را بخوانند. IssueCommandRequest را با نوع RequestDeviceInfo فراخوانی کنید و DeviceInfo.EID را به‌عنوان شناسه دستگاه درخواست‌شده مشخص کنید.

نسخه ۱.۶.۰

‫۱۱ سپتامبر ۲۰۲۵

این نسخه شامل به‌روزرسانی‌های زیر است:

• معرفی امکان نصب برنامه‌های سفارشی برای EMMهایی که از Android Management API استفاده می‌کنند. مدیریت برنامه‌های سفارشی با AMAPI را ببینید.
• سیستم جدیدی برای اختصاص دادن نقش به برنامه‌ها معرفی کنید. مدیریت نقش‌های برنامه را ببینید.
• minSDK را به سطح میانای برنامه‌سازی کاربردی ۲۳ افزایش دهید.

نسخه 1.6.0-rc01

‫۲۸ اوت ۲۰۲۵

این نسخه شامل به‌روزرسانی‌های زیر است:

• معرفی امکان نصب برنامه‌های سفارشی برای EMMهایی که از Android Management API استفاده می‌کنند. مدیریت برنامه‌های سفارشی با AMAPI را ببینید.
• minSDK را به سطح میانای برنامه‌سازی کاربردی ۲۳ افزایش دهید.

نسخه ۱.۵.۰

‫۱۱ اوت ۲۰۲۵

این نسخه شامل به‌روزرسانی‌های زیر است:

• بهبود جریان ثبت دستگاه برای «کنترل‌کننده‌های خط‌مشی دستگاه» (DPC) سفارشی. این رویکرد ساده‌شده از کیت توسعه نرم‌افزار AMAPI و برنامه Android Device Policy (ADP) برای ساده‌سازی ثبت‌نام دستگاه استفاده می‌کند.
• بهبود پایداری و عملکرد با اطلاعات بیشتر دردسترس در استثناهای اعتماد دستگاه؛ AmapiSdkException را ببینید.

نسخه 1.5.0-rc01

‫۲۴ ژوئیه ۲۰۲۵

این نسخه جریان ثبت‌نام دستگاه بهبودیافته‌ای را برای «کنترل‌کننده‌های خط‌مشی دستگاه» (DPC) سفارشی معرفی می‌کند. این رویکرد ساده‌شده از کیت توسعه نرم‌افزار AMAPI و برنامه Android Device Policy (ADP) برای ساده‌سازی ثبت‌نام دستگاه استفاده می‌کند.

نسخه ۱.۴.۰

‫۱۸ ژوئن ۲۰۲۵

این نسخه شامل سیگنال Device.WorkProfileState برای شناسایی وضعیت مدیریت دستگاه است.

تفاوتی با v1.4.0-rc01 ندارد.

مهم: دسترسی به نشان‌های اعتماد دستگاه بااستفاده از فهرست مجاز محدود شده است تا از استفاده غیرمجاز جلوگیری شود. برای اطلاعات بیشتر، به این مقاله مراجعه کنید: Device Trust از Android Enterprise - دسترسی به میانای برنامه‌سازی کاربردی.

نسخه 1.4.0-rc01

‫۲ ژوئن ۲۰۲۵

این نسخه شامل سیگنال Device.WorkProfileState برای شناسایی وضعیت مدیریت دستگاه است.

نسخه ۱.۳.۰

‫۱۴ آوریل ۲۰۲۵

این نسخه شامل اولین انتشار Device Trust از Android Enterprise است.

تفاوتی با v1.3.0-rc01 ندارد.

مهم: دسترسی به نشان‌های اعتماد دستگاه بااستفاده از فهرست مجاز محدود شده است تا از استفاده غیرمجاز جلوگیری شود. برای اطلاعات بیشتر، به این مقاله مراجعه کنید: Device Trust از Android Enterprise - دسترسی به میانای برنامه‌سازی کاربردی.

نسخه 1.3.0-rc01

‫۱۸ فوریه ۲۰۲۵

این نسخه شامل اولین نامزد انتشار برای Device Trust از Android Enterprise است.

• بسته سیگنال اعتماد دستگاه جدید com.google.android.managementapi.device
• بسته New Environment com.google.android.managementapi.environment برای راه‌اندازی دستگاه برای Device Trust از Android Enterprise و، درصورت لزوم، برای نصب یا به‌روزرسانی برنامه Android Device Policy.

نسخه ۱.۱.۵

‫۱۳ مه ۲۰۲۴

این نسخه شامل به‌روزرسانی‌های زیر است:

• رفع اشکال‌ها و بهبودهای داخلی.

نسخه ۱.۱.۴

‫۲۴ ژانویه ۲۰۲۴

این نسخه شامل به‌روزرسانی‌های زیر است:

• بسته جدید «انتقال DPC» com.google.android.managementapi.dpcmigration برای پشتیبانی از انتقال دستگاه به AMAPI. برای اطلاعات بیشتر، می‌توانید راهنمای انتقال دستگاه‌های موجود به AMAPI را مرور کنید.

نسخه ۱.۰.۱

‫۱۵ فوریه ۲۰۲۲

این نسخه شامل به‌روزرسانی‌های زیر است:

• رفع اشکال‌ها و بهبودهای داخلی.

نسخه ۱.۰.۰

۲۰ سپتامبر ۲۰۲۱

این نسخه شامل به‌روزرسانی‌های زیر است:

• نسخهٔ پخش اولیه.