SDV geliştirme için IDE ayarlama

Android Studio for Platform (ASfP), Android Automotive OS (AAOS) Yazılım Tanımlı Araç (SDV) platformu geliştirme için önerilen entegre geliştirme ortamıdır (IDE). ASfP, SDV hizmet paketleri için Rust da dahil olmak üzere AAOS SDV platformunun kullandığı tüm dilleri destekler.

Bu sayfada yalnızca SDV'ye özel kurulum ele alınmaktadır. Genel ASfP özellikleri ve iş akışları hakkında daha fazla bilgi için Android Studio for Platform sayfasını inceleyin.

ASfP yalnızca x86-64 CPU'lara sahip 64 bit Linux'ta çalışır. Yerel bir Linux iş istasyonunda veya bulutta kullanabilirsiniz. Bulut kurulumu hakkında daha fazla bilgi için Bulut geliştirme başlıklı makaleyi inceleyin.

ASfP'yi yükleme

ASfP, varsayılan olarak maksimum 30 GB yığın boyutuna sahiptir. Platformun tamamını dizine eklemek, özellikle aynı makinede birden fazla sanal makineye sahip Cuttlefish cihazları da çalıştırıyorsanız çok fazla bellek kullanır. Projenizin kapsamını üzerinde çalıştığınız dizinlerle sınırlı tutun ve gerekirse ASfP bellek ayarlarında maksimum yığın boyutunu ayarlayın.

ASfP, IDE içi otomatik güncellemeleri destekler. Daha fazla bilgi için Platform için Android Studio'yu güncelleme başlıklı makaleyi inceleyin. ASfP'yi indirme ve yükleme, sistem gereksinimlerini kontrol etme hakkında daha fazla bilgi için Android Studio for Platform'u yükleme başlıklı makaleyi inceleyin.

SDV projesi oluşturma

Başlamadan önce AAOS SDV ödeme sayfanızı ilk kullanıma hazırlayın, senkronize edin ve derleyin. Ödeme sayfanızı ayarlama hakkında daha fazla bilgi için Kod konumu ve İndirme, derleme ve çalıştırma bölümlerine bakın.

SDV projesi oluşturmak için aşağıdaki adımları uygulayın:

  1. ASfP'de yeni bir proje oluşturun ve depo çıkışı olarak AAOS SDV çıkışınızın kökünü seçin. Sihirbaz adımları hakkında daha fazla bilgi için Proje oluşturma veya içe aktarma başlıklı makaleyi inceleyin.
  2. ASfP projeyi oluşturduktan sonra ASfP > Project > Open Config'i (ASfP > Proje > Yapılandırmayı Aç) seçerek .asfp-project dosyasını açın.
  3. Dosyanın içeriğini aşağıdaki örnekle değiştirin ve ardından repo değerini ödeme sayfanızın yolu olarak ayarlayın:

    repo: /path/to/sdv_source
    lunch: sdv_core_cf-aosp_current-userdebug
    directories:
      include:
        -   system/software_defined_vehicle/samples
    other_languages:
      -   rust
    
  4. Çalıştığınız alan için lunch ve directories değerlerini güncelleyin. Dizine ekleme ve senkronizasyonun hızlı olması için yalnızca aktif olarak değiştirdiğiniz dizinleri dahil edin. Aşağıdaki tabloda, yaygın SDV hedefleri ve dizinleri listelenmiştir:

    SDV geliştirme odağı lunch hedef Önerilenler directories
    SDV hizmet paketleri sdv_core_cf-aosp_current-userdebug Hizmet kataloğunuz ve paket dizininiz (ör. system/software_defined_vehicle/samples)
    SDV Core platform entegrasyonu sdv_core_cf-aosp_current-userdebug system/software_defined_vehicle/middleware, system/software_defined_vehicle/automotive_services, device/google/sdv
    SDV IVI'da SDV Gateway sdv_ivi_cf-aosp_current-userdebug system/software_defined_vehicle/sdv_gateway, system/software_defined_vehicle/samples/sdv_gateway, packages/services/Car
    SDV Media'da ekran güvenliği sdv_media_har_cf-aosp_current-userdebug packages/services/display_safety, device/google/sdv_display_safety
    SDV IVI'da Ekran Güvenliği sdv_ivi_cf_ds-aosp_current-userdebug packages/apps/Car/DriverUI, packages/services/display_safety/service

    Ödeme sayfanızda trunk_staging manifesti kullanılıyorsa -aosp_current-userdebug değerini -trunk_staging-userdebug ile değiştirin. Yerel platform koduna da göz atmak için other_languages dosyasına cpp ekleyin. Tüm yapılandırma seçenekleri hakkında daha fazla bilgi için Yapılandırma parametreleri başlıklı makaleyi inceleyin.

  5. Değişikliklerinizi uygulamak için ASfP > Sync > Sync Project'i (ASfP > Senkronize et > Projeyi senkronize et) seçin. Senkronizasyon modları (Tam Senkronizasyon, Kısmi Senkronizasyon ve Derlemesiz Senkronizasyon) ve ekibiniz için paylaşılabilir .asfp-project şablonlarını dışa veya içe aktarma hakkında daha fazla bilgi edinmek için Senkronizasyon modları ve Soong araç penceresi ve Paylaşılabilir proje şablonları (dışa ve içe aktarma) başlıklı makaleleri inceleyin.

