Codelab для Android-разработчиков

Вы можете помочь разработать самую широко устанавливаемую операционную систему в истории Земли. Да, вы здесь, чтобы стать инженером платформы Android.

Несмотря на то, что путь сложен, команда Android стремится упростить ваше путешествие с каждым выпуском. И команда каждый день вносит улучшения благодаря непосредственной работе в Android Open Source Project (AOSP).

Так что расслабьтесь, запустите терминал и давайте творить историю.

Цели

Миссия этой кодлабы двояка:

1. Чтобы дать вам небольшое представление о том, на что похож рабочий процесс разработчиков Android, работающих над платформой (операционной системой).
2. Поощряйте вас оставлять отзывы об инструментах Android, документации и рабочем процессе разработчиков.

Предпосылки

Список требований для этой кодлабы основан на требованиях для разработки на общей платформе ( AOSP ). Чтобы воспользоваться этой кодовой лабораторией, настройте следующее:

• Физическая рабочая станция Linux, отвечающая всем общедоступным требованиям .
• Репозиторий и конфигурация Git, необходимые для редактирования базы кода Android.

Окружающая среда

Как правило, пользователи строят и разрабатывают непосредственно на рабочей станции. Поскольку вы можете работать в разных терминалах, а многие из используемых команд специфичны для терминала, вам нужно будет повторно запускать их в каждом сеансе терминала. В частности, к ним относятся source build/envsetup.sh и команды lunch .

Настроить рабочую станцию

1. Установите необходимые пакеты на рабочую станцию.
2. Находясь в терминале, установите Repo и получите учетные данные для всех репозиториев Git.

Инициализировать и синхронизировать код

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

   cd ~
   

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

   mkdir aosp
   

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

   cd aosp
   

4. Инициализируйте основную ветку исходного кода репозитория AOSP (по умолчанию):

   repo init -u https://android.googlesource.com/platform/manifest
   

5. Введите или примите свои учетные данные Git (имя, адрес электронной почты).

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

   repo sync -j8
   

Первоначальная синхронизация может занять час или больше.

Каждая проверка репо представлена ​​файлом манифеста . Разрешено иметь более 1 проверки репо одновременно, если они существуют в разных каталогах. Но обратите внимание, что каждая проверка и сборка занимают примерно 300 ГБ (и растут), поэтому либо ограничьтесь двумя проверками репо, либо дополните свою систему дополнительным диском.

СОВЕТ: Чтобы увеличить свободное пространство, удалите каталог филиала и начните заново с создания каталога, например: rm -rf aosp2.

Создайте код

Чтобы собрать Android, вы должны выбрать тип целевого устройства для сборки с помощью команды lunch . Цель — это перестановка устройства, например конкретная модель или форм-фактор.

Приведенное ниже целевое устройство aosp_cf_x86_64_phone-userdebug позволяет создать виртуальное Android-устройство Cuttlefish для тестирования без физического устройства.

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

1. Настройте среду для сборки устройств Android, выполнив следующую команду из корня проверки исходного кода:

   source build/envsetup.sh
   

2. Передайте цель сборки команде обеда, например:

   lunch aosp_cf_x86_64_phone-userdebug
   

3. Создавайте код из любого места на кассе с помощью:

   m
   

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

Создайте экземпляр Acloud

Acloud — это инструмент командной строки в AOSP, который помогает пользователям создавать виртуальные устройства Android, в данном случае Cuttlefish.

Если вы находитесь в том же сеансе терминала, который использовался для создания кода , продолжайте. В противном случае повторно запустите сценарий envsetup.sh и ту же команду lunch , которую вы использовали раньше. затем

1. Создайте локальный экземпляр Acloud с помощью:

   acloud create --local-image --local-instance
   

2. Примите обновления для необходимых пакетов.

3. При появлении запроса перезагрузите рабочую станцию, чтобы все изменения вступили в силу.

4. Выберите устройство «Каракатица».

