Xử lý các thay đổi về cấu hình

Một số cấu hình thiết bị có thể thay đổi khi ứng dụng đang chạy. Những cấu hình này bao gồm nhưng không giới hạn ở:

• Kích thước trên màn hình của ứng dụng
• Hướng màn hình
• Cỡ chữ và độ đậm
• Ngôn ngữ
• Chế độ tối so với chế độ sáng
• Khả năng sử dụng bàn phím

Hầu hết các thay đổi về cấu hình này xảy ra do một số tương tác của người dùng. Ví dụ: việc xoay hoặc gập thiết bị sẽ thay đổi không gian màn hình hiện có cho ứng dụng. Tương tự, việc thay đổi các chế độ cài đặt của thiết bị như cỡ chữ, ngôn ngữ hoặc giao diện ưu tiên sẽ thay đổi các giá trị tương ứng trong đối tượng Configuration.

Lưu ý: Việc kết nối hoặc ngắt kết nối các thiết bị ngoại vi bên ngoài và hoạt động đa nhiệm phổ biến hơn trên thiết bị có màn hình lớn như máy tính bảng, thiết bị có thể gập lại hoặc ChromeOS. Việc thay đổi cấu hình có thể xảy ra thường xuyên hơn trên các thiết bị đó do tính linh hoạt.

Những tham số này thường yêu cầu các thay đổi đủ lớn đối với giao diện người dùng của ứng dụng để nền tảng Android có cơ chế riêng khi những tham số này thay đổi. Cơ chế này là tạo lại Activity.

Tạo lại hoạt động

Hệ thống sẽ tạo lại một Activity khi cấu hình thay đổi. Để thực hiện việc này, hệ thống sẽ gọi onDestroy() và huỷ bỏ thực thể Activity hiện có. Sau đó, hệ thống sẽ tạo một thực thể mới bằng cách sử dụng onCreate() và thực thể mới của Activity này sẽ được khởi động bằng cấu hình mới, cập nhật. Việc này cũng có nghĩa là hệ thống cũng tạo lại giao diện người dùng bằng cấu hình mới.

Hành vi tạo lại giúp ứng dụng của bạn thích ứng với các cấu hình mới bằng cách tự động tải lại ứng dụng có những tài nguyên thay thế khớp với cấu hình thiết bị mới.

Ví dụ về việc tạo lại

Hãy cân nhắc dùng TextView để hiển thị tiêu đề tĩnh bằng android:text="@string/title", như xác định trong tệp XML bố cục. Khi được tạo, khung hiển thị sẽ đặt văn bản chính xác một lần dựa trên ngôn ngữ hiện tại. Nếu ngôn ngữ thay đổi, hệ thống sẽ tạo lại hoạt động. Do đó, hệ thống cũng sẽ tạo lại khung hiển thị và khởi động khung hiển thị đó theo đúng giá trị dựa trên ngôn ngữ mới.

Việc tạo lại cũng sẽ xoá mọi trạng thái được giữ lại ở dạng trường trong Activity hoặc trong bất kỳ Fragment, View hoặc đối tượng nào khác có trong đó. Nguyên nhân là vì việc tạo lại Activity sẽ tạo ra một thực thể hoàn toàn mới của Activity và giao diện người dùng. Hơn nữa, Activity cũ không còn hiển thị hoặc hợp lệ nữa. Do đó, mọi dữ liệu tham chiếu còn lại đến mã đó hoặc các đối tượng có chứa mã đó đều đã lỗi thời. Chúng có thể gây ra lỗi, rò rỉ bộ nhớ và sự cố.

Lưu ý: Việc tạo lại Activity do các thay đổi về cấu hình chỉ là một trong các trường hợp mà hệ thống có thể huỷ bỏ một Activity và tạo lại sau này. Để biết thêm thông tin, hãy đọc phần Vòng đời Activity.

Kỳ vọng của người dùng

