Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi Cloud Translation API.

Thiết bị Android ảo làm nền tảng phát triển

Để sử dụng Thiết bị Android ảo (AVD), Trình mô phỏng Android hỗ trợ Giao diện người dùng đồ hoạ (GUI) và Giao diện dòng lệnh (CLI). Bạn chọn quy trình làm việc tối ưu cho môi trường của mình.

Tạo và quản lý thiết bị ảo GUI là một công cụ đơn giản được cung cấp cho hầu hết các nhà phát triển và người dùng ứng dụng.
Tính năng Khởi động trình mô phỏng từ dòng lệnh mang đến một cách linh hoạt cho người dùng thành thạo và tính năng tự động hoá. Ví dụ: để sử dụng nhiều AVD hoặc để thiết lập tính năng kiểm thử liên tục và tích hợp liên tục. Để bắt đầu, hãy xem các ví dụ trong công cụ).

Chạy AVD ô tô AOSP bằng bản dựng sẵn

Để nhanh chóng khởi chạy và kiểm thử bằng AVD ô tô AOSP tạo sẵn, hãy sử dụng tập lệnh nguồn mở để tải xuống và khởi chạy bản dựng trình mô phỏng từ ci.android.com. Tập lệnh này đã được kiểm thử trên macOS và Linux.

Bạn cần có Curl để sử dụng tập lệnh này.

Cách chạy tập lệnh:

Sao chép nội dung tập lệnh launch_emu.sh vào tệp cục bộ, giả sử bạn sử dụng launch_emu.sh làm tên tệp cục bộ.
Tạo tập lệnh cục bộ có thể thực thi. Ví dụ: chạy chmod +x ./launch_emu.sh.
Kiểm tra các tuỳ chọn có sẵn bằng cách chạy tập lệnh bằng ./launch_emu.sh -h.
Trên ci.android.com, hãy chuyển đến nhánh aosp-main-throttled và chọn một bản dựng gần đây trong đó sdk_car_x86_64 có màu xanh lục. Ví dụ: 11370359. Nếu bạn không thấy thông tin bản dựng, hãy đăng xuất khỏi Tài khoản Google rồi thử lại.
Tải và cài đặt các tệp nhị phân liên quan đến trình mô phỏng bằng mã bản dựng. Ví dụ: ./launch_emu.sh -i -a 11370359.
Sau đó, bạn có thể sử dụng ./launch_emu.sh để chạy trình mô phỏng đã tải xuống và cài đặt (không sử dụng tuỳ chọn -i hoặc -a).
Để tải xuống và cài đặt một mã bản dựng khác, hãy chạy ./launch_emu.sh -c để dọn sạch không gian làm việc của bạn, sau đó lặp lại Bước 4 và Bước 5 ở trên.

Để chỉ định các tuỳ chọn Khởi động bằng dòng lệnh của trình mô phỏng Android khi chạy trình mô phỏng, hãy sử dụng tuỳ chọn -v. Ví dụ:

  ./launch_emu.sh -v “-cores 4 -memory 6144 -no-snapshot"

Tạo AVD cho ô tô AOSP

Quy trình tạo AVD ô tô AOSP tương tự như quy trình Tạo hình ảnh AVD cho điện thoại (ví dụ: aosp_car_x86_64):

Để thiết lập môi trường phát triển và xác định một nhánh, hãy xem phần Công cụ kiểm soát nguồn. Sau đó, hãy xem lại phần Tải nguồn xuống:

ANDROID_BRANCH="android12L-release"

REPO_URL="https://android.googlesource.com/platform/manifest"

mkdir $ANDROID_BRANCH && cd $ANDROID_BRANCH && repo init -u $REPO_URL -b
$ANDROID_BRANCH --partial-clone &&  repo sync -c -j8

Tạo hình ảnh AVD:

. build/envsetup.sh && lunch sdk_car_x86_64-userdebug && m -j32

Chạy hình ảnh AVD (thêm Tuỳ chọn khởi động dòng lệnh bổ sung nếu cần):
```
emulator &
```
Ví dụ:

Hình 1. Màn hình Trình mô phỏng Android ảo