Вас должен приветствовать сеанс VNC, содержащий устройство Android!

Вы можете взаимодействовать с виртуальным устройством на рабочей станции с помощью мыши и клавиатуры. Вы также можете следить за действиями в журналах во время использования вашего устройства, используя команду logcat Android Debug Bridge (adb):

adb logcat

Изменить

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

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

   cd frameworks/native
   

2. Запустите временный проект с помощью этой команды:

   repo start <some-name> .
   

3. Отредактируйте SurfaceFlinger.cpp , чтобы включить обновления из списка изменений в следующем месте:

   aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
   

4. Найдите эти две строки:

   postFrame();
   postComposition();
   

5. Замените эти две строки на следующие:

   postFrame();
   postComposition();
   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});
   updateColorMatrixLocked();
   

6. Соберите код:

   m
   

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

   adb root
   adb remount
   adb sync
   adb reboot
   acloud reconnect
   

8. Если вам будет предложено выбрать устройство, выберите то, которое показывает наименьшее прошедшее время. (Возможно, это последнее в списке, который вы видите.) Чтобы просмотреть все экземпляры виртуальных устройств, используйте команды acloud list и acloud list -v .

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

Рисунок 1. Внешний вид экрана после успешного изменения цвета

Протестируйте свой код

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

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

1. Бежать:

   atest DevCodelabTest
   

2. Тест провалится. Чтобы исправить это, найдите исходный код неудавшегося теста:

   atest --info android.test.example.devcodelab.DevCodelabTest#testHelloWorld
   

3. Тогда смотри сюда

   platform_testing/tests/example/devcodelab
   

4. Чтобы получить файл для редактирования, возьмите имя теста в android.test.example.devcodelab.DevCodelabTest и замените расширение . с / , чтобы получить этот результат:

   src/android/test/example/devcodelab/DevCodelabTest.java
   

5. Затем отредактируйте

   platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
   

   заменить

   Assert.assertTrue(false)
   

   с

   Assert.assertTrue(true)
   

6. Запустите тест еще раз, чтобы убедиться, что вы устранили проблему:

   atest DevCodelabTest
   

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

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

См. Инструменты контроля версий для обзора Git и Repo со ссылками на полную документацию по работе с исходным кодом Android. Полный список проектов Git и отдельные проекты (пути) для веток, связанных с каждым проектом, см. в репозитории AOSP .

Для проверки кода ваших проектов в Git вы будете использовать веб-систему проверки кода Gerrit .

Важно: убедитесь, что вы вошли в Gerrit, чтобы просматривать изменения и реагировать на них.

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

   cd frameworks/native
   repo start codelab .
   git add .
   git commit
   

2. В качестве сообщения о коммите введите следующее:

   Android codelab change
   Test: manual atest
   

3. Загрузите ваше изменение:

   repo upload
   

В случае успеха вы увидите сообщение, похожее на это:

Upload project frameworks/native/ to remote branch master:
  branch codelab ( 1 commit, Wed Aug 7 09:32:33 2019 -0700):
         ff46b36d android codelab 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 codelab change [NEW]
remote:
To https://android-review.googlesource.com/platform/frameworks/native
 * [new branch]          codelab -> refs/for/master

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

Перейдите по ссылке, напечатанной в терминале, похожей на эту:

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

Это завершает начальную лабораторию кода для разработки платформы Android. Дальнейшие действия см. в разделе Отправка исправлений , а подробные сведения о разработке Android см. в остальной части этого сайта.

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

Обычно после тестирования и после проверки и утверждения вы отправляете свои изменения в Gerrit и объединяете их с репозиторием.

Вместо этого, для целей этой кодовой лаборатории, верните свой список изменений, щелкнув « Отказаться » в Gerrit.

Затем откажитесь от связанной временной ветки в каталоге frameworks/native проекта (или его подкаталогах):

repo abandon codelab .

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

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

На этом все готово! Хорошо сделано!

Получить помощь

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