Strumenti di controllo del codice sorgente

Lavorare con il codice Android richiede l'utilizzo sia di Git (un sistema di controllo della versione open source) che di Repo (uno strumento di gestione del repository creato da Google che viene eseguito su Git). Consulta la pagina Flusso di lavoro del controllo del codice sorgente per un riepilogo delle azioni regolari che puoi eseguire, come il caricamento delle modifiche per la revisione.

Idiota

Git gestisce progetti di grandi dimensioni distribuiti su più repository. Android utilizza Git per operazioni locali come ramificazioni locali, commit, differenze e modifiche. Una delle sfide nell'impostazione del progetto Android è stata determinare come supportare al meglio la comunità esterna, dalla comunità di hobbisti ai grandi OEM che costruiscono dispositivi di consumo per il mercato di massa. Google voleva che i componenti fossero sostituibili e che i componenti interessanti avessero una vita propria, al di fuori di Android. Google ha prima scelto un sistema di controllo di revisione distribuito, poi ha ristretto il campo a Git.

Per maggiori dettagli su Git, fare riferimento a questa documentazione Git .

Repo

Repo unifica i repository Git quando necessario, esegue caricamenti nel sistema di controllo delle revisioni Gerrit e automatizza parti del flusso di lavoro di sviluppo Android.

Il Repo Launcher fornisce uno script Python che inizializza un checkout e scarica la seconda parte, lo strumento Repo completo. Lo strumento Repo completo è incluso nel checkout del codice sorgente Android. Si trova, per impostazione predefinita, in $SRCDIR/.repo/repo/... e riceve i comandi inoltrati dal Repo Launcher scaricato.

Repo non sostituisce Git, semplifica solo il lavoro con Git nel contesto di Android. Repo utilizza file manifest per aggregare progetti Git nel superprogetto Android. Puoi inserire il comando repo , che è uno script Python eseguibile, ovunque nel tuo percorso. Quando si lavora con i file di origine Android, è possibile utilizzare Repo per operazioni su tutta la rete, ad esempio con una singola directory di lavoro Repo.

Nella maggior parte delle situazioni, puoi utilizzare Git invece di Repo o combinare comandi Repo e Git per formare comandi complessi. Tuttavia, l'utilizzo di Repo per le operazioni di base su tutta la rete rende il tuo lavoro molto più semplice. Per ulteriori dettagli su Repo, consulta Repo Command Reference , Repo README , Preupload Hooks (test) che possono essere abilitati in Repo e la documentazione generale in AOSP .

Per scaricare e installare Repo Launcher da git-repo-downloads , vedere Installazione di Repo .

Gerrit

Gerrit è un sistema di revisione del codice basato sul web per progetti che utilizzano Git. Gerrit incoraggia un uso più centralizzato di Git consentendo a tutti gli utenti autorizzati di inviare modifiche, che vengono automaticamente unite se superano la revisione del codice. Inoltre, Gerrit semplifica la revisione, visualizzando le modifiche una accanto all'altra nel browser e abilitando i commenti in linea.

Trova l'interfaccia di revisione di Android Gerrit su android-review.googlesource.com e l'interfaccia di navigazione del codice su android.googlesource.com .

Android Code Search ti consente di cercare AOSP senza scaricare nulla. Puoi utilizzare Ricerca codice per visualizzare il codice sorgente AOSP, passare da un ramo open source all'altro ed esplorare i riferimenti incrociati. Per ulteriori informazioni, consulta il sito di Google Developers per la documentazione sulla ricerca del codice .

Altri strumenti

Android Studio è l'ambiente di sviluppo integrato (IDE) ufficiale per lo sviluppo di app Android.

Android Debug Bridge (ADB) ti consente di connettere la tua workstation di sviluppo direttamente al tuo dispositivo Android in modo da poter installare pacchetti e valutare le modifiche.

Per lo sviluppo AOSP, utilizza Android Studio for Platform (ASfP) .

Installazione del repository

Seguire questi passaggi per installare Repo.

  1. Esegui questi comandi per utilizzare il pacchetto ufficiale dalla tua distribuzione Linux:
      sudo apt-get update
      sudo apt-get install repo
    
    Se questi comandi non hanno funzionato per il tuo sistema, ad esempio, vedi che la versione del pacchetto è obsoleta o non è disponibile un pacchetto ufficiale dal tuo Distribuzione Linux, installare manualmente Repo utilizzando i seguenti comandi:
    export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
    curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
    gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
    
  2. Questi comandi configurano un file temporaneo, scaricano il repository e verificano che la chiave fornita corrisponda alla chiave richiesta. Se questi hanno esito positivo, l'installazione procede.

    Dopo l'installazione, verificare che repo version riporti qualcosa di simile al seguente quando è in esecuzione in una directory normale. (Una directory normale non fa parte di un client repository; ad esempio, è la tua directory home.)

  3. Esegui questo comando:
  4. repo version
  5. Aspettatevi un rapporto simile a questo:
  6. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • Il numero repo launcher version riportato come 2.15 o superiore indica un numero di versione corretto e un'installazione corretta.
    • (from /usr/bin/repo) indica l'installazione da un pacchetto.
    • (from /home/<>/bin/repo) indica l'installazione manuale.

Completamento dell'installazione

Successivo: per completare l'installazione completa dello strumento Repo, vedere Inizializzazione di un client Repo nella pagina Download dell'origine .