Mengelola update sistem

Panduan developer ini menjelaskan bagaimana pengendali kebijakan perangkat (DPC) Anda dapat mengelola update sistem Android atas nama pengguna perangkat.

Pengantar

Perangkat Android dapat menerima dan menginstal update over-the-air (OTA) ke software sistem dan aplikasi. Android memberi tahu pengguna perangkat bahwa update sistem tersedia dan pengguna perangkat dapat menginstal update tersebut segera atau nanti.

Dengan menggunakan DPC, admin IT dapat mengelola update sistem untuk pengguna perangkat. DPC dapat memiliki perangkat terkelola sepenuhnya (disebut pemilik perangkat) atau dapat memiliki profil kerja (disebut pemilik profil). Tabel 1 menunjukkan cara pemilik perangkat mengelola sistem sementara pemilik profil hanya dapat melaporkan informasi tentang update sistem.

Tabel 1: Tugas yang tersedia untuk DPC bergantung pada mode pemilik

Memeriksa update yang tertunda

Update tertunda adalah update sistem untuk perangkat yang belum diinstal. DPC dapat membantu admin IT memeriksa perangkat mana yang memiliki update sistem yang tertunda—dan mungkin meminta pengguna perangkat untuk segera menginstal pembaruan penting.

Pemilik perangkat dan pemilik profil yang berjalan di Android 8.0 (level API 26) atau yang lebih tinggi dapat memeriksa apakah perangkat memiliki pembaruan sistem yang tertunda. Telepon DevicePolicyManager.getPendingSystemUpdate() yang menampilkan null jika perangkat sudah diupdate. Jika update sistem tertunda, metode akan menampilkan informasi tentang update.

Cari tahu info selengkapnya tentang update yang tertunda

Setelah memanggil getPendingSystemUpdate(), Anda dapat memeriksa objek yang ditampilkan Nilai SystemUpdateInfo untuk mengetahui lebih lanjut update yang tertunda. Tujuan contoh berikut menunjukkan cara mengetahui kapan update tertunda pertama kali yang tersedia untuk perangkat:

val firstAvailable =
        dpm.getPendingSystemUpdate(adminName)?.receivedTime
firstAvailable?.let {
    Log.i(TAG, "Update first available: ${Date(firstAvailable)}")
}

SystemUpdateInfo updateInfo = dpm.getPendingSystemUpdate(adminName);
if (updateInfo != null) {
  Long firstAvailable = updateInfo.getReceivedTime();
  Log.i(TAG, "Update first available: " + new Date(firstAvailable));
}

Callback sistem

Saat update tersedia, sistem Android akan memberi tahu pemilik perangkat tentang update baru. Di Android 8.0 atau yang lebih tinggi, sistem juga akan memberi tahu pemilik profil.

Di subclass DeviceAdminReceiver, ganti callback onSystemUpdatePending(). Anda tidak perlu untuk mendaftar atau mengiklankan DPC agar menerima callback. Sistem mungkin memanggil metode ini lebih dari sekali untuk satu update, jadi periksa status update sebelum merespons. Panggil getPendingSystemUpdate() untuk mengetahui lebih lanjut update sistem dalam callback. Contoh berikut menunjukkan cara Anda dapat melakukan ini:

/**
 * Called when a new update is available.
 */
override fun onSystemUpdatePending(context: Context?, intent: Intent?,
                                   receivedTime: Long) {

    // System update information is supported in API level 26 or higher.
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) {
        return
    }

    val updateInfo = getManager(context)
            .getPendingSystemUpdate(getWho(context))
            ?: return
    if (updateInfo.securityPatchState ==
            SystemUpdateInfo.SECURITY_PATCH_STATE_TRUE) {
        // Perhaps install because this is a security patch.
        // ...
    }
}

/**
 * Called when a new update is available.
 */
public void onSystemUpdatePending (Context context, Intent intent,
                                   long receivedTime) {

  // System update information is supported in API level 26 or higher.
  if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) {
    return;
  }
  SystemUpdateInfo updateInfo = getManager(context)
      .getPendingSystemUpdate(getWho(context));
  if (updateInfo == null) {
    return;
  }
  if (updateInfo.getSecurityPatchState() ==
      SystemUpdateInfo.SECURITY_PATCH_STATE_TRUE) {
    // Perhaps install because this is a security patch.
    // ...
  }
}

Jika sistem memiliki lebih dari satu DPC, misalnya profil kerja di DPC yang terkelola sepenuhnya perangkat, pemilik perangkat dan pemilik profil akan menerima callback.