Lưu ý về quy trình này:
- Vì quy trình xây dựng giống như quy trình cần thiết để xây dựng Android cho một thiết bị thực, nên hãy dành thời gian tải nguồn xuống rồi tạo bản dựng.
- Để làm việc trên các nhánh khác, hãy đặt $ANDROID_BRANCH thành một nhánh/thẻ khác.
- Hình ảnh AVD, chẳng hạn như system.img, được tạo tại $ANDROID_PRODUCT_OUT. Để tìm hiểu thêm về hình ảnh chính, hãy xem thư mục hệ thống AVD.
- Hãy xem tệp README để tìm hiểu cách sử dụng các tệp nhị phân trình mô phỏng tạo sẵn trong cây Android để chạy trình mô phỏng.

Tạo AVD trên ô tô

Việc thêm AVD ô tô mới gần giống với cách Thêm thiết bị mới. Ví dụ: 1660554 sẽ tạo một AVD avd_car mới.

Cách tạo AVD trên ô tô:

Tạo một công ty và thư mục thiết bị nếu cần. Ví dụ này sử dụng $ANDROID_BUILD_TOP/device/google_car/avd_car.
Tạo tệp makefile sản phẩm, avd_car.mk, xác định cách tạo AVD.
Tạo một thư mục thiết bị, avd_car_device, để chứa BoardConfig.mk và source.properties.
Thêm makefile mới và lựa chọn lunch mới vào AndroidProducts.mk.

Cách tạo và chạy AVD avd_car mới:

. build/envsetup.sh && lunch acar-userdebug && m -j32 && emulator &

Giờ đây, bạn đã sẵn sàng tạo bản minh hoạ cho hầu hết các tính năng của HMI và ứng dụng trên AVD mới.

Gói tệp zip hình ảnh AVD

Bạn có thể đóng gói và chia sẻ AVD với người khác hoặc sử dụng AVD trên một máy tính khác. Sử dụng emu_img_zip.mk để tạo tệp zip hình ảnh AVD:

Sau khi bạn tạo AVD, hãy đặt emu_img_zip làm mục tiêu:
```
m emu_img_zip
```
Tệp zip hình ảnh AVD có tiền tố là sdk-repo-linux-system-images được tạo trong thư mục có tên $ANDROID_PRODUCT_OUT.
Lưu ý: Mặc dù emu_img_zip.mk được thêm vào sau Android 11, nhưng bạn có thể điều chỉnh tệp makefile cho phù hợp với phiên bản trước. Ví dụ: 1661582 hoạt động với Android 11.

Tạo hạt nhân AVD

Hạt nhân AVD tương tự như các hạt nhân Android khác ở chỗ tất cả đều là hình ảnh tạo sẵn. Thông thường, bạn có thể sử dụng hình ảnh hạt nhân goldfish tiêu chuẩn được tạo sẵn như trong mỗi bản phát hành Android.

Cách thử nghiệm các thay đổi về hạt nhân:

Chạy loạt hướng dẫn sau:

mkdir goldfish-kernel-54
cd goldfish-kernel-54
repo init -u https://android.googlesource.com/kernel/manifest -b
common-android11-5.4
repo sync
BUILD_CONFIG=common/build.config.gki.x86_64 build/build.sh
BUILD_CONFIG=common-modules/virtual-device/build.config.goldfish.x86_64
build/build.sh
ls -l ./out/android11-5.4/dist/

Thay thế tệp nhị phân nhân hệ điều hành trong cơ sở mã theo tệp makefile AVD. Ví dụ: x86_64-vendor.mk bao gồm x86_64-kernel.mk.

Mã và cấu hình hạt nhân được đặt như sau:

Mục	Giá trị
Chi nhánh	`common-android11-5.4` (dùng trong Android 11)
Tệp kê khai	`kernel/manifest/common-android11-5.4`
common-modules/virtual-device	`kernel/common-modules/virtual-device/android11-5.4`
Kernel	`kernel/common/android11-5.4`

Tạo hồ sơ thiết bị mới

