Chẩn đoán các vấn đề về độ ổn định

Nếu đang gặp vấn đề về hiệu suất do việc kết hợp lại quá mức hoặc không cần thiết, bạn nên gỡ lỗi để ổn định ứng dụng của mình. Hướng dẫn này đề ra một số phương pháp để thực hiện điều này.

Lưu ý quan trọng: Bạn nên nhắm đến việc đối phó với tình trạng tối ưu hoá không cần thiết hoặc quá sớm. Trước khi tối ưu hoá để đảm bảo tính ổn định, hãy đảm bảo bạn đang làm theo các phương pháp hay nhất của chúng tôi để đạt được hiệu suất của Compose.

Lưu ý: Nếu bạn muốn biết thêm thông tin về cách phù hợp để đo lường hiệu suất, hãy xem Hướng dẫn về Macrobenchmark.

Layout Inspector

Layout Inspector trong Android Studio cho phép bạn xem thành phần kết hợp nào đang được kết hợp lại trong ứng dụng của mình. Công cụ này cũng cho thấy số lần Compose đã kết hợp lại hoặc bỏ qua một thành phần.

Báo cáo của trình biên dịch Compose

Trình biên dịch Compose có thể đưa ra kết quả suy luận về độ ổn định của nó để bạn kiểm tra. Bằng cách sử dụng kết quả này, bạn có thể xác định thành phần kết hợp nào có thể bỏ qua và thành phần nào thì không. Các tiểu mục tiếp theo tóm tắt cách sử dụng các báo cáo này, nhưng để biết thêm thông tin, hãy xem tài liệu kỹ thuật.

Cảnh báo: Bạn chỉ nên sử dụng kỹ thuật này nếu thực sự đang gặp vấn đề về hiệu suất liên quan đến độ ổn định. Việc cố gắng để có thể bỏ qua toàn bộ giao diện người dùng của bạn là một biện pháp tối ưu hoá sớm và có thể dẫn đến những khó khăn sau này trong việc bảo trì.

Thiết lập

Các báo cáo của trình biên dịch Compose không được bật theo mặc định. Bạn có thể bật tính năng này bằng cờ của trình biên dịch. Chế độ thiết lập chính xác sẽ khác nhau tuỳ thuộc vào dự án, nhưng đối với các dự án sử dụng trình bổ trợ gradle của trình biên dịch Compose, bạn có thể thêm phần sau vào mỗi tệp build.gradle mô-đun.

  android { ... }

  composeCompiler {
    reportsDestination = layout.buildDirectory.dir("compose_compiler")
    metricsDestination = layout.buildDirectory.dir("compose_compiler")
  }

Giờ đây, các báo cáo của trình biên dịch Compose sẽ được tạo khi bạn tạo dự án.

Lưu ý quan trọng: Hãy nhớ luôn chạy tác vụ này trên một bản phát hành để đảm bảo tính chính xác kết quả.

Kết quả ví dụ

reportsDestination xuất ra 3 tệp. Sau đây là ví dụ về kết quả đầu ra từ JetSnack.

• <modulename>-classes.txt: Một báo cáo về tính ổn định của các lớp trong mô-đun này. Mẫu.
• <modulename>-composables.txt: Một báo cáo về khả năng khởi động lại và bỏ qua của các thành phần kết hợp trong mô-đun. Mẫu.
• <modulename>-composables.csv: Một phiên bản CSV của báo cáo về thành phần kết hợp. Bạn có thể nhập báo cáo này vào bảng tính hoặc xử lý bằng tập lệnh. Mẫu

Lưu ý: Cấu hình metricsDestination tạo ra số liệu thống kê tổng thể về số lượng thành phần kết hợp trong dự án của bạn và các thông tin tương tự khác.

Lưu ý: Những báo cáo này sử dụng thẻ trình biên dịch được mô tả trong phần Compose về độ ổn định.

Báo cáo về thành phần kết hợp

Tệp composables.txt nêu chi tiết từng hàm có khả năng kết hợp cho mô-đun nhất định, bao gồm cả độ ổn định của các tham số của hàm đó và liệu hàm đó có thể khởi động lại hay có thể bỏ qua hay không. Sau đây là một ví dụ giả định từ JetSnack:

restartable skippable scheme("[androidx.compose.ui.UiComposable]") fun SnackCollection(
  stable snackCollection: SnackCollection
  stable onSnackClick: Function1<Long, Unit>
  stable modifier: Modifier? = @static Companion
  stable index: Int = @static 0
  stable highlight: Boolean = @static true
)

Thành phần kết hợp SnackCollection này hoàn toàn có thể khởi động lại, bỏ qua và ổn định. Thành phần này thường được ưa chuộng hơn, mặc dù chắc chắn là không bắt buộc phải sử dụng.

Mặt khác, hãy xem một ví dụ nữa.

restartable scheme("[androidx.compose.ui.UiComposable]") fun HighlightedSnacks(
  stable index: Int
  unstable snacks: List<Snack>
  stable onSnackClick: Function1<Long, Unit>
  stable modifier: Modifier? = @static Companion
)

Không thể bỏ qua thành phần kết hợp HighlightedSnacks. Compose sẽ không bao giờ bỏ qua thành phần này trong quá trình kết hợp lại. Điều này xảy ra ngay cả khi không có tham số nào của thành phần này thay đổi. Nguyên nhân là do tham số unstable, snacks.

Báo cáo về các lớp

Tệp classes.txt này chứa một báo cáo tương tự về các lớp trong mô-đun nhất định. Đoạn mã sau đây là kết quả đối với lớp Snack:

unstable class Snack {
  stable val id: Long
  stable val name: String
  stable val imageUrl: String
  stable val price: Long
  stable val tagline: String
  unstable val tags: Set<String>
  <runtime stability> = Unstable
}

Để tham khảo, sau đây là định nghĩa của Snack:

data class Snack(
    val id: Long,
    val name: String,
    val imageUrl: String,
    val price: Long,
    val tagline: String = "",
    val tags: Set<String> = emptySet()
)

Trình biên dịch Compose đã đánh dấu Snack là không ổn định. Nguyên nhân là do kiểu của tham số tags là Set<String>. Đây là một kiểu dữ liệu bất biến, vì không phải là MutableSet. Tuy nhiên, về bản chất thì các lớp tập hợp tiêu chuẩn như Set, List và Map đều là các giao diện. Như vậy, phương thức triển khai cơ bản có thể vẫn có khả năng biến đổi.

Ví dụ: bạn có thể viết val set: Set<String> = mutableSetOf("foo"). Biến này là hằng số và kiểu dữ liệu đã khai báo của nó là không biến đổi được, nhưng vẫn có thể biến đổi phương thức triển khai. Trình biên dịch Compose không thể chắc chắn về tính bất biến của lớp này vì nó chỉ nhìn thấy kiểu dữ liệu đã khai báo. Do đó công cụ này đánh dấu tags là không ổn định.

Lưu ý quan trọng: Để biết thông tin về cách làm cho một lớp không ổn định như thế này trở nên ổn định, hãy xem hướng dẫn Khắc phục sự cố về tính ổn định.