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:

• Cần có môi trường 64 bit cho 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 nhiều không gian hơn vì các máy nhân bản đầy đủ của Dự án mã nguồn mở Android (AOSP) chứa tất cả các kho lưu trữ Git đã từng được sử dụng.
• Google khuyến nghị RAM ít nhất 64 GB và không thử nghiệm với ít hơn. Số lượng thấp hơn dẫn đến việc các bản dựng bị tắt OOM.

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. Quá trình này mất khoảng 40 phút để tạo bản dựng hoàn chỉnh (và chỉ vài phút cho 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áy 6 lõi có dung lượng RAM tương tự phải mất 3 giờ.

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

Nhánh main AOSP theo truyền thống được phát triển và thử nghiệm trên các bản phát hành Hỗ trợ dài hạn (LTS) của Ubuntu, nhưng các bản phân phối khác có thể được sử dụng. Xem Thiết lập môi trường xây dựng để biết các gói cần thiết 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. Những yêu cầu này áp dụng cho nhánh main 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ần thiết. Để biết 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 dựa trên nhánh main AOSP, hãy sử dụng Ubuntu 18.04 trở lên.

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

JDK

Nhánh main của Android trong AOSP đi kèm với phiên bản OpenJDK dựng sẵn, do đó 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 JDK riêng. Trên Ubuntu, sử dụng OpenJDK.

Gói khóa

Nhánh chính AOSP đi kèm với phiên bản Make dựng sẵn, do đó 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ư chi tiết trong Sunsetting Python 2 . Tất cả các bản phân phối Linux chính đều không còn hỗ trợ gói Python 2. Google thực sự khuyên bạn nên di 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ó 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 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ề việc ngừng sử dụng mã Python 2 của bạn.

Tệp nhị phân của thiết bị

Tải xuống các bản xem trước, hình ảnh xuất xưởng, trình điều khiển, bả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 các tệp nhị phân độc quyền .

• Xem trước các tệp nhị phân (blobs) để phát triển nhánh main AOSP
• Hình ảnh gốc cho các thiết bị được hỗ trợ 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ợ xây dựng bằng clang/LLVM, bao gồm cả các công cụ lưu trữ. Thay vào đó, các bản phát hành cũ hơn đã sử dụng GCC. Trong cả hai trường hợp, Android chỉ hỗ trợ xây dựng với trình biên dịch dựng sẵn được kiểm tra trong prebuilts/ .