Google is committed to advancing racial equity for Black communities. See how.
Эта страница переведена с помощью Cloud Translation API.
Switch to English

Инструменты контроля версий

Для работы с кодом Android требуется использование Git (система контроля версий с открытым исходным кодом) и Repo (созданный Google инструмент управления репозиториями, работающий поверх Git). См. Раздел « Рабочий процесс управления версиями» для получения сводной информации о регулярных действиях, таких как загрузка изменений для проверки.

Git

Git предназначен для обработки больших проектов, распределенных по нескольким репозиториям. Android использует Git для локальных операций, таких как локальное ветвление, фиксация, сравнение и редактирование. Одной из проблем при создании проекта Android было выяснить, как лучше всего поддерживать внешнее сообщество - от сообщества любителей до крупных OEM-производителей, создающих потребительские устройства для массового рынка. Мы хотели, чтобы компоненты можно было заменять, и чтобы интересные компоненты жили собственной жизнью за пределами Android. Сначала мы выбрали распределенную систему контроля версий, а затем сузили ее до Git.

Дополнительные сведения о Git см. В документации Git .

Репо

При необходимости Repo объединяет репозитории Git, выполняет загрузку в систему контроля версий Gerrit и автоматизирует части рабочего процесса разработки Android.

Repo состоит из двух частей: Repo Launcher, который вы загружаете и устанавливаете из git-repo-downloads . Это сценарий Python, который знает, как инициализировать оформление заказа и может загрузить вторую часть, полный инструмент Repo , включенный в проверку исходного кода Android. Полный инструмент Repo по умолчанию находится в $SRCDIR/.repo/repo/... и принимает перенаправленные команды из загруженной программы запуска Repo.

Repo не предназначен для замены Git, он предназначен только для упрощения работы с Git в контексте Android. Он использует файлы манифеста для объединения проектов Git в суперпроект Android. Команда repo - это исполняемый скрипт Python, который можно поместить в любое место на своем пути. При работе с исходными файлами Android вы используете Repo для сетевых операций, например, с одним рабочим каталогом Repo.

В большинстве случаев вы можете использовать Git вместо Repo или смешивать команды Repo и Git для формирования сложных команд. Однако использование Repo для базовых сетевых операций значительно упрощает вашу работу. Дополнительные сведения о репо см. В Справочнике по командамрепо, README репо , перехватчиках предварительной загрузки (тесты), которые можно включить в репо, и общей документации в AOSP .

Геррит

Gerrit - это веб-система проверки кода для проектов, использующих Git. Геррит поощряет более централизованное использование Git, позволяя всем авторизованным пользователям отправлять изменения, которые автоматически объединяются, если они проходят проверку кода. Кроме того, Gerrit упрощает просмотр, отображая изменения рядом в браузере и разрешая встроенные комментарии.

Найдите интерфейс обзора Android Gerrit на android-review.googlesource.com и интерфейс навигации по коду на android.googlesource.com .

Прочие инструменты

Android Code Search позволяет выполнять поиск в AOSP, ничего не загружая. Вы можете использовать поиск кода для просмотра исходного кода AOSP, переключения между ветвями с открытым исходным кодом и навигации по перекрестным ссылкам. Дополнительную информацию см. На сайте разработчиков Google для документации по поиску кода .

Android Studio - это официальная интегрированная среда разработки (IDE) для разработки приложений Android.

Android Debug Bridge (ADB) позволяет подключать рабочую станцию ​​разработчика непосредственно к устройству Android, чтобы вы могли устанавливать пакеты и оценивать свои изменения.

Установка репо

Repo - это инструмент, который упрощает работу с Git в контексте Android. См. Выше обзор репо, чтобы узнать его назначение и ссылки на связанные документы.

Repo состоит из двух частей: одна - это устанавливаемый вами сценарий запуска, и он взаимодействует со второй частью, полным инструментом Repo, включенным в проверку исходного кода. Чтобы установить Repo:

  1. Убедитесь, что у вас есть каталог bin/ в вашем домашнем каталоге и что он включен в ваш путь:

    mkdir ~/bin
    PATH=~/bin:$PATH
    
  2. Загрузите Repo Launcher и убедитесь, что он исполняемый:

    curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
    chmod a+x ~/bin/repo
    
  3. При желании проверьте, соответствует ли пусковая установка нашим подписям:

    gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ~/bin/repo
    

Старое репо для устаревших систем Python 2

Если вы используете старую систему без Python 3.6+, попробуйте загрузить старую версию Repo Launcher, которая все еще поддерживает Python 2.7. Это не будет работать бесконечно, но может помочь, пока ваша система не будет обновлена.

curl https://storage.googleapis.com/git-repo-downloads/repo-1 > ~/bin/repo
chmod a+x ~/bin/repo