SDV hizmet paketlerini dağıtma

ASfP, hizmet paketlerinizi içeren bir APEX'i doğrudan çalışan bir SDV cihazına dağıtan bir SDV eklentisi içerir. Eklenti varsayılan olarak devre dışıdır. Kullanmak için Ayarlar > Eklentiler bölümünde SDV eklentisini etkinleştirin. APEX paketleme hakkında daha fazla bilgi için Hizmet paketleri oluşturma ve dağıtma başlıklı makaleyi inceleyin.

Dağıtım şekliniz, APEX'in cihazda zaten mevcut olup olmadığına bağlıdır:

  • APEX zaten yüklüyse değişikliklerinizi doğrudan ASfP'den dağıtabilirsiniz.
  • APEX yeniyse önce sistem görüntüsünü yeniden oluşturup yeniden başlatmanız veya APEX'i imzalamak için kullanılan anahtarı içeren bir sistem görüntüsü kullanmanız gerekir. Ardından ASfP'den dağıtım yapabilirsiniz.

Hizmet paketi APEX'i dağıtmak için aşağıdaki adımları uygulayın:

  1. Cuttlefish eklentisiyle SDV cihazınızı başlatın. Daha fazla bilgi için Cuttlefish'te SDV cihazlarını çalıştırma başlıklı makaleyi inceleyin.
  2. Hizmet paketinizin apex/Android.bp dosyasını açın ve apex { bloğunun yanındaki sütun aralığında bulunan Çalıştır simgesini tıklayın.
  3. Açılan menüde Run 'Deploy APEX_NAME' ('' dağıtımını çalıştır) seçeneğini belirleyin. Aynı menüden APEX'i dağıtmadan derleyebilir veya çalıştırma yapılandırmasını değiştirebilirsiniz.

Cuttlefish'te SDV cihazlarını çalıştırma

ASfP, yerel Cuttlefish cihazları oluşturup çalıştıran bir Cuttlefish eklentisi içerir. Eklenti için Cuttlefish ana makine düzenleyicisi gerekir. Ana makine düzenleyici kullanılamıyorsa ASfP, kurulum talimatlarını gösterir.

SDV cihazı oluşturmak için aşağıdaki adımları uygulayın:

  1. Tools > Device Manager'ı (Araçlar > Cihaz Yönetim Paneli) seçin, + simgesini tıklayın ve Create Cuttlefish Device'ı (Cuttlefish Cihazı Oluştur) seçin.
  2. Çoklu sanal makine kurulumu oluşturmak için Standart yapılandırmadan'ı seçin ve kurulumunuz için bir yapılandırma oluşturun veya içe aktarın (ör. SDV IVI ile SDV Core veya Display Safety için SDV IVI ile SDV Media). Tek bir sanal makine oluşturmak için Yerel Android kaynak ağacı kontrolünden'i seçin.

Tüm sanal makine ekranlarını tek bir ekranda görüntülemek ve ek cihaz seçeneklerine erişmek için Cuttlefish araç penceresini kullanın. Açmak için yan paneldeki ... simgesini seçip Cuttlefish'i seçin veya Yardım > İşlem Bul bölümünde Cuttlefish'i arayın. Ekranları Çalışan Cihazlar'da tek tek de görüntüleyebilirsiniz. SDV Core, ekran olmadan çalıştığı için incelemek üzere Logcat ve Terminal'i kullanın.

Hata ayıklama ve test etme

ASfP, C++ ve Rust kodu için yerleşik bir LLDB hata ayıklayıcı içerir. ASfP'de hata ayıklama ve test etme hakkında daha fazla bilgi için Platform kodunda hata ayıklama, Rust kodunda hata ayıklama, Atest ile platform kodunu test etme ve LLDB altında cc_test ve rust_test hedeflerinde hata ayıklama başlıklı makaleleri inceleyin.

Hata ayıklayıcıyı bir hizmet paketine eklediğinizde, paketi barındıran işleme ekleyin. İşlem adları <bundle_name>:<instance_name> biçimini kullanır (ör. OrchestratorSampleRustServiceBundle:sample-main-no-conditions). Aşağıdaki komut, eşleşen işlemleri ve işlem kimliklerini listeler:

adb shell ps -A | grep <bundle_name>

Birden fazla cihaza bağlanma ve günlükleri görüntüleme gibi SDV hata ayıklama iş akışları hakkında daha fazla bilgi için SDV'de hata ayıklama başlıklı makaleyi inceleyin.

VSIDL dosyalarını düzenleme

ASfP, VSIDL Dil Sunucusu'nu (vsidl-lsp) içerir. Kataloğunuzu dil sunucusu için nasıl ayarlayacağınız hakkında daha fazla bilgi edinmek için Otomatik katalog güncellemeleri ve LSP entegrasyonu başlıklı makaleyi inceleyin. Kataloğunuzda bir CATALOG_UPDATE dosyası varsa düzenleyici, .vsidl dosyaları için aşağıdaki özellikleri sağlar:

  • Canlı doğrulama: Düzenleyici, VSIDL anahtar kelimelerini vurgular ve Sorunlar penceresinde söz dizimi hatalarını, çözümlenmemiş türleri ve VSIDLC doğrulama hatalarını gösterir. Doğrulama kuralları ve hata kodları hakkında daha fazla bilgi için VSIDL dil spesifikasyonuna bakın.
  • Otomatik tamamlama ve dokümanlar: Anahtar kelime, mesaj, hizmet, konu ve kanal önerileri için Ctrl+Boşluk tuşlarına, doküman yorumlarını görüntülemek için Ctrl+Q tuşlarına basabilirsiniz.
  • Gezinme ve biçimlendirme: .vsidl veya .proto tanımlarına gitmek için Ctrl+B, referansları bulmak için Alt+Üst Karakter+F7, dosya yapısını görüntülemek için Ctrl+F12 ve dosyayı biçimlendirmek için Ctrl+Alt+L tuşlarına basabilirsiniz.

Yapay zeka asistanları için SDV bağlamı ekleme

ASfP, Android Studio'da yapay zeka ve Soong derleme ve atest araçlarıyla yerleşik bir temsilci içerir. AGENTS.md dosyaları, sürüm denetiminde kaynak kodunuzla birlikte yer aldığından aynı SDV kurallarını ASfP'nin yerleşik temsilcisi ve AGENTS.md dosyasını okuyan komut satırı veya container tabanlı kodlama temsilcileri arasında paylaşabilirsiniz. ASfP'de bir dosya açıkken istem gönderdiğinizde temsilci, o dosyanın dizininden ve üst dizinlerinden AGENTS.md dosyalarını yükler (aynı dizindeki bir GEMINI.md dosyası öncelikli değilse). Etkin dosyaları, sohbet panelinin Bağlam çekmecesindeki AGENTS.md Dosyaları bölümünden doğrulayabilirsiniz. Daha fazla bilgi için Platform için Android Studio ile tanışın ve AGENTS.md dosyalarını kullanarak temsilciyi özelleştirme başlıklı makaleleri inceleyin.

Aşağıdaki şablonlar, SDV projesi oluşturma bölümündeki iş akışları için başlangıç noktaları sağlar.

SDV hizmet paketleri

Bu AGENTS.md dosyasını, catalog/, services/ ve apex/ klasörlerinizi içeren .asfp-project dizinine yerleştirin. Daha fazla bilgi için Ara katman yazılımı oluşturma, Hizmet paketleri oluşturma ve dağıtma, SOME/IP eşleme dosyası yazma ve SDV iletişim yetkilendirmesine genel bakış başlıklı makaleleri inceleyin.

# 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 IVI'da SDV Gateway

Bu AGENTS.md dosyasını IVI istemci modülü dizininize veya system/software_defined_vehicle/sdv_gateway/ dizinine yerleştirin. Daha fazla bilgi için IVI'da SDV Gateway'i kullanma başlıklı makaleyi inceleyin.

# 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)

Güvenlik

Bu AGENTS.md dosyasını packages/services/display_safety/ dizinine veya gösterge paneli uygulama dizininize yerleştirin. Daha fazla bilgi için Display Safety'yi kullanmaya başlama, HAR platform soyutlama katmanı, Güvenlik tasarımı araç zinciri ve DriverUI bölümlerine bakın.

# 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