Dokumentacja polecenia repozytorium

Repozytorium uzupełnia Git, upraszczając pracę w wielu repozytoriach. Więcej informacji o relacji między repozytorium a Git znajdziesz w artykule Narzędzia do kontroli wersji. Więcej szczegółowe informacje o repozytorium znajdziesz w Plik README repozytorium

Korzystanie z repozytorium:

repo command options

Elementy opcjonalne są umieszczone w nawiasach kwadratowych []. Na przykład wiele poleceń project-list jako argument. Możesz podać parametr project-list jako listę nazw lub listę ścieżek do lokalnych katalogów źródłowych w przypadku projektów:

repo sync [project0 project1 ... projectn]
repo sync [/path/to/project0 ... /path/to/projectn]

pomoc

repo help

Zapewnia pomoc dotyczącą polecenia repo. Szczegółowe informacje o konkretnym poleceniu Repo możesz zobaczyć, podając je jako opcję:

repo help command

Na przykład poniższe polecenie powoduje wyświetlenie opisu i listy opcji dla polecenia init:

repo help init

Aby zobaczyć tylko listę dostępnych opcji polecenia, uruchom polecenie:

repo command --help

Na przykład:

repo init --help

init

repo init -u url [options]

Instaluje repozytorium w bieżącym katalogu. To polecenie tworzy .repo/ z repozytoriami Git zawierającymi kod źródłowy Repo oraz standardowych plikach manifestu Androida.

Opcje:

  • -u: podaj adres URL, z którego chcesz pobrać repozytorium pliku manifestu. Wspólny plik manifestu znajduje się pod adresem https://android.googlesource.com/platform/manifest.

  • -m: wybierz plik manifestu w repozytorium. Jeśli nie wybierzesz nazwy pliku manifestu, zostanie użyta domyślna wartość default.xml.

  • -b: określenie wersji, czyli konkretnej manifest-branch.

.

synchronizacja

repo sync [project-list]

pobiera nowe zmiany i aktualizuje pliki robocze w środowisku lokalnym; co pozwoli uzyskać git fetch we wszystkich repozytoriach Git. Jeśli biegasz repo sync bez argumentów, synchronizuje pliki we wszystkich projektach.

Po uruchomieniu repo sync:

  • Jeśli projekt nigdy nie był synchronizowany, repo sync jest równoznaczne z git clone; wszystkie gałęzie w zdalnym repozytorium są kopiowane do lokalnego katalogu projektu.

  • Jeśli projekt był już synchronizowany, repo sync jest równoważne z:

    git remote update
git rebase origin/branch

    Gdzie branch to bieżąca wypisana gałąź w lokalnym katalogu projektu. Jeśli oddział lokalny nie śledzi oddziału na pilocie projekt nie zostanie zsynchronizowany.

Po pomyślnym uruchomieniu polecenia repo sync kod w określonych projektach jest aktualny i zsynchronizowany z kodem w zdalnym repozytorium.

Opcje klucza:

  • -c: pobierz z serwera tylko bieżącą gałąź pliku manifestu.
  • -d: przełączanie określonych projektów z powrotem na wersję pliku manifestu. Ta opcja jest przydatne, jeśli projekt jest w gałęzi tematu, ale wersja pliku manifestu jest tymczasowo potrzebny.
  • -f: kontynuuj synchronizację innych projektów, nawet jeśli nie uda się zsynchronizować danego projektu.
  • threadcount: podziel synchronizację między wątkami: szybszego ukończenia. Nie przeciążaj komputera – zostaw trochę procesora na potrzeby innych zadań. Aby zobaczyć liczbę dostępnych procesorów, najpierw uruchom nproc --all
  • -q: działaj dyskretnie przez pomijanie komunikatów o stanie.
  • -s: synchronizacja z dobrą kompilacją określoną przez element manifest-server w bieżącym pliku manifestu.

Aby zobaczyć więcej opcji, uruchom repo help sync.

prześlij

repo upload [project-list]

Przesyła zmiany na serwer opinii. W przypadku określonych projektów Repo porównuje gałęzie lokalne z gałęziami zdalnymi zaktualizowanymi podczas ostatniej synchronizacji repozytorium. W repozytorium zobaczysz prośbę o wybranie co najmniej 1 gałęzi, która nie została został przesłany do sprawdzenia.

Wszystkie zatwierdzenia w wybranych gałęziach są następnie przesyłane do Gerrit przez Połączenie HTTPS. Aby umożliwić przesyłanie, musisz skonfigurować hasło HTTPS autoryzacji. Aby wygenerować nową parę nazwy użytkownika i hasła do używania przez HTTPS, odwiedź Generator haseł.

Gdy Gerrit otrzymuje dane obiektu przez swój serwer, zmienia każdą z nich wprowadzić zmiany, aby weryfikatorzy mogli skomentować konkretne zatwierdzenie. Aby połączyć kilka zatwierdzeń punktu kontrolnego w jedno zatwierdzenie, użyj git rebase -i przed przesłaniem.

Jeśli uruchomisz funkcję repo upload bez argumentów, przeszukuje ona wszystkie projekty pod kątem: zmiany do przesłania.

