کلاینت به‌روزرسانی سیستم Oem 

public interface OemSystemUpdateClient

کلاینتی برای برنامه‌های OEM جهت تعامل با API مدیریت اندروید در رابطه با به‌روزرسانی‌های سیستم از طریق بی‌سیم (OTA).

به کلاینت‌های OTA این امکان را می‌دهد که دستورالعمل‌های تعیین‌شده توسط سیاست را بازیابی کرده و وضعیت مربوط به به‌روزرسانی‌های سیستم را گزارش دهند.

تماس‌ها با استفاده از این کلاینت از کلاینت OTA به کامپوننت درون دستگاهی API مدیریت اندروید انجام می‌شوند.

خلاصه

روش‌های عمومی

abstract @ NonNull SystemUpdate

یک منبع SystemUpdate جدید به AMAPI ارائه می‌دهد.

abstract @ NonNull ListenableFuture <@ NonNull SystemUpdate >

یک منبع SystemUpdate جدید به AMAPI ارائه می‌دهد.

abstract @ NonNull SystemUpdate

یک منبع SystemUpdate که قبلاً توسط کلاینت OTA تنظیم شده است را بازیابی می‌کند.

abstract @ NonNull ListenableFuture <@ NonNull SystemUpdate >

یک منبع SystemUpdate که قبلاً توسط کلاینت OTA تنظیم شده است را بازیابی می‌کند.

abstract @ NonNull UpdateControlState

وضعیت کنترل به‌روزرسانی سیستم فعلی را دریافت می‌کند.

abstract @ NonNull ListenableFuture <@ NonNull UpdateControlState >

وضعیت کنترل به‌روزرسانی سیستم فعلی را دریافت می‌کند.

abstract @ NonNull ListSystemUpdatesResponse

لیستی از تمام منابع SystemUpdate که قبلاً توسط کلاینت OTA تنظیم شده‌اند را بازیابی می‌کند.

abstract @ NonNull ListenableFuture <@ NonNull ListSystemUpdatesResponse >

لیستی از تمام منابع SystemUpdate که قبلاً توسط کلاینت OTA تنظیم شده‌اند را بازیابی می‌کند.

abstract @ NonNull ReportSystemUpdateAbortedResponse

گزارش می‌دهد که به‌روزرسانی سیستم لغو شده است.

abstract @ NonNull ListenableFuture <@ NonNull ReportSystemUpdateAbortedResponse >

گزارش می‌دهد که به‌روزرسانی سیستم لغو شده است.

abstract @ NonNull ReportSystemUpdateAppliedResponse

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

abstract @ NonNull ListenableFuture <@ NonNull ReportSystemUpdateAppliedResponse >

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

abstract @ NonNull ReportSystemUpdateAppliedWithOverrideResponse

گزارش می‌دهد که به‌روزرسانی سیستم اعمال شده است و دستورالعمل‌های AMAPI را نادیده می‌گیرد.

abstract @ NonNull ListenableFuture <@ NonNull ReportSystemUpdateAppliedWithOverrideResponse >

گزارش می‌دهد که به‌روزرسانی سیستم اعمال شده است و دستورالعمل‌های AMAPI را نادیده می‌گیرد.

abstract @ NonNull ReportSystemUpdateApplyPreventedResponse

از گزارش‌هایی مبنی بر اعمال به‌روزرسانی سیستم جلوگیری می‌شود.

abstract @ NonNull ListenableFuture <@ NonNull ReportSystemUpdateApplyPreventedResponse >

از گزارش‌هایی مبنی بر اعمال به‌روزرسانی سیستم جلوگیری می‌شود.

abstract @ NonNull ReportSystemUpdateDownloadPreventedResponse

گزارش می‌دهد که از دانلود به‌روزرسانی سیستم جلوگیری می‌شود.

abstract @ NonNull ListenableFuture <@ NonNull ReportSystemUpdateDownloadPreventedResponse >

گزارش می‌دهد که از دانلود به‌روزرسانی سیستم جلوگیری می‌شود.

abstract @ NonNull ReportSystemUpdateDownloadedResponse

گزارش می‌دهد که به‌روزرسانی سیستم با موفقیت دانلود شده است.

abstract @ NonNull ListenableFuture <@ NonNull ReportSystemUpdateDownloadedResponse >

