Configura un IDE per lo sviluppo di SDV

Android Studio for Platform (ASfP) è l'ambiente di sviluppo integrato consigliato (IDE) per lo sviluppo della piattaforma Android, inclusi i progetti Software Defined Vehicle (SDV) di Android Automotive Operating System (AAOS) . ASfP fornisce un ricco set di strumenti per la modifica, la creazione, il debug e il test del codice, tra cui:

  • Assistenza basata sull'AI (Gemini)
  • Supporto per i linguaggi Rust, C o C++, Java
  • Integrazioni utili per lo sviluppo di AAOS SDV (ad esempio, supporto dell'emulatore Cuttlefish e del linguaggio VSIDL)

Installare Android Studio for Platform

Per installare ASfP:

  1. Scarica Android Studio for Platform.

  2. Scegli la versione più adatta alle tue esigenze:

    • Stabile: l'ultima release di produzione, consigliata per la maggior parte degli utenti
    • Canary: build di accesso in anteprima con le funzionalità più recenti, ma potenzialmente meno stabili

  3. Segui le istruzioni di installazione fornite nella pagina di download.

Configurare un progetto AAOS SDV

Per configurare un progetto AAOS SDV:

  1. Verifica di avere accesso al repository di codice sorgente AAOS SDV e di aver inizializzato e sincronizzato il checkout locale. Per informazioni dettagliate sull'accesso al codice sorgente e sull'inizializzazione del repository, consulta Scaricare, creare ed eseguire.

  2. Avvia Android Studio for Platform.

  3. Se è la prima volta che utilizzi l'app, segui la procedura guidata di configurazione per personalizzare l'ambiente di sviluppo.

  4. Crea un nuovo progetto:

    • Se non hai un progetto aperto, fai clic su Nuovo nella schermata di benvenuto.
    • Se hai già un progetto aperto, fai clic su Apri o seleziona ASfP > Progetto > Importa progetto ASfP dal menu.

  5. Inserisci i dettagli di configurazione del progetto nella procedura guidata:

    • Checkout del repository: specifica il percorso assoluto alla root del checkout del codice sorgente AAOS SDV locale (ad esempio, /path/to/sdv_source).

    • Target di lunch: inserisci il target di lunch appropriato per lo sviluppo di AAOS SDV su Cuttlefish, ad esempio sdv_core_cf-trunk_staging-userdebug. Per altri target disponibili, consulta Scegliere un target per.

    • Origini del progetto: elenca le directory o i moduli iniziali che vuoi includere nel progetto oppure fai clic sull'icona della cartella per aprire il browser del file system e selezionare le directory. La selezione di troppe directory o moduli influisce sulle prestazioni di indicizzazione e ricerca dell'IDE, quindi includi solo le directory o i moduli pertinenti.

    • Supporto linguistico: seleziona Rust e C++ come lingue supportate.

    • Nome del progetto: assegna al progetto un nome descrittivo.

    • Completa la configurazione: fai clic su Fine. ASfP crea la struttura del progetto e il file di configurazione .asfp-project.

ASfP avvia automaticamente una procedura di sincronizzazione iniziale. ASfP analizza il codice sorgente, risolve le dipendenze utilizzando il sistema di compilazione Soong e crea le informazioni necessarie per le funzionalità di intelligenza del codice. Questa operazione può richiedere molto tempo, soprattutto per la prima sincronizzazione.

Personalizzare il progetto

Il file .asfp-project nella root del progetto consente un'ulteriore personalizzazione. Puoi modificare questo file per:

  • Aggiungere o rimuovere directory e moduli.
  • Attivare il supporto per altre lingue, come C++ o Rust (Java e Kotlin sono impostate per impostazione predefinita).
  • Configurare i flag di build.

Per apportare modifiche al file di configurazione, seleziona ASfP > Progetto > Apri configurazione. Per le opzioni di configurazione disponibili, consulta Panoramica dei progetti.

Eseguire il debug e testare

Per eseguire il debug e testare il codice in ASfP, consulta Eseguire il debug del codice della piattaforma e Testare il codice della piattaforma con atest.

Integrazioni disponibili

ASfP include alcune integrazioni utili per lo sviluppo di AAOS SDV, tra cui il supporto per Cuttlefish e Language Server Protocol (LSP) in VSIDL.

Plug-in Cuttlefish

Il plug-in Cuttlefish consente agli utenti di creare ed eseguire dispositivi Cuttlefish locali direttamente da ASfP.

Installare il plug-in

Il plug-in Cuttlefish è preinstallato con ASfP e non richiede alcuna configurazione. Il plug-in richiede l'installazione degli strumenti Cuttlefish sul dispositivo. Se necessario, segui le istruzioni per installare gli strumenti Cuttlefish.

Creare un dispositivo Cuttlefish

Per creare un nuovo dispositivo:

  1. Apri la finestra degli strumenti Gestione dispositivi selezionando Strumenti > Gestione dispositivi o facendo clic sull'icona Dispositivi in esecuzione nel riquadro a destra se Gestione dispositivi è già bloccato.

  2. Fai clic sull'icona + e seleziona Crea dispositivo Cuttlefish.

  3. Configura il nuovo dispositivo Cuttlefish. Puoi creare dispositivi Cuttlefish in due modi:

    • Dalla directory di checkout del codice sorgente Android locale:

      • Seleziona il percorso del target di build che corrisponde alla configurazione di avvio (per maggiori dettagli, consulta Scegliere un target).
      • Seleziona il percorso dell'host.
      • (Facoltativo) Seleziona le configurazioni del dispositivo disponibili o Nessuna per la configurazione predefinita.

    • Dalla configurazione canonica (utilizza questa opzione per creare più dispositivi da una singola configurazione):

      • Seleziona il percorso della configurazione del dispositivo.
      • (Facoltativo) Fornisci eventuali flag di override per sostituire le opzioni di configurazione.

  4. Attendi che il dispositivo Cuttlefish venga creato e aggiunto all'elenco dei dispositivi in esecuzione in Gestione dispositivi.

  5. Seleziona il dispositivo Cuttlefish dal menu Dispositivi in esecuzione.

Puoi avviare o arrestare i singoli dispositivi Cuttlefish facendo clic sull'icona di arresto o di avvio accanto al dispositivo in Gestione dispositivi.

Accedere alla pagina del dispositivo Cuttlefish

Il plug-in Cuttlefish ha una finestra degli strumenti che mostra la pagina Dispositivo Cuttlefish, in cui puoi accedere alle funzionalità di mirroring dello schermo.

Per aprire la finestra degli strumenti Cuttlefish, fai clic sull'icona ... nel riquadro a sinistra e seleziona Cuttlefish. In alternativa, puoi cercare Cuttlefish nella voce di menu Aiuto > Trova azione.

Language Server Protocol in VSIDL

In VSIDL, LSP fornisce un ricco set di funzionalità IDE per migliorare il flusso di lavoro di sviluppo quando lavori con file VSIDL (con estensione .vsidl) in ASfP.

Evidenziazione della sintassi semantica

Il server LSP fornisce l'evidenziazione della sintassi per i file VSIDL.

  • Funzionalità: evidenzia le parole chiave (service_bundle, publisher), i campi (package:, message:) e i valori letterali.

  • Come provare: apri un file VSIDL. Il file è codificato a colori per distinguere le parole chiave strutturali dagli identificatori definiti dall'utente.

Diagnostica in tempo reale (errori e avvisi)

Il server LSP convalida continuamente i file e segnala i problemi in tempo reale.

  • Funzionalità: rileva errori di sintassi, riferimenti a tipi non validi e altri errori nell'intero catalogo e nelle relative dipendenze.

  • Come provare: inserisci un errore di battitura nel nome di un messaggio (ad esempio, TiiirePressure). Sotto l'errore di ortografia viene visualizzata una linea ondulata rossa. Passa il mouse sopra la parola per visualizzare il messaggio di errore o visualizza l'elenco completo nella finestra degli strumenti Problemi nella parte inferiore dell'IDE.

Puoi utilizzare le funzionalità di navigazione e intelligenza per esplorare le relazioni tra le diverse parti del catalogo VSIDL.

  • Completamento automatico: premi Ctrl + Spazio per visualizzare i suggerimenti per parole chiave, messaggi protobuf, servizi RPC, argomenti e canali. I suggerimenti per le parole chiave includono brevi spiegazioni utili del loro scopo direttamente nel menu di completamento. LSP fornisce anche snippet intelligenti per blocchi come publisher o server per velocizzare il flusso di lavoro.

  • Vai a una definizione: tieni premuto Ctrl e fai clic (o premi Ctrl+B) su un riferimento a un messaggio, un servizio, un argomento o un canale per passare direttamente alla relativa definizione di origine, anche se si trova in un file VSIDL o protobuf diverso.

  • Trova riferimenti: posiziona il cursore sulla parola chiave publisher, subscriber, server o client e premi Alt+Maiusc+F7 per trovare tutte le occorrenze.

  • Informazioni al passaggio del mouse: sposta il cursore su un tipo o una proprietà (o premi Ctrl+Q). Viene visualizzata una descrizione comando con i commenti della documentazione (se presenti).

Funzionalità strutturali

Il server LSP ti aiuta a gestire e navigare nella struttura di file VSIDL di grandi dimensioni:

  • Simboli del documento (struttura): premi Ctrl+F12 per visualizzare una descrizione comando di navigazione rapida oppure apri la finestra degli strumenti Struttura (Ctrl+Alt+7) per visualizzare una visualizzazione ad albero di tutti i bundle e le unità nel file.

  • Intervalli di folding: fai clic sulle icone > o V nel gutter (accanto ai numeri di riga) per comprimere o espandere blocchi logici di grandi dimensioni come service_bundle o definizioni di mappatura.

  • Formattazione del documento: premi Ctrl+Alt+L per riformattare automaticamente il file, creando rientri e spaziature coerenti.