Попробуйте разработку для Android

Это руководство поможет вам сделать первые шаги в разработке операционной системы Android.

Настройка для разработки под Android

Прежде чем скачивать и собирать ветку манифеста android-latest-release исходного кода Android, убедитесь, что ваше оборудование соответствует необходимым требованиям и требуемое программное обеспечение правильно установлено. Также вам следует ознакомиться со следующими терминами:

Git
Git – это бесплатная распределенная система управления версиями с открытым исходным кодом. Android использует Git для локальных операций, таких как ветвление, коммиты, диффы и правки. Дополнительную информацию о Git можно найти в документации.
Repo
Repo – это оболочка Python для Git, которая упрощает выполнение сложных операций в нескольких хранилищах Git. Repo не заменяет Git для всех операций управления версиями, а лишь упрощает выполнение сложных операций Git. Repo использует файлы манифеста, чтобы объединять проекты Git в суперпроект Android.
файл манифеста
Файл манифеста – это XML-файл, в котором указано, где в дереве исходного кода AOSP размещены различные проекты Git в исходном коде Android.

Требования к оборудованию Meet

Ваш рабочий компьютер должен соответствовать следующим требованиям к оборудованию:

  • 64-разрядная система x86.

  • Не менее 400 ГБ свободного места на диске для извлечения и сборки кода (250 ГБ для извлечения и 150 ГБ для сборки).

  • Не менее 64 ГБ ОЗУ. Для сборки Android мы используем 72-ядерные компьютеры с 64 ГБ ОЗУ. При такой конфигурации оборудования полная сборка Android занимает около 40 минут, а инкрементная – всего несколько минут. Для сравнения: полная сборка на 6-ядерном компьютере с 64 ГБ ОЗУ занимает около 6 часов.

Требования к операционной системе

На рабочей станции разработчика должен быть установлен любой 64-разрядный дистрибутив Linux с библиотекой GNU C (glibc) версии 2.17 или более поздней.

Установите необходимые пакеты

Чтобы установить необходимые пакеты для Ubuntu 18.04 или более поздней версии, выполните следующую команду:

sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig

Установите необходимое ПО

Прежде чем начать работу с AOSP, необходимо установить OpenJDK, Make, Python 3 и Repo. В последней версии Android есть встроенные версии OpenJDK, Make и Python 3, поэтому дополнительные действия по установке не требуются. В следующем разделе объясняется, как установить Repo.

Установка Repo

Выполните следующие шаги, чтобы установить Repo:

  1. Скачайте информацию о текущем пакете:

    sudo apt-get update
  2. Чтобы установить средство запуска Repo, выполните следующую команду:

    sudo apt-get install repo

    Программа запуска Repo предоставляет скрипт Python, который инициализирует извлечение и скачивает полный инструмент Repo.

    Если все в порядке, перейдите к шагу 4.

  3. При необходимости установите 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

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

  4. Проверьте версию программы запуска Repo:

    repo version

    В выводе должна быть указана версия 2.4 или выше, например:

    repo launcher version 2.45
    

Как скачать исходный код Android

Исходный код Android находится в наборе хранилищ Git, размещенных Google. Каждый репозиторий Git содержит полную историю исходного кода Android, включая изменения и время их внесения. Чтобы скачать исходный код Android:

  1. Перейдите в домашний каталог:

    cd ~
  2. Создайте в нем локальный рабочий подкаталог:

    mkdir aosp
  3. Перейдите в каталог:

    cd aosp
  4. Инициализируйте ветку последнего выпуска исходного кода хранилища AOSP (android-latest-release):

    repo init --partial-clone -b android-latest-release -u https://android.googlesource.com/platform/manifest
  5. Введите или подтвердите свои учетные данные Git (имя, адрес электронной почты).

  6. Синхронизируйте исходный код:

    repo sync -c -j8

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

Создайте код

Чтобы создать код, выполните следующие действия:

  1. В рабочем каталоге запустите скрипт envsetup.sh, чтобы настроить среду сборки:

    source build/envsetup.sh
  2. Укажите тип целевого устройства, для которого нужно выполнить сборку с помощью команды lunch. Цель – это вариант устройства, например определенная модель или форм-фактор. Укажите эту цель:

    lunch aosp_cf_x86_64_only_phone-aosp_current-userdebug

    Вы должны увидеть краткое описание целевой среды и среды сборки:

    ============================================
    PLATFORM_VERSION_CODENAME=Baklava
    PLATFORM_VERSION=Baklava
    TARGET_PRODUCT=aosp_cf_x86_64_only_phone
    TARGET_BUILD_VARIANT=userdebug
    TARGET_ARCH=x86_64
    TARGET_ARCH_VARIANT=silvermont
    HOST_OS=linux
    HOST_OS_EXTRA=Linux-6.10.11-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete
    HOST_CROSS_OS=windows
    BUILD_ID=BP1A.250305.020
    OUT_DIR=out
    ============================================
    
  3. Создайте целевой объект:

    m

Первая сборка может занять несколько часов. Последующие сборки занимают значительно меньше времени. Результат сборки появится в $OUT_DIR.