Người dùng ứng dụng mong muốn trạng thái được giữ nguyên. Nếu người dùng điền vào biểu mẫu và mở một ứng dụng khác ở chế độ nhiều cửa sổ để tham chiếu thông tin, trải nghiệm người dùng kém nếu họ quay lại biểu mẫu đã xóa hoặc một vị trí khác trong ứng dụng. Là nhà phát triển, bạn phải mang đến trải nghiệm nhất quán cho người dùng khi thay đổi cấu hình và tạo lại hoạt động.

Để xác minh xem trạng thái có được giữ nguyên trong ứng dụng hay không, bạn có thể thực hiện các thao tác khiến cấu hình thay đổi cả khi ứng dụng đang chạy ở nền trước lẫn khi chạy trong nền. Các thao tác này bao gồm:

• Xoay thiết bị
• Chuyển sang chế độ nhiều cửa sổ
• Đổi kích thước của ứng dụng khi ở chế độ nhiều cửa sổ hoặc cửa sổ tuỳ ý
• Gập thiết bị có thể gập lại với nhiều màn hình
• Thay đổi giao diện của hệ thống, chẳng hạn như chế độ tối so với chế độ sáng
• Thay đổi cỡ chữ
• Thay đổi ngôn ngữ hệ thống hoặc ngôn ngữ ứng dụng
• Kết nối hoặc ngắt kết nối bàn phím phần cứng
• Kết nối hoặc ngắt kết nối đế sạc

Lưu ý: Trước đây, bạn có thể ngăn một số thay đổi về cấu hình này bằng cách hạn chế các tỷ lệ khung hình và hướng được hỗ trợ hoặc tắt tính năng đổi kích thước. Trong Android 12L (API cấp 32) trở lên, một ứng dụng đã thêm các hạn chế này sẽ chuyển sang chế độ tương thích nếu không trực tiếp hỗ trợ trạng thái hiện tại của thiết bị. Nếu một ứng dụng đã thêm các hạn chế này để tránh việc tạo lại Activity, hãy đảm bảo ứng dụng hoạt động đúng cách và không bị mất trạng thái khi mở khoá các hạn chế đó nhằm tận dụng màn hình trên mọi thiết bị.

Có 3 cách tiếp cận chính mà bạn có thể thực hiện để duy trì trạng thái liên quan khi tạo lại Activity. Việc sử dụng cách tiếp cận nào tuỳ thuộc vào loại trạng thái mà bạn muốn duy trì:

• Cố định cục bộ để xử lý trường hợp bị buộc tắt đối với dữ liệu lớn hoặc phức tạp. Bộ nhớ cục bộ ổn định bao gồm cơ sở dữ liệu hoặc DataStore.
• Các đối tượng được giữ lại như các thực thể ViewModel để xử lý trạng thái liên quan đến giao diện người dùng trong bộ nhớ khi người dùng đang dùng ứng dụng.
• Trạng thái đã lưu của thực thể để xử lý trường hợp hệ thống buộc tắt và giữ trạng thái tạm thời tuỳ thuộc vào hoạt động đầu vào hoặc thao tác của người dùng.

Để đọc chi tiết về các API cho từng trạng thái trong số này và thời điểm phù hợp để dùng mỗi trạng thái đó, hãy xem bài viết Lưu trạng thái giao diện người dùng.

Hạn chế việc tạo lại hoạt động

Bạn có thể ngăn việc tự động tạo lại hoạt động đối với một số thay đổi về cấu hình. Việc tạo lại Activity sẽ tạo lại toàn bộ giao diện người dùng và mọi đối tượng bắt nguồn từ Activity. Có thể bạn có lý do chính đáng để tránh làm như vậy. Ví dụ: ứng dụng của bạn có thể không cần cập nhật tài nguyên trong một thay đổi cụ thể về cấu hình, hoặc bạn có thể bị giới hạn về hiệu suất. Trong trường hợp đó, bạn có thể khai báo rằng hoạt động của bạn tự xử lý thay đổi về cấu hình và ngăn hệ thống khởi động lại hoạt động.

