Memigrasikan aplikasi ke Android 13

Dokumen ini memberikan gambaran mendetail tentang fase pengembangan dan pengujian umum yang dapat membantu Anda merencanakan kesiapan sesuai dengan linimasa rilis platform dan memastikan pengalaman terbaik bagi pengguna Anda di Android 13.

Dengan setiap rilis Android, kami memperkenalkan fitur baru serta perubahan perilaku yang bertujuan untuk menjadikan Android lebih bermanfaat, lebih aman, dan berperforma lebih baik. Umumnya, aplikasi Anda akan bekerja persis seperti yang diharapkan dari awal, saat kasus lain, Anda mungkin perlu mengupdate aplikasi Anda untuk beradaptasi dengan perubahan platform.

Pengguna dapat mulai menerima platform baru ini segera setelah kode sumbernya dirilis ke AOSP (Android Open Source Project). Oleh karena itu, aplikasi harus sudah siap digunakan, dapat berperforma sesuai ekspektasi pengguna, dan idealnya memanfaatkan fitur serta API baru untuk memaksimalkan penggunaan platform yang baru.

Migrasi umum memiliki dua fase, yang dapat terjadi bersamaan:

  • Memastikan kompatibilitas aplikasi (dengan rilis final Android 13)
  • Menargetkan fitur platform dan API baru (sesegera mungkin setelah rilis final)

Memastikan kompatibilitas dengan Android 13

Penting untuk menguji fungsionalitas aplikasi Anda yang ada terhadap Android 13 untuk memastikan pengalaman terbaik bagi pengguna yang melakukan update ke Android versi terbaru. Beberapa perubahan platform dapat memengaruhi cara aplikasi Anda berperilaku, jadi penting untuk melakukan pengujian sejak awal dan secara menyeluruh, serta menentukan berbagai penyesuaian untuk aplikasi Anda.

Anda biasanya dapat menyesuaikan aplikasi dan memublikasikan update tanpa perlu melakukan perubahan targetSdkVersion aplikasi. Demikian pula, Anda tidak perlu menggunakan API atau mengubah compileSdkVersion aplikasi, meskipun hal ini dapat bergantung pada cara dibuat dan fungsi platform yang digunakannya.

Sebelum memulai pengujian, pastikan Anda memahami perilaku perubahan untuk semua aplikasi. Perubahan ini dapat memengaruhi aplikasi, meskipun Anda tidak mengubah targetSdkVersion-nya.

Mendapatkan Android 13

Lakukan flash pada image sistem Android 13 ke perangkat, atau download image sistem untuk emulator Android.

Tinjau perubahan

Tinjau perubahan perilaku sistem untuk mengidentifikasi area yang mungkin memengaruhi aplikasi Anda.

Uji

Instal aplikasi di perangkat atau emulator, lalu jalankan pengujian. Fokus pada perubahan perilaku sistem, dan jelajahi semua alur aplikasi.

Update

Hanya lakukan perubahan kode yang diperlukan untuk beradaptasi dengan perubahan perilaku atau selesaikan masalah. Kompilasi ulang menggunakan API level sama yang awalnya ditargetkan oleh aplikasi Anda - sehingga tidak perlu menargetkan Android 13.

Publikasikan

Tanda tangani, upload, dan publikasikan Android App Bundle atau APK yang telah diupdate.

Melakukan pengujian kompatibilitas

Pada umumnya, pengujian kompatibilitas dengan Android 13 mirip dengan pengujian aplikasi biasa. Inilah waktu yang tepat untuk meninjau pedoman kualitas aplikasi inti dan praktik terbaik untuk pengujian.

Untuk menguji, instal aplikasi yang dipublikasikan saat ini di perangkat yang menjalankan Android 13, dan jelajahi semua alur dan fungsi sembari mencari masalah. Untuk membantu memfokuskan pengujian, meninjau perubahan perilaku untuk semua aplikasi yang diperkenalkan di Android 13 yang dapat memengaruhi fungsi aplikasi atau menyebabkan aplikasi Anda mengalami error.

