Memigrasikan aplikasi ke Android 14

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 14.

Dengan setiap rilis Android, kami memperkenalkan fitur baru serta perubahan perilaku yang bertujuan untuk menjadikan Android lebih bermanfaat, lebih aman, dan berperforma lebih baik. Dalam banyak kasus, aplikasi Anda akan berfungsi sesuai ekspektasi dari awal, sementara dalam kasus lain, Anda mungkin perlu mengupdate aplikasi untuk menyesuaikannya 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 14)
  • Menargetkan fitur platform dan API baru (sesegera mungkin setelah rilis final)

Memastikan kompatibilitas dengan Android 14

Penting untuk menguji fungsi aplikasi yang ada di Android 14 agar Anda dapat terus memberikan pengalaman terbaik bagi pengguna yang melakukan update ke versi terbaru Android ini. Beberapa perubahan platform dapat memengaruhi perilaku aplikasi Anda, jadi Anda harus melakukan pengujian sejak awal dan secara menyeluruh, lalu membuat penyesuaian yang diperlukan pada aplikasi Anda.

Anda biasanya dapat menyesuaikan aplikasi dan memublikasikan update tanpa perlu mengubah targetSdkVersion aplikasi. Demikian pula, Anda tidak perlu menggunakan API baru atau mengubah compileSdkVersion aplikasi, meskipun hal ini mungkin bergantung pada cara aplikasi Anda di-build dan fungsi platform yang digunakannya.

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

Mendapatkan Android 14

Lakukan flash pada image sistem Android 14 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 14.

Publikasikan

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

Melakukan pengujian kompatibilitas

Pada umumnya, pengujian kompatibilitas dengan Android 14 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 14, dan jelajahi semua alur dan fungsi sembari mencari masalah. Untuk membantu Anda berfokus pada pengujian, tinjau perubahan perilaku untuk semua aplikasi yang diperkenalkan di Android 14 yang dapat memengaruhi fungsi aplikasi atau menyebabkan aplikasi tidak bekerja.

Pastikan juga Anda meninjau dan menguji penggunaan antarmuka non-SDK yang dibatasi. Anda harus mengganti antarmuka terbatas apa pun yang digunakan oleh aplikasi dengan SDK publik atau yang setara dengan NDK. 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 14 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 update, sebaiknya segera publikasikan aplikasi Anda yang sudah kompatibel. Hal ini memungkinkan pengguna menguji aplikasi lebih awal dan membantu memastikan transisi yang lancar bagi pengguna saat mereka melakukan update ke Android 14.

Mengupdate versi target aplikasi dan melakukan build dengan API baru

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

Ketika Anda merencanakan pekerjaan untuk sepenuhnya mendukung Android 14, tinjau perubahan perilaku yang memengaruhi aplikasi yang menargetkan Android 14. Perubahan perilaku yang ditargetkan ini dapat menyebabkan masalah fungsional yang harus Anda atasi. Dalam beberapa kasus, perubahan ini memerlukan pengembangan yang signifikan. Jadi, sebaiknya pelajari dan coba untuk mengatasinya secepat 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 14 sepenuhnya.

Mendapatkan Android 14 SDK

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

Meninjau perubahan perilaku

Tinjau perubahan perilaku yang berlaku untuk aplikasi yang menargetkan Android 14. 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 14.

Menggunakan fitur Android 14

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

Uji

Uji pada perangkat atau emulator Android 14. 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 Android 14 API 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 14, gunakan versi pratinjau terbaru Android Studio untuk mendownload Android 14 SDK dan fitur 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 14 Anda

Setelah mengompilasi aplikasi dan menginstalnya di perangkat yang menjalankan Android 14, mulai pengujian untuk memastikan bahwa aplikasi berfungsi dengan baik saat menargetkan Android 14. Beberapa perubahan perilaku hanya berlaku saat aplikasi Anda menargetkan platform baru, jadi sebaiknya tinjau perubahan tersebut 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 14. Ini juga merupakan waktu yang tepat untuk memeriksa kesesuaian aplikasi dengan 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 14 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.

Menguji aplikasi menggunakan tombol alih kompatibilitas

Android 14 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 menonaktifkan 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 root masalah dalam output log dengan cepat.

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