Để tắt tính năng tạo lại hoạt động cho các thay đổi cụ thể về cấu hình, hãy thêm loại cấu hình vào android:configChanges trong mục <activity> ở tệp AndroidManifest.xml của bạn. Các giá trị có thể có xuất hiện trong tài liệu về thuộc tính android:configChanges.

Mã tệp kê khai sau đây sẽ tắt tính năng tạo lại Activity cho MyActivity khi hướng màn hình và khả năng sử dụng bàn phím thay đổi:

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

Một số thay đổi về cấu hình luôn khiến hoạt động khởi động lại. Bạn không thể tắt chúng. Ví dụ: bạn không thể tắt tính năng thay đổi màu động được ra mắt trong Android 12L (API cấp 32).

Cảnh báo: Ngay cả khi bạn tắt tính năng tạo lại hoạt động đối với một thay đổi cụ thể về cấu hình, thay đổi đó vẫn tiếp tục xảy ra. Việc tắt tính năng tạo lại Activity sẽ chuyển trách nhiệm xử lý thay đổi về cấu hình đó sang Activity. Nếu bạn tắt tính năng tạo lại Activity, thì ứng dụng của bạn phải xử lý thay đổi một cách thích hợp khi nó diễn ra.

Phản ứng với các thay đổi về cấu hình trong hệ thống Khung hiển thị

Trong hệ thống View, khi cấu hình thay đổi mà bạn đã tắt tính năng tạo lại Activity, hoạt động đó sẽ nhận được một lệnh gọi đến Activity.onConfigurationChanged(). Bất kỳ khung hiển thị đính kèm nào cũng sẽ nhận được lệnh gọi đến View.onConfigurationChanged(). Đối với các thay đổi về cấu hình mà bạn chưa thêm vào android:configChanges, hệ thống sẽ tạo lại hoạt động như bình thường.

Cảnh báo: Trong hệ thống View, khi tắt tính năng tạo lại Activity, việc sử dụng tài nguyên thay thế sẽ trở nên khó khăn hơn nhiều. Lý do là hệ thống không còn áp dụng các thay đổi này cho bạn. Trong các ứng dụng được tạo bằng hệ thống View, hãy chỉ tắt tính năng tạo lại Activity như một phương án cuối cùng khi bạn phải tránh việc khởi động lại do thay đổi về cấu hình. Không nên dùng phương án này cho hầu hết các ứng dụng.

Phương thức gọi lại onConfigurationChanged() nhận đối tượng Configuration chỉ định cấu hình mới cho thiết bị. Đọc các trường trong đối tượng Configuration để xác định cấu hình mới của bạn. Để thực hiện các thay đổi tiếp theo, hãy cập nhật tài nguyên bạn sử dụng trong giao diện. Khi hệ thống gọi phương thức này, đối tượng Resources của hoạt động sẽ được cập nhật để trả về tài nguyên dựa trên cấu hình mới. Việc này cho phép bạn đặt lại các phần tử trên giao diện người dùng mà không cần hệ thống khởi động lại hoạt động của bạn.

Ví dụ: quy trình triển khai onConfigurationChanged() sau đây sẽ kiểm tra xem có bàn phím không:

Kotlin

override fun onConfigurationChanged(newConfig: Configuration) {
    super.onConfigurationChanged(newConfig)

    // Checks whether a keyboard is available
    if (newConfig.keyboardHidden === Configuration.KEYBOARDHIDDEN_YES) {
        Toast.makeText(this, "Keyboard available", Toast.LENGTH_SHORT).show()
    } else if (newConfig.keyboardHidden === Configuration.KEYBOARDHIDDEN_NO) {
        Toast.makeText(this, "No keyboard", Toast.LENGTH_SHORT).show()
    }
}

Java

@Override
public void onConfigurationChanged(Configuration newConfig) {
    super.onConfigurationChanged(newConfig);

    // Checks whether a keyboard is available
    if (newConfig.keyboardHidden == Configuration.KEYBOARDHIDDEN_YES) {
        Toast.makeText(this, "Keyboard available", Toast.LENGTH_SHORT).show();
    } else if (newConfig.keyboardHidden == Configuration.KEYBOARDHIDDEN_NO){
        Toast.makeText(this, "No keyboard", Toast.LENGTH_SHORT).show();
    }
}

