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.

Thử phát triển Android
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.

Hướng dẫn này giúp bạn thử phát triển hệ điều hành Android lần đầu tiên.

Thiết lập để phát triển Android

Trước khi tải xuống và tạo nhánh tệp kê khai android-latest-release của nguồn Android, hãy đảm bảo rằng phần cứng của bạn đáp ứng các yêu cầu cần thiết và phần mềm bắt buộc được cài đặt đúng cách. Bạn cũng cần quen thuộc với các thuật ngữ sau:

Git: Git là một hệ thống quản lý phiên bản phân phối nguồn mở và miễn phí. Android sử dụng Git cho các thao tác cục bộ như phân nhánh, xác nhận, khác biệt và chỉnh sửa. Để được trợ giúp về cách tìm hiểu Git, hãy tham khảo tài liệu về Git.
Kho lưu trữ: Repo là một trình bao bọc Python xung quanh Git giúp đơn giản hoá việc thực hiện các thao tác phức tạp trên nhiều kho lưu trữ Git. Repo không thay thế Git cho tất cả các thao tác kiểm soát phiên bản, mà chỉ giúp bạn dễ dàng thực hiện các thao tác phức tạp trong Git. Kho lưu trữ sử dụng tệp kê khai để tổng hợp các dự án Git vào siêu dự án Android.
tệp kê khai: Tệp kê khai là tệp XML chỉ định vị trí đặt các dự án Git khác nhau trong nguồn Android trong cây nguồn AOSP.

Đáp ứng các yêu cầu về phần cứng

Máy trạm phát triển của bạn phải đáp ứng hoặc vượt quá các yêu cầu về phần cứng sau:

Hệ thống x86 64 bit.

Lưu ý: Bạn có thể biên dịch các phiên bản AOSP trước 2.3.x trên hệ thống 32 bit.
Ít nhất 400 GB dung lượng ổ đĩa trống để kiểm tra và tạo mã (250 GB để kiểm tra + 150 GB để tạo).

Lưu ý: Nếu đang kiểm tra một bản sao, bạn cần thêm dung lượng vì bản sao đầy đủ của Dự án nguồn mở Android (AOSP) chứa tất cả các kho lưu trữ Git từng được sử dụng.
RAM tối thiểu 64 GB. Google sử dụng máy 72 nhân với 64 GB RAM để xây dựng Android. Với cấu hình phần cứng này, bạn sẽ mất khoảng 40 phút để tạo một bản dựng Android đầy đủ và chỉ mất vài phút để tạo một bản dựng Android tăng dần. Ngược lại, một bản dựng đầy đủ trên máy 6 nhân có 64 GB RAM sẽ mất khoảng 6 giờ.

Đáp ứng các yêu cầu về hệ điều hành

Máy trạm phát triển của bạn phải chạy bất kỳ bản phân phối Linux 64 bit nào có Thư viện GNU C (glibc) 2.17 trở lên.

Cài đặt các gói bắt buộc

Để cài đặt các gói bắt buộc cho Ubuntu 18.04 trở lên, hãy chạy lệnh sau:

sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig

Cài đặt phần mềm bắt buộc

Trước khi có thể làm việc với AOSP, bạn phải cài đặt OpenJDK, Make, Python 3 và Repo. Nhánh phát hành mới nhất của Android đi kèm với các phiên bản tạo sẵn của OpenJDK, Make và Python 3, vì vậy, bạn không cần thực hiện các bước cài đặt bổ sung. Phần sau đây giải thích cách cài đặt Repo.

Cài đặt Repo

Làm theo các bước sau để cài đặt Repo:

Tải thông tin gói hiện tại xuống:
```
sudo apt-get update
```
Chạy lệnh sau để cài đặt trình chạy Repo:
```
sudo apt-get install repo
```
Trình chạy Repo cung cấp một tập lệnh Python khởi chạy quy trình thanh toán và tải công cụ Repo đầy đủ xuống.

Nếu thành công, hãy chuyển sang bước 4.
(không bắt buộc) Cài đặt Repo theo cách thủ công bằng loạt lệnh sau:
```
export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
```
Ba lệnh đầu tiên thiết lập một tệp tạm thời, tải Repo xuống tệp và xác minh rằng khoá được cung cấp khớp với khoá bắt buộc. Nếu các lệnh này thành công, lệnh cuối cùng sẽ cài đặt trình chạy Repo.
Xác minh phiên bản trình chạy Repo:
```
repo version
```
Kết quả sẽ cho biết phiên bản 2.4 trở lên, ví dụ:

repo launcher version 2.45

Tải nguồn Android xuống

Nguồn Android nằm trong một tập hợp các kho lưu trữ Git do Google lưu trữ. Mỗi kho lưu trữ Git bao gồm toàn bộ nhật ký của nguồn Android, bao gồm cả các thay đổi đối với nguồn và thời điểm thực hiện các thay đổi đó. Cách tải nguồn Android xuống:

Chuyển đến thư mục gốc:
```
cd ~
```
Tạo một thư mục con đang hoạt động trên máy trong thư mục đó:
```
mkdir aosp
```
Chuyển đến thư mục:
```
cd aosp
```

Khởi chạy nhánh phát hành mới nhất của mã nguồn kho lưu trữ AOSP (android-latest-release):

repo init --partial-clone -b android-latest-release -u https://android.googlesource.com/platform/manifest

Nhập hoặc chấp nhận thông tin xác thực Git (tên, địa chỉ email).
Đồng bộ hoá mã nguồn:
```
repo sync -c -j8
```
Nếu bạn gặp vấn đề trong quá trình tải xuống, hãy tham khảo bài viết Khắc phục sự cố đồng bộ hoá.

Tạo mã

Cách tạo mã:

Trong thư mục đang hoạt động, hãy lấy nguồn tập lệnh envsetup.sh để thiết lập môi trường xây dựng:
```
source build/envsetup.sh
```

Chỉ định loại thiết bị mục tiêu để tạo bằng lệnh lunch. Mục tiêu là một hoán vị thiết bị, chẳng hạn như một mẫu hoặc hệ số hình dạng cụ thể. Chỉ định mục tiêu này:

lunch aosp_cf_x86_64_only_phone-aosp_current-userdebug

Bạn sẽ thấy bản tóm tắt về mục tiêu và môi trường xây dựng:

============================================
PLATFORM_VERSION_CODENAME=Baklava
PLATFORM_VERSION=Baklava
TARGET_PRODUCT=aosp_cf_x86_64_only_phone
TARGET_BUILD_VARIANT=userdebug
TARGET_ARCH=x86_64
TARGET_ARCH_VARIANT=silvermont
HOST_OS=linux
HOST_OS_EXTRA=Linux-6.10.11-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete
HOST_CROSS_OS=windows
BUILD_ID=BP1A.250305.020
OUT_DIR=out
============================================

Tạo mục tiêu:
```
m
```

Quá trình tạo bản dựng đầu tiên có thể mất vài giờ. Các bản dựng tiếp theo sẽ mất ít thời gian hơn đáng kể. Kết quả của bản dựng sẽ xuất hiện trong $OUT_DIR.

Chạy Cuttlefish

Cuttlefish là trình mô phỏng Android dùng để kiểm thử bản dựng.

Chạy các lệnh sau để tải xuống, tạo và cài đặt các gói Debian của máy chủ:

sudo apt install -y git devscripts equivs config-package-dev debhelper-compat golang curl
git clone https://github.com/google/android-cuttlefish
cd android-cuttlefish
for dir in base frontend; do
pushd $dir
# Install build dependencies
sudo mk-build-deps -i
dpkg-buildpackage -uc -us
popd
done
sudo dpkg -i ./cuttlefish-base_*_*64.deb || sudo apt-get install -f
sudo dpkg -i ./cuttlefish-user_*_*64.deb || sudo apt-get install -f
sudo usermod -aG kvm,cvdnetwork,render $USER
sudo reboot

Thao tác khởi động lại sẽ kích hoạt việc cài đặt các mô-đun nhân bổ sung và áp dụng các quy tắc udev.

Chạy Cuttlefish:
```
launch_cvd --daemon
```
Kết nối với thiết bị Cuttlefish bằng cách chuyển đến https://localhost:8443 trong trình duyệt web. Thiết bị Android ảo của bạn sẽ xuất hiện.

Thực hiện thay đổi

Cập nhật mã nguồn theo danh sách thay đổi mẫu này.

Từ thư mục gốc của lượt thanh toán (thư mục aosp/), hãy chuyển đến dự án Git frameworks/native:
```
cd frameworks/native
```
Khởi động một dự án tạm thời bằng lệnh sau:
```
repo start <some-name> .
```
Sử dụng trình chỉnh sửa để chỉnh sửa SurfaceFlinger.cpp tại vị trí sau:
```
aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
```

Tìm dòng này:

void SurfaceFlinger::updateColorMatrixLocked() {

Thêm dòng này vào đầu updateColorMatrixLocked():

mClientColorMatrix = mat4(vec4{1.0f, 0.0f, 0.0f, 0.0f}, vec4{0.0f, -1.0f, 0.0f, 0.0f},
                         vec4{0.0f, 0.0f, -1.0f, 0.0f}, vec4{0.0f, 1.0f, 1.0f, 1.0f});

Tạo mã:
```
m
```

Cập nhật bản dựng trên thiết bị:

adb root
adb remount -R
adb root
adb sync
adb reboot

Xác minh rằng bạn thấy sự thay đổi về màu sắc trên thiết bị đã chọn tương tự như trong Hình 1.

Hình 1. Giao diện màn hình sau khi thay đổi màu thành công

Khắc phục kiểm thử

Phần này của lớp học lập trình sử dụng một bài kiểm thử mẫu trong cây nguồn và đang không đạt.

Để chạy, gỡ lỗi và khắc phục kiểm thử, hãy làm theo các hướng dẫn sau:

Chạy:
```
atest DevCodelabTest
```
Kiểm thử không thành công.

Lưu ý: atest là một công cụ dòng lệnh cho phép bạn tạo, cài đặt và chạy các chương trình kiểm thử Android cục bộ.

Kiểm tra dấu vết ngăn xếp của kiểm thử không thành công:

STACKTRACE:
java.lang.AssertionError
 at org.junit.Assert.fail(Assert.java:87)
 at org.junit.Assert.assertTrue(Assert.java:42)
 at org.junit.Assert.assertTrue(Assert.java:53)
 at android.test.example.devcodelab.DevCodelabTest.testHelloWorld(DevCodelabTest.java:29)

Dòng cuối cùng của dấu vết ngăn xếp cho thấy kiểm thử không thành công (testHelloWorld). Kiểm thử này nằm trong tệp có tên DevCodelabTest.java.

Để xác định vị trí của kiểm thử cần khắc phục, hãy nối WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/ vào dòng cuối cùng của dấu vết ngăn xếp, bao gồm cả tên của tệp kiểm thử. Vì vậy, android.test.example.devcodelab.DevCodelabTest sẽ trở thành WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java.
Chỉnh sửa platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java và thay thế Assert.assertTrue(false) bằng Assert.assertTrue(true)
Chạy lại bài kiểm thử để xác minh rằng bạn đã khắc phục được vấn đề:
```
atest DevCodelabTest
```

Tải mã lên để xem xét

Repo đơn giản hoá việc sử dụng Git bằng cách đóng gói các lệnh như git clone để hoạt động trên nhiều kho lưu trữ Git (hoặc dự án) cùng một lúc.

Để xem xét mã của các dự án trong Git, hãy sử dụng hệ thống xem xét mã dựa trên web Gerrit.

Giả sử bạn đã thực hiện các thay đổi trong dự án frameworks/native, hãy chạy các lệnh sau để tải các thay đổi lên:
```
cd frameworks/native
repo start codelab .
git add .
git commit
```
Nhập nội dung sau đây cho thông báo cam kết:
```
Android codelab change
Test: manual atest
```

Tải nội dung thay đổi lên:

repo upload

Nếu thành công, bạn sẽ thấy một thông báo tương tự như sau:

Upload project frameworks/native/ to remote branch android15-qpr2-release:
 branch codelab ( 1 commit, Wed Aug 7 09:32:33 2019 -0700):
        ff46b36d android codelab change
to https://android-review.googlesource.com/ (y/N)? y
remote: Processing changes: refs: 1, new: 1, done
remote:
remote: SUCCESS
remote:
remote:   https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432 android codelab change [NEW]
remote:
To https://android-review.googlesource.com/platform/frameworks/native
* [new branch]          codelab -> refs/for/android15-qpr2-release

Xem thay đổi của bạn trong Gerrit

Để xem thay đổi trong Gerrit, hãy chuyển đến đầu ra đường liên kết trong thiết bị đầu cuối. Đường liên kết tương tự như sau:

https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432

Huỷ bỏ thay đổi

Thông thường, sau khi kiểm thử, xem xét và phê duyệt, bạn sẽ gửi nội dung thay đổi trong Gerrit và hợp nhất nội dung đó vào kho lưu trữ. Thay vào đó, trong phạm vi của lớp học lập trình này, hãy huỷ bỏ công việc của bạn:

Trong Gerrit, hãy nhấp vào Thoát.
Bỏ nhánh tạm thời được liên kết trong thư mục dự án frameworks/native (hoặc các thư mục con của thư mục đó):
```
repo abandon codelab .
```
Huỷ bỏ các thay đổi mà bạn đã thực hiện đối với tệp kiểm thử. Vì bạn không chạy repo start, git commit và repo upload trên thay đổi kiểm thử, nên bạn có thể đặt lại chính tệp đó. Giả sử bạn đang ở aosp/platform_testing directory, hãy sử dụng lệnh sau để đặt lại tệp:
```
git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
git checkout .
```

Như vậy là bạn đã hoàn tất lớp học lập trình về phát triển nền tảng Android.

Nhận trợ giúp

Nếu bạn gặp lỗi trong lớp học lập trình này, hãy báo cáo lỗi bằng cách sử dụng đường liên kết Công cụ theo dõi lỗi ở cuối trang bất kỳ. Gửi câu hỏi đến nhóm android-building.

Nhập ps -A | grep crosvm để xem crosvm có đang chạy hay không. Nếu crossvm đang chạy, hãy nhập quy trình stop_cvd || true hoặc kill crosvm bằng PID của quy trình.