DpcMigrationClient

کاتلین | جاوا

public interface DpcMigrationClient

---

مشتری برای ایجاد درخواست های مربوط به مهاجرت dpc.

خلاصه

روش های عمومی
abstract @ NonNull ListenableFuture < DpcMigrationAttempt >	getMigrationAttempt ( @ NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) تلاش برای مهاجرت دریافت می کند.
abstract DpcMigrationAttempt	getMigrationAttemptAwait ( @ NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) تلاش برای مهاجرت دریافت می کند.
abstract @ NonNull ListenableFuture <@ NonNull List <@ NonNull DpcMigrationAttempt >>	listMigrationAttempts () فهرستی از تمام تلاش‌های مهاجرت را برمی‌گرداند.
abstract @ NonNull List <@ NonNull DpcMigrationAttempt >	listMigrationAttemptsAwait () فهرستی از تمام تلاش‌های مهاجرت را برمی‌گرداند.
abstract @ NonNull ListenableFuture <@ NonNull DpcMigrationAttempt >	migrateDeviceManagementToAndroidManagementApi ( @ NonNull ComponentName notificationServiceComponentName, @ NonNull ComponentName adminComponentName, @ NonNull DpcMigrationRequest migrationRequest ) این دستگاه را به مدیریت API مدیریت Android منتقل کنید.
abstract @ NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait ( @ NonNull ComponentName notificationServiceComponentName, @ NonNull ComponentName adminComponentName, @ NonNull DpcMigrationRequest migrationRequest ) این دستگاه را به مدیریت API مدیریت Android منتقل کنید.

روش های عمومی

getMigrationAttempt

abstract @NonNull ListenableFuture<DpcMigrationAttempt> getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

تلاش برای مهاجرت دریافت می کند.

اگر نامی در GetDpcMigrationAttemptRequest مشخص نشده باشد، جدیدترین DpcMigrationAttempt برگردانده می شود.

این روش را فقط می‌توان توسط یک Device Owner یا Profile Owner یا یک Device Owner یا Profile Owner که به Android Management API منتقل شده است فراخوانی کرد.

برمی گرداند

@ NonNull ListenableFuture < DpcMigrationAttempt >

ListenableFuture که نتیجه را می پیچد. این میتواند باشد آینده ای موفق که در صورت موفقیت، یک DpcMigrationAttempt را بسته بندی می کند. در صورتی که DpcMigrationAttempt پیدا نشود، یک بسته بندی موفق در آینده تهی است. بسته بندی ناموفق در آینده یک SecurityException ، در صورتی که تماس گیرنده مالک دستگاه یا مالک نمایه نباشد، یا مالک قبلی دستگاه یا مالک نمایه ای نباشد که به API مدیریت Android منتقل شده است. بسته بندی ناموفق در آینده DpcMigrationException اگر تماس مربوط به مهاجرت dpc ناموفق بود. پیام و نوع فرعی استثنا حاوی جزئیات بیشتری در مورد شکست است.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

تلاش برای مهاجرت دریافت می کند.

اگر نامی در GetDpcMigrationAttemptRequest مشخص نشده باشد، جدیدترین DpcMigrationAttempt برگردانده می شود.

این روش را فقط می‌توان توسط یک Device Owner یا Profile Owner یا یک Device Owner یا Profile Owner که به Android Management API منتقل شده است فراخوانی کرد.

برمی گرداند
DpcMigrationAttempt	DpcMigrationAttempt درخواستی یا تهی، اگر پیدا نشد

پرتاب می کند
java.lang.SecurityException	اگر تماس‌گیرنده مالک دستگاه یا مالک نمایه یا مالک قبلی دستگاه یا مالک نمایه نباشد که به API مدیریت Android منتقل شده است.
com.google.android.managementapi.dpcmigration.DpcMigrationException	اگر تماس مربوط به مهاجرت dpc ناموفق بود. پیام و نوع فرعی استثنا حاوی جزئیات بیشتری در مورد شکست است.

listMigrationAttempts

abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> listMigrationAttempts()

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

این روش را فقط می‌توان توسط یک Device Owner یا Profile Owner یا یک Device Owner یا Profile Owner که به Android Management API منتقل شده است فراخوانی کرد. توجه: تلاش‌های مهاجرت قدیمی‌تر به‌طور خودکار حذف می‌شوند و برگردانده نمی‌شوند.

برمی گرداند

@ NonNull ListenableFuture <@ NonNull List <@ NonNull DpcMigrationAttempt >>

