SDV 개발용 IDE 설정

플랫폼용 Android 스튜디오 (ASfP)는 Android Automotive OS (AAOS) 소프트웨어 정의 차량 (SDV) 플랫폼 개발에 권장되는 통합 개발 환경 (IDE)입니다. ASfP는 SDV 서비스 번들의 Rust를 비롯하여 AAOS SDV 플랫폼에서 사용하는 모든 언어를 지원합니다.

이 페이지에서는 SDV 관련 설정만 다룹니다. 일반적인 ASfP 기능 및 워크플로에 관한 자세한 내용은 플랫폼용 Android 스튜디오를 참고하세요.

ASfP는 x86-64 CPU가 있는 64비트 Linux에서만 실행됩니다. 로컬 Linux 워크스테이션이나 클라우드에서 사용할 수 있습니다. 클라우드 설정에 대한 자세한 내용은 클라우드 개발을 참고하세요.

ASfP 설치

ASfP 다운로드 및 설치와 시스템 요구사항 확인에 관한 자세한 내용은 플랫폼용 Android 스튜디오 설치를 참고하세요.

플랫폼 체크아웃을 색인화하면 특히 동일한 머신에서 다중 VM Cuttlefish 기기를 실행하는 경우 메모리를 많이 사용합니다. ASfP가 느리게 실행되면 ASfP 메모리 설정에서 최대 힙 크기를 프로젝트와 머신에 맞게 늘리고 프로젝트 범위를 작업하는 디렉터리로 유지하세요.

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 개발 초점	목표 lunch개	권장 directories
   SDV 서비스 번들	sdv_core_cf-aosp_current-userdebug	서비스 카탈로그 및 번들 디렉터리(예: system/software_defined_vehicle/samples)
   SDV 핵심 플랫폼 통합	sdv_core_cf-aosp_current-userdebug	system/software_defined_vehicle/middleware, system/software_defined_vehicle/automotive_services, device/google/sdv
   SDV IVI의 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	device/google/sdv_display_safety packages/services/display_safety
   SDV IVI에 안전 표시	sdv_ivi_cf_ds-aosp_current-userdebug	packages/services/display_safety/service packages/apps/Car/DriverUI

   체크아웃에서 trunk_staging 매니페스트를 사용하는 경우 -aosp_current-userdebug을 -trunk_staging-userdebug로 바꿉니다. 네이티브 플랫폼 코드도 함께 탐색하려면 other_languages에 cpp를 추가하세요. 모든 구성 옵션에 관한 자세한 내용은 구성 매개변수를 참고하세요.

5. 변경사항을 적용하려면 File > Sync Project를 선택합니다.

SDV 서비스 번들 배포

ASfP에는 서비스 번들을 실행 중인 SDV 기기에 직접 배포하는 APEX를 배포하는 SDV 플러그인이 포함되어 있습니다. 플러그인은 기본적으로 사용 중지되어 있습니다. 이를 사용하려면 Settings > Plugins에서 SDV 플러그인을 사용 설정하세요. APEX 패키징에 관한 자세한 내용은 서비스 번들 빌드 및 배포를 참고하세요.

배포 방법은 APEX가 기기에 이미 있는지에 따라 다릅니다.

• APEX가 이미 설치된 경우 ASfP에서 직접 변경사항을 배포할 수 있습니다.
• APEX가 새로운 경우 먼저 시스템 이미지를 다시 빌드하고 다시 실행하거나 APEX에 서명하는 데 사용된 키가 포함된 시스템 이미지를 사용해야 합니다. 그런 다음 ASfP에서 배포할 수 있습니다.

서비스 번들 APEX를 배포하려면 다음 단계를 따르세요.