گزارش می‌دهد که به‌روزرسانی سیستم با موفقیت دانلود شده است.

abstract @ NonNull ReportSystemUpdateDownloadedWithOverrideResponse

گزارش می‌دهد که به‌روزرسانی سیستم دانلود شده است و دستورالعمل‌های AMAPI را نادیده می‌گیرد.

abstract @ NonNull ListenableFuture <@ NonNull ReportSystemUpdateDownloadedWithOverrideResponse >

گزارش می‌دهد که به‌روزرسانی سیستم دانلود شده است و دستورالعمل‌های AMAPI را نادیده می‌گیرد.

abstract @ NonNull ReportSystemUpdateDownloadingResponse

گزارش می‌دهد که دانلود به‌روزرسانی سیستم آغاز شده است.

abstract @ NonNull ListenableFuture <@ NonNull ReportSystemUpdateDownloadingResponse >

گزارش می‌دهد که دانلود به‌روزرسانی سیستم آغاز شده است.

abstract @ NonNull ReportSystemUpdateDownloadingWithOverrideResponse

گزارش می‌دهد که دانلود به‌روزرسانی سیستم آغاز شده است و دستورالعمل‌های AMAPI را لغو می‌کند.

abstract @ NonNull ListenableFuture <@ NonNull ReportSystemUpdateDownloadingWithOverrideResponse >

گزارش می‌دهد که دانلود به‌روزرسانی سیستم آغاز شده است و دستورالعمل‌های AMAPI را لغو می‌کند.

abstract @ NonNull UpdateControlState

وضعیت کنترل به‌روزرسانی سیستم را به‌روزرسانی می‌کند.

abstract @ NonNull ListenableFuture <@ NonNull UpdateControlState >

وضعیت کنترل به‌روزرسانی سیستم را به‌روزرسانی می‌کند.

روش‌های عمومی

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

abstract @NonNull SystemUpdate createSystemUpdate(@NonNull CreateSystemUpdateRequest request)

یک منبع SystemUpdate جدید به AMAPI ارائه می‌دهد.

شیء SystemUpdate در request فقط باید شامل فیلدهایی باشد که متعلق به کلاینت OTA هستند. فیلدهایی که در SystemUpdate به عنوان فقط خروجی علامت‌گذاری شده‌اند (مثلاً instruction ) در صورت ارائه در درخواست، نادیده گرفته می‌شوند.

پاسخ شامل یک شیء SystemUpdate است که با فیلدهای فقط خروجی مانند instruction تعیین‌شده توسط AMAPI بر اساس سیاست، تکمیل شده است.

پارامترها
@ NonNull CreateSystemUpdateRequest request

درخواست CreateSystemUpdateRequest که شامل شیء SystemUpdate برای ایجاد است.

بازگشت‌ها
@ NonNull SystemUpdate

یک شیء کامل SystemUpdate ، شامل فیلدهای دستورالعمل فقط خروجی.

پرتاب‌ها
com.google.android.managementapi.oemsystemupdate.UpdateControlStateRequiredException

اگر UpdateControlState برابر با UpdateControlState.ControlState.UNIFIED_UPDATE_CONTROL نباشد.

اگر به‌روزرسانی سیستمی با همین نام از قبل وجود داشته باشد، SystemUpdateAlreadyExistsException می‌دهد.

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

اگر درخواست ناقص باشد، InvalidArgumentException می‌دهد.

java.lang.SecurityException

java.lang.SecurityException اگر کلاینت OTA مجاز به فراخوانی این API نباشد.

اگر برنامه‌ی خط‌مشی دستگاه اندروید نیاز به به‌روزرسانی داشته باشد، AndroidDevicePolicyAppNotUpdatedException می‌دهد.

اگر خطای داخلی رخ دهد، InternalException رخ می‌دهد.

TimeoutException

java.util.concurrent.TimeoutException اگر یک timeout رخ دهد.

استثنای پایه AmapiSdkException برای همه خطاهای دیگر.

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

abstract @NonNull ListenableFuture<@NonNull SystemUpdate> createSystemUpdateFuture(@NonNull CreateSystemUpdateRequest request)

یک منبع SystemUpdate جدید به AMAPI ارائه می‌دهد. این مشابه createSystemUpdate است، اما به جای تعلیق، ListenableFuture برمی‌گرداند.