Memperbarui kebijakan

Pemilik perangkat dapat mengontrol waktu penginstalan update dengan menyetel sistem lokal kebijakan pembaruan untuk perangkat. Kebijakan update sistem dapat berupa salah satu dari tiga jenis:

Otomatis

Menginstal update sistem segera setelah tersedia tersedia (tanpa interaksi pengguna). Menyetel jenis kebijakan ini akan langsung menginstal semua update yang tertunda yang mungkin ditunda atau menunggu masa pemeliharaan.

Berjendela

Menginstal update sistem selama pemeliharaan harian periode (tanpa interaksi pengguna). Tetapkan awal dan akhir periode pemeliharaan harian, sebagai menit hari, saat membuat kebijakan berperiode baru.

Ditunda

Menunda penginstalan update sistem selama 30 hari. Setelah periode 30 hari berakhir, sistem akan meminta pengguna perangkat untuk menginstal update.

Periode penundaan

Sistem membatasi setiap update dengan penundaan selama 30 hari. Periode dimulai saat sistem pertama kali menunda update dan menetapkan kebijakan penundaan baru tidak akan memperpanjang periode.

Selain penundaan, Android mungkin tidak dapat menginstal update karena alasan lain seperti tidak ada konektivitas, kapasitas disk tidak cukup, atau daya baterai lemah.

Sistem akan mereset timer penundaan 30 hari jika update lain tersedia selama periode tersebut, sehingga admin IT dapat mencoba update sistem gabungan. Setelah 30 hari berlalu tanpa update baru, sistem akan meminta pengguna untuk menginstal semua update yang tertunda. Kemudian, saat update sistem baru tersedia, periode 30 hari akan dimulai lagi.

Cara menetapkan kebijakan

Anda dapat menetapkan kebijakan update di Android 8.0 (API level 26) atau yang lebih tinggi. Untuk menentukan kapan perangkat harus menginstal update sistem, buat instance SystemUpdatePolicy menggunakan salah satu dari tiga jenis yang diuraikan di atas. Untuk menetapkan kebijakan, pemilik perangkat Anda memanggil metode DevicePolicyManager setSystemUpdatePolicy(). Kode berikut contoh menunjukkan bagaimana Anda dapat melakukannya. Untuk melihat contoh kebijakan dengan periode waktu, lihat dokumentasi SystemUpdatePolicy.

// Create the system update policy to postpone installation for 30 days.
val policy = SystemUpdatePolicy.createPostponeInstallPolicy()

// Get a DevicePolicyManager instance to set the policy on the device.
val dpm = context.getSystemService(Context.DEVICE_POLICY_SERVICE)
        as DevicePolicyManager
val adminName = getComponentName(context)

// Set the policy.
dpm.setSystemUpdatePolicy(adminName, policy)

// Create the system update policy to postpone installation for 30 days.
SystemUpdatePolicy policy = SystemUpdatePolicy.createPostponeInstallPolicy();

// Get a DevicePolicyManager instance to set the policy on the device.
DevicePolicyManager dpm = (DevicePolicyManager) context
    .getSystemService(Context.DEVICE_POLICY_SERVICE);
ComponentName adminName = getComponentName(context);

// Set the policy.
dpm.setSystemUpdatePolicy(adminName, policy);

Instance kebijakan tidak dapat diubah setelah Anda membuatnya. Untuk mengubah waktu perangkat menginstal update, Anda dapat membuat dan menetapkan kebijakan baru. Untuk menghapus kebijakan dari perangkat, panggil setSystemUpdatePolicy() yang meneruskan null sebagai argumen policy. Setelah DPC Anda menghapus kebijakan, pengguna perangkat akan melihat notifikasi untuk update sistem yang tersedia.

Aplikasi dapat memanggil getSystemUpdatePolicy() untuk mendapatkan kebijakan saat ini untuk perangkat. Jika metode ini menampilkan null, ini berarti kebijakan saat ini tidak disetel.

Periode pembekuan

Untuk membekukan versi OS selama periode kritis, seperti hari libur atau aktivitas sibuk lainnya kali, pemilik perangkat dapat menangguhkan pembaruan sistem hingga 90 hari. Saat perangkat berada dalam periode pembekuan, perilakunya adalah sebagai berikut:

• Perangkat tidak menerima notifikasi apa pun tentang update sistem yang tertunda.
• Update sistem ke OS tidak diinstal.
• Pengguna perangkat tidak dapat memeriksa update sistem secara manual di Setelan.

