Yêu cầu

Trước khi bạn tải xuống và xây dựng nguồn Android, hãy đảm bảo rằng hệ thống của bạn đáp ứng các yêu cầu sau, sau đó xem Thiết lập Môi trường Xây dựng để biết hướng dẫn cài đặt theo hệ điều hành.

Yêu cầu 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 phần cứng sau:

• Môi trường 64-bit là bắt buộc đối với Android 2.3.x (Gingerbread) và các phiên bản cao hơn, bao gồm cả nhánh chính. Bạn có thể biên dịch các phiên bản cũ hơn trên hệ thống 32-bit.
• Ít nhất 250 GB dung lượng đĩa trống để kiểm tra mã và thêm 150 GB để tạo mã. Nếu bạn tiến hành nhiều bản dựng, bạn cần thêm không gian.
  Lưu ý: Nếu bạn đang kiểm tra một máy nhân bản, bạn cần thêm dung lượng vì các máy nhân bản Dự án nguồn mở Android (AOSP) đầy đủ chứa tất cả các kho lưu trữ Git đã từng được sử dụng.
• Cần có ít nhất 16 GB RAM khả dụng, nhưng Google khuyến nghị 64 GB.

Kể từ tháng 6 năm 2021, Google đang sử dụng các máy 72 lõi với 64 GB RAM bên trong, mất khoảng 40 phút để tạo đầy đủ (và chỉ vài phút cho các bản dựng tăng dần, tùy thuộc vào chính xác tệp nào đã được sửa đổi). Ngược lại, một máy 6 nhân với dung lượng RAM tương tự phải mất 3 giờ.

Yêu cầu phần mềm

Nhánh master AOSP được phát triển và thử nghiệm theo truyền thống trên các bản phát hành Hỗ trợ dài hạn (LTS) của Ubuntu, nhưng có thể sử dụng các bản phân phối khác. Xem Thiết lập Môi trường Xây dựng để biết các gói yêu cầu bổ sung và các lệnh để cài đặt chúng.

Máy trạm của bạn phải có phần mềm được liệt kê bên dưới. Các yêu cầu này áp dụng cho nhánh master của AOSP. Đối với các phiên bản Android 8.0 (Oreo hoặc O) đến 5.0 (Lollipop hoặc L), hãy cân nhắc sử dụng Dockerfile đi kèm để dễ dàng cài đặt tất cả các gói được yêu cầu. Đối với phương pháp thủ công, hãy xem Hỗ trợ các phiên bản cũ hơn .

Hệ điều hành

Nếu bạn đang phát triển chống lại nhánh master của AOSP, hãy sử dụng Ubuntu 18.04 (Bionic Beaver) .

Cảnh báo: KHÔNG hỗ trợ xây dựng trên Windows hoặc MacOS (kể từ ngày 22 tháng 6 năm 2021).

JDK

Nhánh master của Android trong AOSP đi kèm với phiên bản OpenJDK dựng sẵn, vì vậy không cần cài đặt thêm.

Các phiên bản Android cũ hơn yêu cầu cài đặt riêng JDK. Trên Ubuntu, sử dụng OpenJDK.

Các gói chính

Nhánh chính AOSP đi kèm với phiên bản Make dựng sẵn, vì vậy không cần cài đặt thêm. Git được cài đặt tương tự như một phần của quy trình Thiết lập Môi trường Xây dựng .

Đảm bảo rằng hệ thống của bạn có Python 3 .

Cảnh báo: Hỗ trợ Python 2 đã ngừng hoạt động vào ngày 1 tháng 1 năm 2020 như được nêu chi tiết trong Sunsetting Python 2 . Tất cả các bản phân phối Linux chính đều không hỗ trợ gói Python 2. Google thực sự khuyên bạn nên chuyển tất cả các tập lệnh của mình sang Python 3.

Lưu ý: AOSP cung cấp các bản sao riêng của gói Python 2 và Python 3 và bạn có thể sử dụng phiên bản (chẳng hạn như SEPolicy ) được bao gồm trong cây nguồn. Google đang di chuyển tất cả các tập lệnh trong cây nguồn Android sang Python 3 và bản sao được nhúng của Python 2 có thể không được dùng nữa.

Để biết thêm chi tiết, hãy xem Chuyển mã Python 2 sang Python 3 và lời khuyên về cách hủy mã Python 2 của bạn.

Mã nhị phân thiết bị

Tải xuống bản xem trước, hình ảnh xuất xưởng, trình điều khiển, cập nhật qua mạng (OTA) và các đốm màu khác bên dưới. Để biết chi tiết, hãy xem Lấy mã nhị phân độc quyền .

• Xem trước mã nhị phân (đốm màu) để phát triển nhánh master AOSP
• Hình ảnh xuất xưởng cho các thiết bị được hỗ trợ đang chạy các nhánh phát hành AOSP được gắn thẻ
• Các tệp hỗ trợ phần cứng nhị phân cho các thiết bị chạy các nhánh phát hành AOSP được gắn thẻ

Xây dựng chuỗi công cụ

Android 8.0 trở lên chỉ hỗ trợ Clang / LLVM để xây dựng nền tảng Android. Tham gia nhóm android-llvm để đặt câu hỏi và nhận trợ giúp. Báo cáo NDK / sự cố trình biên dịch tại NDK GitHub .

Đối với Bộ phát triển bản địa (NDK) và các hạt nhân kế thừa, GCC 4.9 có trong nhánh master AOSP (dưới các bản prebuilts/ ) cũng có thể được sử dụng.