پارامترها
@ NonNull CreateSystemUpdateRequest request

درخواست CreateSystemUpdateRequest که شامل شیء SystemUpdate برای ایجاد است.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull SystemUpdate >

یک ListenableFuture از شیء کامل SystemUpdate ، که با فیلدهای فقط خروجی مانند instruction تعیین‌شده توسط AMAPI بر اساس سیاست‌هایش تکمیل شده است. آینده ممکن است با موارد زیر شکست بخورد:

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

abstract @NonNull SystemUpdate getSystemUpdate(@NonNull GetSystemUpdateRequest request)

یک منبع SystemUpdate که قبلاً توسط کلاینت OTA تنظیم شده است را بازیابی می‌کند.

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

پارامترها
@ NonNull GetSystemUpdateRequest request

درخواستی که شامل نام منبع و نمای مورد نظر برای منبع است.

بازگشت‌ها
@ NonNull SystemUpdate

یک شیء SystemUpdate که مطابق با نمای درخواستی، مقداردهی می‌شود.

پرتاب‌ها

اگر به‌روزرسانی سیستم پیدا نشود، SystemUpdateNotFoundException می‌دهد.

اگر وضعیت کنترل به‌روزرسانی پیدا نشود، UpdateControlStateNotFoundException می‌دهد.

اگر گذار وضعیت به‌روزرسانی سیستم نامعتبر باشد، InvalidSystemUpdateStateException رخ می‌دهد.

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

اگر درخواست ناقص باشد، InvalidArgumentException می‌دهد.

java.lang.SecurityException

java.lang.SecurityException اگر کلاینت OTA مجاز به فراخوانی این API نباشد.

اگر برنامه‌ی خط‌مشی دستگاه اندروید نیاز به به‌روزرسانی داشته باشد، AndroidDevicePolicyAppNotUpdatedException می‌دهد.

اگر خطای داخلی رخ دهد، InternalException رخ می‌دهد.

TimeoutException

java.util.concurrent.TimeoutException اگر یک timeout رخ دهد.

استثنای پایه AmapiSdkException برای همه خطاهای دیگر.

دریافت سیستم به روز رسانی آینده 

abstract @NonNull ListenableFuture<@NonNull SystemUpdate> getSystemUpdateFuture(@NonNull GetSystemUpdateRequest request)

یک منبع SystemUpdate که قبلاً توسط کلاینت OTA تنظیم شده است را بازیابی می‌کند. این مشابه getSystemUpdate است، اما به جای تعلیق، ListenableFuture برمی‌گرداند.

پارامترها
@ NonNull GetSystemUpdateRequest request

درخواستی که شامل نام منبع و نمای مورد نظر برای منبع است.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull SystemUpdate >

یک شیء ListenableFuture از SystemUpdate که بر اساس view درخواستی پر شده است. تابع future ممکن است با موارد زیر با شکست مواجه شود:

دریافت وضعیت کنترل 

abstract @NonNull UpdateControlState getUpdateControlState(@NonNull GetUpdateControlStateRequest request)

وضعیت فعلی کنترل به‌روزرسانی سیستم را دریافت می‌کند. کلاینت OTA تولیدکننده اصلی تجهیزات (OEM) از این متد برای بازیابی وضعیت فعلی راهکار کنترل به‌روزرسانی که AMAPI از آن آگاه است، استفاده می‌کند.

پارامترها
@ NonNull GetUpdateControlStateRequest request

یک GetUpdateControlStateRequest خالی.

بازگشت‌ها
@ NonNull UpdateControlState

UpdateControlState فعلی برای دستگاه.

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

دریافتUpdateControlStateFuture 

abstract @NonNull ListenableFuture<@NonNull UpdateControlState> getUpdateControlStateFuture(
    @NonNull GetUpdateControlStateRequest request
)

وضعیت فعلی کنترل به‌روزرسانی سیستم را دریافت می‌کند. کلاینت OTA تولیدکننده اصلی تجهیزات (OEM) از این متد برای بازیابی وضعیت فعلی راهکار کنترل به‌روزرسانی که AMAPI از آن آگاه است، استفاده می‌کند.

پارامترها
@ NonNull GetUpdateControlStateRequest request

