Tải xuống nguồn Android

Nguồn Android nằm trong tập hợp các kho lưu trữ Git do Google lưu trữ. Kho lưu trữ Git bao gồm toàn bộ lịch sử của nguồn Android, bao gồm các thay đổi đối với nguồn và thời điểm thực hiện các thay đổi. Trang này mô tả cách tải xuống nguồn.

Khởi tạo ứng dụng khách Repo

Thiết lập ứng dụng khách của bạn để truy cập kho lưu trữ nguồn Android:

  1. Tạo và điều hướng đến một thư mục làm việc:

    $ mkdir WORKING_DIRECTORY
    $ cd WORKING_DIRECTORY
    
  2. Khởi tạo thư mục làm việc của bạn để kiểm soát nguồn:

    $ repo init -b main -u https://android.googlesource.com/platform/manifest
    

    Tùy chọn -b được sử dụng để xác định nhánh bạn đang khởi tạo. Nếu -b không được cung cấp, repo init mặc định là nhánh chính. Để biết danh sách các nhánh và tên thẻ, hãy xem Thẻ mã nguồn và bản dựng .

    Tùy chọn -u là bắt buộc và được sử dụng để chỉ định tệp kê khai , đây là tệp XML chỉ định vị trí đặt các dự án Git khác nhau trong nguồn Android trong thư mục làm việc của bạn. Trong ví dụ này, tên của tệp kê khai không được chỉ định, vì vậy lệnh sử dụng tệp kê khai mặc định ( default.xml ).

    Đầu ra phải chứa thông báo:

    $ repo has been initialized in path_to_working_directory
    

Để biết thông tin về định dạng tệp kê khai, hãy xem Định dạng tệp kê khai repo .

Để biết danh sách tất cả các lệnh Repo, hãy xem tài liệu tham khảo về lệnh Repo .

Tải xuống nguồn Android

Chạy lệnh sau để tải cây nguồn Android về thư mục làm việc của bạn:

$ repo sync -c -j8

Đối số -c hướng dẫn Repo tìm nạp nhánh bảng kê khai hiện tại từ máy chủ. Lệnh -j8 chia tách đồng bộ hóa giữa các luồng để hoàn thành nhanh hơn.

Hoạt động này sẽ mất hơn một giờ một chút.

Nếu bạn gặp bất kỳ sự cố nào trong quá trình tải xuống, hãy tham khảo Khắc phục sự cố mạng .

Khắc phục sự cố mạng

Phần này cung cấp một số đề xuất để khắc phục sự cố mạng có thể khiến đồng bộ hóa không thành công.

Sử dụng xác thực để tránh rào cản hạn ngạch

Để bảo vệ máy chủ khỏi việc sử dụng quá mức, mỗi địa chỉ IP được sử dụng để truy cập nguồn sẽ được liên kết với một hạn ngạch.

Khi chia sẻ địa chỉ IP với những người dùng khác, chẳng hạn như khi truy cập vào kho lưu trữ nguồn từ bên ngoài tường lửa NAT, hạn ngạch có thể kích hoạt các mẫu thông thường. Ví dụ: hạn ngạch có thể được kích hoạt khi một số người dùng đồng bộ hóa ứng dụng khách mới từ cùng một địa chỉ IP trong một khoảng thời gian ngắn.

Để tránh kích hoạt hạn ngạch, bạn có thể sử dụng quyền truy cập được xác thực, sử dụng hạn ngạch riêng cho từng người dùng, bất kể địa chỉ IP.

Để kích hoạt quyền truy cập được xác thực:

  1. Tạo mật khẩu bằng trình tạo mật khẩu .

  2. Chạy lệnh sau để chuyển đổi ứng dụng khách của bạn sang sử dụng xác thực tự động (không thay đổi nhánh):

    $ repo init -u https://android.googlesource.com/a/platform/manifest
    

    Lưu ý rằng tiền tố thư mục /a/ sẽ kích hoạt xác thực tự động.

Định cấu hình để sử dụng proxy

Nếu bạn đang tải xuống nguồn từ phía sau proxy, như thường thấy trong một số môi trường công ty, hãy đảm bảo bạn chỉ định rõ ràng proxy để Repo sử dụng bằng cách chạy các lệnh sau:

$ export HTTP_PROXY=http://proxy_user_id:proxy_password@proxy_server:proxy_port
$ export HTTPS_PROXY=http://proxy_user_id:proxy_password@proxy_server:proxy_port

Điều chỉnh cài đặt TCP/IP để tránh các sự cố kết nối