Để cho phép người dùng tạo một AVD cụ thể trong Trình quản lý thiết bị ảo Android Studio, hãy xem phần Tạo và quản lý thiết bị ảo. Nhà sản xuất thiết bị có thể xác định thông số kỹ thuật phần cứng của riêng họ, chẳng hạn như kích thước màn hình và DPI, thông qua việc sử dụng tệp devices.xml có trong hình ảnh AVD.

Ví dụ: xem hồ sơ Thiết bị ô tô trong automotive.xml.
Để phát triển hoặc tạo nguyên mẫu HMI, bạn có thể thêm nhiều thiết bị vào tệp cho cùng một hình ảnh AVD.
Đưa tệp vào tệp zip hình ảnh AVD OEM trong thư mục [ABI]. Ví dụ: dưới dạng x86_64.
Nhà sản xuất thiết bị cũng có thể Tạo giao diện trình mô phỏng. Ví dụ: để xác định các nút phần cứng bổ sung nhằm mang lại trải nghiệm người dùng có độ trung thực cao hơn. Điều này không chỉ hữu ích cho quy trình làm việc của nhà phát triển mà còn cho các nhiệm vụ khác như nghiên cứu và đánh giá trải nghiệm người dùng.

Tạo tệp XML hình ảnh AVD

Nhà sản xuất thiết bị có thể tạo tệp XML Hình ảnh AVD để Android Studio tải xuống.

Ví dụ: xem tệp XML hình ảnh AVD AAOS, sys-img2-1.xml.
Nhà sản xuất thiết bị có thể xác định thoả thuận cấp phép AVD OEM của riêng họ cho người dùng mục tiêu (sử dụng hệ thống danh dự) bằng giấy phép cho Trình mô phỏng Android. Android Studio sẽ nhận được sự đồng thuận của người dùng khi có giấy phép như vậy.

Cách tạo hình ảnh:

Chuẩn bị tệp zip hình ảnh AVD.
Giải nén ${ANDROID_PRODUCT_OUT}/sdk-repo-linux-system-images-*.zip.
Thêm devices.xml vào thư mục x86_64 rồi nén tệp trong một tệp zip. Ví dụ: dưới dạng oem_avd_img_x86_64.zip.
Cập nhật oem-sys-img2-1.xml.
Cập nhật tên, kích thước và shasum của tệp zip (các tệp XML mẫu được cung cấp trong tools).

Ví dụ: để lưu trữ AVD trên Google Cloud Storage, hãy xem phần Tạo bộ chứa bộ nhớ.

Để tải lên và cho phép truy cập công khai vào AVD, hãy xem phần Công khai dữ liệu:

BUCKET_NAME="aaos-avd"
gsutil mb gs://$BUCKET_NAME
gsutil cp oem_avd_img_x86_64.zip gs://$BUCKET_NAME
gsutil cp oem-sys-img2-1.xml gs://$BUCKET_NAME
gsutil iam ch allUsers:objectViewer gs://$BUCKET_NAME

Định dạng URL của tiện ích bổ sung SDK hình ảnh AVD là: https://storage.googleapis.com/$BUCKET_NAME/oem-sys-img2-1.xml. Ví dụ: nếu BUCKET_NAME là aaos-avd, thì URL sẽ là: https://storage.googleapis.com/aaos-avd/oem-sys-img2-1.xml.

Để người dùng có thể tải hình ảnh AVD xuống và sử dụng AVD bằng Android Studio, bạn có thể cung cấp tệp XML tiện ích bổ sung SDK. Để biết thông tin chi tiết, hãy xem phần Cập nhật Bộ công cụ SDK và IDE.

Cách tải AVD xuống từ mạng:

Lưu trữ tệp zip hình ảnh và tệp XML trên máy chủ.
Cung cấp URL cho người dùng mục tiêu.
(Không bắt buộc) Giới hạn quyền truy cập theo tên người dùng và mật khẩu.

Ngoài ra, để đẩy nhanh quá trình phát triển, hãy tải AVD xuống một thư mục cục bộ:

Lưu các tệp XML và tất cả cấu phần phần mềm được chỉ định trong tệp XML vào một thư mục (ví dụ: tất cả tệp zip hình ảnh AVD) có tên là ADDON_DIR.
Chỉ định URL là file://$ADDON_DIR/oem-sys-img2-1.xml.