یک GetUpdateControlStateRequest خالی.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull UpdateControlState >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به UpdateControlState فعلی برای دستگاه تبدیل می‌شود. تابع future ممکن است با موارد زیر با شکست مواجه شود:

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

abstract @NonNull ListSystemUpdatesResponse listSystemUpdates(@NonNull ListSystemUpdatesRequest request)

لیستی از تمام منابع SystemUpdate که قبلاً توسط کلاینت OTA تنظیم شده‌اند را بازیابی می‌کند.

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

پارامترها
@ NonNull ListSystemUpdatesRequest request

درخواستی که شامل نمای مورد نظر برای منابع است.

بازگشت‌ها
@ NonNull ListSystemUpdatesResponse

یک ListSystemUpdatesResponse حاوی فهرستی از اشیاء SystemUpdate که بر اساس نمای درخواستی پر شده‌اند.

پرتاب‌ها
com.google.android.managementapi.oemsystemupdate.UpdateControlStateRequiredException

اگر UpdateControlState برابر با UpdateControlState.ControlState.UNIFIED_UPDATE_CONTROL نباشد.

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

اگر درخواست ناقص باشد، InvalidArgumentException می‌دهد.

java.lang.SecurityException

java.lang.SecurityException اگر کلاینت OTA مجاز به فراخوانی این API نباشد.

اگر برنامه‌ی خط‌مشی دستگاه اندروید نیاز به به‌روزرسانی داشته باشد، AndroidDevicePolicyAppNotUpdatedException می‌دهد.

اگر خطای داخلی رخ دهد، InternalException رخ می‌دهد.

TimeoutException

java.util.concurrent.TimeoutException اگر یک timeout رخ دهد.

استثنای پایه AmapiSdkException برای همه خطاهای دیگر.

listSystemUpdatesFuture 

abstract @NonNull ListenableFuture<@NonNull ListSystemUpdatesResponse> listSystemUpdatesFuture(@NonNull ListSystemUpdatesRequest request)

لیستی از تمام منابع SystemUpdate که قبلاً توسط کلاینت OTA تنظیم شده‌اند را بازیابی می‌کند. این همان listSystemUpdates است، اما به جای تعلیق، ListenableFuture برمی‌گرداند.

پارامترها
@ NonNull ListSystemUpdatesRequest request

درخواستی که شامل نمای مورد نظر برای منابع است.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull ListSystemUpdatesResponse >

یک ListenableFuture از ListSystemUpdatesResponse که شامل لیستی از اشیاء SystemUpdate است که بر اساس view درخواستی پر شده‌اند. future ممکن است با موارد زیر با شکست مواجه شود:

گزارشSystemUpdateلغو شد 

abstract @NonNull ReportSystemUpdateAbortedResponse reportSystemUpdateAborted(
    @NonNull ReportSystemUpdateAbortedRequest request
)

گزارش می‌دهد که به‌روزرسانی سیستم لغو شده است.

این متد زمانی فراخوانی می‌شود که کلاینت OTA فرآیند به‌روزرسانی سیستم را متوقف کند. درخواست باید شامل نام منبع به‌روزرسانی سیستم و توجیهی برای لغو آن باشد. این یک حالت پایانی برای به‌روزرسانی است.

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

گزارشSystemUpdateAbortedFuture 

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAbortedResponse> reportSystemUpdateAbortedFuture(
    @NonNull ReportSystemUpdateAbortedRequest request
)

گزارش می‌دهد که به‌روزرسانی سیستم لغو شده است.

این متد زمانی فراخوانی می‌شود که کلاینت OTA فرآیند به‌روزرسانی سیستم را متوقف کند. درخواست باید شامل نام منبع به‌روزرسانی سیستم و توجیهی برای لغو آن باشد. این یک حالت پایانی برای به‌روزرسانی است.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull ReportSystemUpdateAbortedResponse >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به ReportSystemUpdateAbortedResponse ختم می‌شود. Future ممکن است با موارد زیر با شکست مواجه شود:

گزارشSystemUpdateApplied 

abstract @NonNull ReportSystemUpdateAppliedResponse reportSystemUpdateApplied(
    @NonNull ReportSystemUpdateAppliedRequest request
)

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

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

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

