Alat kontrol sumber

Bekerja dengan kode Android memerlukan penggunaan Git (sistem kontrol versi sumber terbuka) dan Repo (alat manajemen repositori buatan Google yang berjalan di atas Git). Lihat halaman Alur Kerja Kontrol Sumber untuk ringkasan tindakan rutin yang dapat Anda lakukan, seperti mengunggah perubahan untuk ditinjau.

Git

Git menangani proyek besar yang didistribusikan ke beberapa repositori. Android menggunakan Git untuk operasi lokal seperti percabangan lokal, penerapan, diff, dan pengeditan. Salah satu tantangan dalam menyiapkan proyek Android adalah menentukan cara terbaik untuk mendukung komunitas luar—mulai dari komunitas penghobi hingga OEM besar yang membangun perangkat konsumen pasar massal. Google ingin komponen-komponennya dapat diganti, dan ingin komponen-komponen menarik dapat berfungsi sendiri, di luar Android. Google pertama-tama memilih sistem kontrol revisi terdistribusi, lalu mempersempitnya ke Git.

Untuk detail lebih lanjut tentang Git, lihat Dokumentasi Git ini.

Repo

Repo menyatukan repositori Git bila diperlukan, melakukan pengunggahan ke sistem kontrol revisi Gerrit , dan mengotomatiskan bagian alur kerja pengembangan Android.

Repo Launcher menyediakan skrip Python yang menginisialisasi checkout dan mengunduh bagian kedua, alat Repo lengkap. Alat Repo lengkap disertakan dalam checkout kode sumber Android. Itu terletak, secara default, di $SRCDIR/.repo/repo/... dan menerima perintah yang diteruskan dari Repo Launcher yang diunduh.

Repo tidak menggantikan Git, hanya mempermudah bekerja dengan Git dalam konteks Android. Repo menggunakan file manifes untuk menggabungkan proyek Git ke dalam proyek super Android. Anda dapat meletakkan perintah repo , yang merupakan skrip Python yang dapat dieksekusi, di mana pun di jalur Anda. Dalam bekerja dengan file sumber Android, Anda dapat menggunakan Repo untuk operasi lintas jaringan seperti dengan satu direktori kerja Repo.

Dalam kebanyakan situasi, Anda dapat menggunakan Git sebagai pengganti Repo, atau menggabungkan perintah Repo dan Git untuk membentuk perintah yang kompleks. Namun, menggunakan Repo untuk operasi dasar lintas jaringan membuat pekerjaan Anda lebih sederhana. Untuk rincian lebih lanjut tentang Repo, lihat Repo Perintah Referensi , Repo README , Preupload Hooks (tes) yang dapat diaktifkan di Repo, dan dokumen umum di AOSP .

Untuk mengunduh dan menginstal Repo Launcher dari git-repo-downloads , lihat Menginstal Repo .

Gerrit

Gerrit adalah sistem peninjauan kode berbasis web untuk proyek yang menggunakan Git. Gerrit mendorong penggunaan Git yang lebih terpusat dengan mengizinkan semua pengguna yang berwenang untuk mengirimkan perubahan, yang secara otomatis digabungkan jika mereka lulus tinjauan kode. Selain itu, Gerrit memudahkan peninjauan, menampilkan perubahan secara berdampingan di browser dan mengaktifkan komentar sebaris.

Temukan antarmuka ulasan Android Gerrit di android-review.googlesource.com dan antarmuka navigasi kode di android.googlesource.com .

Pencarian Kode Android memungkinkan Anda mencari AOSP tanpa mengunduh apa pun. Anda dapat menggunakan Pencarian Kode untuk melihat kode sumber AOSP, beralih antar cabang sumber terbuka, dan menavigasi referensi silang. Untuk informasi selengkapnya, lihat situs Google Developers untuk dokumentasi penelusuran Kode .

Alat lainnya

Android Studio adalah lingkungan pengembangan terintegrasi (IDE) resmi untuk pengembangan aplikasi Android.

Android Debug Bridge (ADB) memungkinkan Anda menghubungkan stasiun kerja pengembangan langsung ke perangkat Android sehingga Anda dapat menginstal paket dan mengevaluasi perubahan Anda.

Untuk pengembangan AOSP, gunakan Android Studio for Platform (ASfP) .

Menginstal Repo

Ikuti langkah-langkah berikut untuk menginstal Repo.

  1. Jalankan perintah ini untuk menggunakan paket resmi dari distribusi Linux Anda:
      sudo apt-get update
      sudo apt-get install repo
    
    Jika perintah tersebut tidak berfungsi untuk sistem Anda–misalnya, Anda melihat bahwa versi paket sudah usang, atau tidak ada paket resmi yang tersedia dari Anda Distribusi Linux, instal Repo secara manual menggunakan perintah berikut:
    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
    
  2. Perintah ini menyiapkan file sementara, mengunduh repo ke dalamnya, dan memverifikasi bahwa kunci yang diberikan cocok dengan kunci yang diperlukan. Jika berhasil, instalasi dilanjutkan.

    Setelah instalasi, verifikasi bahwa repo version melaporkan sesuatu yang mirip dengan yang berikut ini ketika dijalankan di direktori biasa. (Direktori reguler bukan bagian dari klien repo; misalnya, ini adalah direktori home Anda.)

  3. Jalankan perintah ini:
  4. repo version
  5. Harapkan laporan serupa dengan ini:
  6. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • Nomor repo launcher version yang dilaporkan sebagai 2.15 atau lebih tinggi menunjukkan nomor versi yang benar dan pemasangan yang benar.
    • (from /usr/bin/repo) menunjukkan instalasi dari suatu paket.
    • (from /home/<>/bin/repo) menunjukkan instalasi manual.

Menyelesaikan instalasi

Berikutnya: Untuk menyelesaikan instalasi Repo Tool lengkap, lihat Menginisialisasi klien Repo , di halaman Mengunduh Sumber .