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-proyek besar yang didistribusikan melalui beberapa repositori. Android menggunakan Git untuk operasi lokal seperti percabangan lokal, komit, diff, dan pengeditan. Salah satu tantangan dalam menyiapkan proyek Android adalah menentukan cara terbaik untuk mendukung komunitas luar—dari komunitas penggemar hingga OEM besar yang membangun perangkat konsumen pasar massal. Google ingin komponen dapat diganti, dan ingin komponen yang menarik memiliki kehidupannya sendiri, di luar Android. Google pertama-tama memilih sistem kontrol revisi terdistribusi, lalu mempersempitnya menjadi Git.

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

repo

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

Peluncur Repo 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, itu hanya membuatnya lebih mudah untuk 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 saja 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 daripada Repo, atau mencampur perintah Repo dan Git untuk membentuk perintah yang kompleks. Namun, menggunakan Repo untuk operasi lintas jaringan dasar membuat pekerjaan Anda lebih sederhana. Untuk detail lebih lanjut tentang Repo, lihat Referensi Perintah Repo , 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 Memasang Repo .

Gerrit

Gerrit adalah sistem tinjauan 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

Pencarian Kode Android memungkinkan Anda untuk mencari AOSP tanpa mengunduh apa pun. Anda dapat menggunakan Pencarian Kode untuk melihat kode sumber AOSP, beralih di antara 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 workstation pengembangan Anda langsung ke perangkat Android sehingga Anda dapat menginstal paket dan mengevaluasi perubahan Anda.

Untuk Android 10 dan lebih tinggi, gunakan IntelliJ dengan AIDEgen IDE untuk pengembangan platform Android.

Memasang Repo

Ikuti langkah-langkah ini 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 bekerja 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-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
   curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
   

Perintah-perintah ini mengatur file temp, mengunduh repo ke sana, dan memverifikasi bahwa kunci yang diberikan cocok dengan kunci yang diperlukan. Jika berhasil maka instalasi akan dilanjutkan.

Catatan: Kunci terdaftar di keys.openpgp.org dan bekerja secara default untuk distribusi berbasis Debian. Jika Anda tidak dapat mengunduh kunci atau jika verifikasi gagal, lihat dokumentasi distribusi Anda untuk menggunakan Gnu Privacy Guard (GPG). Untuk sumber daya tambahan, lihat situs web GnuPG .

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

2. Jalankan perintah ini:

repo version

3. Harapkan laporan yang mirip dengan yang ini:

<repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)

• Pelaporan nomor repo launcher version sebagai 2.15 atau lebih tinggi menunjukkan nomor versi yang benar dan pemasangan yang benar.
• (from /usr/bin/repo) menunjukkan instalasi dari sebuah paket.
• (from /home/<>/bin/repo) menunjukkan instalasi manual.

Menyelesaikan instalasi

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