گزارشSystemUpdateAppliedFuture 

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedResponse> reportSystemUpdateAppliedFuture(
    @NonNull ReportSystemUpdateAppliedRequest request
)

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

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

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull ReportSystemUpdateAppliedResponse >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به ReportSystemUpdateAppliedResponse تبدیل می‌شود. Future ممکن است با موارد زیر با شکست مواجه شود:

گزارشSystemUpdateAppliedWithOverride 

abstract @NonNull ReportSystemUpdateAppliedWithOverrideResponse reportSystemUpdateAppliedWithOverride(
    @NonNull ReportSystemUpdateAppliedWithOverrideRequest request
)

گزارش می‌دهد که به‌روزرسانی سیستم اعمال شده است و دستورالعمل‌های AMAPI را نادیده می‌گیرد.

این متد زمانی فراخوانی می‌شود که کلاینت OTA به‌روزرسانی سیستم را برخلاف دستورالعمل BLOCK از API مدیریت اندروید اعمال کند. درخواست باید شامل نام منبع به‌روزرسانی سیستم و توجیهی برای لغو آن باشد. این یک حالت پایانی برای به‌روزرسانی است.

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

گزارشSystemUpdateAppliedWithOverrideFuture 

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedWithOverrideResponse> reportSystemUpdateAppliedWithOverrideFuture(
    @NonNull ReportSystemUpdateAppliedWithOverrideRequest request
)

گزارش می‌دهد که به‌روزرسانی سیستم اعمال شده است و دستورالعمل‌های AMAPI را نادیده می‌گیرد.

این متد زمانی فراخوانی می‌شود که کلاینت OTA به‌روزرسانی سیستم را برخلاف دستورالعمل BLOCK از API مدیریت اندروید اعمال کند. درخواست باید شامل نام منبع به‌روزرسانی سیستم و توجیهی برای لغو آن باشد. این یک حالت پایانی برای به‌روزرسانی است.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull ReportSystemUpdateAppliedWithOverrideResponse >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به ReportSystemUpdateAppliedWithOverrideResponse تبدیل می‌شود. Future ممکن است با موارد زیر با شکست مواجه شود:

گزارشSystemUpdateApplyPrevented 

abstract @NonNull ReportSystemUpdateApplyPreventedResponse reportSystemUpdateApplyPrevented(
    @NonNull ReportSystemUpdateApplyPreventedRequest request
)

از گزارش‌هایی مبنی بر اعمال به‌روزرسانی سیستم جلوگیری می‌شود.

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

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

گزارشSystemUpdateApplyPreventedFuture 

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateApplyPreventedResponse> reportSystemUpdateApplyPreventedFuture(
    @NonNull ReportSystemUpdateApplyPreventedRequest request
)

از گزارش‌هایی مبنی بر اعمال به‌روزرسانی سیستم جلوگیری می‌شود.

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

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull ReportSystemUpdateApplyPreventedResponse >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به ReportSystemUpdateApplyPreventedResponse ختم می‌شود. تابع future ممکن است با موارد زیر با شکست مواجه شود:

گزارشبه‌روزرسانیسیستمدانلودپیشگیری‌شده 

abstract @NonNull ReportSystemUpdateDownloadPreventedResponse reportSystemUpdateDownloadPrevented(
    @NonNull ReportSystemUpdateDownloadPreventedRequest request
)

گزارش می‌دهد که از دانلود به‌روزرسانی سیستم جلوگیری می‌شود.

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

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

گزارشبه‌روزرسانی سیستمدانلودپیشگیری‌شدهآینده 

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadPreventedResponse> reportSystemUpdateDownloadPreventedFuture(
    @NonNull ReportSystemUpdateDownloadPreventedRequest request
)

گزارش می‌دهد که از دانلود به‌روزرسانی سیستم جلوگیری می‌شود.

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

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull ReportSystemUpdateDownloadPreventedResponse >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به ReportSystemUpdateDownloadPreventedResponse تبدیل می‌شود. Future ممکن است با موارد زیر با شکست مواجه شود:

گزارشبه‌روزرسانی سیستمدانلود شد 

abstract @NonNull ReportSystemUpdateDownloadedResponse reportSystemUpdateDownloaded(
    @NonNull ReportSystemUpdateDownloadedRequest request
)

