Эта страница переведена с помощью Cloud Translation API.

Редактор исходного кода Git

Обзор

Редактор исходного кода Git (ci.android.com/edit) — это браузерный инструмент для редактирования файлов в проекте Android с открытым исходным кодом (AOSP) и загрузки изменений в Gerrit. Он предназначен для внесения незначительных изменений в небольшое количество файлов и обеспечивает более быстрый рабочий процесс, чем загрузка дерева исходного кода Android . Прежде чем использовать редактор исходного кода Git, вы должны быть ознакомлены с полным процессом отправки изменений в AOSP с помощью Git, Repo и Gerrit.

Когда вы редактируете файл с помощью редактора исходного кода Git, вся работа происходит на вашем локальном компьютере, пока вы не загрузите изменения для создания списка изменений Gerrit.

Авторизоваться

Загрузите редактор исходного кода Git в браузере.
Нажмите «Войти», чтобы войти в свою учетную запись.
Примечание. Обязательно войдите в систему под учетной записью, имеющей права Gerrit для ветвей, которые вы хотите редактировать.
Рисунок 1. Кнопка входа в систему

Редактирование файлов и изменений

Редактор исходного кода Git имеет следующие основные рабочие процессы:

Отредактируйте один или несколько файлов по вашему выбору в выбранной вами ветке.
Отредактируйте изменение. Результат редактирования изменения зависит от того, кто создал это изменение:
- Если вы внесли изменение, ваши изменения в редакторе исходного кода Git будут добавлены в изменение как новый набор исправлений.
- Если изменение создал кто-то другой, ваши изменения в редакторе исходного кода Git создают новое изменение, которым вы владеете, на основе загруженного вами изменения.

Загрузите то, что хотите редактировать

Начните сеанс редактирования, загрузив файл или изменение.

Загрузить файлы

Введите URL-адрес файла, который вы хотите отредактировать, в поле «Путь к файлу/изменению» вверху страницы.
Пример пути к файлу: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md.
Нажмите «Загрузить файл или изменить» .
Рисунок 2. Загрузка файла или изменение
Файл загружается в панели редактора. Панель навигации слева от панели редактора представляет собой браузер файлов, который открывает репозиторий с предварительно загруженным файлом.
Рисунок 3. Файл, загруженный в область редактирования

Вы можете использовать панель навигации, чтобы открыть больше файлов в одном репозитории. Если вы открываете несколько файлов, каждый файл отображается в виде вкладки в строке над панелью редактирования. Щелкните вкладку, чтобы открыть этот файл на панели редактирования.

Вкладки для загруженных файлов

Рисунок 4. Вкладки для загруженных файлов

Загрузить изменение

Перейдите к изменению, которое вы хотите отредактировать, введя URL-адрес списка изменений Gerrit в поле «Путь к файлу/изменению» в верхней части страницы (см. рис. 2).

Пример ссылки на изменение: https://android-review.googlesource.com/c/platform/build/soong/+/1284176.

Файлы в изменении открываются на панели редактирования (см. рис. 3).

Если изменение включает несколько файлов, каждый файл отображается в виде вкладки в строке над панелью редактирования (см. рис. 4). Щелкните вкладку, чтобы открыть этот файл на панели редактирования.

Внесите свои изменения

Редактируйте файлы с помощью панели редактирования текста. Файлы, которые вы редактируете, отображаются в списке «Ожидание изменений» под панелью редактирования. Если вы случайно закрыли вкладку файла с изменениями, вы можете снова открыть файл с изменениями, щелкнув его имя в списке Ожидающие изменения.

Отправить изменения

Вы создаете и публикуете изменения в Gerrit в редакторе исходного кода Git. Затем вы отслеживаете утверждение изменения в Gerrit.

Создайте и опубликуйте изменения

Следуйте этой процедуре, чтобы создать и опубликовать внесенные вами изменения.

