Tổng quan về dự án

Một dự án trong Android Studio chứa mọi thông tin giúp xác định không gian làm việc cho ứng dụng, từ mã nguồn và tài sản, cho đến mã thử nghiệm và cấu hình bản dựng. Khi bạn bắt đầu một dự án mới, Android Studio sẽ tạo cấu trúc cần thiết cho tất cả các tệp của bạn và hiển thị các cấu hình đó trong cửa sổ Dự án ở bên trái của IDE (nhấp vào Xem > Công cụ Windows > Dự án). Trang này cung cấp thông tin tổng quan về các thành phần chính trong dự án của bạn.

Mô-đun

Mô-đun là một tập hợp gồm các tệp nguồn và tùy chọn cài đặt bản dựng cho phép bạn chia dự án của mình thành các đơn vị chức năng riêng biệt. Dự án của bạn có thể có một hoặc nhiều mô-đun và một mô-đun có thể sử dụng một mô-đun khác làm phần phụ thuộc. Bạn có thể xây dựng, kiểm tra và gỡ lỗi độc lập từng mô-đun.

Mô-đun bổ sung thường hữu ích khi tạo các thư viện mã trong dự án của riêng bạn hoặc khi bạn muốn tạo các bộ mã và tài nguyên khác nhau cho các loại thiết bị khác nhau, chẳng hạn như điện thoại và thiết bị đeo, nhưng giữ tất cả các tệp trong cùng một dự án và chia sẻ một số mã.

Thêm mô-đun mới vào dự án của bạn bằng cách nhấp vào Tệp > Mới > Mô-đun mới.

Android Studio cung cấp một số loại mô-đun riêng biệt:

Mô-đun ứng dụng Android
Cung cấp một 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 của bạn, chẳng hạn như tệp bản dựng ở cấp mô-đun và tệp kê khai Android. Khi bạn tạo một dự án mới, tên mô-đun mặc định là "ứng dụng".

Trong cửa sổ Tạo mô-đun mới, Android Studio cung cấp các loại mô-đun ứng dụng sau đây:

  • Mô-đun điện thoại và máy tính bảng
  • Mô-đun Wear OS
  • Mô-đun Android TV
  • Mô-đun thủy tinh

Mỗi tệp đều cung cấp các tệp thiết yếu và một số mẫu mã phù hợp với loại ứng dụng hoặc thiết bị tương ứng.

Để biết thêm thông tin về cách thêm mô-đun, hãy đọc phần Thêm mô-đun cho thiết bị mới.

Mô-đun tính năng
Đại diện cho một tính năng được mô-đun hóa của ứng dụng có thể tận dụng Phân phối tính năng trên Play. Ví dụ: với các mô-đun tính năng, bạn có thể cung cấp cho người dùng một số tính năng nhất định theo yêu cầu của bạn hoặc dưới dạng trải nghiệm tức thì thông qua Google Play Instant.

Để tìm hiểu thêm, hãy đọc phần Thêm hỗ trợ cho Phân phối tính năng trên Play.

Mô-đun thư viện
Cung cấp một vùng chứa cho mã có thể sử dụng lại mà bạn có thể dùng làm phần phụ thuộc trong các mô-đun ứng dụng khác hoặc nhập vào các dự án khác. Về cấu trúc, một mô-đun thư viện giống như một mô-đun ứng dụng, nhưng khi được tạo, mô-đun này tạo tệp lưu trữ mã thay vì APK, vì vậy, bạn không thể cài đặt mô-đun này trên thiết bị.

Trong cửa sổ Tạo mô-đun mới, Android Studio cung cấp các mô-đun thư viện sau đây:

  • Thư viện Android: Loại thư viện này có thể chứa tất cả các loại tệp được hỗ trợ trong một dự án Android, bao gồm cả mã nguồn, tài nguyên và tệp kê khai. Kết quả là một tệp Android Storage (AAR) mà bạn có thể thêm dưới dạng phần phụ thuộc cho các mô-đun ứng dụng Android của mình.
  • Thư viện Java: Loại thư viện này chỉ có thể chứa các tệp nguồn Java. Kết quả về bản dựng là một tệp lưu trữ Java (JAR) mà bạn có thể thêm vào dưới dạng phần phụ thuộc cho mô-đun ứng dụng Android hoặc các dự án Java khác.