ListenableFuture که نتیجه را می پیچد. این میتواند باشد آینده ای موفق که در صورت موفقیت، فهرستی از DpcMigrationAttempt را جمع بندی می کند. بسته بندی ناموفق در آینده یک SecurityException ، در صورتی که تماس گیرنده مالک دستگاه یا مالک نمایه نباشد، یا مالک قبلی دستگاه یا مالک نمایه ای نباشد که به API مدیریت Android منتقل شده است. بسته بندی ناموفق در آینده DpcMigrationException اگر تماس مربوط به مهاجرت dpc ناموفق بود. پیام و نوع فرعی استثنا حاوی جزئیات بیشتری در مورد شکست است.

listMigrationAttemptsAwait

abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()

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

این روش را فقط می‌توان توسط یک Device Owner یا Profile Owner یا یک Device Owner یا Profile Owner که به Android Management API منتقل شده است فراخوانی کرد. توجه: تلاش‌های مهاجرت قدیمی‌تر به‌طور خودکار حذف می‌شوند و برگردانده نمی‌شوند.

برمی گرداند
@ NonNull List <@ NonNull DpcMigrationAttempt >	لیستی از DpcMigrationAttempt

پرتاب می کند
java.lang.SecurityException	اگر تماس‌گیرنده مالک دستگاه یا مالک نمایه یا مالک قبلی دستگاه یا مالک نمایه نباشد که به API مدیریت Android منتقل شده است.
com.google.android.managementapi.dpcmigration.DpcMigrationException	اگر تماس مربوط به مهاجرت dpc ناموفق بود. پیام و نوع فرعی استثنا حاوی جزئیات بیشتری در مورد شکست است.

migrateDeviceManagementToAndroidManagementApi

abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

این دستگاه را به مدیریت API مدیریت Android منتقل کنید.

پس از تکمیل انتقال، برنامه تماس، امتیازات مالک دستگاه یا مالک نمایه خود را از دست می دهد، زیرا این امتیازات به خط مشی دستگاه Android منتقل می شوند.

اخطار: این کار قابل لغو نیست! ListenableFuture برگشتی زمانی تکمیل می‌شود که Android Device Policy درخواست را دریافت کرده و بررسی‌های اولیه روی رمز انتقال را انجام دهد. در صورت شکست ListenableFuture یک Exception می پوشاند.

این روش را فقط می توان توسط یک Device Owner یا Profile Owner فراخوانی کرد. در Android 10 و پایین‌تر، این نباید در دستگاهی با مالک دستگاه و مالک نمایه فراخوانی شود.

شبکه‌های Wi-Fi پیکربندی‌شده باید در DpcMigrationRequest توسط مالک نمایه (به استثنای Android 12) در دستگاه شخصی که هر شبکه Wi-Fi را پیکربندی کرده باشد، ارسال شود. اینها نباید روی دستگاه متعلق به شرکت منتقل شوند. توجه داشته باشید که این شبکه‌های Wi-Fi درست قبل از انتقال مدیریت دستگاه به Android Device Policy حذف خواهند شد. در صورت عدم موفقیت در حذف یک شبکه، مهاجرت نیز با شکست مواجه می شود و از آنجایی که حذف شبکه ها یک عملیات اتمی نیست، ممکن است برخی از شبکه ها قبلا حذف شده باشند.

در دستگاه‌های شخصی با نمایه کاری دارای Android 12، همه شبکه‌های Wi-Fi پیکربندی‌شده توسط DPC تماس‌گیر درست قبل از انتقال مدیریت دستگاه به خط‌مشی دستگاه Android، بدون توجه به شبکه‌های Wi-Fi ارسال شده در migrationRequest حذف می‌شوند.

مولفه های
@ NonNull ComponentName notificationServiceComponentName	ComponentName سرویسی که NotificationReceiverService را گسترش می دهد. باید یک جزء معتبر متعلق به برنامه فراخوان باشد و در مانیفست صادر شود، در غیر این صورت یک IllegalArgumentException پرتاب می شود.
@ NonNull ComponentName adminComponentName	ComponentName ادمین DeviceAdminReceiver DPC فراخوانی.
@ NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest حاوی رمز مهاجرت و شبکه های Wi-Fi پیکربندی شده است. مورد دوم تنها در صورتی مورد نیاز است که تماس‌گیرنده مالک نمایه دستگاه شخصی باشد و هر شبکه‌ای را پیکربندی کرده باشد.

برمی گرداند

@ NonNull ListenableFuture <@ NonNull DpcMigrationAttempt >