Aby edytować zmiany po ich przesłaniu, użyj narzędzia takiego jak git rebase -i lub git commit --amend, aby zaktualizować lokalne zatwierdzenia. Po wprowadzeniu zmian:

  • Sprawdź, czy zaktualizowana gałąź jest aktualnie wymeldowaną gałęzią.
  • Użyj elementu repo upload --replace PROJECT, aby otworzyć edytor dopasowywania zmian.

  • W przypadku każdego zatwierdzenia w serii wpisz identyfikator zmiany w Gerricie w nawiasach:

    # 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.

Po zakończeniu przesyłania dla zmian zostanie ustawiona dodatkowa poprawka.

Jeśli chcesz przesłać tylko bieżącą gałąź Git, użyj flagi --current-branch (lub --cbr w skrócie).

różnice

repo diff [project-list]

Pokazuje oczekujące zmiany między zatwierdzeniem a drzewem roboczym za pomocą git diff

pobierz

repo download target change

Pobiera określoną zmianę z systemu sprawdzania i czyni ją dostępną w lokalnym katalogu roboczym projektu.

Aby pobrać na przykład plik zmień 23823 na Katalog platform/build:

repo download platform/build 23823

Uruchomienie repo sync spowoduje usunięcie wszystkich zatwierdzeń pobranych za pomocą repo download. Lub Ty może sprawdzić gałąź zdalną za pomocą git checkout m/main.

Forall

repo forall [project-list] -c command

Wykonuje podane polecenie powłoki w każdym projekcie. Poniższe dodatkowe zmienne środowiskowe zostały udostępnione przez program repo forall:

  • REPO_PROJECT ma unikalną nazwę projektu.
  • REPO_PATH to ścieżka w odniesieniu do katalogu głównego klienta.
  • REPO_REMOTE to nazwa systemu zdalnego z pliku manifestu.
  • REPO_LREV to nazwa wersji z pliku manifestu przekształcona w lokalną gałąź śledzenia. Użyj tej zmiennej, jeśli chcesz przekazać wersję pliku manifestu do lokalnie wykonanego polecenia Git.
  • REPO_RREV to nazwa wersji z pliku manifestu, dokładnie tak jak jest zapisana w pliku.

Opcje:

  • -c: polecenie i argumenty do wykonania. Polecenie jest sprawdzane przez /bin/sh i wszystkie argumenty po nim przekazywane jako pozycjonująca powłoka .
  • -p: przed wyświetleniem danych wyjściowych określonego polecenia wyświetla nagłówki projektu. To jest osiągnięto dzięki powiązaniom potoków ze strumieniami stdin, stdout i sterr polecenia oraz podawanie wszystkich danych wyjściowych w ciągły strumień, który jest wyświetlany na pojedynczym stronie .
  • -v: pokazuje komunikaty, które polecenie zapisuje w stderr.

śliwka

repo prune [project-list]

usuwa tematy, które zostały już scalone.

rozpocznij

repo start branch-name [project-list]

Rozpoczyna nową gałąź na potrzeby programowania, zaczynając od wersji określonej w pliku manifestu.

Argument BRANCH_NAME zawiera krótki opis zmiany, którą wnosisz w projektach. Jeśli nie znasz nazwy, użyj nazwy default.

Argument project-list określa, które projekty uczestniczą w tej gałęzi tematu.

status

repo status [project-list]

Porównuje drzewo robocze z obszarem pośrednim (indeksem) oraz najnowszym zatwierdzonym commitem w tej gałęzi (HEAD) w każdym z podanych projektów. Wyświetla wiersz podsumowania dla każdego pliku, w którym występują różnice między tymi 3 stanami.

Aby wyświetlić tylko stan bieżącej gałęzi, uruchom polecenie repo status .. Stan wyświetlane są informacje według projektu. Każdy plik w projekcie zawiera dwuliterowy kod za pomocą kodu.

W pierwszej kolumnie litera w wielkiej literze wskazuje, czym obszar stagingu różni się od ostatniego stanu.

List Znaczenie Opis
- Bez zmian Takie same w sekcji nagłówka i indeksie
A Dodano Nie w sekcji HEAD, ale w indeksie
M Data modyfikacji W elemencie HEAD, zmodyfikowano w indeksie
D Usunięte W sekcji HEAD, ale nie w indeksie
R Nazwa została zmieniona Nie w HEAD, ścieżka w indeksie została zmieniona
C Skopiowano Brak w głównym pliku, skopiowane z innego w indeksie
T Tryb został zmieniony Ta sama treść w HEAD i indeksie, tryb zmieniony
U Rozdzielono Konflikt między HEAD a indeksem; wymagane rozwiązanie

W drugiej kolumnie mała litera wskazuje, czym różni się katalog roboczy od indeksu.

List Znaczenie Opis
- Nowy/nieznany Brak indeksu, w drzewie roboczym
min Data modyfikacji Zmodyfikowano w indeksie, w drzewie roboczym
d Usunięte W indeksie, nie w drzewie roboczym

Obsługa błędów repozytorium

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 .

Błąd repo: error: no branches ready for upload pojawia się, gdy polecenie repo start nie zostało wykonane na początku sesji. Aby przywrócić zmiany, możesz sprawdzić identyfikator zatwierdzenia, utworzyć nową gałąź i scalić ją.