Нажмите соответствующую кнопку:
- Нажмите «Создать изменение», если вы создаете новое изменение.
- Нажмите «Обновить изменение», если вы обновляете существующее изменение.
Откроется диалоговое окно.
Рисунок 5. Диалоговое окно «Создать изменение»
Введите описание изменения, которое станет описанием изменения в Gerrit. Это описание является обязательным. Если вы редактируете существующее изменение, вы можете отредактировать его описание, если хотите.
При необходимости снимите или установите флажок Публиковать при создании .
Это поле выбрано по умолчанию.
Если этот флажок установлен при создании изменения, изменение немедленно публикуется в Gerrit. Если флажок не установлен, изменение загружается в Gerrit, но не публикуется.
Нажмите Создать .
Изменение загружается в Gerrit. Если вы установили флажок «Опубликовать при создании» , изменение также будет опубликовано в Gerrit. Изменение связано с уведомлением в верхней части экрана.
Рисунок 6. Изменить созданное уведомление

Отслеживание утверждения изменений в Gerrit

Отслеживайте статус отправки изменений непосредственно в Gerrit, как и любые другие изменения.

Отслеживание статуса отправки изменений в Gerrit

Рисунок 7. Отслеживание статуса отправки изменений в Gerrit

Посмотреть различия файлов

Установите флажок «Различия» под панелью редактирования, чтобы просмотреть различия в изменениях, внесенных вами в файл, активный на панели редактирования. Это полезно при изменении файла и при редактировании существующих изменений.

Просмотр различий файлов

Рисунок 8. Просмотр различий файлов

Восстановить файлы

Вы можете отменить изменения из одного файла или из всех файлов в списке ожидающих изменений. Обе опции возврата отменяют изменения только в редакторе исходного кода Git. Они НЕ будут обновлять изменения в Геррите.

Вернуть один файл

Чтобы отменить один файл, нажмите X рядом с именем файла в списке ожидающих изменений.

Раздел ожидающих изменений

Рисунок 9. Раздел ожидающих изменений

Восстановить все файлы

Чтобы восстановить все файлы одновременно, нажмите «Восстановить все файлы» под панелью редактирования.

Рисунок 10. Кнопка «Вернуть все файлы»

Откроется всплывающее диалоговое окно. Нажмите «Отменить все» , чтобы отменить изменения во всех ожидающих файлах, или нажмите «Отмена», чтобы сохранить изменения и продолжить редактирование.

Диалоговое окно подтверждения возврата всех файлов

Рисунок 11. Диалоговое окно подтверждения возврата всех файлов

Редактируйте страницу прямо из поиска кода Android.

Вы можете открыть файл в Git Source Editor прямо из поиска кода Android . Это полезно, если вам нужно найти файл перед его редактированием.

Следуйте этой процедуре, чтобы редактировать файл непосредственно из поиска кода Android.

В поиске кода Android (cs.android.com) перейдите к файлу, который вы хотите редактировать.
Нажмите Изменить код .
Рис. 12. Кнопка редактирования кода поиска кода Android
Редактор исходного кода Git откроется с файлом, предварительно выбранным для редактирования.
В раскрывающемся списке «Выберите ветку git» выберите ветку Git, в которой вы хотите редактировать файл, затем нажмите «Выбрать ветку» .
Рисунок 13. Выбор ветки Git для редактирования
Файл откроется в области редактирования.
Продолжайте редактирование, как описано в разделе «Внесение изменений» .
Вы можете открыть дополнительные файлы для редактирования, как описано в разделе «Загрузка файлов» .

Разрешение конфликтов

Для разрешения конфликтов:

В редакторе исходного кода перейдите к изменению. После загрузки изменения конфликтующие файлы отображаются в нижней части экрана. Например, на рисунке 14 показано, что файл Android.pb имеет конфликт.
Рисунок 14. Конфликт редактора исходного кода
Щелкните конфликтующий файл. Файл последовательно загружает и отображает конфликтующие блоки контента внутри маркеров Git ( <<<<<<< и >>>>>>> ).
Рисунок 15. Маркеры конфликта редактора исходного кода
Устраните конфликт, отредактировав файл и вручную удалив маркеры конфликта вокруг содержимого, которое вы хотите сохранить. Кроме того, удалите маркеры контента и конфликта для контента, который вы не хотите сохранять.
Нажмите «Создать изменение», чтобы создать новое изменение. Появится диалоговое окно «Создать изменение».
Рисунок 16. Создание изменений
Введите описание изменения и нажмите «Создать» .