Nếu bạn đang viết mã Compose cho ứng dụng hoặc tạo các thư viện và API Compose, hãy làm theo các phương pháp hay nhất để giúp mã của bạn có khả năng mở rộng, hiệu suất cao hơn và nhất quán với phần còn lại của hệ sinh thái.
Các tài liệu sau đây cung cấp nguyên tắc cho bất kỳ ai viết mã sử dụng Compose:
- Nguyên tắc về API đối với Jetpack Compose: Nêu ra các mẫu, phương pháp hay nhất và nguyên tắc về kiểu có tính chỉ dẫn cho mọi hệ thống sử dụng trình bổ trợ trình biên dịch và thời gian chạy Jetpack Compose. Khoá học này bao gồm các chủ đề sau:
- Nguyên tắc về kiểu Kotlin cho Compose, dựa trên Quy ước lập trình Kotlin
- Hướng dẫn cho các hàm và API
@Composableđược xây dựng dựa trên các chức năng thời gian chạy Compose - Nguyên tắc dành cho các API sử dụng và mở rộng bộ công cụ Compose UI
- Các mẫu để giải quyết các trường hợp sử dụng khi thiết kế một API Compose
- Nguyên tắc về API đối với các thành phần
@Composabletrong Jetpack Compose: Cung cấp một bộ nguyên tắc và đề xuất để tạo và sử dụng các thành phần giao diện người dùng@Composable, bao gồm cả các chủ đề sau:- Tạo và xếp lớp các thành phần
- Đặt tên cho thành phần mới
- Thể hiện các phần phụ thuộc của thành phần
- Các tham số trong thành phần
@Composable - Tuân theo các mẫu chính xác để tạo các lớp và hàm liên quan đến thành phần
- Ghi lại các thành phần
@Composable - Cải thiện khả năng hỗ trợ tiếp cận cho các thành phần
- Cập nhật API thành phần trong khi vẫn duy trì khả năng tương thích ngược
Đối tượng người xem
Các nguyên tắc này được viết cho 3 đối tượng sau:
- Nhà phát triển tạo ứng dụng dựa trên Jetpack Compose. Bạn thuộc nhóm này nếu sử dụng Jetpack Compose trong một phần của ứng dụng.
- Nhà phát triển làm việc trên quá trình phát triển khung Jetpack Compose. Bạn thuộc nhóm này nếu đóng góp cho các thư viện
androidx.compose. - Nhà phát triển tạo thư viện dựa trên Jetpack Compose. Bạn thuộc nhóm này nếu tạo các API Compose hoặc thư viện gồm các phần tử giao diện người dùng Compose. Các thư viện thành phần Compose này có thể được cung cấp công khai hoặc chỉ dành riêng cho công ty hoặc nhóm của bạn.
Tuỳ thuộc vào nhóm mà bạn tham gia, bạn sẽ có các mức độ nghiêm ngặt khác nhau cho từng nguyên tắc về phong cách. Ví dụ: hoạt động phát triển khung Jetpack Compose thường tuân thủ các nguyên tắc này một cách nghiêm ngặt nhất.
Để biết thêm thông tin về các yêu cầu đối với từng đối tượng nhà phát triển, hãy xem RFC2119.
Đóng góp cho khung và nguyên tắc
Chúng tôi hoan nghênh những đóng góp cho một số thư viện trong cơ sở mã androidx và chính các nguyên tắc về kiểu (Nguyên tắc về Compose API và nguyên tắc về các thành phần @Composable).
Để đóng góp, hãy làm theo hướng dẫn trong androidx hướng dẫn đóng góp.