Mặc dù hiếm khi xảy ra nhưng máy khách Linux có thể gặp phải sự cố kết nối, chẳng hạn như bị kẹt khi đang tải xuống trong khi nhận đối tượng. Để cải thiện vấn đề này, hãy điều chỉnh cài đặt của ngăn xếp TCP/IP hoặc sử dụng các kết nối không song song. Bạn phải có quyền truy cập root để sửa đổi cài đặt TCP. Để sửa đổi cài đặt, hãy đưa ra các lệnh sau:

$ sudo sysctl -w net.ipv4.tcp_window_scaling=0
$ repo sync -j1

Sử dụng máy nhân bản cục bộ để tránh độ trễ mạng

Khi sử dụng nhiều máy khách, bạn có thể tạo một bản sao cục bộ của toàn bộ nội dung máy chủ và đồng bộ hóa các máy khách từ máy nhân bản đó mà không cần truy cập mạng. Thực hiện theo các hướng dẫn sau để tạo một máy nhân bản cục bộ tại ~/aosp-mirror/ và đồng bộ hóa các máy khách với máy nhân bản đó:

  1. Tạo và đồng bộ hóa gương:

    $ mkdir -p /usr/local/aosp/mirror
    $ cd /usr/local/aosp/mirror
    $ repo init -u https://android.googlesource.com/mirror/manifest --mirror
    

    Các lệnh này tạo một máy nhân bản cục bộ trong /user/local/aosp/mirror và khởi tạo máy nhân bản bằng cờ --mirror bằng lệnh repo init .

  2. Để đồng bộ hóa ứng dụng khách từ máy nhân bản:

    $ mkdir -p /usr/local/aosp/main
    $ cd /usr/local/aosp/main
    $ repo init -u /usr/local/aosp/mirror/platform/manifest.git
    $ repo sync
    
  3. Cuối cùng, hãy làm theo các lệnh sau để đồng bộ hóa máy nhân bản với máy chủ và đồng bộ hóa máy khách với máy nhân bản:

    $ cd /usr/local/aosp/mirror</code>
    $ repo sync
    $ cd /usr/local/aosp/main
    $ repo sync
    

Có thể lưu trữ máy nhân bản trên máy chủ LAN và truy cập nó qua NFS, SSH hoặc Git. Cũng có thể lưu trữ nó trên một ổ đĩa di động và chuyển ổ đĩa đó giữa những người dùng hoặc máy móc.

Sử dụng bản sao một phần

Nếu bạn đang sử dụng Git phiên bản 2.19 trở lên, hãy chỉ định --partial-clone khi thực hiện repo init để khắc phục mọi sự cố mạng có độ trễ thấp:

  $ repo init -u https://android.googlesource.com/platform/manifest -b main --partial-clone --clone-filter=blob:limit=10M

Thay vì khởi tạo Repo để tải xuống mọi thứ, lệnh này sẽ tải xuống các đối tượng Git khi cần thiết.

Tải xuống các tệp nhị phân độc quyền

AOSP có thể chạy trực tiếp trên trình mô phỏng Cuttlefish, nhưng không thể sử dụng AOSP trên phần cứng nếu không có thư viện độc quyền bổ sung dành riêng cho thiết bị. Dưới đây là cách lấy các tệp nhị phân của thiết bị đó:

  • Nếu bạn đang tải xuống nhánh main và tòa nhà cho thiết bị Nexus hoặc Pixel, hãy tải xuống các tệp nhị phân mới nhất từ ​​trang xem trước Binaries .
  • Nếu bạn đang tải xuống và xây dựng nhánh main cũng như xây dựng cho thiết bị của riêng mình, bạn phải cung cấp các tệp nhị phân dành riêng cho thiết bị của mình.
  • Nếu bạn đang tải xuống và xây dựng một nhánh và tòa nhà được gắn thẻ, không chính, cho thiết bị Nexus hoặc Pixel, hãy tải xuống tệp nhị phân dành riêng cho thiết bị từ Binaries cho thiết bị Nexus và Pixel .

Trích xuất các tệp nhị phân độc quyền

Mỗi bộ tệp nhị phân có dạng tập lệnh tự giải nén trong kho lưu trữ nén. Để trích xuất và đặt các tệp nhị phân này vào đúng vị trí của cây nguồn của bạn:

  1. Trích xuất kho lưu trữ.
  2. Chạy tập lệnh shell tự giải nén đi kèm từ thư mục gốc của cây nguồn AOSP của bạn.
  3. Đồng ý với các điều khoản của thỏa thuận cấp phép kèm theo. Các tệp nhị phân và các tệp tạo tệp phù hợp của chúng được cài đặt trong hệ thống phân cấp vendor/ cấp của cây nguồn.

(tùy chọn) Xác minh tính hợp pháp của mã