Pastikan juga Anda meninjau dan menguji penggunaan non-SDK terbatas antarmuka. Anda harus mengganti antarmuka terbatas apa pun yang digunakan oleh aplikasi dengan SDK publik atau yang setara dengan NDK. Perhatikan peringatan logcat yang menandai hal ini mengakses, dan menggunakan metode StrictMode detectNonSdkApiUsage() untuk menangkap secara terprogram.

Terakhir, pastikan Anda menguji library dan SDK di aplikasi secara menyeluruh guna memastikan semuanya berfungsi dengan baik di Android 13 dan sudah mengikuti praktik terbaik untuk privasi, performa, UX, penanganan data, dan izin. Jika menemukan masalah, coba update SDK ke versi terbaru atau hubungi developer SDK untuk mendapatkan bantuan.

Setelah menyelesaikan pengujian dan melakukan pembaruan, sebaiknya publikasikan aplikasi yang kompatibel. Hal ini memungkinkan pengguna menguji aplikasi lebih awal dan membantu memastikan transisi yang lancar bagi pengguna saat mereka melakukan update ke Android 13.

Mengupdate versi target aplikasi dan melakukan build dengan API baru

Setelah memublikasikan versi aplikasi yang kompatibel, langkah berikutnya adalah menambahkan dukungan penuh untuk Android 13 dengan mengupdate targetSdkVersion dan memanfaatkan API serta kemampuan baru di Android 13. Anda dapat segera melakukan pembaruan ini setelah Anda siap, dengan memperhatikan Persyaratan Play untuk menargetkan platform baru.

Ketika Anda merencanakan pekerjaan untuk sepenuhnya mendukung Android 13, tinjau perubahan perilaku yang memengaruhi aplikasi yang menargetkan Android 13. Perubahan perilaku yang ditargetkan ini dapat menyebabkan masalah fungsional yang harus Anda atasi. Dalam beberapa kasus, perubahan ini memerlukan pengembangan yang signifikan, sehingga kami merekomendasikan untuk mempelajari dan menyelesaikannya sedini mungkin. Untuk membantu mengidentifikasi perubahan perilaku tertentu yang memengaruhi aplikasi Anda, gunakan tombol alih kompatibilitas untuk menguji aplikasi dengan mengaktifkan perubahan yang dipilih.

Langkah-langkah berikut menjelaskan cara mendukung Android 13 sepenuhnya.

Mendapatkan Android 13 SDK

Instal versi terbaru pratinjau Android Studio untuk membuat build dengan Android 13. Pastikan Anda memiliki perangkat atau emulator Android 13.
Update targetSdkVersion dan konfigurasi build lainnya.

Meninjau perubahan perilaku

Tinjau perubahan perilaku yang berlaku untuk aplikasi yang menargetkan Android 13. Identifikasi area yang mungkin memengaruhi aplikasi Anda, dan rencanakan cara mendukungnya.

Memeriksa perubahan privasi baru

Buat perubahan kode dan arsitektur yang diperlukan untuk mendukung perubahan privasi pengguna Android 13.

Menggunakan fitur Android 13

Manfaatkan API Android 13 untuk menghadirkan fitur dan kemampuan baru di aplikasi Anda. Kompilasi ulang untuk Android 13.

Uji

Uji pada perangkat atau emulator Android 13. Fokus pada area dengan perubahan perilaku yang mungkin memengaruhi aplikasi Anda. Coba fungsi yang menggunakan API baru. Berikan masukan platform dan API. Laporkan masalah platform, API, atau SDK pihak ketiga.

Update terakhir

Setelah API Android 13 sudah benar-benar selesai, update kembali targetSdkVersion dan konfigurasi build lainnya, buat update tambahan, lalu uji aplikasi Anda.

