Ta strona została przetłumaczona przez Cloud Translation API.

Edytor źródeł Git

Omówienie

Edytor źródeł Git (ci.android.com/edit) to narzędzie działające w przeglądarce, które umożliwia edytowanie plików w ramach Projektu Android Open Source (AOSP) i przesyłanie zmian do Gerrit. Narzędzie to służy 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 kodu źródłowego Git, zapoznaj się z całym procesem przesyłania zmian do AOSP za pomocą Git, Repo i Gerrit.

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

Zaloguj się

W przeglądarce otwórz Git Source Editor.
Kliknij Zaloguj się, aby zalogować się na swoje konto.

Uwaga: zaloguj się na konto, które ma uprawnienia Gerrit dla gałęzi, które chcesz edytować.

Rysunek 1. Przycisk logowania

Edytowanie plików i zmian

Edytor źródeł Git umożliwia wykonywanie tych głównych procesów:

Edytuj wybrane pliki w wybranej gałęzi.
Edytuj zmianę. Gdy edytujesz zmianę, wynik zależy od tego, kto ją utworzył:
- Jeśli zmiana została wprowadzona przez Ciebie, zmiany w Git Source Editor zostaną zastosowane do tej zmiany jako nowy zestaw poprawek.
- Jeśli zmianę wprowadził ktoś inny, zmiany w Git Source Editor utworzą nową zmianę, która będzie Twoją własnością, na podstawie załadowanej zmiany.

Załaduj to, co chcesz edytować

Aby rozpocząć edycję, załaduj plik lub zmianę.

Wczytywanie plików

W polu Ścieżka do pliku/zmiany u góry strony wpisz adres URL pliku, który chcesz edytować.

Przykładowa ścieżka do pliku: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md
Kliknij Wczytaj plik lub zmień.

Rysunek 2. wczytywanie pliku lub zmiana;

Plik zostanie załadowany 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 do panelu edycji

Za pomocą panelu nawigacyjnego 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.

Karty wczytanych plików

Rysunek 4. Karty wczytanych plików

Ładowanie zmiany

Przejdź do zmiany, którą chcesz edytować, wpisując adres URL listy zmian Gerrita w polu ś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 w zmianie otwierają się w panelu edycji (patrz rysunek 3).

Jeśli zmiana dotyczy wielu plików, każdy z nich będzie widoczny jako karta w wierszu nad panelem edycji (patrz rys. 4). Kliknij kartę, aby otworzyć plik w panelu edycji.

Wprowadź zmiany

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

Wprowadź zmiany

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

Tworzenie i publikowanie zmian

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

Kliknij odpowiedni przycisk:
- Jeśli tworzysz nową zmianę, kliknij Utwórz zmianę.
- Jeśli aktualizujesz dotychczasową zmianę, kliknij Zaktualizuj zmianę.
Otworzy się okno.

Rysunek 5. Okno dialogowe Utwórz zmianę
Wpisz opis zmiany, który stanie się opisem zmiany w Gerrit. Ten opis jest wymagany. Jeśli edytujesz istniejące zmiany, możesz w razie potrzeby zmienić ich opis.
Opcjonalnie odznacz lub zaznacz pole wyboru Opublikuj po utworzeniu.

To pole jest domyślnie zaznaczone.

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

Zmiana jest przesyłana do Gerrit. Jeśli zaznaczysz pole wyboru Opublikuj podczas tworzenia, zmiana zostanie opublikowana również w Gerrit. Zmiana jest powiązana z powiadomieniem u góry ekranu.

Rysunek 6. Zmiana utworzonego powiadomienia

Śledzenie zatwierdzenia zmian w Gerrit

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

Śledzenie stanu przesyłania zmian w Gerricie

Rysunek 7. Śledzenie stanu przesyłania zmian w Gerricie

Wyświetlanie różnic między plikami

Zaznacz pole wyboru Różnice pod panelem edycji, aby wyświetlić różnice między wersjami pliku, który jest aktywny w panelu edycji. Jest to przydatne podczas zmiany pliku i edytowania istniejącej zmiany.

Wyświetlanie różnic między plikami

Rysunek 8. Wyświetlanie różnic między plikami

Przywracanie plików

Możesz cofnąć zmiany w pojedynczym pliku lub we wszystkich plikach na liście oczekujących zmian. Obie opcje cofnięcia cofają zmiany tylko w edytorze źródeł Git. Nie będą one aktualizować zmian w Gerrit.

Przywracanie pojedynczego pliku

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

Sekcja oczekujące zmiany

Rysunek 9. Sekcja oczekujące zmiany

Przywróć wszystkie pliki

Aby cofnąć wszystkie pliki jednocześnie, pod panelem edycji kliknij Cofnij wszystkie pliki.

Rysunek 10. Przycisk Cofnij wszystkie pliki

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

Okno potwierdzenia cofnięcia wszystkich plików

Rysunek 11. Okno potwierdzenia cofnięcia wszystkich plików

Edytowanie strony bezpośrednio w wyszukiwarce kodu Androida

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

Aby edytować plik bezpośrednio z wyszukiwarki kodu na Androida, wykonaj te czynności.

W wyszukiwarce kodu Androida (cs.android.com) przejdź do pliku, który chcesz edytować.
Kliknij Edytuj kod.

Rysunek 12. Przycisk Edytuj kod w Android Code Search

Otworzy się edytor źródeł Git z wybranym do edycji plikiem.
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.
Kontynuuj edycję zgodnie z instrukcjami w sekcji Wprowadzanie zmian.
Możesz otworzyć dodatkowe pliki do edycji w sposób opisany w sekcji Wczytywanie plików.

Rozwiązywanie konfliktów

Aby rozwiązać konflikty:

W Edytorze źródeł przejdź do zmiany. Po załadowaniu zmian pliki z konfliktami są wyświetlane w dolnej części ekranu. Na przykład na rysunku 14 widać, że plik Android.pb ma konflikt.

Rysunek 14. Konflikt w edytorze źródeł
Kliknij plik powodujący konflikt. Plik wczytuje i wyświetla naprzemiennie bloki treści w oznacznikach Git (<<<<<<< i >>>>>>>).

Rysunek 15. znaczniki konfliktów w edytorze źródeł.
Rozwiąż konflikt, edytując plik i ręcznie usuwając znaczniki konfliktu wokół treści, które chcesz zachować. Usuń też treści i oznaczenia konfliktu dotyczące treści, których nie chcesz zachować.
Aby utworzyć nową zmianę, kliknij Utwórz zmianę. Pojawi się okno Tworzenie zmiany.

Rysunek 16. Tworzenie zmian
Wpisz opis zmiany i kliknij Utwórz.