گزارش می‌دهد که به‌روزرسانی سیستم با موفقیت دانلود شده است.

این متد باید زمانی فراخوانی شود که کلاینت OTA دانلود به‌روزرسانی سیستم را طبق دستورالعمل API مدیریت اندروید تکمیل کند. درخواست باید شامل نام منبع به‌روزرسانی سیستم دانلود شده باشد.

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

گزارشسیستم‌به‌روزرسانیدانلودشدهآینده 

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedResponse> reportSystemUpdateDownloadedFuture(
    @NonNull ReportSystemUpdateDownloadedRequest request
)

گزارش می‌دهد که به‌روزرسانی سیستم با موفقیت دانلود شده است.

این متد باید زمانی فراخوانی شود که کلاینت OTA دانلود به‌روزرسانی سیستم را طبق دستورالعمل API مدیریت اندروید تکمیل کند. درخواست باید شامل نام منبع به‌روزرسانی سیستم دانلود شده باشد.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull ReportSystemUpdateDownloadedResponse >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به ReportSystemUpdateDownloadedResponse تبدیل می‌شود. Future ممکن است با موارد زیر با شکست مواجه شود:

گزارشبه‌روزرسانیسیستمدانلودشدهباحذف 

abstract @NonNull ReportSystemUpdateDownloadedWithOverrideResponse reportSystemUpdateDownloadedWithOverride(
    @NonNull ReportSystemUpdateDownloadedWithOverrideRequest request
)

گزارش می‌دهد که به‌روزرسانی سیستم دانلود شده است و دستورالعمل‌های AMAPI را نادیده می‌گیرد.

این متد زمانی فراخوانی می‌شود که کلاینت OTA دانلود به‌روزرسانی سیستم را تکمیل کند و دستورالعمل BLOCK را از API مدیریت اندروید لغو کند. درخواست باید شامل نام منبع به‌روزرسانی سیستم و توجیهی برای لغو آن باشد.

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

گزارشSystemUpdateDownloadedWithOverrideFuture 

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedWithOverrideResponse> reportSystemUpdateDownloadedWithOverrideFuture(
    @NonNull ReportSystemUpdateDownloadedWithOverrideRequest request
)

گزارش می‌دهد که به‌روزرسانی سیستم دانلود شده است و دستورالعمل‌های AMAPI را نادیده می‌گیرد.

این متد زمانی فراخوانی می‌شود که کلاینت OTA دانلود به‌روزرسانی سیستم را تکمیل کند و دستورالعمل BLOCK را از API مدیریت اندروید لغو کند. درخواست باید شامل نام منبع به‌روزرسانی سیستم و توجیهی برای لغو آن باشد.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull ReportSystemUpdateDownloadedWithOverrideResponse >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به ReportSystemUpdateDownloadedWithOverrideResponse تبدیل می‌شود. Future ممکن است با موارد زیر با شکست مواجه شود:

گزارشبه‌روزرسانی سیستمدر حال دانلود 

abstract @NonNull ReportSystemUpdateDownloadingResponse reportSystemUpdateDownloading(
    @NonNull ReportSystemUpdateDownloadingRequest request
)

گزارش می‌دهد که دانلود به‌روزرسانی سیستم آغاز شده است.

این متد باید زمانی فراخوانی شود که کلاینت OTA دانلود به‌روزرسانی سیستم را مطابق با دستورالعمل‌های دریافتی از API مدیریت اندروید آغاز یا از سر می‌گیرد. درخواست باید حاوی نام منبع به‌روزرسانی سیستم در حال دانلود باشد.

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

گزارشبه‌روزرسانیسیستمدانلودآینده 

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingResponse> reportSystemUpdateDownloadingFuture(
    @NonNull ReportSystemUpdateDownloadingRequest request
)

گزارش می‌دهد که دانلود به‌روزرسانی سیستم آغاز شده است.

این متد باید زمانی فراخوانی شود که کلاینت OTA دانلود به‌روزرسانی سیستم را مطابق با دستورالعمل‌های دریافتی از API مدیریت اندروید آغاز یا از سر می‌گیرد. درخواست باید حاوی نام منبع به‌روزرسانی سیستم در حال دانلود باشد.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull ReportSystemUpdateDownloadingResponse >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به ReportSystemUpdateDownloadingResponse تبدیل می‌شود. Future ممکن است با موارد زیر با شکست مواجه شود:

گزارشبه‌روزرسانیسیستمدر حال دانلودبا لغو 

abstract @NonNull ReportSystemUpdateDownloadingWithOverrideResponse reportSystemUpdateDownloadingWithOverride(
    @NonNull ReportSystemUpdateDownloadingWithOverrideRequest request
)

گزارش می‌دهد که دانلود به‌روزرسانی سیستم آغاز شده است و دستورالعمل‌های AMAPI را لغو می‌کند.

این متد باید زمانی فراخوانی شود که کلاینت OTA شروع به دانلود به‌روزرسانی سیستم می‌کند، حتی اگر دستورالعمل API مدیریت اندروید مسدود کردن دانلود باشد. درخواست باید شامل نام منبع به‌روزرسانی سیستم و توجیهی برای لغو آن باشد.

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

گزارشبه‌روزرسانیسیستمدر حال دانلودباOverrideآینده 

abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingWithOverrideResponse> reportSystemUpdateDownloadingWithOverrideFuture(
    @NonNull ReportSystemUpdateDownloadingWithOverrideRequest request
)

گزارش می‌دهد که دانلود به‌روزرسانی سیستم آغاز شده است و دستورالعمل‌های AMAPI را لغو می‌کند.

این متد باید زمانی فراخوانی شود که کلاینت OTA شروع به دانلود به‌روزرسانی سیستم می‌کند، حتی اگر دستورالعمل API مدیریت اندروید مسدود کردن دانلود باشد. درخواست باید شامل نام منبع به‌روزرسانی سیستم و توجیهی برای لغو آن باشد.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull ReportSystemUpdateDownloadingWithOverrideResponse >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به ReportSystemUpdateDownloadingWithOverrideResponse تبدیل می‌شود. تابع future ممکن است با موارد زیر با شکست مواجه شود:

updateUpdateControlState 

abstract @NonNull UpdateControlState updateUpdateControlState(
    @NonNull UpdateUpdateControlStateRequest request
)

وضعیت کنترل به‌روزرسانی سیستم را به‌روزرسانی می‌کند. کلاینت OTA تولیدکننده اصلی (OEM) از این متد برای گزارش هرگونه تغییر در وضعیت کنترل به‌روزرسانی استفاده می‌کند. کلاینت تولیدکننده اصلی (OEM) باید هر زمان که وضعیت کنترل تغییر می‌کند، این متد را فراخوانی کند.

پارامترها
@ NonNull UpdateUpdateControlStateRequest request

درخواستی که حاوی UpdateControlState جدید است.

بازگشت‌ها
@ NonNull UpdateControlState

UpdateControlState به‌روزرسانی‌شده.

پرتاب‌ها

اگر سطح API دستگاه پایین‌تر از Tiramisu (سطح API 33) باشد، ApiLevelException .

اگر برنامه‌ی Android Device Policy نصب نشده باشد، AndroidDevicePolicyAppNotInstalledException می‌دهد.

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

اگر دستگاه توسط سازمان مدیریت نشود، DeviceNotManagedException می‌دهد.

updateUpdateControlStateFuture 

abstract @NonNull ListenableFuture<@NonNull UpdateControlState> updateUpdateControlStateFuture(
    @NonNull UpdateUpdateControlStateRequest request
)

وضعیت کنترل به‌روزرسانی سیستم را به‌روزرسانی می‌کند. کلاینت OTA تولیدکننده اصلی (OEM) از این متد برای گزارش هرگونه تغییر در وضعیت کنترل به‌روزرسانی استفاده می‌کند. کلاینت تولیدکننده اصلی (OEM) باید هر زمان که وضعیت کنترل تغییر می‌کند، این متد را فراخوانی کند.

پارامترها
@ NonNull UpdateUpdateControlStateRequest request

درخواستی که حاوی UpdateControlState جدید است.

بازگشت‌ها
@ NonNull ListenableFuture <@ NonNull UpdateControlState >

یک ListenableFuture که در صورت موفقیت‌آمیز بودن فراخوانی، به UpdateControlState به‌روزرسانی‌شده تبدیل می‌شود. Future ممکن است با موارد زیر با شکست مواجه شود: