Codelab per sviluppatori Android

Puoi aiutare a sviluppare il sistema operativo più installato nella storia della Terra. Sì, sei qui per intraprendere il viaggio per diventare un ingegnere di piattaforme Android.

Sebbene il percorso sia impegnativo, il team di Android si sforza di semplificare il tuo viaggio, ad ogni rilascio. E il team apporta miglioramenti ogni giorno attraverso il lavoro diretto nell'Android Open Source Project (AOSP).

Quindi siediti, accendi un terminale e facciamo la storia.

obiettivi

La missione di questo codelab è duplice:

  1. Per darti un piccolo assaggio di come è il flusso di lavoro degli sviluppatori per gli ingegneri Android che lavorano sulla piattaforma (il sistema operativo).
  2. Ti incoraggiano a fornire feedback sugli strumenti, la documentazione e il flusso di lavoro degli sviluppatori di Android.

Prerequisiti

L'elenco dei requisiti per questo codelab è derivato da quelli per lo sviluppo della piattaforma generale ( AOSP ). Per utilizzare questo codelab, imposta quanto segue:

Ambiente

In genere, gli utenti creano e sviluppano direttamente sulla workstation. Poiché potresti lavorare in vari terminali e molti dei comandi utilizzati sono specifici del terminale, dovrai eseguirli nuovamente in ogni sessione del terminale. In particolare, questi includono i comandi source build/envsetup.sh e lunch .

Allestire la postazione di lavoro

  1. Installa i pacchetti necessari sulla tua workstation.
  2. Mentre sei ancora in un terminale, installa Repo e ottieni le credenziali per tutti i repository Git.

Inizializza e sincronizza il codice

  1. Naviga nella tua home directory:

    cd ~
    
  2. Crea una sottodirectory di lavoro locale al suo interno:

    mkdir aosp
    
  3. Naviga nella directory:

    cd aosp
    
  4. Inizializzare il ramo principale del codice sorgente del repository AOSP (impostazione predefinita):

    repo init -u https://android.googlesource.com/platform/manifest
    
  5. Inserisci o accetta le tue credenziali Git (nome, indirizzo email).

  6. Sincronizza il codice sorgente:

    repo sync -j8
    

Le sincronizzazioni iniziali possono richiedere un'ora o più. Durante l'attesa, vedere le istruzioni per il download per i dettagli correlati.

Ogni estrazione del repository è rappresentata da un file manifest . È consentito avere più di 1 checkout del repository alla volta, purché esistano in directory distinte. Ma nota che ogni checkout e build ammonta a circa 300 GB di utilizzo (e in crescita), quindi limitati a 2 checkout del repository o aumenta il tuo sistema con un'unità secondaria.

Suggerimento: per liberare spazio, eliminare una directory di filiale e ricominciare dalla creazione della directory, come mostrato qui:

rm -rf aosp2

Costruisci il codice

Per compilare Android, devi selezionare un tipo di dispositivo di destinazione da costruire con il comando lunch . Un Target è una permutazione del dispositivo, ad esempio un modello o un fattore di forma specifico.

Il target del dispositivo incluso di seguito, aosp_cf_x86_64_phone-userdebug , consente di creare il dispositivo Android virtuale Cuttlefish per il test senza un dispositivo fisico.

Per costruire e aggiornare invece un dispositivo fisico, scegli un'altra destinazione e segui le istruzioni per il flashing dei dispositivi .

  1. Configura il tuo ambiente per la creazione di dispositivi Android eseguendo il seguente comando dalla radice del checkout del codice sorgente:

    source build/envsetup.sh
    
  2. Passa il target di build al comando lunch, in questo modo:

    lunch aosp_cf_x86_64_phone-userdebug
    
  3. Crea il codice da qualsiasi punto della tua cassa con:

    m
    

Aspettati che la prima build richieda ore. Le build successive richiedono molto meno tempo.

Crea un'istanza cloud

Acloud è uno strumento da riga di comando in AOSP che assiste gli utenti nella creazione di dispositivi Android virtuali, in questo caso Cuttlefish.

Se ti trovi nella stessa sessione del terminale utilizzata per creare il codice , procedi. Altrimenti, riesegui lo script envsetup.sh e lo stesso comando lunch hai usato prima. Poi

  1. Crea un'istanza locale Acloud con:

    acloud create --local-image --local-instance
    
  2. Accetta gli aggiornamenti ai pacchetti richiesti.

  3. Se richiesto, riavviare la workstation per rendere effettive tutte le modifiche.

  4. Seleziona il dispositivo Seppie.

Dovresti essere accolto con una sessione VNC contenente un dispositivo Android!

Puoi interagire con il dispositivo virtuale sulla tua workstation utilizzando il mouse e la tastiera. Puoi anche seguire l'attività all'interno dei registri mentre utilizzi il dispositivo utilizzando il comando logcat Android Debug Bridge (adb):

