Это руководство поможет вам сделать первые шаги в разработке операционной системы 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:
Скачайте информацию о текущем пакете:
sudo apt-get updateЧтобы установить средство запуска Repo, выполните следующую команду:
sudo apt-get install repoПрограмма запуска Repo предоставляет скрипт Python, который инициализирует извлечение и скачивает полный инструмент Repo.
Если все в порядке, перейдите к шагу 4.
При необходимости установите Repo вручную, используя следующие команды:
export REPO=$(mktemp /tmp/repo.XXXXXXXXX)curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repogpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repoПервые три команды создают временный файл, скачивают в него Repo и проверяют, что предоставленный ключ соответствует требуемому. Если эти команды выполнены успешно, последняя команда устанавливает средство запуска Repo.
Проверьте версию программы запуска Repo:
repo versionВ выводе должна быть указана версия 2.4 или выше, например:
repo launcher version 2.45
Как скачать исходный код Android
Исходный код Android находится в наборе хранилищ Git, размещенных Google. Каждый репозиторий Git содержит полную историю исходного кода Android, включая изменения и время их внесения. Чтобы скачать исходный код Android:
Перейдите в домашний каталог:
cd ~Создайте в нем локальный рабочий подкаталог:
mkdir aospПерейдите в каталог:
cd aospИнициализируйте ветку последнего выпуска исходного кода хранилища AOSP (
android-latest-release):repo init --partial-clone -b android-latest-release -u https://android.googlesource.com/platform/manifestВведите или подтвердите свои учетные данные Git (имя, адрес электронной почты).
Синхронизируйте исходный код:
repo sync -c -j8Если у вас возникли проблемы со скачиванием, ознакомьтесь со статьей Устранение неполадок с синхронизацией.
Создайте код
Чтобы создать код, выполните следующие действия:
В рабочем каталоге запустите скрипт
envsetup.sh, чтобы настроить среду сборки:source build/envsetup.shУкажите тип целевого устройства, для которого нужно выполнить сборку с помощью команды
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 ============================================Создайте целевой объект:
m
Первая сборка может занять несколько часов. Последующие сборки занимают значительно меньше времени. Результат сборки появится в $OUT_DIR.
Запустить Cuttlefish
Cuttlefish – это эмулятор Android, который используется для тестирования сборок.
Чтобы скачать, собрать и установить пакеты Debian для хоста, выполните следующие команды:
sudo apt install -y git devscripts equivs config-package-dev debhelper-compat golang curlgit clone https://github.com/google/android-cuttlefishcd android-cuttlefishtools/buildutils/build_packages.shsudo apt install -y ./cuttlefish-base_*.deb ./cuttlefish-user_*.debsudo usermod -aG kvm,cvdnetwork,render $USERsudo rebootПри перезагрузке устанавливаются дополнительные модули ядра и применяются правила
udev.После перезагрузки рабочей станции перейдите в каталог
aosp, настройте среду сборки и запустите Cuttlefish:cd ~/aospsource build/envsetup.shlunch aosp_cf_x86_64_only_phone-aosp_current-userdebuglaunch_cvd --daemonПодключитесь к устройству Cuttlefish, перейдя по адресу
https://localhost:8443в браузере. На экране появится виртуальное устройство Android.
Внесите изменения
Обновите исходный код, как показано в примере.
Из корневого каталога извлечения (
aosp/) перейдите в проект Gitframeworks/native:cd frameworks/nativeСоздайте временную ветку с помощью следующей команды:
repo start BRANCH_NAME .Откройте файл
SurfaceFlinger.cppв редакторе. Он находится по следующему пути:aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cppНайдите следующую строку:
void SurfaceFlinger::updateColorMatrixLocked() {Добавьте эту строку в начало файла
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});Создайте код:
mОбновите сборку на устройстве:
adb rootadb remount -Radb rootadb syncadb rebootУбедитесь, что цвет на выбранном устройстве изменился.
Как исправить тест
В этой части практической работы используется пример теста, который находится в дереве исходного кода и завершается ошибкой. Чтобы запустить, отладить и исправить тест, выполните следующие действия:
Запущено:
atest DevCodelabTestТест не пройден.
Изучите трассировку стека для неудачного теста:
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.Чтобы определить местоположение теста, который нужно исправить, добавьте
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.Измените
platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java, заменивAssert.assertTrue(false)наAssert.assertTrue(true).Чтобы убедиться, что проблема устранена, запустите проверку ещё раз.
atest DevCodelabTest
Загрузите код для проверки
Repo упрощает работу с Git, объединяя команды, например git clone, для одновременного выполнения в нескольких репозиториях (или проектах) Git. Для проверки кода проектов в Git используйте веб-систему Gerrit.
Если вы внесли изменения в проект
frameworks/native, выполните следующие команды, чтобы загрузить их:cd frameworks/nativerepo start BRANCH_NAME .git add .git commitВ качестве сообщения о фиксации введите следующее:
Android BRANCH_NAME change Test: manual atestЗагрузите изменения:
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 и объединяете их с репозиторием. Вместо этого для целей этой практической работы отмените свою работу:
В Gerrit нажмите Abandon (Отменить).
Удалите связанную временную ветку в каталоге проекта
frameworks/native(или его подкаталогах):repo abandon BRANCH_NAME .Отмените изменения, внесенные в тестовый файл. Поскольку вы не запускали команды
repo start,git commitиrepo uploadдля тестового изменения, вы можете сбросить сам файл. Если вы находитесь в каталогеaosp/platform_testing, используйте следующие команды, чтобы сбросить файл:git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.javagit checkout .
На этом практическая работа по разработке платформы Android завершена.
Справка
Если во время выполнения практической работы у вас возникнут ошибки, сообщите о них, используя ссылку на систему отслеживания ошибок внизу любой страницы. Вопросы можно отправлять в группу android-building.
Введите ps -A | grep crosvm, чтобы проверить, запущен ли crosvm. Если crosvm запущено, введите stop_cvd || true или kill crosvm с идентификатором процесса.