Nếu bạn lo ngại về tính hợp pháp của mã nguồn, chẳng hạn như liệu nó có đến từ Google hay không, bạn có thể xác minh thẻ git cho chi nhánh. Để xác minh thẻ Git:

  1. Sao chép và dán khối khóa sau vào một tệp văn bản, chẳng hạn như keyfile.asc .

    -----BEGIN PGP PUBLIC KEY BLOCK-----
    Version: GnuPG v1.4.2.2 (GNU/Linux)
    
    mQGiBEnnWD4RBACt9/h4v9xnnGDou13y3dvOx6/t43LPPIxeJ8eX9WB+8LLuROSV
    lFhpHawsVAcFlmi7f7jdSRF+OvtZL9ShPKdLfwBJMNkU66/TZmPewS4m782ndtw7
    8tR1cXb197Ob8kOfQB3A9yk2XZ4ei4ZC3i6wVdqHLRxABdncwu5hOF9KXwCgkxMD
    u4PVgChaAJzTYJ1EG+UYBIUEAJmfearb0qRAN7dEoff0FeXsEaUA6U90sEoVks0Z
    wNj96SA8BL+a1OoEUUfpMhiHyLuQSftxisJxTh+2QclzDviDyaTrkANjdYY7p2cq
    /HMdOY7LJlHaqtXmZxXjjtw5Uc2QG8UY8aziU3IE9nTjSwCXeJnuyvoizl9/I1S5
    jU5SA/9WwIps4SC84ielIXiGWEqq6i6/sk4I9q1YemZF2XVVKnmI1F4iCMtNKsR4
    MGSa1gA8s4iQbsKNWPgp7M3a51JCVCu6l/8zTpA+uUGapw4tWCp4o0dpIvDPBEa9
    b/aF/ygcR8mh5hgUfpF9IpXdknOsbKCvM9lSSfRciETykZc4wrRCVGhlIEFuZHJv
    aWQgT3BlbiBTb3VyY2UgUHJvamVjdCA8aW5pdGlhbC1jb250cmlidXRpb25AYW5k
    cm9pZC5jb20+iGAEExECACAFAknnWD4CGwMGCwkIBwMCBBUCCAMEFgIDAQIeAQIX
    gAAKCRDorT+BmrEOeNr+AJ42Xy6tEW7r3KzrJxnRX8mij9z8tgCdFfQYiHpYngkI
    2t09Ed+9Bm4gmEO5Ag0ESedYRBAIAKVW1JcMBWvV/0Bo9WiByJ9WJ5swMN36/vAl
    QN4mWRhfzDOk/Rosdb0csAO/l8Kz0gKQPOfObtyYjvI8JMC3rmi+LIvSUT9806Up
    hisyEmmHv6U8gUb/xHLIanXGxwhYzjgeuAXVCsv+EvoPIHbY4L/KvP5x+oCJIDbk
    C2b1TvVk9PryzmE4BPIQL/NtgR1oLWm/uWR9zRUFtBnE411aMAN3qnAHBBMZzKMX
    LWBGWE0znfRrnczI5p49i2YZJAjyX1P2WzmScK49CV82dzLo71MnrF6fj+Udtb5+
    OgTg7Cow+8PRaTkJEW5Y2JIZpnRUq0CYxAmHYX79EMKHDSThf/8AAwUIAJPWsB/M
    pK+KMs/s3r6nJrnYLTfdZhtmQXimpoDMJg1zxmL8UfNUKiQZ6esoAWtDgpqt7Y7s
    KZ8laHRARonte394hidZzM5nb6hQvpPjt2OlPRsyqVxw4c/KsjADtAuKW9/d8phb
    N8bTyOJo856qg4oOEzKG9eeF7oaZTYBy33BTL0408sEBxiMior6b8LrZrAhkqDjA
    vUXRwm/fFKgpsOysxC6xi553CxBUCH2omNV6Ka1LNMwzSp9ILz8jEGqmUtkBszwo
    G1S8fXgE0Lq3cdDM/GJ4QXP/p6LiwNF99faDMTV3+2SAOGvytOX6KjKVzKOSsfJQ
    hN0DlsIw8hqJc0WISQQYEQIACQUCSedYRAIbDAAKCRDorT+BmrEOeCUOAJ9qmR0l
    EXzeoxcdoafxqf6gZlJZlACgkWF7wi2YLW3Oa+jv2QSTlrx4KLM=
    =Wi5D
    -----END PGP PUBLIC KEY BLOCK-----
    
  2. Chạy lệnh sau để nhập khóa chung vào cơ sở dữ liệu khóa GnuPG của bạn. Khóa được sử dụng để ký các thẻ chú thích đại diện cho các bản phát hành.

    $ gpg --import keyfile.asc
    
  3. Sau khi nhập khóa, bạn có thể xác minh bất kỳ thẻ nào bằng cách chạy lệnh này:

    $ git tag -v TAG_NAME