Di chuyển sang AndroidX

AndroidX thay thế các API thư viện hỗ trợ gốc bằng các gói trong không gian tên androidx. Chỉ tên gói và cấu phần phần mềm Maven thay đổi còn lớp, phương thức và tên trường thì không.

Lưu ý: Từ cuối năm 2021, hầu hết hệ sinh thái thư viện đã hỗ trợ AndroidX. Tức là dự án của bạn có nhiều khả năng đã sử dụng trực tiếp các thư viện AndroidX. Do đó, bạn có thể không cần làm theo các bước trong hướng dẫn di chuyển này. Ngoài ra, cờ enableJetifier được đề cập trong hướng dẫn này có thể kéo dài thời gian xây dựng, vì vậy không nên sử dụng nếu không cần thiết.

Nếu dự án đã có cờ enableJetifier được bật thì bạn có thể chạy quy trình kiểm tra Jetifier của Trình phân tích bản dựng để xác nhận thao tác này có thực sự cần thiết hay không. Quy trình kiểm tra Trình phân tích bản dựng hiện có sẵn trong Android Studio Chipmunk.

Điều kiện tiên quyết

Hãy cập nhật ứng dụng trước khi bạn di chuyển. Bạn nên cập nhật dự án để sử dụng phiên bản mới nhất của thư viện hỗ trợ: phiên bản 28.0.0. Lý do là các cấu phần phần mềm AndroidX phiên bản 1.0.0 tương ứng về mặt nhị phân với các cấu phần phần mềm Thư viện hỗ trợ 28.0.0.

Lưu ý: Nên làm việc tại một nhánh riêng trong quá trình di chuyển. Ngoài ra, bạn hãy cố gắng hạn chế tái cấu trúc mã trong khi di chuyển.

Ánh xạ

Nếu bạn gặp vấn đề do dự án chưa di chuyển hoàn toàn sang AndroidX, hãy tham khảo các bảng sau để xác định các ánh xạ thích hợp từ thư viện hỗ trợ đến các cấu phần phần mềm và lớp AndroidX tương ứng:

• Ánh xạ cấu phần phần mềm Maven
• Ánh xạ lớp

Để tìm hiểu các phiên bản mới nhất của thư viện Jetpack, hãy xem trang về các phiên bản thư viện.

Tài nguyên khác

Để tìm hiểu thêm về việc di chuyển mã sang AndroidX, hãy tham khảo một số tài nguyên sau:

Bài đăng trên blog

• Di chuyển Plaid sang AndroidX
• Di chuyển sang AndroidX: Hướng dẫn, mẹo và thủ thuật

Video

• Đã đến lúc di chuyển sang AndroidX