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

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

Гит

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

Более подробную информацию о Git можно найти в этой документации Git .

Репо

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

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

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

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

Чтобы загрузить и установить Repo Launcher из git-repo-downloads , см. Установка Repo .

Геррит

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, чтобы вы могли устанавливать пакеты и оценивать внесенные изменения.

Для разработки AOSP используйте Android Studio for Platform (ASfP) .

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

Выполните следующие действия, чтобы установить Repo.

  1. Запустите эти команды, чтобы использовать официальный пакет из вашего дистрибутива Linux:
      sudo apt-get update
      sudo apt-get install repo
    
    Если эти команды не сработали в вашей системе — например, вы видите, что версия пакета устарела или на вашем компьютере нет официального пакета. Дистрибутив Linux: установите Repo вручную, используя следующие команды:
    export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
    curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
    gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
    
  2. Эти команды создают временный файл, загружают в него репозиторий и проверяют, соответствует ли предоставленный ключ требуемому ключу. Если все прошло успешно, установка продолжается.

    После установки убедитесь, что repo version сообщает что-то похожее на следующее, когда она работает в обычном каталоге. (Обычный каталог не является частью клиента репо; например, это ваш домашний каталог.)

  3. Запустите эту команду:
  4. repo version
  5. Ожидайте отчет, похожий на этот:
  6. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • Номер repo launcher version , указанный как 2.15 или выше, указывает на правильный номер версии и правильную установку.
    • (from /usr/bin/repo) указывает на установку из пакета.
    • (from /home/<>/bin/repo) указывает на установку вручную.

Завершение установки

Далее: Чтобы завершить полную установку Repo Tool, см. Инициализация клиента Repo на странице «Загрузка исходного кода» .