Edytor źródeł Git

Przegląd

Edytor źródła Git (ci.android.com/edit) to narzędzie przeglądarkowe do edytowania plików w projekcie Android Open Source Project (AOSP) i przesyłania zmian do Gerrit. Jest ona przeznaczona do wprowadzania drobnych zmian w niewielkiej liczbie plików i zapewnia szybszy przepływ pracy niż pobieranie drzewa źródłowego Androida. Zanim zaczniesz korzystać z edytora źródeł Git, zapoznaj się z całym procesem przesyłania zmian do AOSP za pomocą Git, Repo i Gerrit.

Gdy edytujesz plik za pomocą edytora źródeł Git, cała praca odbywa się na komputerze lokalnym, dopóki nie prześlesz zmian, aby utworzyć listę zmian Gerrit.

Zaloguj się

1. Otwórz edytor źródeł Git w przeglądarce.

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

   

   Rysunek 1. Przycisk logowania

Edytowanie plików i zmian

Edytor źródeł Git ma te główne przepływy pracy:

• Edytuj wybrane pliki w wybranej gałęzi.
• Edytowanie zmiany Gdy edytujesz zmianę, wynik zależy od tego, kto ją utworzył:
  • Jeśli zmiany zostały utworzone przez Ciebie, edycje w edytorze źródła Git zostaną włączone do zmiany jako nowy zestaw poprawek.
  • Jeśli zmianę wprowadziła inna osoba, Twoje edycje w Edytorze źródła Git utworzą nową zmianę, której będziesz właścicielem, na podstawie załadowanej zmiany.

Wczytaj element, który chcesz edytować.

Rozpocznij sesję edycji, wczytując plik lub zmianę.

Wczytywanie plików

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

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

2. Kliknij Wczytaj plik lub zmień.

   

   Rysunek 2. wczytywanie pliku lub zmiany,

   Plik zostanie wczytany w 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 w panelu edycji,

W panelu nawigacyjnym możesz otwierać więcej plików w tym samym repozytorium. Jeśli otworzysz kilka plików, każdy z nich pojawi się jako karta w wierszu nad panelem edycji. Kliknij kartę, aby otworzyć plik w panelu edycji.

Rysunek 4. Karty załadowanych plików

Wczytywanie zmiany

Otwórz zmianę, którą chcesz edytować, wpisując adres URL listy zmian Gerrit w polu file/change path (ścieżka pliku/zmiany) u góry strony (patrz rysunek 2).

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

Pliki ze zmianami otworzą się w panelu edycji (patrz rysunek 3).

Jeśli zmiana obejmuje wiele plików, każdy z nich jest wyświetlany jako karta w wierszu nad panelem edycji (patrz rysunek 4). Kliknij kartę, aby otworzyć plik w panelu edycji.

Wprowadź zmiany

Edytuj pliki w panelu edycji tekstu. Edytowane pliki pojawiają się na liście Oczekujące zmiany poniżej panelu edycji. Jeśli przypadkowo zamkniesz kartę pliku ze zmianami, możesz ponownie otworzyć ten plik ze zmianami, klikając jego nazwę na liście Oczekujące zmiany.

Prześlij zmiany

Zmianę tworzysz i publikujesz w Gerrit w edytorze źródeł Git. Następnie możesz śledzić zatwierdzenie zmiany w Gerrit.

Tworzenie i publikowanie zmian

Aby utworzyć i opublikować wprowadzone zmiany, wykonaj te czynności.

1. Kliknij odpowiedni przycisk:

   • Jeśli tworzysz nową zmianę, kliknij Utwórz zmianę.
   • Jeśli aktualizujesz istniejącą zmianę, kliknij Zaktualizuj zmianę.

   Otworzy się okno dialogowe.

   

   Rysunek 5. Okno dialogowe Utwórz zmianę

2. Wpisz opis zmiany, który stanie się opisem zmiany w Gerrit. Ten opis jest wymagany. Jeśli edytujesz istniejącą zmianę, możesz w razie potrzeby zmienić jej opis.

3. Opcjonalnie odznacz lub zaznacz pole wyboru Opublikuj po utworzeniu.

   To pole jest domyślnie zaznaczone.

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

