Tangani perubahan konfigurasi

Beberapa konfigurasi perangkat dapat berubah saat aplikasi berjalan. Perubahan tersebut mencakup, namun tidak terbatas pada:

• Ukuran tampilan aplikasi
• Orientasi layar
• Ketebalan dan ukuran font
• Lokalitas
• Mode gelap versus mode terang
• Ketersediaan keyboard

Sebagian besar perubahan konfigurasi ini terjadi karena beberapa interaksi pengguna. Misalnya, memutar atau melipat perangkat akan mengubah jumlah ruang layar yang tersedia untuk aplikasi Anda. Demikian pula, mengubah setelan perangkat seperti ukuran font, bahasa, atau tema pilihan akan mengubah nilainya dalam objek Configuration.

Parameter ini biasanya memerlukan perubahan yang cukup besar pada UI aplikasi Anda agar platform Android memiliki mekanisme yang dibuat khusus saat berubah. Mekanisme ini adalah pembuatan ulang Activity.

Pembuatan ulang aktivitas

Sistem membuat ulang Activity saat terjadi perubahan konfigurasi. Untuk melakukan ini, sistem memanggil onDestroy dan menghancurkan instance Activity yang ada. Kemudian, sistem membuat instance baru menggunakan onCreate, dan instance baru Activity ini diinisialisasi dengan konfigurasi baru yang diupdate. Ini juga berarti bahwa sistem juga membuat ulang UI dengan konfigurasi baru.

Biasanya, Activity bertindak sebagai host untuk composable. Saat Activity dibuat ulang, Compose juga membuat ulang UI Anda menggunakan nilai konfigurasi baru.

Perilaku pembuatan ulang membantu aplikasi Anda beradaptasi dengan konfigurasi baru melalui pemuatan ulang aplikasi secara otomatis menggunakan resource alternatif yang sesuai dengan konfigurasi perangkat baru.

Contoh pembuatan ulang

Pertimbangkan composable yang menampilkan judul statis menggunakan resource string:

// In the res/values/strings.xml file
// <string name="compose">Jetpack Compose</string>

// In your Compose code
Text(
    text = stringResource(R.string.compose)
)
ResourcesSnippets.kt

Saat Activity dibuat, composable Text membaca konfigurasi saat ini (seperti bahasa) dan menyelesaikan resource string yang sesuai.

Jika bahasa berubah, sistem akan membuat ulang aktivitas. Saat hal ini terjadi, Compose akan membuat ulang UI. Karena stringResource membaca dari konfigurasi saat ini, judul akan otomatis diupdate ke nilai yang dilokalkan dengan benar.

Pembuatan ulang juga menghapus semua status yang disimpan sebagai kolom dalam Activity.

Untuk mempertahankan status UI saat terjadi perubahan konfigurasi, gunakan pola pengelolaan status yang direkomendasikan. Gunakan ViewModel untuk data dan logika bisnis, serta gunakan rememberSaveable untuk status tingkat UI. Dengan mekanisme ini, status Anda akan tetap ada saat pembuatan ulang Activity terjadi, sementara UI diupdate untuk mencerminkan konfigurasi baru.

Untuk mengetahui informasi selengkapnya tentang cara menyimpan status di Compose, lihat Menyimpan status UI di Compose.

Ekspektasi pengguna

Pengguna aplikasi mengharapkan status dipertahankan. Jika pengguna mengisi formulir dan membuka aplikasi lain dalam mode multi-aplikasi untuk mereferensikan informasi, pengalaman pengguna akan menjadi buruk jika mereka kembali ke formulir yang telah dihapus, atau ke tempat yang sama sekali lain di aplikasi. Sebagai developer, Anda harus memberikan pengalaman pengguna yang konsisten melalui perubahan konfigurasi dan pembuatan ulang aktivitas.

Untuk memastikan apakah status dipertahankan di aplikasi, Anda dapat melakukan tindakan yang menyebabkan perubahan konfigurasi saat aplikasi berada di latar depan maupun di latar belakang. Tindakan ini termasuk:

• Memutar perangkat
• Memasuki mode multi-aplikasi
• Mengubah ukuran aplikasi saat dalam mode multi-aplikasi atau jendela bentuk bebas
• Melipat perangkat foldable dengan beberapa layar
• Mengubah tema sistem, seperti mode gelap versus mode terang
• Mengubah ukuran font
• Mengubah bahasa sistem atau aplikasi
• Menyambungkan atau memutuskan sambungan keyboard hardware
• Menyambungkan atau memutuskan sambungan dok

Ada beberapa pendekatan yang dapat Anda lakukan untuk mempertahankan status yang relevan melalui pembuatan ulang Activity. Yang akan digunakan bergantung pada jenis status yang ingin Anda pertahankan:

