Repo melengkapi Git dengan menyederhanakan pekerjaan di beberapa repositori. Untuk penjelasan hubungan antara Repo dan Git, lihat Alat kontrol sumber. Untuk selengkapnya detail tentang Repo, lihat README Repositori
Penggunaan repo memiliki bentuk berikut:
repo command options
Elemen opsional ditampilkan dalam tanda kurung []. Misalnya, banyak perintah mengambil project-list sebagai argumen. Anda dapat menentukan project-list sebagai daftar nama atau daftar jalur ke direktori sumber lokal untuk project:
repo sync [project0 project1 ... projectn]
repo sync [/path/to/project0 ... /path/to/projectn]
help
repo help
Memberikan bantuan tentang perintah repo
. Anda dapat melihat informasi mendetail tentang
perintah Repo tertentu yang menentukan perintah sebagai opsi:
repo help command
Misalnya, perintah berikut menghasilkan deskripsi dan daftar opsi
untuk perintah init
:
repo help init
Atau, untuk hanya melihat daftar opsi yang tersedia untuk perintah, jalankan:
repo command --help
Contoh:
repo init --help
init
repo init -u url [options]
Menginstal Repo di direktori saat ini. Perintah ini membuat direktori .repo/
dengan repositori Git untuk kode sumber Repo dan
file manifes Android standar.
Opsi:
-u
: Tentukan URL tempat repositori manifes akan diambil. Hal yang umum manifes ditemukan dihttps://android.googlesource.com/platform/manifest
.-m
: Pilih file manifes dalam repositori. Jika tidak ada nama manifes yang Jika dipilih, defaultnya adalahdefault.xml
.-b
: Menentukan revisi, yaitu manifest-branch tertentu.
sinkronkan
repo sync [project-list]
Mendownload perubahan baru dan memperbarui file yang sedang digunakan di lingkungan lokal Anda,
yang pada dasarnya menyelesaikan git fetch
di semua repositori Git. Jika Anda menjalankan
repo sync
tanpa argumen, tindakan ini akan menyinkronkan file untuk semua project.
Saat Anda menjalankan repo sync
, berikut yang akan terjadi:
Jika project belum pernah disinkronkan,
repo sync
setara dengangit clone
; semua cabang di repositori jarak jauh disalin ke jaringan lokal project.Jika project telah disinkronkan sebelumnya,
repo sync
akan setara menjadi:git remote update git rebase origin/branch
Dengan branch adalah cabang yang saat ini diambil di direktori project lokal. Jika cabang lokal tidak melacak cabang di repositori jarak jauh, tidak akan ada sinkronisasi untuk project.
Setelah repo sync
berhasil dijalankan, kode dalam project yang ditentukan
akan diperbarui dan disinkronkan dengan kode di repositori jarak jauh.
Opsi kunci:
-c
: Hanya mengambil cabang manifes saat ini dari server.-d
: Mengalihkan project yang ditentukan kembali ke revisi manifes. Opsi ini berguna jika project berada di cabang topik, tetapi revisi manifes diperlukan untuk sementara.-f
: Lanjutkan menyinkronkan project lain meskipun project gagal disinkronkan.threadcount
: Memisahkan sinkronisasi di seluruh thread untuk penyelesaian yang lebih cepat. Pastikan Anda tidak membebani mesin - sisakan beberapa CPU untuk tugas lain. Untuk melihat jumlah CPU yang tersedia, jalankannproc --all
terlebih dahulu.-q
: Berjalan dengan senyap dengan menyembunyikan pesan status.-s
: Menyinkronkan ke build yang diketahui baik seperti yang ditentukan oleh elemenmanifest-server
dalam manifes saat ini.
Untuk opsi lainnya, jalankan repo help sync
.
upload
repo upload [project-list]
Mengupload perubahan ke server peninjauan. Untuk project yang ditentukan, Repo membandingkan cabang lokal dengan cabang jarak jauh yang diperbarui selama sinkronisasi Repo terakhir. Repo meminta Anda untuk memilih satu atau beberapa cabang yang belum diupload untuk ditinjau.
Semua commit pada cabang yang dipilih kemudian ditransmisikan ke Gerrit melalui koneksi HTTPS. Anda harus mengonfigurasi sandi HTTPS untuk mengaktifkan upload otorisasi. Untuk membuat pasangan nama pengguna/sandi baru yang akan digunakan melalui HTTPS, buka Pembuat sandi.
Saat menerima data objek melalui servernya, Gerrit akan mengubah setiap commit menjadi perubahan sehingga peninjau dapat mengomentari commit tertentu.
Untuk menggabungkan beberapa commit checkpoint menjadi satu commit, gunakan git rebase -i
sebelum Anda menjalankan upload.
Jika Anda menjalankan repo upload
tanpa argumen, semua project akan ditelusuri untuk
perubahan untuk diupload.
Untuk mengedit perubahan setelah diupload, gunakan alat seperti git rebase -i
atau
git commit --amend
untuk memperbarui commit lokal Anda. Setelah pengeditan selesai:
- Verifikasi bahwa cabang yang diperbarui adalah cabang yang diperiksa saat ini.
- Gunakan
repo upload --replace PROJECT
untuk membuka editor pencocokan perubahan. Untuk setiap commit dalam seri, masukkan ID perubahan Gerrit di dalam tanda kurung:
# Replacing from branch foo [ 3021 ] 35f2596c Refactor part of GetUploadableBranches to lookup one specific... [ 2829 ] ec18b4ba Update proto client to support patch set replacements # Insert change numbers in the brackets to add a new patch set. # To create a new change record, leave the brackets empty.
Setelah upload selesai, perubahan akan memiliki set patch tambahan.
Jika Anda hanya ingin mengupload cabang Git yang saat ini di-check out, gunakan flag
--current-branch
(atau --cbr
untuk singkatnya).
diff
repo diff [project-list]
Menampilkan perubahan yang belum selesai antara commit dan hierarki kerja menggunakan
git diff
.
download
repo download target change
Mendownload perubahan yang ditentukan dari sistem peninjauan dan menyediakannya di direktori kerja lokal project Anda.
Misalnya, untuk mendownload
change 23823 ke direktori
platform/build
Anda:
repo download platform/build 23823
Menjalankan repo sync
akan menghapus commit yang diambil dengan repo download
. Atau, Anda
dapat memeriksa cabang jarak jauh menggunakan git checkout m/main
.
forall
repo forall [project-list] -c command
Mengeksekusi perintah shell yang diberikan di setiap project. Tambahan berikut
variabel lingkungan disediakan oleh repo forall
:
REPO_PROJECT
ditetapkan ke nama unik project.REPO_PATH
adalah jalur yang terkait dengan root klien.REPO_REMOTE
adalah nama sistem jarak jauh dari manifes.REPO_LREV
adalah nama revisi dari manifes, yang diterjemahkan ke cabang pelacakan lokal. Gunakan variabel ini jika Anda perlu meneruskan manifes revisi terhadap perintah Git yang dijalankan secara lokal.REPO_RREV
adalah nama revisi dari manifes, persis seperti yang ditulis dalam manifes.
Opsi:
-c
: Perintah dan argumen yang akan dieksekusi. Perintah dievaluasi melalui/bin/sh
dan argumen apa pun setelah diteruskan sebagai posisi shell parameter.-p
: Menampilkan header project sebelum output perintah yang ditentukan. Hal ini dicapai dengan mengikat pipa ke aliran stdin, stdout, dan sterr perintah, dan memasukkan semua output ke dalam aliran berkelanjutan yang ditampilkan dalam satu sesi pager.-v
: Menampilkan pesan yang ditulis perintah ke stderr.
prune
repo prune [project-list]
Memangkas (menghapus) topik yang sudah digabungkan.
start
repo start branch-name [project-list]
Memulai cabang baru untuk pengembangan, mulai dari revisi yang ditetapkan dalam manifes.
Argumen BRANCH_NAME
memberikan deskripsi singkat tentang perubahan yang sedang Anda
lakukan dalam proyek. Jika Anda tidak tahu, pertimbangkan untuk menggunakan nama
default
.
Argumen project-list
menentukan project mana yang berpartisipasi dalam topik ini
.
status
repo status [project-list]
Membandingkan hierarki kerja dengan area staging (indeks) dan commit terbaru di cabang ini (HEAD) di setiap project yang ditentukan. Menampilkan baris ringkasan untuk setiap file yang memiliki perbedaan di antara ketiga status ini.
Untuk melihat status cabang saat ini saja, jalankan repo status .
. Status
informasi yang dicantumkan
berdasarkan proyek. Untuk setiap file dalam project, kode dua huruf
akan digunakan.
Di kolom pertama, huruf besar menunjukkan perbedaan area staging dari status yang terakhir di-commit.
Letter | Arti | Deskripsi |
---|---|---|
- | Tidak ada perubahan | Sama di HEAD dan indeks |
A | Ditambahkan | Tidak di HEAD, dalam indeks |
S | Diubah | Di HEAD, diubah dalam indeks |
D | Dihapus | Di HEAD, bukan di indeks |
R | Nama telah diganti | Tidak di HEAD, jalur diubah di indeks |
C | Disalin | Tidak ada di HEAD, disalin dari URL lain dalam indeks |
T | Mode diubah | Konten yang sama di HEAD dan indeks, mode diubah |
U | Dipisahkan | Konflik antara HEAD dan indeks; resolusi diperlukan |
Di kolom kedua, huruf kecil menunjukkan perbedaan direktori kerja dengan pada indeks.
Letter | Arti | Deskripsi |
---|---|---|
- | Baru/tidak diketahui | Tidak ada dalam indeks, dalam hierarki kerja |
m | Diubah | Dalam indeks, di hierarki kerja, dimodifikasi |
d | Dihapus | Dalam indeks, bukan di hierarki kerja |
Menangani error repo
git commit -a # Commit local changes first so they aren't lost. repo start branch-name # Start the branch git reset --hard HEAD@{1} # And reset the branch so that it matches the commit before repo start repo upload .
Error repo: error: no branches ready for upload
muncul saat perintah
repo start
tidak berjalan pada awal sesi. Untuk memulihkan, Anda dapat memeriksa
ID commit, memulai cabang baru, lalu menggabungkannya.