Sistem memberlakukan masa tenggang selama 60 hari wajib setelah pembekuan yang ditentukan periode untuk mencegah pembekuan perangkat tanpa batas waktu. Ingat, sistem pembekuan dapat mencegah perangkat menerima pembaruan penting.

Anda menetapkan periode pembekuan pada kebijakan update. Anda tidak dapat menetapkan periode pembekuan tanpa menetapkan kebijakan. Saat perangkat berada di luar periode pembekuan yang Anda setel, perilaku kebijakan normal (otomatis, terjadwal, atau ditunda) akan berlaku.

Cara menyetel periode pembekuan

Anda dapat menetapkan periode pembekuan di Android 9 (API level 28) atau yang lebih tinggi. Perangkat pemilik menetapkan periode pembekuan pada kebijakan update sistem sebelum menyetel kebijakan untuk perangkat. Langkah-langkahnya adalah:

1. Buat kebijakan update sistem baru (atau dapatkan versi saat ini).
2. Tetapkan periode pembekuan pada kebijakan dengan memanggil setFreezePeriods().
3. Menyetel kebijakan dan membekukan periode untuk perangkat dengan memanggil setSystemUpdatePolicy()

Karena periode pembekuan berulang setiap tahun, tanggal mulai dan akhir periode periode diwakili oleh nilai bulan dan nilai hari. Hari mulai harus dimulai pada setidaknya 60 hari setelah akhir periode pembekuan sebelumnya. Contoh berikut menunjukkan cara menetapkan dua periode pembekuan untuk kebijakan update sistem yang ada:

// Get the existing policy from the DevicePolicyController instance.
val policy = dpm.systemUpdatePolicy ?: return

try {
    // Set the two annual freeze periods on the policy for our retail
    // point-of-sale devices.
    val summerSale = FreezePeriod(
            MonthDay.of(6, 1),
            MonthDay.of(7, 31)) // Jun 1 - Jul 31 inclusive
    val winterSale = FreezePeriod(
            MonthDay.of(11, 20),
            MonthDay.of(1, 12)) // Nov 20 - Jan 12 inclusive
    policy.freezePeriods = Arrays.asList(summerSale, winterSale)

    // Set the policy again to activate the freeze periods.
    dpm.setSystemUpdatePolicy(adminName, policy)

} catch (e: SystemUpdatePolicy.ValidationFailedException) {
    // There must be previous periods recorded on the device because
    // summerSale and winterSale don’t overlap and are separated by more
    // than 60 days. Report the overlap ...
}

// Get the existing policy from the DevicePolicyController instance.
SystemUpdatePolicy policy = dpm.getSystemUpdatePolicy();

try {
  // Set the two annual freeze periods on the policy for our
  // retail point-of-sale devices.
  FreezePeriod summerSale = new FreezePeriod(
      MonthDay.of(6, 1),
      MonthDay.of(7, 31)); // Jun 1 - Jul 31 inclusive
  FreezePeriod winterSale = new FreezePeriod(
      MonthDay.of(11, 20),
      MonthDay.of(1, 12)); // Nov 20 - Jan 12 inclusive
  policy.setFreezePeriods(Arrays.asList(summerSale, winterSale));

  // Don’t forget to set the policy again to activate the freeze periods.
  dpm.setSystemUpdatePolicy(adminName, policy);

} catch (SystemUpdatePolicy.ValidationFailedException e) {
  // There must be previous periods recorded on the device because summerSale
  // and winterSale don’t overlap and are separated by more than 60 days.
  // Report the overlap ...
}

Hari mulai dan hari akhir bersifat inklusif. Jika hari mulai lebih besar daripada hari terakhir (seperti winterSale pada contoh sebelumnya), pembekuan periode ini meluas hingga tahun berikutnya.

Saat menetapkan periode pembekuan pada kebijakan update sistem, Android akan menguji persyaratan ini:

• Tidak ada periode pembekuan yang lebih dari 90 hari.
• Interval antara periode pembekuan minimal 60 hari.
• Periode pembekuan tidak tumpang-tindih.
• Tidak ada periode pembekuan duplikat.

Saat menyetel kebijakan update sistem untuk perangkat, Android akan mengulangi pengujian ini dan termasuk periode pembekuan saat ini atau sebelumnya untuk perangkat.

Android akan menampilkan SystemUpdatePolicy.ValidationFailedException saat salah satu pengujian ini gagal.

