Thêm các thành phần vào dự án

Trước khi bắt đầu, bạn nên đọc tài liệu về Thành phần cấu trúc Hướng dẫn thiết lập Cấu trúc ứng dụng. Hướng dẫn này có một số nguyên tắc hữu ích có thể áp dụng cho tất cả ứng dụng Android và cho bạn biết cách sử dụng cùng lúc nhiều Thành phần cấu trúc.

Các Thành phần cấu trúc đang có sẵn trong kho lưu trữ Maven của Google. Bạn phải thêm kho lưu trữ vào dự án để có thể sử dụng các thành phần này.

Mở tệp settings.gradle và thêm kho lưu trữ google() như hình bên dưới:

dependencyResolutionManagement {
   ...
    repositories {
        google()
        jcenter()
    }
}

dependencyResolutionManagement {
    ...
    repositories {
        google()
        jcenter()
    }
}

Khai báo phần phụ thuộc

Mở tệp build.gradle cho ứng dụng hoặc mô-đun của bạn và thêm các cấu phần phần mềm mà bạn cần làm phần phụ thuộc. Bạn có thể thêm thành phần phụ thuộc cho tất cả Thành phần cấu trúc hoặc chọn một tập hợp con.

Xem hướng dẫn cách khai báo phần phụ thuộc cho từng Thành phần cấu trúc trong phần ghi chú phát hành:

• Futures (có trong androidx.concurrent)
• Các thành phần Vòng đời (kể cả ViewModel)
• Navigation (kể cả SafeArgs)
• Paping
• Room
• WorkManager

Bạn có thể xem các bản phát hành AndroidX để biết số phiên bản mới nhất cho từng thành phần.

Để biết thêm thông tin về việc tái cấu trúc AndroidX và mức độ ảnh hưởng của thư viện này đến các gói và mã mô-đun lớp nói trên, hãy xem tài liệu về việc tái cấu trúc AndroidX.

Kotlin

Một số phần phụ thuộc AndroidX hỗ trợ các mô-đun phần mở rộng Kotlin. Những mô-đun này có hậu tố "-ktx" được thêm vào tên của các mô-đun đó. Ví dụ:

implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version"

implementation("androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version")

trở thành

implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"

implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")

Bạn có thể tìm thêm thông tin (kể cả tài liệu về phần mở rộng của Kotlin) trong tài liệu về KTX.

Lưu ý: Đối với các ứng dụng dựa trên Kotlin, hãy đảm bảo rằng bạn sử dụng kapt thay vì annotationProcessor. Bạn cũng nên thêm trình bổ trợ kotlin-kapt.