Android Studio for Platform (ASfP) – это рекомендуемая интегрированная среда разработки (IDE) для создания программно-определяемых автомобилей (SDV) на базе Android Automotive OS (AAOS). ASfP поддерживает все языки, которые используются на платформе AAOS SDV, включая Rust для пакетов сервисов SDV.
На этой странице описана только настройка SDV. Дополнительную информацию об общих функциях и рабочих процессах ASfP можно найти в статье Android Studio for Platform.
ASfP работает только на 64-разрядных системах Linux с процессорами x86-64. Вы можете использовать его на локальной рабочей станции Linux или в облаке. Подробнее о настройке облака…
Установка ASfP
По умолчанию максимальный размер кучи в ASfP составляет 30 ГБ. Индексирование платформы требует большого объема памяти, особенно если на том же компьютере запущено несколько виртуальных устройств Cuttlefish. Ограничьте область проекта каталогами, с которыми вы работаете, и при необходимости измените максимальный размер кучи в настройках памяти ASfP.
ASfP поддерживает автоматические обновления в IDE. Подробнее о том, как обновить Android Studio для платформы… Подробнее о том, как скачать и установить Android Studio for Platform и проверить системные требования…
Создайте проект SDV
Прежде чем начать, инициализируйте, синхронизируйте и соберите проект AAOS SDV. Дополнительную информацию о настройке оформления покупки можно найти в разделах Расположение кода и Скачивание, сборка и запуск.
Чтобы создать проект SDV, выполните следующие действия:
- Создайте новый проект в ASfP и выберите корневой каталог извлечения AAOS SDV в качестве извлечения репозитория. Подробнее о создании и импорте проектов…
- После того как ASfP создаст проект, выберите ASfP > Project (Проект) > Open Config (Открыть конфигурацию), чтобы открыть файл
.asfp-project. Замените содержимое файла следующим примером, а затем укажите в
repoпуть к странице оплаты:repo: /path/to/sdv_source lunch: sdv_core_cf-aosp_current-userdebug directories: include: - system/software_defined_vehicle/samples other_languages: - rustОбновите данные (
lunch,directories) для области, в которой вы работаете. Чтобы индексирование и синхронизация выполнялись быстрее, включайте только те каталоги, которые вы активно изменяете. В таблице ниже перечислены распространенные цели и каталоги SDV.SDV development focus lunchцельРекомендуем – directoriesПакеты сервисов SDV sdv_core_cf-aosp_current-userdebugКаталог сервисов и каталог пакетов, например system/software_defined_vehicle/samples.Интеграция с платформой SDV Core sdv_core_cf-aosp_current-userdebugsystem/software_defined_vehicle/middleware,system/software_defined_vehicle/automotive_services,device/google/sdvШлюз SDV в информационно-развлекательной системе SDV sdv_ivi_cf-aosp_current-userdebugsystem/software_defined_vehicle/sdv_gateway,system/software_defined_vehicle/samples/sdv_gateway,packages/services/CarБезопасность при показе медиаконтента на SDV sdv_media_har_cf-aosp_current-userdebugpackages/services/display_safety,device/google/sdv_display_safetyБезопасность дисплея в информационно-развлекательной системе программно-определяемого автомобиля sdv_ivi_cf_ds-aosp_current-userdebugpackages/apps/Car/DriverUI,packages/services/display_safety/serviceЕсли при оформлении заказа используется манифест
trunk_staging, замените-aosp_current-userdebugна-trunk_staging-userdebug. Чтобы просматривать код нативной платформы, добавьтеcppвother_languages. Дополнительную информацию обо всех параметрах конфигурации можно найти в статье Параметры конфигурации.Чтобы применить изменения, выберите ASfP > Sync (Синхронизация) > Sync Project (Синхронизировать проект). Подробнее о режимах синхронизации (полная, частичная и без сборки), а также об экспорте и импорте шаблонов
.asfp-projectдля команды рассказывается в статьях Режимы синхронизации и окно инструмента Soong и Общие шаблоны проектов (экспорт и импорт).
Развертывание пакетов сервисов SDV
В ASfP входит плагин SDV, который развертывает APEX с пакетами сервисов непосредственно на работающем устройстве SDV. По умолчанию плагин отключен. Чтобы использовать его, включите плагин SDV в разделе Настройки > Плагины. Подробнее об упаковке APEX см. в разделе Создание и развертывание пакетов сервисов.
Способ развертывания зависит от того, есть ли уже APEX на устройстве:
- Если APEX уже установлено, вы можете развернуть изменения прямо из ASfP.
- Если APEX-файл новый, сначала пересоберите и перезапустите образ системы или используйте образ системы, который включает ключ, использованный для подписания APEX-файла. После этого вы сможете развернуть его из ASfP.
Чтобы развернуть пакет сервисов APEX, выполните следующие действия:
- Запустите устройство SDV с плагином Cuttlefish. Подробнее о том, как запускать устройства SDV на Cuttlefish…
- Откройте файл
apex/Android.bpпакета сервисов и нажмите на значок Run (Запустить) на полях рядом с блокомapex {. - В открывшемся меню выберите Run 'Deploy APEX_NAME' (Запустить "Развернуть "). В этом же меню можно собрать APEX без развертывания или изменить конфигурацию запуска.
Как запускать устройства SDV на Cuttlefish
В ASfP входит плагин Cuttlefish, который создает и запускает локальные устройства Cuttlefish. Для работы плагина требуется оркестратор хоста Cuttlefish. Если хост-оркестратор недоступен, ASfP покажет инструкции по его настройке.
Чтобы создать устройство SDV, выполните следующие действия:
- Выберите Tools (Инструменты) > Device Manager (Диспетчер устройств), нажмите + и выберите Create Cuttlefish Device (Создать устройство Cuttlefish).
- Чтобы создать конфигурацию с несколькими виртуальными машинами, выберите From canonical configuration (Из канонической конфигурации) и создайте или импортируйте конфигурацию, например SDV Core с SDV IVI или SDV Media с SDV IVI для Display Safety. Чтобы создать одну ВМ, выберите From local Android source tree checkout (Из локального дерева исходного кода Android).
Чтобы посмотреть все экраны ВМ на одном экране и получить доступ к дополнительным параметрам устройства, используйте окно инструмента Cuttlefish. Чтобы открыть его, нажмите на значок … на боковой панели и выберите Cuttlefish или найдите Cuttlefish в разделе Help (Справка) > Find Action (Найти действие). Вы также можете просматривать отдельные экраны в окне Активные устройства. Поскольку SDV Core работает без дисплея, используйте Logcat и терминал для проверки.
Отладка и тестирование
В ASfP есть встроенный отладчик LLDB для кода на C++ и Rust. Дополнительную информацию об отладке и тестировании в ASfP можно найти в статьях Отладка кода платформы, Отладка кода Rust, Тестирование кода платформы с помощью atest и Отладка целей cc_test и rust_test в LLDB.
При подключении отладчика к пакету служб подключитесь к процессу, в котором он размещен. Названия процессов указываются в формате <bundle_name>:<instance_name>, например OrchestratorSampleRustServiceBundle:sample-main-no-conditions. Следующая команда выводит список соответствующих процессов и их идентификаторов:
adb shell ps -A | grep <bundle_name>
Дополнительную информацию о рабочих процессах отладки SDV, например о подключении к нескольким устройствам и просмотре журналов, можно найти в статье Отладка SDV.
Редактирование файлов VSIDL
В ASfP входит языковой сервер VSIDL (vsidl-lsp). Чтобы узнать, как настроить каталог для языкового сервера, прочитайте статью Автоматическое обновление каталога и интеграция LSP. Если в каталоге есть файл CATALOG_UPDATE, то в редакторе для файлов .vsidl доступны следующие функции:
- Проверка в реальном времени. Редактор выделяет ключевые слова VSIDL и показывает синтаксические ошибки, неразрешенные типы и ошибки проверки VSIDLC в окне Проблемы. Дополнительную информацию о правилах проверки и кодах ошибок можно найти в спецификации языка VSIDL.
- Автозаполнение и документация. Нажмите Ctrl + Пробел, чтобы увидеть подсказки по ключевым словам, сообщениям, сервисам, темам и каналам, или Ctrl + Q, чтобы посмотреть комментарии к документации.
- Навигация и форматирование. Чтобы перейти к определениям
.vsidlили.proto, нажмите Ctrl + B. Чтобы найти ссылки, нажмите Alt + Shift + F7. Чтобы посмотреть структуру файла, нажмите Ctrl + F12. Чтобы отформатировать файл, нажмите Ctrl + Alt + L.
Добавление контекста SDV для ИИ-помощников
ASfP включает ИИ в Android Studio и встроенного агента со сборкой Soong и инструментами atest. Поскольку файлы AGENTS.md хранятся вместе с исходным кодом в системе управления версиями, вы можете использовать одни и те же правила SDV как для встроенного агента ASfP, так и для агентов программирования на основе командной строки или контейнеров, которые считывают AGENTS.md. Когда вы отправляете запрос, открыв файл в ASfP, агент загружает файлы AGENTS.md из каталога этого файла и его родительских каталогов (если только файл GEMINI.md в том же каталоге не имеет приоритета). Вы можете проверить активные файлы на панели чата в разделе Контекст в разделе Файлы AGENTS.md. Дополнительную информацию вы найдете в статьях Знакомство с Android Studio for Platform и Настройка агента с помощью файлов AGENTS.md.
Шаблоны ниже можно использовать в качестве отправной точки для рабочих процессов, описанных в разделе Создание проекта SDV.
Пакеты сервисов SDV
Поместите файл AGENTS.md в каталог пакета, указанный в .asfp-project, в котором находятся папки catalog/, services/ и apex/. Дополнительную информацию можно найти в статьях Генерация промежуточного ПО, Сборка и развертывание пакетов сервисов, Создание файла сопоставления SOME/IP и Обзор авторизации связи SDV.
# AAOS SDV service bundle and VSIDL rules
## Build and test
- Initialize the build environment (`source build/envsetup.sh` and
`lunch sdv_core_cf-aosp_current-userdebug`) when running outside ASfP, build
modules with Soong (`m <module_name>`), and run tests with
`atest <TestModuleName>` (`rust_test`, `rust_test_host`, `cc_test`, or
`python_test_host`), without creating `Cargo.toml` files or running `cargo`
- In catalog `Android.bp` files, avoid `defaults` on `rust_protobuf` modules
(`vsidlc` uses a regex parser), include each `.proto` file in at most one
`rust_protobuf` target, and cover all catalog files in the first `filegroup`
(`srcs: ["**/*"]`)
## Protobuf, VSIDL, and AUTOSAR SOME/IP mapping conventions
- Keep `.proto` files limited to `message`, `enum`, and RPC `service` schemas
(using `sdv/vsidl/v1/annotations.proto` only for field size bounds), without
topic names, channel names, or queue capacities
- Write `.vsidl` files in TextProto `VsidlEntry` syntax (`package: "..."`,
`service_bundle { name: "..." }`, `publisher` or `subscriber` with `message`
and `topic`, and `server` or `client` with `service` and `channel`, without
`import` statements; RPCs support unary, client-streaming, and
server-streaming methods, not bidirectional streaming), and isolate
`some_ip_mapping` (`sdv_type_mapping` and `someip_service_mapping` for
AUTOSAR electronic control unit (ECU) `ARXML` or `vsomeip` IDs) or
`vhal_mapping` rules in dedicated `.vsidl` mapping files so core bundles stay
transport-independent
- Use `PascalCase` for `service_bundle` names (avoiding Rust, C++, and Java
keywords), `snake_case` for `build_cfg.target_name`, a globally unique
lowercase `package` with at least four segments (`com.<org>.sdv.<domain>`;
never reuse platform-reserved `com.android.sdv.*` or sample `com.sdv.*`
names), and lowercase dash-case starting with a letter (no consecutive or
trailing hyphens, underscores, or slashes) for `topic`, `channel`, and
instance names
- Set `capacity` on every `publisher` to an even integer greater than or equal
to 2, and pair every `subscriber` and RPC `client` with a matching
`publisher` or `server` in the catalog or its `-d` dependency catalogs
## Code generation, authorization, and APEX packaging
- Export `ANDROID_BUILD_TOP`, check `CATALOG_UPDATE` for catalog-relative
`output_path` (such as `".."`), `dependency_catalog_paths` (`-d`), and
`vsidlc_gen_args`, and run `vsidlc -c <catalog_dir> -o <output_dir>`; omit
`--services` from `vsidlc_gen_args` and avoid `-p` (`--purge`) or
`regenerator` when `output_path` holds handwritten `services/` code
- Leave generated files in `generated_rs/`, `apex/`, and `configs/` unmodified,
and implement Rust logic in `services/<ServiceBundleName>/src/main.rs` (even
though the initial `vsidlc --services` skeleton header says not to edit; C++
bundles do not use `vsidlc` C++ codegen and instead use
`libsdv_lifecycle_client_cpp`, `libsdv_comms_cpp`, and
`sdv_service_bundle_metadata` with `native_library_path: "lib64/lib<so>.so"`
in `sdv_service_bundles_manifest.textproto`)
- Keep communications authorization `.textproto` policies in `configs/` aligned
with every `publisher`, `subscriber`, `server`, and `client` unit (omitting
`capacity` inside manual authorization `.textproto` `publisher` entries) so
Service Discovery does not reject endpoints at runtime
- In Rust bundles, wait for publisher or RPC server availability before
creating subscribers or clients, stop active tasks in `on_stop`, and run
blocking work in `tokio::spawn_blocking`
- Generate Rust service bundle APEXes with `vsidlc --apex` (`updatable: true`,
`min_sdk_version: "35"`, and `product_specific: true` in `apex/Android.bp`,
never `vendor: true` or `soc_specific: true`, with matching unique `name` and
`version` >= 1 in `apex_manifest.json`), and do not set
`supportsRebootlessUpdate: true` or run `adb install --force-non-staged`
because SDV APEX updates require a reboot
Шлюз SDV на SDV IVI
Поместите этот файл AGENTS.md в каталог модуля клиента IVI или system/software_defined_vehicle/sdv_gateway/. Подробнее о том, как использовать шлюз SDV в IVI…
# AAOS SDV Gateway on SDV IVI rules
- Initialize the build environment (`source build/envsetup.sh` and
`lunch sdv_ivi_cf-aosp_current-userdebug`) when running outside ASfP, build
IVI modules with Soong (`m <module_name>`), and run verification with
`atest <TestModuleName>`
- For native C or C++ IVI clients (including vehicle hardware abstraction layer
(VHAL) integrations), link `libsdvgatewayclient`
(`#include "libsdvgatewayclient.h"`) or `ISdvGateway`; for in-tree system Java
or Kotlin clients, use `libsdvgatewayclient-java`,
`libsdvgatewayclient-java-sdk.stubs`, `libsdvgatewayclient-java-sdk`, and
`com.android.sdv.gateway.client`
- Start the Binder thread pool before calling `ASDVGateway_Client_new`, and
call `ASDVGateway_Client_initComms` (or `SdvGatewayClient.initComms`) before
any service discovery, data tunnel, or RPC calls
- Check `ASDVGateway_Client_isRpcAvailable` or
`ASDVGateway_Client_isProcessBoundToSdvRpcNetworkInterface` before opening
RPC sockets on early boot, treat `ASDVGateway_StatusCode_OK` with null
`ASDVGateway_RpcCredentials_t` as insecure `UNLOCKED` boot mode, and free
non-null credentials with `ASDVGateway_Client_deleteRpcCredentials`
- Grant `sdv_gateway_client_domain(<domain>)` in SELinux (do not add
`binder_use` on `/vendor` daemons, which violates Treble `neverallow`; add
`group inet` on native init services, and `INTERNET` plus
`CONNECTIVITY_USE_RESTRICTED_NETWORKS` privapp permissions for system Java
RPC clients)
Безопасность дисплея
Поместите файл AGENTS.md в каталог packages/services/display_safety/ или каталог приложения приборной панели. Дополнительную информацию можно найти в статьях Начало работы с Display Safety, Уровень абстракции платформы HAR, Набор инструментов для проектирования безопасности и DriverUI.
# AAOS Display Safety partner integration rules
- Display Safety spans two guest VMs with separate `lunch` targets: keep
safety-critical telltales, gauges, camera views, chimes, and early-boot or
fallback placeholders in the Rust high availability renderer (HAR) and safety
monitor on SDV Media (`sdv_media_har_cf`), and build non-safety cluster UI on
SDV IVI (`sdv_ivi_cf_ds`) using `ClusterHomeManager` (`Cluster2` rather than
legacy `Cluster1`)
- Implement target OS and hardware subsystems (display, graphics, exterior view
system (EVS) cameras, audio, user input, and vehicle signals) in a dedicated
`har-platform-<target>` platform abstraction layer (PAL) crate implementing
`har-platform-api` traits rather than modifying core `harry` framework crates,
and verify PAL crates against the HAR platform test suite with `atest`
- Generate safety monitor configurations and telltale inspection artifacts from
the serialized Automotive Design for Compose document and safety JSON mapping
(`{"documents": [{"rootnode": "#...", "display_id": 1, "document_id": "...",`
`"states": {"<signal>": "#<node_id>"}}]}`) using the safety design compiler
rather than hardcoding telltale pixel coordinates
- Because the HAR display plane composites above Android IVI, ensure HAR clears
the cluster viewport region to `alpha = 0.0` while valid `HeartbeatRequest`
gRPC messages arrive from IVI, and set opaque pixels in custom HAR OpenGL ES
surfaces to `alpha = 1.0` (`0xFF`)
- Initialize the build environment (`source build/envsetup.sh` and `lunch`) when
running outside ASfP, integrate prebuilt cluster APKs into `sdv_ivi_cf_ds`
through `DriverUIPrebuilt` (`overrides: ["DriverUIStubApp"]`), launch dual-VM
Cuttlefish setups from ASfP or with `ds_toolkit launch`, pass `--user 0` to
`adb shell am` cluster commands, and note that
`adb shell dumpsys SurfaceFlinger` on SDV IVI inspects only Android layers
rather than the overlying HAR plane