Untuk mendapatkan daftar periode pembekuan yang telah ditetapkan sebelumnya pada objek kebijakan update sistem, semua aplikasi yang diinstal dapat memanggil SystemUpdatePolicy.getFreezePeriods(). Contoh berikut memanggil metode ini untuk mencatat periode pembekuan perangkat:

// Log any freeze periods that might be set on a system update policy.
dpm.systemUpdatePolicy?.freezePeriods?.forEach {
    Log.i(TAG, "Freeze period: $it")
}

// Log any freeze periods that might be set on a system update policy.
SystemUpdatePolicy currentPolicy = dpm.getSystemUpdatePolicy();
if (currentPolicy != null) { // A policy might not be set.
  for (FreezePeriod freezePeriod : currentPolicy.getFreezePeriods()) {
    Log.i(TAG, "Freeze period: " + freezePeriod.toString());
  }
}

Tahun kabisat

Android menggunakan kalender ISO 8601 (juga disebut kalender Gregorian) untuk menghitung periode pembekuan dan mengabaikan tahun kabisat. Artinya bahwa tanggal 29 Februari tidak dikenal sebagai tanggal yang valid dan diperlakukan seolah-olah tanggal tersebut adalah 28 Februari. Oleh karena itu, 29 Februari tidak dihitung saat menghitung durasi pembekuan titik.

Pengembangan dan pengujian

Saat mengembangkan dan menguji fitur update sistem DPC, Anda mungkin perlu membuat banyak periode pembekuan. Karena Android memeriksa interval 60 hari antara periode pembekuan sebelumnya, Anda mungkin tidak dapat menetapkan periode pembekuan baru tanpa menghapus data periode sebelumnya terlebih dahulu. Untuk menghapus catatan periode pembekuan perangkat, jalankan perintah berikut di shell Android Debug Bridge (adb):

adb shell dpm clear-freeze-period-record

Anda dapat mengonfirmasi bahwa perangkat berada dalam periode pembekuan dengan memeriksa bahwa pengguna antarmuka untuk pembaruan sistem dinonaktifkan.

Update Sistem Google Play (Utama)

Update Sistem Google Play (juga disebut update Utama) adalah diunduh secara otomatis, tetapi perangkat perlu diinstal ulang. Update ini tidak akan memicu mulai ulang otomatis dan akan diinstal pada saat dimulai ulang pengguna, admin, atau kebijakan berikutnya. Mulai ulang yang dipicu oleh sistem akan menginstal update sistem Google/OEM terkait dan setiap update Sistem Google Play yang telah didownload sebelumnya.

Update Sistem Google Play juga dapat diinstal secara manual dengan membuka Setelan > Tentang > Versi Android > Update sistem Google Play.

Me-roll back update

Dalam beberapa kasus, alat Rollback Update Sistem Google Play (GPSUR) dapat digunakan untuk memulihkan status perangkat karena penginstalan Update Sistem Google Play yang bermasalah. Alat ini harus digunakan oleh pengguna tingkat lanjut atau jika diarahkan untuk melakukannya oleh staf dukungan karena dapat mengakibatkan hilangnya data. Berikut cara menggunakan alat GPSUR:

1. Jika Anda memiliki Android Debug Bridge (adb) yang berjalan di komputer, hentikan layanan adb sebelum melanjutkan agar tidak mengganggu proses rollback. Untuk menghentikan adb, jalankan adb kill-server.
2. Buka alat GPSUR.
3. Klik Izinkan akses ADB untuk mengizinkan alat berkomunikasi dengan perangkat pengujian Anda melalui adb.
4. Klik Tambahkan perangkat baru.
5. Pilih perangkat Anda dari daftar dan klik Hubungkan. Daftar ini mungkin tidak berisi nama lengkap perangkat.
6. Di layar perangkat, pilih Selalu izinkan dari komputer ini, lalu klik Oke untuk menerima koneksi proses debug USB.
7. Pilih perangkat yang terhubung di browser Anda.
8. Teks tombol di halaman akan beralih dari Tidak Ada Rollback yang Tersedia menjadi Rollback Update Terbaru jika ada rollback yang tersedia di perangkat Anda. Klik Rollback Recent Updates.
9. Baca peringatan di modal Konfirmasi Rollback, lalu klik Konfirmasi.
10. Tunggu hingga rollback selesai. Setelah selesai, pesan Rollback Berhasil akan muncul dan perangkat akan dimulai ulang. Sekarang Anda dapat mencabut perangkat dengan aman.

Referensi lainnya

Untuk mempelajari update sistem lebih lanjut, baca OTA Project Open Source Android Update.