Nếu không cần cập nhật ứng dụng dựa trên những thay đổi về cấu hình này, bạn có thể không cần triển khai onConfigurationChanged(). Trong trường hợp đó, mọi tài nguyên được dùng trước khi thay đổi cấu hình vẫn được sử dụng và bạn chỉ tránh được việc khởi động lại hoạt động của mình. Ví dụ: một ứng dụng TV không nên phản ứng khi bàn phím Bluetooth được gắn hoặc tháo rời.

Giữ lại trạng thái

Khi sử dụng kỹ thuật này, bạn vẫn phải giữ nguyên trạng thái trong vòng đời hoạt động bình thường. Lý do là:

• Các thay đổi không tránh được: các thay đổi về cấu hình mà bạn không ngăn chặn được có thể khởi động lại ứng dụng của bạn.
• Trường hợp bị buộc tắt: ứng dụng của bạn phải có khả năng xử lý trường hợp hệ thống buộc tắt. Nếu người dùng rời khỏi ứng dụng của bạn và ứng dụng chuyển sang chạy trong nền, thì hệ thống có thể huỷ bỏ ứng dụng đó.

Lưu ý quan trọng: Khi tắt tính năng tạo lại hoạt động cho một thay đổi về cấu hình, bạn có trách nhiệm đặt lại mọi phần tử mà bạn cung cấp các lựa chọn thay thế. Ví dụ: nếu tắt tính năng tạo lại hoạt động cho một Activity có hình ảnh thay đổi giữa chế độ ngang và dọc, thì bạn phải gán lại từng tài nguyên cho từng phần tử trong onConfigurationChanged().

Phản ứng với các thay đổi về cấu hình trong Jetpack Compose

Jetpack Compose giúp ứng dụng của bạn dễ dàng phản ứng với các thay đổi về cấu hình. Tuy nhiên, nếu bạn tắt tính năng tạo lại Activity cho mọi thay đổi về cấu hình, ứng dụng của bạn vẫn phải xử lý đúng cách các thay đổi về cấu hình nếu có thể.

Đối tượng Configuration có trong hệ phân cấp giao diện người dùng Compose với thành phần kết hợp cục bộ LocalConfiguration. Bất cứ khi nào giá trị này thay đổi, các hàm có khả năng kết hợp đọc từ LocalConfiguration.current sẽ kết hợp lại. Để biết thông tin về cách hoạt động của thành phần kết hợp cục bộ, hãy xem bài viết Dữ liệu trong phạm vi cục bộ với CompositionLocal.

Lưu ý quan trọng: Như đã thảo luận trong phần Hạn chế việc tạo lại Activity, bạn không thể tắt hoàn toàn tính năng tạo lại Activity trong ứng dụng Android. Vì vậy, bạn vẫn cần lưu trạng thái chính xác khi hệ thống tạo lại Activity. Ngoài ra, các khung hiển thị được nhúng trong Compose có API có khả năng tương tác (chẳng hạn như AndroidView) có thể sẽ tạo lại Activity khi có các thay đổi về cấu hình. Ngoài ra, nếu một hàm có khả năng kết hợp kết hợp lại do thay đổi về cấu hình, thì khung hiển thị được sử dụng bên trong các API có khả năng tương tác cũng sẽ kết hợp lại.

Ví dụ

Trong ví dụ sau, một thành phần kết hợp hiển thị một ngày có định dạng cụ thể. Thành phần kết hợp phản ứng với các thay đổi về cấu hình ngôn ngữ hệ thống bằng cách gọi ConfigurationCompat.getLocales() thông qua 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))
    )
}

Để tránh việc tạo lại Activity khi ngôn ngữ thay đổi, Activity lưu trữ mã Compose cần chọn không thay đổi cấu hình ngôn ngữ. Để làm như vậy, bạn đặt android:configChanges thành locale|layoutDirection.

