Thêm một mô-đun cho thiết bị mới

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Các mô-đun cung cấp vùng chứa cho mã nguồn, tệp tài nguyên và các tùy chọn cài đặt cấp ứng dụng, chẳng hạn như tệp tạo ở cấp mô-đun và tệp kê khai Android. Mỗi mô-đun có thể được tạo, thử nghiệm và gỡ lỗi độc lập.

Android Studio sử dụng các mô-đun để giúp bạn dễ dàng thêm thiết bị mới vào dự án của bạn. Bằng cách làm theo một vài bước đơn giản trong Android Studio, bạn có thể tạo một mô-đun chứa mã dành riêng cho một loại thiết bị, chẳng hạn như Wear OS hoặc Android TV. Android Studio tự động tạo các thư mục mô-đun (chẳng hạn như thư mục nguồn và tài nguyên) và tệp build.gradle mặc định phù hợp với loại thiết bị. Ngoài ra, Android Studio sẽ tạo các mô-đun thiết bị có cấu hình bản dựng được đề xuất, chẳng hạn như sử dụng thư viện Leanback cho các mô-đun Android TV.

Trang này mô tả cách thêm mô-đun mới cho một thiết bị cụ thể.

Android Studio cũng giúp bạn dễ dàng thêm thư viện hoặc mô-đun Google Cloud vào dự án của mình. Để biết thông tin chi tiết về việc tạo một mô-đun thư viện, hãy xem phần Tạo mô-đun thư viện.

Tạo mô-đun mới

Để thêm một mô-đun mới vào dự án của bạn cho một thiết bị mới, hãy làm như sau:

  1. Nhấp vào File > New > New Module (Tệp > Mới > Mô-đun mới).
  2. Trong cửa sổ Create New Module (Tạo mô-đun mới) xuất hiện, Android Studio cung cấp các mô-đun thiết bị sau:
    • Mô-đun điện thoại và máy tính bảng
    • Mô-đun Wear OS
    • Mô-đun Android TV
    • Mô-đun Mắt kính
    Chọn mô-đun cho thiết bị bạn muốn, sau đó nhấp vào Next (Tiếp tục).
  3. Trong biểu mẫu Configure your new module (Định cấu hình mô-đun mới), hãy nhập các thông tin sau:
    • Application Name (Tên ứng dụng): Tên này được dùng làm tiêu đề của biểu tượng trình chạy cho mô-đun mới.
    • Module Name (Tên mô-đun): Văn bản này được dùng làm tên của thư mục hiển thị mã nguồn và tệp tài nguyên của bạn.
    • Package Name (Tên gói): Đây là không gian tên Java cho mã trong mô-đun của bạn. Tên này sẽ trở thành thuộc tính package trong tệp kê khai Android của mô-đun.
    • SDK tối thiểu: Tùy chọn cài đặt này cho biết phiên bản Nền tảng Android thấp nhất mà mô-đun ứng dụng hỗ trợ. Giá trị này sẽ quy định thuộc tính minSdkVersion trong tệp build.gradle mà bạn có thể chỉnh sửa sau.

    Sau đó nhấp vào Next (Tiếp theo).

  4. Tùy thuộc vào mô-đun thiết bị bạn đã chọn, trang sau đây sẽ hiển thị một số mã mẫu thích hợp mà bạn có thể chọn làm hoạt động chính. Nhấp vào một mẫu hoạt động mà bạn muốn bắt đầu, sau đó nhấp vào Next (Tiếp). Nếu bạn không cần hoạt động nào, hãy nhấp vào Add No Activity (Không thêm hoạt động), nhấp vào Finish (Hoàn tất) và thế là xong.
  5. Nếu bạn đã chọn một mẫu hoạt động, hãy nhập các tùy chọn cài đặt cho hoạt động của bạn trên trang Customize the Activity (Tùy chỉnh hoạt động). Hầu hết các mẫu đều yêu cầu Activity Name (Tên hoạt động), Layout Name (Tên bố cục), Title (Tiêu đề) và Source Language (Ngôn ngữ nguồn) nhưng mỗi mẫu có một vài chế độ cài đặt đặc trưng cho hoạt động của bạn. Nhấp vào Hoàn tất. Khi tạo mô-đun ứng dụng với mẫu hoạt động, bạn có thể chạy và kiểm tra mô-đun ngay trên thiết bị của mình.

Android Studio tạo tất cả các tệp cần thiết cho mô-đun mới và đồng bộ hóa dự án với các tệp gradle mô-đun mới. Thêm mô-đun cho một thiết bị mới cũng sẽ thêm mọi phần phụ thuộc bắt buộc cho thiết bị đích vào tệp bản dựng của mô-đun.

Sau khi quá trình đồng bộ hóa dự án Gradle hoàn tất, mô-đun mới sẽ xuất hiện trong cửa sổ Project (Dự án) ở bên trái. Nếu bạn không thấy thư mục mô-đun mới, hãy đảm bảo cửa sổ hiển thị Chế độ xem Android.

Nhập mô-đun

Để thêm một mô-đun hiện có vào dự án của bạn, hãy tiến hành như sau:

  1. Nhấp vào File > New > Import Module(Tệp > Mới > Thêm Mô-đun).
  2. Trong hộp Source directory (Thư mục nguồn), hãy nhập hoặc chọn thư mục của mô-đun mà bạn muốn nhập:
    • Nếu bạn đang nhập một mô-đun, hãy chỉ rõ thư mục gốc của mô-đun đó.
    • Nếu bạn đang nhập nhiều mô-đun từ một dự án, hãy chỉ ra thư mục dự án. Đối với mỗi mô-đun bên trong thư mục, một hộp sẽ xuất hiện và cho biết Vị trí nguồnTên mô-đun. Hãy đảm bảo rằng bạn đã đánh dấu vào hộp Import(Thêm) cho từng mô-đun mà bạn muốn thêm vào.
    Nếu(các) mô-đun của bạn có các phần phụ thuộc khác, thì các mô-đun đó sẽ được liệt kê để thêm trong phần Mô-đun bắt buộc bổ sung.
  3. Nhập tên mô-đun mà bạn muốn vào trường Tên mô-đun.
  4. Nhấp vào Hoàn tất.

Sau khi được nhập, mô-đun sẽ xuất hiện trong cửa sổ Project (Dự án) ở bên trái.

Bước tiếp theo

Sau khi thêm mô-đun mới, bạn có thể sửa đổi mã và tài nguyên mô-đun, định cấu hình tùy chọn cài đặt bản dựng của mô-đun và xây dựng mô-đun. Bạn cũng có thể chạy và gỡ lỗi mô-đun như bất kỳ ứng dụng nào khác.

Bạn cũng nên thêm mã và tài nguyên để hỗ trợ thiết bị mới đúng cách. Để biết thêm thông tin về cách phát triển các mô-đun ứng dụng cho các loại thiết bị khác nhau, hãy xem tài liệu tương ứng.

Khi phát triển mô-đun mới, bạn có thể tạo mã độc lập cho thiết bị đã bị trùng lặp trong một mô-đun ứng dụng khác. Thay vì duy trì mã trùng lặp, hãy cân nhắc di chuyển mã được chia sẻ sang một mô-đun thư viện và thêm thư viện đó vào phần phụ thuộc của các mô-đun ứng dụng. Để biết thêm thông tin về việc tạo mô-đun thư viện và thêm mô-đun làm phần phụ thuộc, hãy xem Tạo thư viện Android.