Edytor źródeł Git

Przegląd

Edytor źródeł Git (ci.android.com/edit) to oparte na przeglądarce narzędzie do edycji plików w projekcie Android Open Source Project (AOSP) i przesyłania zmian do Gerrit. Jest przeznaczony do wprowadzania drobnych zmian w niewielkiej liczbie plików i zapewnia szybszy przepływ pracy niż pobieranie drzewa źródłowego Androida . Przed użyciem edytora źródeł Git powinieneś zapoznać się z pełnym procesem przesyłania zmian do AOSP przy użyciu Git, Repo i Gerrit.

Kiedy edytujesz plik za pomocą edytora źródeł Git, cała praca odbywa się na komputerze lokalnym, dopóki nie prześlesz zmian w celu utworzenia listy zmian Gerrit.

Zaloguj sie

1. Załaduj edytor źródła Git do przeglądarki.

2. Kliknij Zaloguj się , aby zalogować się na swoje konto.

   

   Rysunek 1. Przycisk Zaloguj

Edytuj pliki i zmiany

Git Source Editor ma następujące główne przepływy pracy:

• Edytuj jeden lub więcej wybranych plików w wybranej gałęzi.
• Edytuj zmianę. Wynik edycji zmiany zależy od tego, kto ją utworzył:
  • Jeśli to Ty stworzyłeś zmianę, zmiany w Edytorze źródeł Git zostaną załatane do zmiany jako nowy zestaw poprawek.
  • Jeśli ktoś inny stworzył zmianę, zmiany dokonane w Edytorze źródeł Git utworzą nową zmianę, której jesteś właścicielem, na podstawie załadowanej zmiany.

Załaduj to, co chcesz edytować

Rozpocznij sesję edycyjną, ładując plik lub zmianę.

Załaduj pliki

1. Wpisz adres URL pliku, który chcesz edytować, w polu pliku/zmień ścieżkę u góry strony.

   Przykładowa ścieżka pliku: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md

2. Kliknij Załaduj plik lub zmień .

   

   Rysunek 2. Ładowanie pliku lub zmiany

   Plik zostanie załadowany do panelu edytora. Panel nawigacyjny po lewej stronie panelu edytora to przeglądarka plików, która otwiera repozytorium z wstępnie załadowanym plikiem.

   

   Rysunek 3. Plik załadowany do panelu edycji

Możesz użyć panelu nawigacji, aby otworzyć więcej plików w tym samym repozytorium. Jeśli otworzysz wiele plików, każdy plik pojawi się jako zakładka w wierszu nad okienkiem edycji. Kliknij kartę, aby otworzyć ten plik w okienku edycji.

Rysunek 4. Zakładki załadowanych plików

Załaduj zmianę

Przejdź do zmiany, którą chcesz edytować, wprowadzając adres URL listy zmian Gerrit w polu pliku/ścieżki zmiany u góry strony (patrz rysunek 2).

Przykładowy link do zmiany: https://android-review.googlesource.com/c/platform/build/soong/+/1284176

Pliki objęte zmianą otwierają się w okienku edycji (patrz rysunek 3).

Jeśli zmiana obejmuje wiele plików, każdy plik pojawi się jako zakładka w wierszu nad okienkiem edycji (patrz rysunek 4). Kliknij kartę, aby otworzyć ten plik w okienku edycji.

Wprowadź zmiany

Edytuj pliki za pomocą panelu edycji tekstu. Edytowane pliki pojawiają się na liście Oczekujące zmiany poniżej okienka edycji. Jeśli przypadkowo zamkniesz kartę pliku zawierającego zmiany, możesz ponownie otworzyć plik z nienaruszonymi zmianami, klikając jego nazwę na liście Oczekujące zmiany.

Prześlij zmiany

Tworzysz i publikujesz swoje zmiany w Gerrit w Git Source Editor. Następnie śledzisz zatwierdzenie zmiany w Gerrit.

Utwórz i opublikuj zmiany

Postępuj zgodnie z poniższą procedurą, aby utworzyć i opublikować wprowadzone zmiany.

1. Kliknij odpowiedni przycisk:

   • Kliknij opcję Utwórz zmianę , jeśli tworzysz nową zmianę.
   • Kliknij opcję Aktualizuj zmianę, jeśli aktualizujesz istniejącą zmianę.

   Zostanie otwarte okno dialogowe.

   

   Rysunek 5. Okno dialogowe Utwórz zmianę

2. Wprowadź opis zmiany, który stanie się opisem zmiany w Gerrit. Ten opis jest wymagany. Jeśli edytujesz istniejącą zmianę, możesz edytować jej opis, jeśli chcesz.