Publikasikan

Tanda tangani, upload, dan publikasikan Android App Bundle atau APK yang telah diupdate.

Mendapatkan SDK, mengubah versi target, melakukan build dengan API yang baru

Untuk mulai menguji dukungan penuh Android 13, gunakan versi pratinjau Android Studio untuk mendownload Android 13 SDK dan alat lain yang Anda butuhkan. Selanjutnya, update targetSdkVersion dan compileSdkVersion aplikasi Anda, lalu kompilasi ulang aplikasi. Lihat panduan penyiapan SDK untuk mengetahui detailnya.

Menguji aplikasi Android 13 Anda

Setelah Anda mengompilasi aplikasi dan menginstalnya di perangkat yang menjalankan Android 13, mulai pengujian untuk memastikan aplikasi berfungsi dengan baik saat menargetkan Android 13. Beberapa perubahan perilaku hanya berlaku saat aplikasi Anda menargetkan platform baru, jadi Anda perlu meninjaunya perubahan sebelum memulai.

Seperti dengan pengujian kompatibilitas dasar, jelajahi semua alur dan fungsi aplikasi untuk menemukan masalah. Fokuskan pengujian pada perubahan perilaku untuk aplikasi yang menargetkan Android 13. Penting ini juga waktu yang tepat untuk memeriksa kepatuhan aplikasi Anda terhadap pedoman kualitas aplikasi inti dan praktik terbaik untuk pengujian.

Pastikan Anda melakukan peninjauan dan pengujian untuk menemukan penggunaan antarmuka non-SDK yang dibatasi yang mungkin berlaku. Perhatikan peringatan logcat yang menandai akses ini, lalu gunakan metode StrictMode detectNonSdkApiUsage() untuk mendeteksinya secara terprogram.

Terakhir, pastikan Anda menguji library dan SDK di aplikasi secara menyeluruh guna memastikan semuanya berfungsi dengan baik di Android 13 dan sudah mengikuti praktik terbaik untuk privasi, performa, UX, penanganan data, dan izin. Jika Anda temukan masalah, coba update SDK ke versi terbaru, atau hubungi developer SDK untuk mendapatkan bantuan.

Menguji aplikasi menggunakan tombol alih kompatibilitas

Android 13 menyertakan tombol beralih kompatibilitas yang mempermudah pengujian aplikasi dengan perubahan perilaku yang ditargetkan. Untuk aplikasi yang dapat di-debug, tombol beralih memungkinkan Anda:

  • Menguji perubahan yang ditargetkan tanpa benar-benar mengubah targetSdkVersion aplikasi. Anda dapat menggunakan tombol alih untuk mengaktifkan paksa setiap perubahan perilaku yang ditargetkan, guna mengevaluasi dampaknya terhadap aplikasi yang ada.
  • Memfokuskan pengujian pada perubahan tertentu. Dengan tombol alih ini, Anda dapat menonaktifkan beberapa perubahan yang ditargetkan, sehingga dapat melakukan pengujian sesuai kebutuhan tanpa perlu menangani semua perubahan yang ditargetkan sekaligus.
  • Mengelola tombol alih melalui adb. Anda dapat menggunakan perintah adb untuk mengaktifkan dan nonaktifkan perubahan yang dapat diganti statusnya di lingkungan pengujian otomatis.
  • Men-debug lebih cepat menggunakan ID perubahan standar. Setiap perubahan yang dapat diganti statusnya memiliki ID dan nama unik yang dapat Anda gunakan untuk men-debug akar masalah dengan cepat dalam log {i>output<i} tersebut.

Selagi Anda melakukan persiapan untuk mengubah versi target aplikasi, atau melakukan pengembangan aktif untuk dukungan Android 13, tombol alih tersebut dapat membantu Anda. Untuk mengetahui informasi selengkapnya, lihat Perubahan framework kompatibilitas (Android 13).