Memigrasikan aplikasi ke Android 15

Dokumen ini memberikan gambaran mendetail tentang fase pengembangan dan pengujian umum yang dapat membantu Anda merencanakan kesiapan sesuai dengan waktu rilis platform dan memastikan pengalaman hebat bagi pengguna Anda Android 15.

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

Pengguna dapat mulai menerima platform baru segera setelah kode sumber dirilis untuk AOSP (Proyek Open Source Android), sehingga hal ini penting untuk aplikasi Anda siap, bekerja seperti yang diharapkan bagi pengguna, dan idealnya memanfaatkan fitur dan API baru untuk memaksimalkan 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

Anda harus menguji fungsionalitas aplikasi yang ada terhadap Android 15 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 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 15

Melakukan flash image sistem Android 15 ke perangkat, atau mendownload image sistem untuk Android Emulator.

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 dengan level API yang sama yang awalnya ditargetkan oleh aplikasi Anda - tidak perlu menargetkan Android 15.

Publikasikan

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

Melakukan pengujian kompatibilitas

Pada umumnya, menguji kompatibilitas dengan Android 15 adalah mirip dengan pengujian aplikasi biasa. Inilah saat yang tepat untuk meninjau aplikasi inti pedoman kualitas dan praktik terbaik untuk pengujian.

Untuk menguji, instal aplikasi yang dipublikasikan saat ini di perangkat yang menjalankan Android 15, dan mengikuti semua alur dan fungsinya sembari mencari masalah. Untuk membantu memfokuskan pengujian, meninjau perubahan perilaku untuk semua aplikasi yang diperkenalkan di Android 15 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 aplikasi Anda 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 untuk memastikan memastikan berfungsi seperti yang diharapkan di Android 15 dan mengikuti perkembangan privasi, kinerja, UX, penanganan data, dan izin. Jika Anda temukan 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 kelancaran transisi bagi pengguna Anda saat mereka memperbarui 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 serta memanfaatkan API dan kemampuan baru di Android 15. 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 15, tinjau perubahan perilaku yang memengaruhi aplikasi yang menargetkan Android 15. Perubahan perilaku yang ditargetkan ini dapat menyebabkan masalah fungsional yang harus Anda alamat IPv6 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 kompatibilitas tombol beralih untuk menguji aplikasi dengan mengaktifkan perubahan yang dipilih.

Langkah-langkah berikut menjelaskan cara mendukung Android 15 sepenuhnya.

Mendapatkan Android 15 SDK

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

Meninjau perubahan perilaku

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

Menggunakan fitur Android 15

Manfaatkan API Android 15 untuk menghadirkan fitur dan terhadap 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 targetSdkVersion dan konfigurasi build lainnya sekali lagi, melakukan update tambahan, dan menguji 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 Android Studio untuk mendownload Android 15 SDK dan alat lain yang Anda butuhkan. Selanjutnya, update targetSdkVersion dan compileSdkVersion, lalu kompilasi ulang aplikasi. Lihat panduan penyiapan SDK untuk spesifikasi pendukung.

Menguji aplikasi Android 15 Anda

Setelah Anda mengompilasi aplikasi dan menginstalnya pada perangkat yang menjalankan Android 15, mulai pengujian untuk memastikan aplikasi berfungsi dengan baik saat menargetkan Android 15. 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 15. 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 penggunaan antarmuka non-SDK yang dibatasi yang mungkin berlaku. Perhatikan peringatan logcat yang menandai akses dan penggunaan ini metode StrictMode detectNonSdkApiUsage() untuk menemukannya secara terprogram.

Terakhir, pastikan Anda menguji library dan SDK di aplikasi secara menyeluruh untuk memastikan memastikan berfungsi seperti yang diharapkan di Android 15 dan mengikuti perkembangan privasi, kinerja, 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 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 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.

Saat Anda melakukan persiapan untuk mengubah penargetan aplikasi, atau saat Anda aktif untuk dukungan Android 15, tombol alih tersebut dapat membantu Anda. Untuk informasi selengkapnya, lihat Perubahan framework kompatibilitas (Android 15).