Android Studio for Platform (ASfP) помогает настроить среду разработки для Android Open Source Project (AOSP). ASfP, созданный на основе модели рабочей области IntelliJ, поддерживает как ручную настройку, так и шаблоны, которыми можно делиться с командой.
Как запустить мастер настройки проекта
Запустить мастер настройки проекта можно двумя способами:
- На экране приветствия нажмите New Project (Новый проект) или Import ASfP Project (Импортировать проект ASfP).
- В открытом проекте: в главном меню выберите ASfP > Project (Проект) > New Project (Новый проект) или Import ASfP Project (Импортировать проект ASfP).
Как импортировать данные из шаблона
Если у вашей команды есть стандартный файл конфигурации .asfp-project, вы можете инициализировать рабочую область непосредственно из этого шаблона:
- В мастере настройки проекта выберите Импортировать из шаблона.
- Найдите и выберите общий файл YAML
.asfp-projectили.asfp-template. - После того как мастер заполнит настройки проекта на основе шаблона, проверьте локальный путь Repo checkout и нажмите Finish (Готово).
Настройка вручную
Чтобы создать конфигурацию проекта с нуля, выполните следующие действия:
В мастере настройки проекта выберите вариант настройки вручную и заполните сведения о проекте:
- Repo checkout (пути к модулям) – укажите абсолютный путь к корневому каталогу локальной копии исходного кода AOSP (например,
/path/to/aosp). - Целевое значение обеда. Укажите целевое значение обеда, которое вы используете для здания (например,
aosp_cf_x86_64_phone-aosp_current-userdebug). - Название проекта. Укажите информативное название проекта.
- Каталоги и модули. Укажите начальные каталоги или модули Soong, которые нужно включить в проект (относительно корневого каталога репозитория, например
frameworks/baseилиpackages/apps/Settings). - Языки. Если ваш рабочий процесс включает код платформы C, C++ или Rust, выберите C или C++ или Rust. По умолчанию включены Java, Kotlin и
Android.bp. - Переменные среды и параметры сборки. В поле Переменные среды добавьте любые пользовательские переменные среды, например
SOONG_ALLOW_MISSING_DEPENDENCIES=true. При необходимости установите флажок Частичная компиляция Soong (SOONG_PARTIAL_COMPILE), чтобы ускорить сборку.
- Repo checkout (пути к модулям) – укажите абсолютный путь к корневому каталогу локальной копии исходного кода AOSP (например,
Нажмите Готово. ASfP создаст структуру проекта, сгенерирует файл конфигурации
.asfp-projectв корневом каталоге проекта и выполнит начальную синхронизацию.
Как поделиться конфигурацией проекта или настроить ее
После первоначальной настройки вы можете в любое время изменить проект, отредактировав файл
.asfp-project (ASfP > Project > Open Config (ASfP > Проект > Открыть конфигурацию)):
- Добавлять или исключать каталоги и модули Soong.
- Включите дополнительные языки (
cpp,rust). - Настройте специальные флаги Soong и переменные среды.
Чтобы экспортировать конфигурацию для коллег, нажмите правой кнопкой мыши на вкладку .asfp-project и выберите Экспортировать в шаблон.
.asfp-projectAndroid.bpПодробнее о проектах и рабочих процессах Soong…