ListenableFuture که نتیجه را می پیچد. این میتواند باشد آینده ای موفق که در صورت موفقیت، یک DpcMigrationAttempt را بسته بندی می کند. اگر تماس گیرنده مالک دستگاه یا مالک نمایه نباشد، در آینده ناموفق بسته بندی یک SecurityException است. بسته‌بندی ناموفق در آینده یک IllegalArgumentException ، اگر کد انتقال خالی باشد، یا اگر notificationServiceComponentName به مؤلفه معتبر توسعه‌دهنده NotificationReceiverService که در مانیفست صادر می‌شود اشاره نکند، یا اگر adminComponentName یک سرپرست فعال متعلق به بسته فعلی نباشد. بسته بندی ناموفق آینده DpcMigrationException ، اگر تماس مربوط به مهاجرت dpc ناموفق باشد. پیام و نوع فرعی استثنا حاوی جزئیات بیشتری در مورد شکست است.

migrateDeviceManagementToAndroidManagementApiAwait

abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

این دستگاه را به مدیریت API مدیریت Android منتقل کنید.

پس از تکمیل انتقال، برنامه تماس، امتیازات مالک دستگاه یا مالک نمایه خود را از دست می دهد، زیرا این امتیازات به خط مشی دستگاه Android منتقل می شوند.

هشدار: این کار قابل لغو نیست! زمانی که Android Device Policy درخواست را دریافت کرده و بررسی‌های اولیه روی رمز انتقال را انجام دهد، این سرگرمی تعلیق برمی‌گردد. در صورت شکست یک Exception پرتاب می شود.

این روش را فقط می توان توسط یک Device Owner یا Profile Owner فراخوانی کرد. در Android 10 و پایین‌تر، این نباید در دستگاهی با مالک دستگاه و مالک نمایه فراخوانی شود.

شبکه‌های Wi-Fi پیکربندی‌شده باید در DpcMigrationRequest توسط مالک نمایه (به استثنای Android 12) در دستگاه شخصی که هر شبکه Wi-Fi را پیکربندی کرده باشد، ارسال شود. اینها نباید روی دستگاه متعلق به شرکت منتقل شوند. توجه داشته باشید که این شبکه‌های Wi-Fi درست قبل از انتقال مدیریت دستگاه به Android Device Policy حذف خواهند شد. در صورت عدم موفقیت در حذف یک شبکه، مهاجرت نیز با شکست مواجه می شود و از آنجایی که حذف شبکه ها یک عملیات اتمی نیست، ممکن است برخی از شبکه ها قبلا حذف شده باشند.

در دستگاه‌های شخصی با نمایه کاری دارای Android 12، همه شبکه‌های Wi-Fi پیکربندی‌شده توسط DPC تماس‌گیر درست قبل از انتقال مدیریت دستگاه به خط‌مشی دستگاه Android، بدون توجه به شبکه‌های Wi-Fi ارسال شده در migrationRequest حذف می‌شوند.

مولفه های
@ NonNull ComponentName notificationServiceComponentName	ComponentName سرویسی که NotificationReceiverService را گسترش می دهد. باید یک جزء معتبر متعلق به برنامه فراخوان باشد و در مانیفست صادر شود، در غیر این صورت یک IllegalArgumentException پرتاب می شود.
@ NonNull ComponentName adminComponentName	ComponentName ادمین DeviceAdminReceiver DPC فراخوانی.
@ NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest حاوی رمز مهاجرت و شبکه های Wi-Fi پیکربندی شده است. مورد دوم تنها در صورتی مورد نیاز است که تماس‌گیرنده مالک نمایه دستگاه شخصی باشد و هر شبکه‌ای را پیکربندی کرده باشد.

برمی گرداند
@ NonNull DpcMigrationAttempt	DpcMigrationException با وضعیت فعلی مهاجرت در صورت موفقیت.

پرتاب می کند
java.lang.SecurityException	اگر تماس گیرنده مالک دستگاه یا مالک نمایه نباشد.
java.lang.IllegalArgumentException	اگر کد انتقال خالی باشد، یا اگر notificationServiceComponentName به مؤلفه معتبری که NotificationReceiverService که در مانیفست صادر می‌شود، اشاره نمی‌کند، یا اگر adminComponentName یک سرپرست فعال متعلق به بسته فعلی نیست.
com.google.android.managementapi.dpcmigration.DpcMigrationException	اگر تماس مربوط به مهاجرت dpc ناموفق بود. پیام و نوع فرعی استثنا حاوی جزئیات بیشتری در مورد شکست است.