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

Обзор

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

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

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

1. Загрузите редактор исходного кода Git в браузере.

2. Нажмите «Войти» , чтобы войти в свою учетную запись.

   

   Рисунок 1. Кнопка входа в систему

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

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

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

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

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

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

1. Введите URL-адрес файла, который вы хотите отредактировать, в поле «Файл/Изменить путь» в верхней части страницы.

   Пример пути к файлу: https://android.googlesource.com/platform/build/+show/refs/heads/android16-release/Changes.md

2. Нажмите Загрузить файл или изменить .

   

   Рисунок 2. Загрузка файла или изменения

   Файл загружается в панель редактора. Панель навигации слева от панели редактора — это файловый браузер, который открывает репозиторий с предварительно загруженным файлом.

   

   Рисунок 3. Файл, загруженный в панель редактирования

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Нажмите соответствующую кнопку:

   • Нажмите «Создать изменение», если вы создаете новое изменение.
   • Нажмите Обновить изменение, если вы обновляете существующее изменение.

   Откроется диалоговое окно.

   

   Рисунок 5. Диалоговое окно «Создать изменение»

2. Введите описание изменения, которое станет описанием изменения в Gerrit. Это описание обязательно. Если вы редактируете существующее изменение, вы можете редактировать его описание, если хотите.

3. При желании снимите или установите флажок Опубликовать при создании .

   Этот флажок установлен по умолчанию.

   Если этот флажок установлен при создании изменения, изменение немедленно публикуется в Gerrit. Если флажок не установлен, изменение загружается в Gerrit, но не публикуется.

4. Нажмите «Создать» .

   Изменение загружается в Gerrit. Если вы отметили флажок Publish on create , изменение также публикуется в Gerrit. Изменение ссылается на уведомление в верхней части экрана.

   

   Рисунок 6. Изменение созданного уведомления

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

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

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

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

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

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

Откат файлов

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

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

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

Рисунок 9. Раздел «Ожидаемые изменения»

Вернуть все файлы

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

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

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

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

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

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

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

1. В Android Code Search (cs.android.com) перейдите к файлу, который вы хотите отредактировать.

2. Нажмите «Изменить код» .

   

   Рисунок 12. Кнопка «Изменить код» поиска кода Android

   Откроется редактор исходного кода Git с предварительно выбранным для редактирования файлом.

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

   

   Рисунок 13. Выбор ветки Git для редактирования

   Файл откроется в панели редактирования.

4. Продолжайте редактирование, как описано в разделе «Внесение изменений» .

5. Вы можете открыть дополнительные файлы для редактирования, как описано в разделе Загрузка файлов.

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

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

1. В редакторе исходного кода перейдите к изменению. После загрузки изменения конфликтующие файлы будут перечислены в нижней части экрана. Например, на рисунке 14 показано, что файл Android.pb имеет конфликт.

   

   Рисунок 14. Конфликт редактора исходного кода

2. Щелкните конфликтующий файл. Файл загружается и показывает конфликтующие блоки контента последовательно и в маркерах Git ( <<<<<<< и >>>>>>> ).

   

   Рисунок 15. Маркеры конфликтов редактора исходного кода

3. Исправьте конфликт, отредактировав файл и вручную удалив маркеры конфликта вокруг контента, который вы хотите сохранить. Также удалите контент и маркеры конфликта для контента, который вы не хотите сохранять.

4. Нажмите «Создать изменение» , чтобы создать новое изменение. Появится диалоговое окно «Создать изменение».

   

   Рисунок 16. Создание изменения

5. Введите описание изменения и нажмите «Создать» .

Отправить отзыв

Используйте кнопку «Ошибка» в правом верхнем углу, чтобы оставить отзыв о Git Source Editor.

Сопутствующая документация

• Поиск кода Android