adb logcat

Fare un cambiamento

Aggiorna il codice sorgente seguendo questo esempio changelist .

  1. Dalla radice del tuo checkout ( directory aosp/ ), vai al progetto frameworks/native Git:

    cd frameworks/native
    
  2. Avvia un progetto temporaneo con questo comando:

    repo start <some-name> .
    
  3. Modifica SurfaceFlinger.cpp per includere gli aggiornamenti dall'elenco modifiche nel seguente percorso:

    aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
    

    Aggiungi quanto segue sotto la riga di codice che hai appena incluso:

    updateColorMatrixLocked();
    
  4. Costruisci il codice:

    m
    
  5. Aggiorna la build sul dispositivo:

    adb root
    adb remount
    adb sync
    adb reboot
    acloud reconnect
    

Verifica di vedere un cambiamento di colore sul dispositivo.

Metti alla prova il tuo codice

Questa parte del codelab utilizza un test di esempio che si trova nell'albero dei sorgenti e fallisce. Questo impiega Atest per eseguire il test localmente e testare il codice.

Per utilizzare il test, seguire queste istruzioni:

  1. Correre:

    atest DevCodelabTest
    
  2. Il test fallirà. Per risolverlo, trova il codice sorgente del test fallito:

    atest --info android.test.example.devcodelab.DevCodelabTest#testHelloWorld
    
  3. Allora guarda qui

    platform_testing/tests/example/devcodelab
    
  4. Per ottenere il file da modificare, prendi il nome del test in android.test.example.devcodelab.DevCodelabTest e sostituisci il . con / , per ottenere questo risultato:

    src/android/test/example/devcodelab/DevCodelabTest.java
    
  5. Quindi, modifica

    platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
    

    Rimpiazzare

    Assert.assertTrue(false)
    

    con

    Assert.assertTrue(true)
    
  6. Esegui nuovamente il test per verificare di aver risolto il problema:

    atest DevCodelabTest
    

Carica il tuo codice per la revisione

Repo semplifica l'utilizzo di Git raggruppando comandi come git clone per lavorare su numerosi repository Git (o progetti) contemporaneamente.

Vedi Strumenti di controllo del codice sorgente per una panoramica di Git e Repo, con collegamenti alla documentazione completa sull'utilizzo del codice sorgente Android. Consulta il repository AOSP per l'elenco completo dei progetti Git e i singoli progetti (percorsi) per i rami associati a ciascun progetto.

Per la revisione del codice dei tuoi progetti in Git, utilizzerai il sistema di revisione del codice basato sul web Gerrit .

  1. Supponendo che tu abbia apportato le modifiche nel frameworks/native progetto frameworks/native , esegui questi comandi per caricarli:

    cd frameworks/native
    repo start codelab .
    git add .
    git commit
    
  2. Per il tuo messaggio di commit, inserisci quanto segue:

    Android codelab change
    Test: manual atest
    
  3. Carica la tua modifica:

    repo upload
    

Se hai successo, vedrai un messaggio simile a questo:

Upload project frameworks/native/ to remote branch master:
  branch codelab ( 1 commit, Wed Aug 7 09:32:33 2019 -0700):
         ff46b36d android codelab change
to https://android-review.googlesource.com/ (y/N)? y
remote: Processing changes: refs: 1, new: 1, done
remote:
remote: SUCCESS
remote:
remote:   https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432 android codelab change [NEW]
remote:
To https://android-review.googlesource.com/platform/frameworks/native
 * [new branch]          codelab -> refs/for/master

Visualizza il tuo cambiamento in Gerrit

Vai al link stampato nel terminale che assomiglia a questo:

https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432

Questo completa il codelab di partenza per lo sviluppo della piattaforma Android. Vedere Invio di patch per i passaggi successivi e vedere il resto di questo sito per tutti i dettagli sullo sviluppo di Android.

Ripristina il tuo cambiamento

Normalmente, dopo il test e dopo la revisione e l'approvazione, invii la tua modifica in Gerrit e la unisci nel repository.

Invece, ai fini di questo codelab, ripristina la tua lista delle modifiche facendo clic su Abbandona in Gerrit.

Quindi abbandonare il ramo temporaneo associato nella directory frameworks/native project (o nelle sue sottodirectory):

repo abandon codelab .

Ricorda anche di ripristinare le modifiche apportate al file di prova. Poiché non hai repo start , git commit e repo upload la modifica, puoi reimpostare il file stesso. Supponendo che ti trovi nella aosp/platform_testing directory , usa quanto segue per reimpostare il file:

git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
git checkout .

A questo punto hai finito! Bel lavoro!

Ottenere aiuto

Se riscontri errori durante questo codelab, segnalali utilizzando il collegamento Issue Tracker nella parte inferiore di qualsiasi pagina. Invia domande al gruppo di costruzione di Android .