Memigrasikan aplikasi ke Android 15

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

Kami memperkenalkan fitur baru serta perubahan perilaku dalam setiap rilis Android dengan tujuan menjadikan Android lebih bermanfaat, lebih aman, dan berperforma lebih baik. Dalam banyak kasus, aplikasi Anda akan berfungsi sesuai ekspektasi dari awal, sedangkan dalam kasus lainnya, Anda mungkin perlu mengupdate aplikasi untuk beradaptasi dengan perubahan platform.

Pengguna dapat mulai menerima platform baru ini segera setelah kode sumber dirilis ke AOSP (Project Open Source Android), sehingga penting bagi aplikasi Anda untuk siap, berperforma seperti yang diharapkan bagi pengguna, dan idealnya memanfaatkan fitur serta API baru untuk mendapatkan hasil maksimal dari platform baru ini.

Migrasi umum memiliki dua fase, yang dapat terjadi bersamaan:

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

Memastikan kompatibilitas dengan Android 15

Penting untuk menguji fungsionalitas aplikasi yang ada di Android 15 agar Anda dapat terus memberikan pengalaman terbaik bagi pengguna yang melakukan update ke versi terbaru Android ini. Beberapa perubahan platform dapat memengaruhi perilaku aplikasi sehingga 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 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 15

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

Meninjau 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 15.

Publikasikan

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

Melakukan pengujian kompatibilitas

Pada umumnya, pengujian kompatibilitas dengan Android 15 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 15, 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 15 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 15 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 15.

Mengupdate versi target aplikasi dan melakukan build dengan API baru

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

Ketika Anda merencanakan pekerjaan untuk sepenuhnya mendukung Android 15, tinjau perubahan perilaku yang memengaruhi aplikasi yang menargetkan Android 15. Perubahan perilaku yang ditargetkan ini dapat menyebabkan masalah fungsional yang harus diatasi. 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 kompatibilitas untuk menguji aplikasi dengan mengaktifkan perubahan yang dipilih.

Langkah-langkah berikut menjelaskan cara untuk sepenuhnya mendukung Android 15.

Mendapatkan Android 15 SDK

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

Meninjau perubahan perilaku

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

Menggunakan fitur Android 15

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

Uji

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

Setelah mengompilasi aplikasi dan menginstalnya di perangkat yang menjalankan Android 15, mulai pengujian untuk memastikan bahwa aplikasi Anda berfungsi dengan baik saat menargetkan Android 15. Beberapa perubahan perilaku hanya berlaku saat aplikasi Anda menargetkan platform baru ini, jadi Anda perlu meninjau 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 15. Ini merupakan waktu yang tepat untuk memeriksa kesesuaian aplikasi dengan pedoman kualitas aplikasi inti serta praktik terbaik untuk pengujian.

Pastikan Anda melakukan peninjauan dan pengujian untuk 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 15 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 15 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 15, tombol alih tersebut dapat membantu Anda. Untuk mengetahui informasi selengkapnya, lihat Perubahan framework kompatibilitas (Android 15).