Android Studio for Platform (ASfP) היא סביבת הפיתוח המשולבת (IDE) המומלצת לפיתוח פלטפורמת SDV (רכב מוגדר תוכנה) של Android Automotive OS (AAOS). ASfP תומכת בכל השפות שבהן משתמשים בפלטפורמת SDV של AAOS, כולל Rust לחבילות שירות של SDV.
הדף הזה עוסק רק בהגדרה הספציפית ל-SDV. מידע נוסף על תכונות ותהליכי עבודה כלליים של ASfP זמין במאמר Android Studio for Platform.
ASfP פועל רק ב-Linux של 64 ביט עם מעבדי x86-64. אפשר להשתמש בו בתחנת עבודה מקומית של Linux או בענן. מידע נוסף על הגדרת הענן זמין במאמר פיתוח בענן.
התקנת ASfP
כברירת מחדל, הגודל המקסימלי של ה-heap ב-ASfP הוא 30GB. הוספה לאינדקס של פלטפורמת checkout דורשת הרבה זיכרון, במיוחד כשמריצים גם מכשירי Cuttlefish עם כמה מכונות וירטואליות באותו מחשב. הגדירו את הפרויקט כך שיכלול רק את הספריות שאתם עובדים עליהן, ואם צריך, שנו את הגודל המקסימלי של ה-heap בהגדרות הזיכרון של ASfP.
ASfP תומך בעדכונים אוטומטיים בתוך ה-IDE. מידע נוסף זמין במאמר עדכון Android Studio לפלטפורמה. במאמר התקנת Android Studio for Platform מוסבר איך מורידים ומתקינים את ASfP ואיך בודקים את דרישות המערכת.
יצירת פרויקט SDV
לפני שמתחילים, צריך להפעיל, לסנכרן ולבנות את ה-checkout של AAOS SDV. למידע נוסף על הגדרת התשלום, קראו את המאמרים מיקום הקוד והורדה, פיתוח והפעלה.
כדי ליצור פרויקט SDV:
- יוצרים פרויקט חדש ב-ASfP ובוחרים את ה-root של ה-checkout של AAOS SDV בתור ה-checkout של המאגר. מידע נוסף על השלבים באשף מופיע במאמר יצירה או ייבוא של פרויקט.
- אחרי ש-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 יעד אחד ( 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/sdvSDV Gateway ב-SDV IVI 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 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. מידע נוסף על מצבי סנכרון (סנכרון מלא, סנכרון חלקי וסנכרון ללא build) וייצוא או ייבוא של תבניות
.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.
- כדי ליצור הגדרה של כמה מכונות וירטואליות, בוחרים באפשרות From canonical configuration ויוצרים או מייבאים הגדרה, כמו SDV Core עם SDV IVI, או SDV Media עם SDV IVI ל-Display Safety. כדי ליצור מכונה וירטואלית אחת, בוחרים באפשרות From local Android source tree checkout.
כדי לראות את כל המסכים של ה-VM במסך אחד ולגשת לאפשרויות נוספות של המכשיר, משתמשים בחלון של הכלי Cuttlefish. כדי לפתוח אותו, לוחצים על הסמל ... בחלונית הצדדית ובוחרים באפשרות Cuttlefish, או מחפשים את Cuttlefish ב-Help > Find Action. אפשר גם לראות מסכים נפרדים בחלון Running Devices. מכיוון ש-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 בחלון Problems. מידע נוסף על כללי האימות וקודי השגיאה שלהם זמין במפרט השפה של VSIDL.
- השלמה אוטומטית ותיעוד: אתם יכולים ללחוץ על Ctrl+Space כדי לקבל הצעות למילות מפתח, להודעות, לשירותים, לנושאים ולערוצים, וללחוץ על Ctrl+Q כדי להציג הערות לתיעוד.
- ניווט ועיצוב: אפשר ללחוץ על Ctrl+B כדי לעבור להגדרות של
.vsidlאו.proto, על Alt+Shift+F7 כדי למצוא קובצי עזר, על Ctrl+F12 כדי לראות את מבנה הקובץ ועל Ctrl+Alt+L כדי לעצב את הקובץ.
הוספת הקשר של SDV לעוזרים אישיים מבוססי-AI
ASfP כולל AI ב-Android Studio וסוכן מובנה עם כלים של Soong build ו-atest. מכיוון שקובצי AGENTS.md נמצאים לצד קוד המקור בניהול הגרסאות, אתם יכולים לשתף את אותם כללי SDV בין הסוכן המובנה של ASfP לבין סוכני תכנות שמבוססים על קונטיינרים או על שורת הפקודה שקוראים את AGENTS.md. כששולחים פרומפט עם קובץ פתוח ב-ASfP, הסוכן טוען קובצי AGENTS.md מהספרייה של הקובץ הזה ומהספריות האם שלו (אלא אם קובץ GEMINI.md באותה ספרייה מקבל קדימות), ואפשר לאמת קבצים פעילים בחלונית Context של חלונית הצ'אט בקטע AGENTS.md Files. מידע נוסף זמין במאמרים היכרות עם 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 Gateway ב-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