3. Opcjonalnie wyczyść lub zaznacz pole wyboru Publikuj po utworzeniu .

   To pole jest domyślnie zaznaczone.

   Jeśli to pole zostanie zaznaczone podczas tworzenia zmiany, zmiana zostanie natychmiast opublikowana w Gerrit. Jeśli to pole nie jest zaznaczone, zmiana zostanie przesłana do Gerrit, ale nie zostanie opublikowana.

4. Kliknij opcję Utwórz .

   Zmiana zostanie przesłana do Gerrit. Jeśli zaznaczyłeś pole wyboru Publikuj po utworzeniu , zmiana zostanie opublikowana także w Gerrit. Link do zmiany znajduje się w powiadomieniu u góry ekranu.

   

   Rysunek 6. Zmiana utworzonego powiadomienia

Śledź zatwierdzanie zmian w Gerrit

Śledź status przesłania zmiany bezpośrednio w Gerrit, tak jak każdą inną zmianę.

Rysunek 7. Śledzenie statusu przesyłania zmian w Gerrit

Zobacz różnice w plikach

Zaznacz pole wyboru Różn. poniżej panelu edycji, aby wyświetlić różnice w edycjach dokonanych w pliku aktywnym w okienku edycji. Jest to przydatne podczas zmiany pliku i edycji istniejącej zmiany.

Rysunek 8. Przeglądanie różnic plików

Przywróć pliki

Możesz cofnąć zmiany w pojedynczym pliku lub we wszystkich plikach na liście oczekujących zmian. Obie opcje przywracania przywracają zmiany tylko w edytorze źródeł Git. NIE zaktualizują zmiany w Gerrit.

Przywróć pojedynczy plik

Aby przywrócić pojedynczy plik, kliknij X obok nazwy pliku na liście Oczekujące zmiany.

Rysunek 9. Sekcja zmian oczekujących

Przywróć wszystkie pliki

Aby przywrócić wszystkie pliki jednocześnie, kliknij opcję Przywróć wszystkie pliki poniżej okienka edycji.

Rysunek 10. Przycisk Przywróć wszystkie pliki

Otworzy się wyskakujące okno dialogowe. Kliknij przycisk Przywróć wszystko , aby cofnąć zmiany we wszystkich oczekujących plikach, lub kliknij przycisk Anuluj , aby zachować zmiany i kontynuować edycję.

Rysunek 11. Okno dialogowe potwierdzenia przywrócenia wszystkich plików

Edytuj stronę bezpośrednio z poziomu wyszukiwania kodu Androida

Możesz otworzyć plik w Git Source Editor bezpośrednio z poziomu wyszukiwania kodu Androida . Jest to przydatne, jeśli chcesz zlokalizować plik przed jego edycją.

Wykonaj tę procedurę, aby edytować plik bezpośrednio z poziomu wyszukiwania kodu Androida.

1. W Android Code Search (cs.android.com) przejdź do pliku, który chcesz edytować.

2. Kliknij Edytuj kod .

   

   Rysunek 12. Przycisk Edytuj kod Android Code Search

   Zostanie otwarty edytor źródła Git z plikiem wybranym do edycji.

3. Wybierz gałąź Git, w której chcesz edytować plik, z listy rozwijanej Wybierz gałąź git , a następnie kliknij Wybierz gałąź .

   

   Rysunek 13. Wybieranie gałęzi Git do edycji

   Plik zostanie otwarty w okienku edycji.

4. Kontynuuj edycję zgodnie z opisem w sekcji Dokonywanie zmian .

5. Możesz otworzyć dodatkowe pliki do edycji, jak opisano w sekcji Ładowanie plików

Rozwiązywać konflikty

Aby rozwiązać konflikty:

1. W Edytorze źródła przejdź do zmiany. Po załadowaniu zmiany pliki powodujące konflikt zostaną wyświetlone w dolnej części ekranu. Na przykład rysunek 14 pokazuje, że w pliku Android.pb występuje konflikt.

   

   Rysunek 14. Konflikt edytora źródłowego

2. Kliknij plik powodujący konflikt. Plik ładuje i pokazuje sprzeczne bloki treści po kolei oraz w obrębie znaczników Git ( <<<<<<< i >>>>>>> ).

   

   Rysunek 15. Znaczniki konfliktu edytora źródłowego

3. Napraw konflikt, edytując plik i ręcznie usuwając znaczniki konfliktu wokół treści, którą chcesz zachować. Usuń także znaczniki treści i konfliktów w przypadku treści, których nie chcesz zachować.

4. Kliknij opcję Utwórz zmianę , aby utworzyć nową zmianę. Pojawi się okno dialogowe Utwórz zmianę.

   

   Rysunek 16. Tworzenie zmiany

5. Wpisz opis zmiany i kliknij Utwórz .

Wyślij opinię

Użyj przycisku błęduw prawym górnym rogu, aby przekazać opinię na temat edytora źródeł Git.

Powiązana dokumentacja

• Wyszukiwanie kodu Androida