Cảnh báo: Để các hàm có khả năng kết hợp kết hợp lại, trạng thái đọc phải thuộc loại State. Đây là trường hợp của thành phần kết hợp cục bộ liên quan đến cấu hình và LocalConfiguration cụ thể. Đang cố đọc ngôn ngữ hiện tại trong Việc Compose sử dụng Locale.getDefault() không khiến thành phần kết hợp kết hợp lại và không phản ứng với các thay đổi về cấu hình. Bởi vì đây không phải là kiểu State. Để biết thêm thông tin về trạng thái trong Compose, hãy xem phần Trạng thái và Jetpack Compose.

Các thay đổi về cấu hình: Các khái niệm chính và phương pháp hay nhất

Dưới đây là các khái niệm chính mà bạn cần biết khi xử lý các thay đổi về cấu hình:

• Cấu hình: Cấu hình thiết bị xác định cách giao diện người dùng xuất hiện với người dùng, chẳng hạn như kích thước trên màn hình của ứng dụng, ngôn ngữ hoặc giao diện hệ thống.
• Các thay đổi về cấu hình: cấu hình thay đổi khi người dùng tương tác. Ví dụ: người dùng có thể thay đổi chế độ cài đặt của thiết bị hoặc cách họ tương tác thực tế với thiết bị. Không có cách nào để ngăn các thay đổi về cấu hình.
• Tạo lại Activity: theo mặc định, các thay đổi về cấu hình sẽ dẫn đến việc tạo lại Activity. Đây là cơ chế tích hợp sẵn để khởi động lại trạng thái ứng dụng cho cấu hình mới.
• Huỷ bỏ Activity: việc tạo lại Activity sẽ khiến hệ thống huỷ bỏ thực thể cũ của Activity và tạo một thực thể mới tại vị trí đó. Thực thể cũ hiện đã lỗi thời. Mọi tham chiếu còn lại đến thực thể đó sẽ dẫn đến rò rỉ bộ nhớ, lỗi hoặc sự cố.
• Trạng thái: trạng thái trong thực thể cũ của Activity không có trong thực thể mới của Activity, vì đây là 2 thực thể khác nhau của đối tượng. Duy trì trạng thái của ứng dụng và người dùng như mô tả trong bài viết Lưu trạng thái giao diện người dùng.
• Chọn không sử dụng: việc chọn không tạo lại hoạt động cho một loại thay đổi về cấu hình là khả năng tối ưu hoá. Phương thức này yêu cầu ứng dụng của bạn cập nhật đúng cách theo cấu hình mới.

Để mang lại trải nghiệm tốt cho người dùng, hãy tuân thủ các phương pháp hay nhất sau:

• Phải chuẩn bị cho các thay đổi thường xuyên về cấu hình: đừng giả định rằng các thay đổi về cấu hình là hiếm hoặc không bao giờ xảy ra, bất kể cấp độ API, hệ số hình dạng hoặc bộ công cụ giao diện người dùng. Khi người dùng khiến cấu hình thay đổi, họ mong muốn các ứng dụng cập nhật và tiếp tục hoạt động đúng cách với cấu hình mới này.
• Duy trì trạng thái: đừng làm mất trạng thái của người dùng khi tạo lại Activity. Duy trì trạng thái như mô tả trong bài viết Lưu trạng thái giao diện người dùng.
• Tránh chọn không sử dụng tính năng sửa nhanh: đừng chọn không sử dụng tính năng tạo lại Activity ở dạng lối tắt để tránh bị mất trạng thái. Việc chọn không tạo lại hoạt động sẽ yêu cầu bạn thực hiện cam kết xử lý thay đổi, và bạn vẫn có thể mất trạng thái do tạo lại Activity từ các thay đổi khác về cấu hình, trường hợp bị buộc tắt hoặc đóng ứng dụng. Bạn không thể tắt hoàn toàn tính năng tạo lại Activity. Duy trì trạng thái như mô tả trong bài viết Lưu trạng thái giao diện người dùng.
• Đừng tránh các thay đổi về cấu hình: đừng đặt các quy định hạn chế về hướng, tỷ lệ khung hình hoặc khả năng đổi kích thước để tránh các thay đổi về cấu hình và tạo lại Activity. Việc này sẽ tác động tiêu cực đến người dùng muốn sử dụng ứng dụng của bạn theo ý họ.

