Android Studio for Platform (ASfP) giúp bạn thiết lập môi trường phát triển cho Dự án nguồn mở Android (AOSP). Được xây dựng trên Mô hình không gian làm việc IntelliJ, ASfP hỗ trợ cả cấu hình thủ công và các mẫu có thể chia sẻ cho nhóm.
Khởi chạy trình hướng dẫn thiết lập dự án
Bạn có thể chạy trình hướng dẫn thiết lập dự án theo hai cách:
- Trên màn hình Chào mừng: Nhấp vào Dự án mới hoặc Nhập dự án ASfP.
- Từ một dự án đang mở: Trong trình đơn chính, hãy chọn ASfP > Project > New Project (ASfP > Dự án > Dự án mới) hoặc Import ASfP Project (Nhập dự án ASfP).
Nhập từ mẫu
Nếu nhóm của bạn chia sẻ một tệp cấu hình .asfp-project tiêu chuẩn, bạn có thể khởi tạo không gian làm việc trực tiếp từ mẫu đó:
- Trong trình hướng dẫn thiết lập dự án, hãy chọn Nhập từ mẫu.
- Duyệt tìm và chọn tệp YAML
.asfp-projecthoặc.asfp-templateđược chia sẻ. - Sau khi trình hướng dẫn điền sẵn các chế độ cài đặt dự án từ mẫu, hãy xác minh đường dẫn Repo checkout (Kiểm xuất kho lưu trữ) cục bộ của bạn, rồi nhấp vào Finish (Hoàn tất).
Định cấu hình theo cách thủ công
Để tạo một cấu hình dự án mới từ đầu, hãy làm như sau:
Trong trình hướng dẫn thiết lập dự án, hãy chọn định cấu hình dự án theo cách thủ công và điền thông tin chi tiết về dự án:
- Repo checkout (Module paths): Chỉ định đường dẫn tuyệt đối đến thư mục gốc của quy trình kiểm tra nguồn AOSP cục bộ (ví dụ:
/path/to/aosp). - Mục tiêu khởi chạy: Nhập mục tiêu khởi chạy mà bạn dùng để tạo (ví dụ:
aosp_cf_x86_64_phone-aosp_current-userdebug). - Tên dự án: Đặt tên mô tả cho dự án của bạn.
- Thư mục và mô-đun: Liệt kê các thư mục ban đầu hoặc mô-đun Soong cần đưa vào dự án của bạn (tương ứng với thư mục gốc của kho lưu trữ, chẳng hạn như
frameworks/basehoặcpackages/apps/Settings). - Ngôn ngữ: Nếu quy trình làm việc của bạn có mã nền tảng C, C++ hoặc Rust, hãy chọn C hoặc C++ hoặc Rust. Java, Kotlin và
Android.bpđược đưa vào theo mặc định. - Biến môi trường và các lựa chọn tạo: Trong trường Biến môi trường của trình hướng dẫn, hãy thêm mọi biến môi trường tuỳ chỉnh như
SOONG_ALLOW_MISSING_DEPENDENCIES=truevà chọn hộp đánh dấu Soong Partial Compile (SOONG_PARTIAL_COMPILE) (Biên dịch một phần Soong) (không bắt buộc) để tăng tốc độ tạo gia tăng.
- Repo checkout (Module paths): Chỉ định đường dẫn tuyệt đối đến thư mục gốc của quy trình kiểm tra nguồn AOSP cục bộ (ví dụ:
Nhấp vào Hoàn tất. ASfP tạo cấu trúc dự án, tạo tệp cấu hình
.asfp-projecttrong thư mục gốc của dự án và chạy quá trình đồng bộ hoá ban đầu.
Chia sẻ hoặc tuỳ chỉnh cấu hình dự án
Sau khi thiết lập ban đầu, bạn có thể tuỳ chỉnh dự án của mình bất cứ lúc nào bằng cách chỉnh sửa tệp .asfp-project (ASfP > Project > Open Config):
- Thêm hoặc loại trừ các thư mục và mô-đun Soong.
- Bật các ngôn ngữ khác (
cpp,rust). - Định cấu hình các cờ Soong và biến môi trường tuỳ chỉnh.
Để xuất cấu hình cho đồng đội, hãy nhấp chuột phải vào thẻ .asfp-project rồi chọn Xuất sang mẫu.
Để biết thêm thông tin về các tham số .asfp-project, chế độ đồng bộ hoá và các thao tác Android.bp trong trình chỉnh sửa, hãy xem bài viết Tổng quan về dự án và quy trình làm việc của Soong.