Как настроить IDE для разработки SDV

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, выполните следующие действия:

  1. Создайте новый проект в ASfP и выберите корневой каталог извлечения AAOS SDV в качестве извлечения репозитория. Подробнее о создании и импорте проектов…
  2. После того как ASfP создаст проект, выберите ASfP > Project (Проект) > Open Config (Открыть конфигурацию), чтобы открыть файл .asfp-project.
  3. Замените содержимое файла следующим примером, а затем укажите в repo путь к странице оплаты:

    repo: /path/to/sdv_source
    lunch: sdv_core_cf-aosp_current-userdebug
    directories:
      include:
        -   system/software_defined_vehicle/samples
    other_languages:
      -   rust
    
  4. Обновите данные (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-userdebug system/software_defined_vehicle/middleware, system/software_defined_vehicle/automotive_services, device/google/sdv
    Шлюз SDV в информационно-развлекательной системе SDV sdv_ivi_cf-aosp_current-userdebug system/software_defined_vehicle/sdv_gateway, system/software_defined_vehicle/samples/sdv_gateway, packages/services/Car
    Безопасность при показе медиаконтента на SDV sdv_media_har_cf-aosp_current-userdebug packages/services/display_safety, device/google/sdv_display_safety
    Безопасность дисплея в информационно-развлекательной системе программно-определяемого автомобиля sdv_ivi_cf_ds-aosp_current-userdebug packages/apps/Car/DriverUI, packages/services/display_safety/service

    Если при оформлении заказа используется манифест trunk_staging, замените -aosp_current-userdebug на -trunk_staging-userdebug. Чтобы просматривать код нативной платформы, добавьте cpp в other_languages. Дополнительную информацию обо всех параметрах конфигурации можно найти в статье Параметры конфигурации.

  5. Чтобы применить изменения, выберите ASfP > Sync (Синхронизация) > Sync Project (Синхронизировать проект). Подробнее о режимах синхронизации (полная, частичная и без сборки), а также об экспорте и импорте шаблонов .asfp-project для команды рассказывается в статьях Режимы синхронизации и окно инструмента Soong и Общие шаблоны проектов (экспорт и импорт).

Развертывание пакетов сервисов SDV

В ASfP входит плагин SDV, который развертывает APEX с пакетами сервисов непосредственно на работающем устройстве SDV. По умолчанию плагин отключен. Чтобы использовать его, включите плагин SDV в разделе Настройки > Плагины. Подробнее об упаковке APEX см. в разделе Создание и развертывание пакетов сервисов.

Способ развертывания зависит от того, есть ли уже APEX на устройстве:

  • Если APEX уже установлено, вы можете развернуть изменения прямо из ASfP.
  • Если APEX-файл новый, сначала пересоберите и перезапустите образ системы или используйте образ системы, который включает ключ, использованный для подписания APEX-файла. После этого вы сможете развернуть его из ASfP.

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

  1. Запустите устройство SDV с плагином Cuttlefish. Подробнее о том, как запускать устройства SDV на Cuttlefish…
  2. Откройте файл apex/Android.bp пакета сервисов и нажмите на значок Run (Запустить) на полях рядом с блоком apex {.
  3. В открывшемся меню выберите Run 'Deploy APEX_NAME' (Запустить "Развернуть "). В этом же меню можно собрать APEX без развертывания или изменить конфигурацию запуска.

Как запускать устройства SDV на Cuttlefish

В ASfP входит плагин Cuttlefish, который создает и запускает локальные устройства Cuttlefish. Для работы плагина требуется оркестратор хоста Cuttlefish. Если хост-оркестратор недоступен, ASfP покажет инструкции по его настройке.

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

  1. Выберите Tools (Инструменты) > Device Manager (Диспетчер устройств), нажмите + и выберите Create Cuttlefish Device (Создать устройство Cuttlefish).
  2. Чтобы создать конфигурацию с несколькими виртуальными машинами, выберите 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