1. Cuttlefish 플러그인으로 SDV 기기를 시작합니다. 자세한 내용은 Cuttlefish에서 SDV 기기 실행을 참고하세요.
2. 서비스 번들의 apex/Android.bp 파일을 열고 apex { 블록 옆의 여백에 있는 실행 아이콘을 클릭합니다.
3. 열리는 메뉴에서 'Deploy APEX_NAME' 실행을 선택합니다. 배포하지 않고 APEX를 빌드하거나 동일한 메뉴에서 실행 구성을 변경할 수도 있습니다.

Cuttlefish에서 SDV 기기 실행

ASfP에는 로컬 Cuttlefish 기기를 만들고 실행하는 Cuttlefish 플러그인이 포함되어 있습니다. 플러그인에는 Cuttlefish 호스트 오케스트레이터가 필요합니다. 호스트 오케스트레이터를 사용할 수 없는 경우 ASfP에 설정 안내가 표시됩니다.

SDV 기기를 만들려면 다음 단계를 따르세요.

1. Tools > 기기 관리도구를 선택하고 +를 클릭한 후 Create Cuttlefish Device를 선택합니다.
2. 다중 VM 설정을 만들려면 표준 구성에서를 선택하고 SDV IVI가 있는 SDV 코어 또는 디스플레이 안전을 위한 SDV IVI가 있는 SDV 미디어와 같은 설정의 구성을 만들거나 가져옵니다. 단일 VM을 만들려면 대신 로컬 Android 소스 트리 체크아웃에서을 선택합니다.

단일 화면에서 모든 VM 디스플레이를 확인하고 추가 기기 옵션에 액세스하려면 Cuttlefish 도구 창을 사용하세요. 이를 열려면 측면 패널에서 … 아이콘을 선택하고 Cuttlefish를 선택하거나 도움말 > 작업 찾기에서 Cuttlefish를 검색합니다. 실행 중인 기기에서 개별 디스플레이를 볼 수도 있습니다. SDV 코어는 디스플레이 없이 실행되므로 Logcat과 터미널을 사용하여 검사합니다.

디버그 및 테스트

ASfP의 디버깅 및 테스트에 관한 자세한 내용은 플랫폼 코드 디버그 및 플랫폼 코드 테스트를 참고하세요. Rust 서비스 번들을 디버깅하도록 CodeLLDB를 설정하는 방법에 관한 자세한 내용은 Rust 디버깅을 참고하세요.

디버거를 서비스 번들에 연결할 때는 서비스를 호스팅하는 프로세스에 연결합니다. 프로세스 이름은 <bundle_name>:<instance_name> 형식(예: OrchestratorSampleRustServiceBundle:sample-main-no-conditions)을 사용합니다. 다음 명령어는 일치하는 프로세스와 해당 프로세스 ID를 나열합니다.

adb shell ps -A | grep <bundle_name>

여러 기기에 연결하고 로그를 보는 등 SDV 디버깅 워크플로에 관한 자세한 내용은 SDV 디버그를 참고하세요.

VSIDL 파일 수정

ASfP에는 VSIDL 언어 서버 (vsidl-lsp)가 포함됩니다. 언어 서버의 카탈로그를 설정하는 방법에 관한 자세한 내용은 자동 카탈로그 업데이트 및 LSP 통합을 참고하세요. 카탈로그에 CATALOG_UPDATE 파일이 포함된 경우 편집기에서 .vsidl 파일에 대해 다음 기능을 제공합니다.

• 실시간 유효성 검사: 편집기에서 VSIDL 키워드를 강조 표시하고 문제 창에 구문 오류, 해결되지 않은 유형, VSIDLC 유효성 검사 오류를 표시합니다. 검증 규칙 및 오류 코드에 대한 자세한 내용은 VSIDL 언어 사양을 참고하세요.
• 자동 완성 및 문서: Ctrl+스페이스바를 눌러 키워드, 메시지, 서비스, 주제, 채널 추천을 확인하고 Ctrl+Q를 눌러 문서 주석을 볼 수 있습니다.
• 탐색 및 서식 지정: Ctrl+B를 눌러 .vsidl 또는 .proto 정의로 이동하고, Alt+Shift+F7을 눌러 참조를 찾고, Ctrl+F12를 눌러 파일 구조를 확인하고, Ctrl+Alt+L을 눌러 파일 서식을 지정할 수 있습니다.

AI 어시스턴트용 SDV 컨텍스트 추가

ASfP에는 Android 스튜디오의 Gemini가 포함되어 있습니다. ASfP 기능에 관한 자세한 내용은 Android 스튜디오 for Platform 소개를 참고하세요. Gemini 또는 다른 AI 코딩 어시스턴트가 SDV 규칙을 따르도록 하려면 SDV 카탈로그의 루트에 AGENTS.md 파일을 추가하세요. 에이전트 파일에 관한 자세한 내용은 AGENTS.md 파일을 사용하여 Gemini 맞춤설정하기를 참고하세요.

다음 예시는 카탈로그에 맞게 조정할 수 있는 시작점입니다.

# AAOS SDV service catalog rules

- Implement SDV service bundles in Rust under `services/<BundleName>/src/`.
- Keep `.proto` files limited to Protobuf `message`, `enum`, and `service` definitions. Define service bundles, APEX packaging, VM placement, and SOME/IP mappings in `.vsidl` files.
- Regenerate middleware with `vsidlc` after you change `.vsidl` or `.proto` files, and leave generated files unmodified.
- Use `PascalCase` for service bundle names and lowercase `kebab-case` for topic and channel names.
- Run `vsidlc --explain <CODE>` to look up a VSIDLC error code.