Mô-đun Google Cloud
Cung cấp một vùng chứa cho mã phụ trợ của Google Cloud. Mô-đun này có mã và phần phụ thuộc bắt buộc cho phần phụ trợ Java App Engine, trong đó sử dụng các giao thức HTTP, Cloud Endpoints và Cloud Messaging đơn giản để kết nối với ứng dụng của bạn. Bạn có thể phát triển phần phụ trợ để cung cấp các dịch vụ đám mây mà ứng dụng của bạn cần.

Việc sử dụng Android Studio để phát triển mô-đun Google Cloud có thể giúp bạn quản lý mã ứng dụng và mã phụ trợ trong cùng một dự án. Bạn cũng có thể chạy và kiểm tra mã phụ trợ của mình trên máy và sử dụng Android Studio để triển khai mô-đun Google Cloud.

Để biết thêm thông tin về cách chạy và triển khai mô-đun Google Cloud, hãy xem phần Chạy, thử nghiệm và triển khai phụ trợ.

Một số người cũng gọi các mô-đun là dự án phụ và không sao, vì Gradle cũng gọi các mô-đun là các dự án. Ví dụ: khi tạo một mô-đun thư viện và muốn thêm mô-đun đó làm phần phụ thuộc cho mô-đun ứng dụng Android, bạn phải khai báo mô-đun đó như sau:

Groovy

dependencies {
    implementation project(':my-library-module')
}

Kotlin

dependencies {
    implementation(project(":my-library-module"))
}

Tệp dự án

Theo mặc định, Android Studio sẽ hiển thị các tệp dự án của bạn ở chế độ xem Android. Chế độ xem này không phản ánh thứ bậc tệp thực tế trên đĩa, nhưng được sắp xếp theo các mô-đun và loại tệp để đơn giản hóa việc di chuyển giữa các tệp nguồn chính của dự án, ẩn một số tệp hoặc thư mục không được sử dụng phổ biến , Một số thay đổi về cấu trúc so với cấu trúc trên đĩa bao gồm:

  • Hiển thị tất cả các tệp cấu hình liên quan đến bản dựng của dự án trong một nhóm Gradle Script cấp cao nhất.
  • Hiển thị tất cả các tệp kê khai cho mỗi mô-đun trong một nhóm cấp mô-đun (khi bạn có nhiều tệp kê khai cho hương vị sản phẩm và các loại bản dựng khác nhau).
  • Hiển thị tất cả các tệp tài nguyên thay thế trong một nhóm, thay vì trong các thư mục riêng trên mỗi bộ định tính tài nguyên. Ví dụ: tất cả các phiên bản mật độ của biểu tượng trình chạy đều hiển thị cạnh nhau.

Trong mỗi mô-đun ứng dụng Android, tệp sẽ được hiển thị ở các nhóm sau:

tệp kê khai
Chứa AndroidManifest.xml tệp.
Java
Chứa các tệp mã nguồn Java, phân tách bằng tên gói, bao gồm cả mã thử nghiệm JUnit.
#res
Chứa tất cả các tài nguyên không mã hóa, chẳng hạn như bố cục XML, chuỗi giao diện người dùng và hình ảnh bitbit, được chia thành các thư mục con tương ứng. Để biết thêm thông tin về tất cả các loại tài nguyên có thể có, hãy xem phần Cung cấp tài nguyên.

Chế độ xem dự án Android

Để xem cấu trúc tệp thực tế của dự án bao gồm tất cả tệp bị ẩn khỏi chế độ xem Android, hãy chọn Dự án từ trình đơn thả xuống ở đầu của Dự án.

Khi chọn chế độ xem Dự án, bạn có thể xem nhiều tệp và thư mục hơn. Mục đích quan trọng nhất trong số đó là:

module-name/
build/
Bao gồm dữ liệu đầu ra của bản dựng.
libs/
Chứa thư viện riêng tư.
src/
Chứa tất cả mã và tệp tài nguyên cho mô-đun trong thư mục con sau:
androidTest/
Chứa mã để kiểm tra khả năng đo lường chạy trên một thiết bị Android. Để biết thêm thông tin, hãy xem tài liệu Thử nghiệm Android.
main/
Chứa các tệp nguồn "chính": mã Android và các tài nguyên dùng chung cho tất cả các biến thể bản dựng (các tệp cho các biến thể bản dựng khác nằm trong các thư mục khác nhau, chẳng hạn như src/debug/ cho loại bản dựng gỡ lỗi).
AndroidManifest.xml
Mô tả tính chất của ứng dụng và từng thành phần của ứng dụng. Để biết thêm thông tin, hãy xem tài liệu về AndroidManifest.xml.
java/
Chứa các nguồn mã Java.
jni/
Chứa mã gốc bằng Giao diện gốc của Java (JNI). Để biết thêm thông tin, hãy xem tài liệu về Android NDK.
gen/
Chứa các tệp Java do Android Studio tạo, chẳng hạn như tệp R.java và các giao diện được tạo từ tệp AIDL.
res/
Chứa các tài nguyên ứng dụng, chẳng hạn như tệp có thể vẽ, tệp bố cục và chuỗi giao diện người dùng. Hãy xem phần Tài nguyên ứng dụng để biết thêm thông tin.
assets/
Chứa tệp cần tổng hợp thành tệp .apk. Bạn có thể chuyển đổi thư mục này theo cách tương tự như một hệ thống tệp thông thường bằng cách dùng URI và đọc tệp dưới dạng các byte dữ liệu bằng cách sử dụng AssetManager . Ví dụ: đây là một vị trí tốt để hiển thị kết cấu và dữ liệu trò chơi.
test/
Chứa mã cho các thử nghiệm cục bộ chạy trên Máy chủ ảo của bạn.
build.gradle (mô-đun)
Quy trình này xác định các cấu hình bản dựng dành riêng cho mô-đun.
build.gradle(dự án)
Quy trình này xác định cấu hình bản dựng áp dụng cho mọi mô-đun. Tệp này là tệp tích hợp cho dự án, do đó, bạn nên duy trì tệp trong tùy chọn kiểm soát sửa đổi với tất cả mã nguồn khác.

Để biết thông tin về các tệp bản dựng khác, hãy xem phần Định cấu hình bản dựng của bạn.

Tùy chọn cài đặt cấu trúc dự án

Để thay đổi các tùy chọn cài đặt khác nhau cho dự án Android Studio của bạn, hãy mở hộp thoại Cấu trúc dự án bằng cách nhấp vào Tệp > Cấu trúc dự án. Phương thức này bao gồm các mục sau:

  • Vị trí SDK: Đặt vị trí của JDK, SDK Android và NDK Android mà dự án của bạn sử dụng.
  • Dự án: Đặt phiên bản cho Gradle và trình bổ trợ Android cho Gradle và tên vị trí lưu trữ.
  • Mô-đun: Cho phép bạn chỉnh sửa các cấu hình bản dựng dành riêng cho mô-đun, bao gồm SDK mục tiêu và tối thiểu, chữ ký ứng dụng và các phần phụ thuộc thư viện. Xem Mô-đun ở bên dưới.

Mô-đun

Phần cài đặt Mô-đun cho phép bạn thay đổi các tùy chọn định cấu hình cho từng mô-đun của dự án. Trang cài đặt của mỗi mô-đun được chia thành các thẻ sau:

  • Thuộc tính: Chỉ định các phiên bản của SDK và xây dựng các công cụ cần sử dụng để biên dịch mô-đun.
  • Ký: Chỉ định chứng chỉ cần sử dụng để ký ứng dụng.
  • Hương vị: Cho phép bạn tạo nhiều hương vị bản dựng, trong đó mỗi hương vị chỉ định một tập hợp cài đặt cấu hình, chẳng hạn như phiên bản SDK mục tiêu và tối thiểu của mô-đun, và mã phiên bản và tên phiên bản. Ví dụ: bạn có thể xác định một phiên bản có SDK tối thiểu là 15 và SDK mục tiêu là 21, còn một phiên bản khác có SDK tối thiểu là 19 và SDK mục tiêu là 23.
  • Loại bản dựng: Cho phép bạn tạo và sửa đổi cấu hình của bản dựng, như mô tả trong bài viết Định cấu hình bản dựng Gradle. Theo mặc định, mọi mô-đun đều có các loại bản dựng gỡ lỗiphát hành. Tuy nhiên, bạn có thể xác định thêm các loại bản dựng nếu cần.
  • Phần phụ thuộc: Liệt kê các phần phụ thuộc trong thư viện, tệp và mô-đun đối với mô-đun này. Bạn có thể thêm, sửa đổi và xóa các phần phụ thuộc khỏi ngăn này. Để biết thêm thông tin về các phần phụ thuộc của mô-đun, hãy xem phần Định cấu hình bản dựng Gradle.