Запустить Cuttlefish

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

  1. Чтобы скачать, собрать и установить пакеты Debian для хоста, выполните следующие команды:

    sudo apt install -y git devscripts equivs config-package-dev debhelper-compat golang curl
    git clone https://github.com/google/android-cuttlefish
    cd android-cuttlefish
    tools/buildutils/build_packages.sh
    sudo apt install -y ./cuttlefish-base_*.deb ./cuttlefish-user_*.deb
    sudo usermod -aG kvm,cvdnetwork,render $USER
    sudo reboot

    При перезагрузке устанавливаются дополнительные модули ядра и применяются правила udev.

  2. После перезагрузки рабочей станции перейдите в каталог aosp, настройте среду сборки и запустите Cuttlefish:

    cd ~/aosp
    source build/envsetup.sh
    lunch aosp_cf_x86_64_only_phone-aosp_current-userdebug
    launch_cvd --daemon
  3. Подключитесь к устройству Cuttlefish, перейдя по адресу https://localhost:8443 в браузере. На экране появится виртуальное устройство Android.

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

Обновите исходный код, как показано в примере.

  1. Из корневого каталога извлечения (aosp/) перейдите в проект Git frameworks/native:

    cd frameworks/native
  2. Создайте временную ветку с помощью следующей команды:

    repo start BRANCH_NAME .
  3. Откройте файл SurfaceFlinger.cpp в редакторе. Он находится по следующему пути:

    aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
    
  4. Найдите следующую строку:

    void SurfaceFlinger::updateColorMatrixLocked() {
    
  5. Добавьте эту строку в начало файла updateColorMatrixLocked():

    mClientColorMatrix = mat4(vec4{1.0f, 0.0f, 0.0f, 0.0f}, vec4{0.0f, -1.0f, 0.0f, 0.0f},
                              vec4{0.0f, 0.0f, -1.0f, 0.0f}, vec4{0.0f, 1.0f, 1.0f, 1.0f});
    
  6. Создайте код:

    m
  7. Обновите сборку на устройстве:

    adb root
    adb remount -R
    adb root
    adb sync
    adb reboot
  8. Убедитесь, что цвет на выбранном устройстве изменился.

Как исправить тест

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

  1. Запущено:

    atest DevCodelabTest

    Тест не пройден.

  2. Изучите трассировку стека для неудачного теста:

    STACKTRACE:
    java.lang.AssertionError
        at org.junit.Assert.fail(Assert.java:87)
        at org.junit.Assert.assertTrue(Assert.java:42)
        at org.junit.Assert.assertTrue(Assert.java:53)
        at android.test.example.devcodelab.DevCodelabTest.testHelloWorld(DevCodelabTest.java:29)
    

    Последняя строка трассировки стека показывает, какой тест не пройден (testHelloWorld). Этот тест находится в файле DevCodelabTest.java.

  3. Чтобы определить местоположение теста, который нужно исправить, добавьте WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/ в последнюю строку трассировки стека до названия тестового файла включительно. Таким образом, android.test.example.devcodelab.DevCodelabTest становится WORKING_DIRECTORY/platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java.

  4. Измените platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java, заменив Assert.assertTrue(false) на Assert.assertTrue(true).

  5. Чтобы убедиться, что проблема устранена, запустите проверку ещё раз.

    atest DevCodelabTest

Загрузите код для проверки

Repo упрощает работу с Git, объединяя команды, например git clone, для одновременного выполнения в нескольких репозиториях (или проектах) Git. Для проверки кода проектов в Git используйте веб-систему Gerrit.

  1. Если вы внесли изменения в проект frameworks/native, выполните следующие команды, чтобы загрузить их:

    cd frameworks/native
    repo start BRANCH_NAME .
    git add .
    git commit
  2. В качестве сообщения о фиксации введите следующее:

    Android BRANCH_NAME change
    Test: manual atest
    
  3. Загрузите изменения:

    repo upload

    Если попытка будет успешной, вы увидите сообщение, похожее на следующее:

    Upload project frameworks/native/ to remote branch android17-release:
      branch BRANCH_NAME ( 1 commit, Wed Aug 7 09:32:33 2019 -0700):
             ff46b36d Android BRANCH_NAME change
    to https://android-review.googlesource.com/ (y/N)? y
    remote: Processing changes: refs: 1, new: 1, done
    remote:
    remote: SUCCESS
    remote:
    remote:   https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432 Android BRANCH_NAME change [NEW]
    remote:
    To https://android-review.googlesource.com/platform/frameworks/native
    * [new branch]          BRANCH_NAME -> refs/for/android17-release
    

Посмотреть изменения в Gerrit

Чтобы посмотреть изменения в Gerrit, перейдите по ссылке, которая появится в терминале. Ссылка выглядит примерно так:

https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432

Отмените изменение

Обычно после тестирования, проверки и утверждения вы отправляете изменения в Gerrit и объединяете их с репозиторием. Вместо этого для целей этой практической работы отмените свою работу:

  1. В Gerrit нажмите Abandon (Отменить).

  2. Удалите связанную временную ветку в каталоге проекта frameworks/native (или его подкаталогах):

    repo abandon BRANCH_NAME .
  3. Отмените изменения, внесенные в тестовый файл. Поскольку вы не запускали команды repo start, git commit и repo upload для тестового изменения, вы можете сбросить сам файл. Если вы находитесь в каталоге aosp/platform_testing, используйте следующие команды, чтобы сбросить файл:

    git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
    git checkout .

На этом практическая работа по разработке платформы Android завершена.

Справка

Если во время выполнения практической работы у вас возникнут ошибки, сообщите о них, используя ссылку на систему отслеживания ошибок внизу любой страницы. Вопросы можно отправлять в группу android-building.

Введите ps -A | grep crosvm, чтобы проверить, запущен ли crosvm. Если crosvm запущено, введите stop_cvd || true или kill crosvm с идентификатором процесса.