4. Kliknij Utwórz.

   Zmiana zostanie przesłana do Gerrit. Jeśli zaznaczysz pole wyboru Opublikuj po utworzeniu, zmiana zostanie też opublikowana w Gerrit. Zmiana zostanie powiązana z powiadomieniem u góry ekranu.

   

   Rysunek 6. Zmienianie utworzonego powiadomienia

Zatwierdzanie zmian w Gerrit

Śledź stan przesłania zmiany bezpośrednio w Gerrit, tak jak w przypadku każdej innej zmiany.

Rysunek 7. Śledzenie stanu przesłania zmiany w Gerrit

Wyświetlanie różnic w plikach

Aby wyświetlić różnice między zmianami wprowadzonymi w pliku aktywnym w panelu edycji, zaznacz pole wyboru Różnice pod panelem edycji. Jest to przydatne podczas zmiany pliku i edytowania istniejącej zmiany.

Rysunek 8. Wyświetlanie różnic w plikach

Przywracanie plików

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

Przywracanie pojedynczego pliku

Aby cofnąć zmiany w jednym pliku, kliknij X obok nazwy pliku na liście Oczekujące zmiany.

Rysunek 9. Sekcja Oczekujące zmiany

Cofnij wszystkie pliki

Aby cofnąć zmiany we wszystkich plikach jednocześnie, kliknij Cofnij zmiany we wszystkich plikach pod panelem edycji.

Rysunek 10. Przycisk Cofnij wszystkie pliki

Otworzy się wyskakujące okno dialogowe. Kliknij Cofnij wszystkie, aby cofnąć zmiany we wszystkich plikach oczekujących, lub Anuluj, aby zachować zmiany i kontynuować edycję.

Rysunek 11. Okno potwierdzenia cofnięcia zmian we wszystkich plikach

Edytowanie strony bezpośrednio z wyszukiwarki kodu na Androida

Plik możesz otworzyć w edytorze źródeł Git bezpośrednio z wyszukiwarki kodu Androida. Jest to przydatne, jeśli przed edycją musisz znaleźć plik.

Aby edytować plik bezpośrednio w wyszukiwarce kodu Androida, wykonaj te czynności.

1. W Android Code Search (cs.android.com) otwórz plik, który chcesz edytować.

2. Kliknij Edytuj kod.

   

   Rysunek 12. Przycisk Edytuj kod w Android Code Search

   Otworzy się edytor źródeł Git z wcześniej wybranym plikiem do edycji.

3. Na liście Wybierz gałąź Git wybierz gałąź Git, w której chcesz edytować plik, a następnie kliknij Wybierz gałąź.

   

   Rysunek 13. Wybieranie gałęzi Git do edycji

   Plik otworzy się w panelu edycji.

4. Kontynuuj edytowanie zgodnie z instrukcjami w sekcji Wprowadzanie zmian.

5. Dodatkowe pliki możesz otworzyć do edycji w sposób opisany w sekcji Wczytywanie plików.

Rozwiąż konflikty

Aby rozwiązać konflikty:

1. W edytorze źródła przejdź do zmiany. Po wczytaniu zmiany pliki powodujące konflikt zostaną wyświetlone w dolnej części ekranu. Na przykład na rysunku 14 widać, że plikAndroid.pb jest w konflikcie.

   

   Rysunek 14. Konflikt edytora źródła

2. Kliknij plik, z którym występuje konflikt. Plik wczytuje się i wyświetla kolejne bloki treści, które są ze sobą sprzeczne, w obrębie znaczników Git (<<<<<<< i >>>>>>>).

   

   Rysunek 15. Znaczniki konfliktów w edytorze źródła

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

4. Aby utworzyć nową zmianę, kliknij Utwórz zmianę. Pojawi się okno dialogowe Utwórz zmianę.

   

   Rysunek 16. Tworzenie zmiany

5. Wpisz opis zmiany i kliknij Utwórz.

Prześlij opinię

Aby przesłać opinię o edytorze źródeł Git, kliknij przycisk błędu w prawym górnym rogu.

Powiązana dokumentacja

• Wyszukiwanie kodu Androida