• Persistensi lokal guna menangani penghentian proses untuk data yang kompleks atau besar. Penyimpanan lokal persisten mencakup database atau DataStore.
• Objek yang dipertahankan seperti instance ViewModel untuk menangani status terkait UI di memori saat pengguna aktif menggunakan aplikasi.
• rememberSaveable untuk mempertahankan status UI sementara saat terjadi perubahan konfigurasi dan penghentian proses yang diinisiasi sistem. Hal ini sesuai untuk status yang bergantung pada input pengguna, posisi scroll, atau navigasi, tetapi tidak termasuk dalam ViewModel.

Untuk membaca secara mendetail tentang API untuk setiap status, dan saat yang tepat untuk menggunakan masing-masing, lihat Menyimpan status UI.

Membatasi pembuatan ulang aktivitas

Anda dapat mencegah pembuatan ulang aktivitas otomatis untuk perubahan konfigurasi tertentu. Di aplikasi modern yang hanya menggunakan Compose, UI Anda akan disusun ulang, tetapi sebaiknya tangani perubahan konfigurasi secara langsung.

Secara default, perubahan konfigurasi akan memaksa sistem untuk menghancurkan dan membuat ulang Aktivitas, termasuk UI dan objek apa pun yang berasal dari Aktivitas. Jika Anda mendeklarasikan bahwa Aktivitas Anda menangani perubahan konfigurasinya sendiri, sistem akan mencegah hal ini. Sebagai gantinya, hanya objek Configuration yang diupdate, dan Compose akan menyusun ulang UI Anda dengan nilai baru.

Menangani perubahan konfigurasi secara langsung di Compose memiliki beberapa manfaat:

• Performa yang ditingkatkan: Menyusun ulang UI lebih murah daripada siklus pembuatan ulang Aktivitas penuh, terutama untuk perubahan kecil.
• Animasi yang lancar: Menghindari memulai ulang Aktivitas memungkinkan Anda menjalankan animasi berkelanjutan saat terjadi perubahan konfigurasi, seperti transisi tata letak yang lancar selama rotasi perangkat.
• Mempertahankan status: Mempertahankan instance Aktivitas akan mengurangi risiko kehilangan status UI sementara selama peristiwa seperti rotasi layar. Perhatikan bahwa Anda tetap harus menangani penyimpanan status untuk penghentian proses yang diinisiasi sistem.

Untuk menonaktifkan pembuatan ulang aktivitas bagi perubahan konfigurasi tertentu, tambahkan jenis konfigurasi ke android:configChanges dalam entri <activity> dalam file AndroidManifest.xml Anda. Nilai yang memungkinkan muncul dalam dokumentasi untuk atribut android:configChanges.

Kode manifes berikut menonaktifkan Activity pembuatan ulang untuk MyActivity saat orientasi layar dan ketersediaan keyboard berubah:

<activity
    android:name=".MyActivity"
    android:configChanges="orientation|screenSize|screenLayout|keyboardHidden"
    android:label="@string/app_name">

Bereaksi terhadap perubahan konfigurasi

Jetpack Compose memungkinkan aplikasi Anda bereaksi lebih mudah terhadap perubahan konfigurasi. Namun, jika Anda menonaktifkan pembuatan ulang Activity untuk semua perubahan konfigurasi yang memungkinkan, aplikasi Anda masih harus menangani perubahan konfigurasi dengan benar.

Objek Configuration tersedia dalam hierarki UI Compose dengan lokal komposisi LocalConfiguration. Setiap kali berubah, fungsi composable dapat membaca dari rekomposisi LocalConfiguration.current. Untuk mengetahui informasi tentang cara kerja lokal komposisi, lihat Data yang dibatasi secara lokal dengan CompositionLocal.

Contoh

Pada contoh berikut, composable menampilkan tanggal dengan format tertentu. Composable bereaksi terhadap perubahan konfigurasi lokalitas sistem dengan memanggil ConfigurationCompat.getLocales dengan LocalConfiguration.current.

@Composable
fun DateText(year: Int, dayOfYear: Int) {
    val dateTimeFormatter = DateTimeFormatter.ofPattern(
        "MMM dd",
        ConfigurationCompat.getLocales(LocalConfiguration.current)[0]
    )
    Text(
        dateTimeFormatter.format(LocalDate.ofYearDay(year, dayOfYear))
    )
}

Untuk menghindari pembuatan ulang Activity saat lokalitas berubah, Activity yang menghosting kode Compose harus memilih untuk tidak mengikuti perubahan konfigurasi lokalitas. Untuk melakukannya, tetapkan android:configChanges ke locale|layoutDirection.

Perubahan konfigurasi: Konsep utama dan praktik terbaik

Berikut adalah konsep utama yang perlu Anda ketahui saat menangani perubahan konfigurasi:

• Konfigurasi: Konfigurasi perangkat menentukan cara UI ditampilkan kepada pengguna, seperti ukuran tampilan aplikasi, lokalitas, atau tema sistem. Di Compose, Anda dapat mengakses nilai konfigurasi menggunakan LocalConfiguration.
• Perubahan konfigurasi: Konfigurasi berubah melalui interaksi pengguna. Misalnya, pengguna mungkin mengubah setelan perangkat atau cara mereka berinteraksi secara fisik dengan perangkat. Tidak ada cara untuk mencegah perubahan konfigurasi.
• Pembuatan ulang Activity: Perubahan konfigurasi menyebabkan pembuatan ulang Activity secara default. Ini adalah mekanisme bawaan untuk menginisialisasi ulang status aplikasi untuk konfigurasi baru.
• Penghancuran Activity: Pembuatan ulang Activity menyebabkan sistem menghancurkan instance Activity lama dan membuat instance baru sebagai gantinya. Instance lama sudah tidak digunakan lagi. Hindari mempertahankan referensi ke objek yang cakupannya siklus proses di luar cakupan yang dimaksudkan.
• Status: Status dalam instance Activity lama tidak ada dalam instance Activity baru, karena keduanya adalah dua instance objek yang berbeda. Daripada mengikat status ke Aktivitas, gunakan API yang direkomendasikan untuk mempertahankan status aplikasi dan pengguna seperti yang dijelaskan dalam Menyimpan status UI.
• Penonaktifan: Penonaktifan pembuatan ulang aktivitas untuk jenis perubahan konfigurasi mengharuskan aplikasi Anda diupdate dengan benar sebagai reaksi terhadap konfigurasi baru. Untuk sebagian besar aplikasi Compose, hal ini tidak direkomendasikan.

Untuk memberikan pengalaman pengguna yang baik, ikuti praktik terbaik berikut:

• Bersiaplah untuk perubahan konfigurasi yang sering terjadi: Jangan berasumsi bahwa perubahan konfigurasi jarang atau tidak pernah terjadi, terlepas dari API level, faktor bentuk, atau toolkit UI. Saat menyebabkan perubahan konfigurasi, pengguna ingin aplikasi melakukan update dan terus berfungsi dengan benar dengan konfigurasi baru.
• Pertahankan status: Jangan sampai status pengguna hilang saat pembuatan ulang Activity terjadi. Pertahankan status seperti yang dijelaskan dalam Menyimpan status UI menggunakan API seperti ViewModel dan rememberSaveable.
• Hindari penonaktifan sebagai perbaikan cepat: Jangan menonaktifkan pembuatan ulang Activity sebagai pintasan untuk menghindari hilangnya status. Penonaktifan pembuatan ulang aktivitas mengharuskan Anda memenuhi janji untuk menangani perubahan, dan Anda masih dapat kehilangan status karena pembuatan ulang Activity dari perubahan konfigurasi lainnya, penghentian proses, atau penutupan aplikasi. Anda tidak dapat sepenuhnya menonaktifkan pembuatan ulang Activity. Pertahankan status seperti yang dijelaskan dalam Menyimpan status UI.
• Jangan hindari perubahan konfigurasi: Jangan terapkan batasan pada orientasi, rasio aspek, atau kemampuan mengubah ukuran untuk menghindari perubahan konfigurasi dan Activity pembuatan ulang. Hal ini berdampak negatif terhadap pengguna yang ingin menggunakan aplikasi Anda dengan cara yang mereka inginkan.

Menangani perubahan konfigurasi berbasis ukuran

Perubahan konfigurasi berbasis ukuran dapat terjadi kapan saja dan lebih mungkin terjadi saat aplikasi berjalan di perangkat layar besar tempat pengguna dapat memasuki mode multi-aplikasi. Mereka menginginkan aplikasi Anda berfungsi dengan baik di lingkungan tersebut.

Ada dua jenis umum perubahan ukuran: signifikan dan tidak signifikan. Perubahan ukuran yang signifikan adalah perubahan dari kumpulan resource alternatif yang berbeda ke konfigurasi baru karena adanya perbedaan ukuran layar, seperti lebar, tinggi, atau lebar terkecil. Resource ini mencakup resource yang ditentukan aplikasi itu sendiri dan resource dari library mana pun.

Membatasi pembuatan ulang aktivitas untuk perubahan konfigurasi berbasis ukuran

Jika Anda menonaktifkan pembuatan ulang Activity untuk perubahan konfigurasi berbasis ukuran, sistem tidak akan membuat ulang Activity. Sebagai gantinya, sistem akan menerima panggilan ke Activity.onConfigurationChanged. Composable apa pun yang membaca LocalConfiguration.current akan otomatis disusun ulang untuk mencerminkan ukuran baru.

Activity pembuatan ulang dinonaktifkan untuk perubahan konfigurasi berbasis ukuran saat Anda memiliki android:configChanges="screenSize|smallestScreenSize|orientation|screenLayout" di file manifes.

Referensi lainnya

Untuk mengetahui informasi selengkapnya tentang cara menangani perubahan konfigurasi, lihat referensi tambahan berikut:

Dokumentasi

• Menyimpan status UI di Compose

Melihat konten

• Menangani perubahan konfigurasi (Tampilan)