Xử lý các thay đổi về cấu hình dựa trên kích thước

Các thay đổi về cấu hình dựa trên kích thước có thể xảy ra bất cứ lúc nào và có nhiều khả năng là khi ứng dụng của bạn chạy trên một thiết bị màn hình lớn. Tại đây, người dùng có thể chuyển sang chế độ nhiều cửa sổ. Họ muốn ứng dụng của bạn hoạt động tốt trong môi trường đó.

Có 2 loại thay đổi chung về kích thước: đáng kể và không đáng kể. Thay đổi kích thước đáng kể là thay đổi trong đó một nhóm tài nguyên thay thế sẽ áp dụng cho cấu hình mới do sự khác biệt trong kích thước màn hình, chẳng hạn như chiều rộng, chiều cao hoặc chiều rộng nhỏ nhất. Các tài nguyên này bao gồm những tài nguyên mà ứng dụng tự xác định và những tài nguyên từ bất kỳ thư viện nào của nó.

Hạn chế việc tạo lại hoạt động đối với các thay đổi về cấu hình dựa trên kích thước

Khi bạn tắt tính năng tạo lại Activity đối với các thay đổi về cấu hình dựa trên kích thước, hệ thống sẽ không tạo lại Activity. Thay vào đó, hệ thống sẽ nhận được một lệnh gọi đến Activity.onConfigurationChanged(). Bất kỳ khung hiển thị đính kèm nào cũng sẽ nhận được lệnh gọi đến View.onConfigurationChanged().

Lưu ý quan trọng: Trong Android 12 (API cấp 31) và Android 12L (API cấp 32), Activity.onConfigurationChanged() chỉ được gọi khi có thay đổi đáng kể. Đây là lỗi đã được khắc phục trong các phiên bản API sau này.

Tính năng tạo lại Activity bị tắt đối với các thay đổi về cấu hình dựa trên kích thước khi bạn có android:configChanges="screenSize|smallestScreenSize|orientation|screenLayout" trong tệp kê khai.

Cho phép việc tạo lại hoạt động đối với các thay đổi về cấu hình dựa trên kích thước

Trên Android 7.0 (API cấp 24) trở lên, việc tạo lại Activity chỉ xảy ra đối với các thay đổi về cấu hình dựa trên kích thước nếu sự thay đổi về kích thước là đáng kể. Khi không tạo lại Activity do không đủ kích thước, hệ thống có thể gọi Activity.onConfigurationChanged() và View.onConfigurationChanged().

Có một số điểm cần lưu ý liên quan đến lệnh gọi lại Activity và View khi Activity không được tạo lại:

• Trên Android 11 (API cấp 30) đến Android 13 (API cấp 33), Activity.onConfigurationChanged() không được gọi.
• Có một sự cố đã biết, đó là View.onConfigurationChanged() có thể không được gọi trong một số trường hợp trên Android 12L (API cấp 32) và các phiên bản ban đầu của Android 13 (API cấp 33). Để biết thêm thông tin, hãy xem sự cố công khai này. Vấn đề này đã được giải quyết trong các bản phát hành Android 13 và Android 14 sau này.

Đối với mã phụ thuộc vào việc theo dõi các thay đổi về cấu hình dựa trên kích thước, bạn nên sử dụng View tiện ích có View.onConfigurationChanged() được ghi đè thay vì dựa vào việc tạo lại Activity hoặc Activity.onConfigurationChanged().

Lưu ý: Tính năng tạo lại Activity sẽ không bị tắt nếu bạn có android:configChanges="" cho Activity trong tệp kê khai. Trường hợp này cũng xảy ra với những thay đổi cấu hình dựa trên kích thước không liên quan như android:configChanges="uiMode".