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
- Załaduj edytor źródła Git do przeglądarki.
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
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
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.
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ę
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.
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.
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.
W Android Code Search (cs.android.com) przejdź do pliku, który chcesz edytować.
Kliknij Edytuj kod .
Rysunek 12. Przycisk Edytuj kod Android Code Search
Zostanie otwarty edytor źródła Git z plikiem wybranym do edycji.
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.
Kontynuuj edycję zgodnie z opisem w sekcji Dokonywanie zmian .
Możesz otworzyć dodatkowe pliki do edycji, jak opisano w sekcji Ładowanie plików
Rozwiązywać konflikty
Aby rozwiązać konflikty:
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.pbwystępuje konflikt.
Rysunek 14. Konflikt edytora źródłowego
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
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ć.
Kliknij opcję Utwórz zmianę , aby utworzyć nową zmianę. Pojawi się okno dialogowe Utwórz zmianę.
Rysunek 16. Tworzenie zmiany
Wpisz opis zmiany i kliknij Utwórz .
Wyślij opinię
Użyj przycisku błędu
w prawym górnym rogu, aby przekazać opinię na temat edytora źródeł Git.