Panoramica
L'editor di codice sorgente Git (ci.android.com/edit) è uno strumento basato su browser per modificare i file in Android Open Source Project (AOSP) e caricare le modifiche in Gerrit. È progettato per apportare modifiche minori a un numero ridotto di file e offre un flusso di lavoro più rapido rispetto al download dell'albero di origine Android. Prima di utilizzare l'editor di codice sorgente Git, devi conoscere l'intera procedura di invio delle modifiche ad AOSP utilizzando Git, Repo e Gerrit.
Quando modifichi un file utilizzando l'editor di codice sorgente Git, tutto il lavoro viene eseguito sul computer locale finché non carichi le modifiche per creare un elenco di modifiche di Gerrit.
Accedi
- Carica l'editor di codice sorgente Git in un browser.
Fai clic su Accedi per accedere al tuo account.
Figura 1. Pulsante di accesso
Modifica file e modifiche
L'editor di codice sorgente Git ha i seguenti flussi di lavoro principali:
- Modifica uno o più file a tua scelta nel ramo che preferisci.
- Modifica una modifica. Quando modifichi una modifica, il risultato dipende da chi l'ha creata:
- Se hai creato la modifica, le modifiche dell'editor di codice sorgente Git vengono applicate alla modifica come nuovo patchset.
- Se qualcun altro ha creato la modifica, le modifiche dell'editor di codice sorgente Git creano una nuova modifica di tua proprietà, basata sulla modifica caricata.
Carica ciò che vuoi modificare
Avvia una sessione di modifica caricando un file o una modifica.
Carica file
Inserisci l'URL del file che vuoi modificare nella casella Percorso file/modifica nella parte superiore della pagina.
Esempio di percorso file: https://android.googlesource.com/platform/build/+show/refs/heads/android17-release/Changes.md
Fai clic su Carica file o modifica.
Figura 2. Caricamento di un file o di una modifica
Il file viene caricato nel riquadro dell'editor. Il riquadro di navigazione a sinistra del riquadro dell'editor è un browser di file che apre il repository con il file precaricato.
Figura 3. Un file caricato nel riquadro di modifica
Puoi utilizzare il riquadro di navigazione per aprire altri file nello stesso repository. Se apri più file, ogni file viene visualizzato come scheda nella riga sopra il riquadro di modifica. Fai clic su una scheda per aprire il file nel riquadro di modifica.
Figura 4. Schede per i file caricati
Carica una modifica
Per passare alla modifica che vuoi modificare, inserisci l'URL di un elenco di modifiche di Gerrit nella casella Percorso file/modifica nella parte superiore della pagina (vedi Figura 2).
Esempio di link di modifica: https://android-review.googlesource.com/c/platform/build/soong/+/1284176
I file della modifica si aprono nel riquadro di modifica (vedi Figura 3).
Se la modifica include più file, ogni file viene visualizzato come scheda nella riga sopra il riquadro di modifica (vedi Figura 4). Fai clic su una scheda per aprire il file nel riquadro di modifica.
Apporta le modifiche
Modifica i file utilizzando il riquadro di modifica del testo. I file modificati vengono visualizzati nell'elenco Modifiche in attesa sotto il riquadro di modifica. Se chiudi accidentalmente la scheda di un file con le modifiche, puoi riaprire il file con le modifiche intatte facendo clic sul suo nome nell'elenco Modifiche in attesa.
Invia modifiche
Crea e pubblica la modifica in Gerrit nell'editor di codice sorgente Git. Poi monitora l'approvazione della modifica in Gerrit.
Crea e pubblica le modifiche
Segui questa procedura per creare e pubblicare le modifiche apportate.
Fai clic sul pulsante appropriato:
- Fai clic su Crea modifica se stai creando una nuova modifica.
- Fai clic su Aggiorna modifica se stai aggiornando una modifica esistente.
Si apre una finestra di dialogo.
Figura 5. Finestra di dialogo Crea modifica
Inserisci una descrizione della modifica, che diventerà la descrizione della modifica in Gerrit. Questa descrizione è obbligatoria. Se stai modificando una modifica esistente, puoi modificarne la descrizione, se vuoi.
(Facoltativo) Seleziona o deseleziona la casella di controllo Pubblica al momento della creazione.
Questa casella è selezionata per impostazione predefinita.
Se questa casella è selezionata quando crei la modifica, la modifica viene pubblicata immediatamente in Gerrit. Se la casella non è selezionata, la modifica viene caricata in Gerrit, ma non pubblicata.
Fai clic su Crea.
La modifica viene caricata in Gerrit. Se hai selezionato la casella di controllo Pubblica al momento della creazione, la modifica viene pubblicata anche in Gerrit. La modifica è collegata a una notifica nella parte superiore dello schermo.
Figura 6. Notifica di modifica creata
Monitora l'approvazione delle modifiche in Gerrit
Monitora lo stato di invio delle modifiche direttamente in Gerrit, come faresti per qualsiasi altra modifica.
Figura 7. Monitoraggio dello stato di invio delle modifiche in Gerrit
Visualizza le differenze nei file
Seleziona la casella di controllo Diff sotto il riquadro di modifica per visualizzare le differenze delle modifiche apportate al file attivo nel riquadro di modifica. Questa opzione è utile quando modifichi un file e quando modifichi una modifica esistente.
Figura 8. Visualizzazione delle differenze nei file
Ripristina i file
Puoi ripristinare le modifiche da un singolo file o da tutti i file nell'elenco delle modifiche in attesa. Entrambe le opzioni di ripristino ripristinano le modifiche solo nell'editor di codice sorgente Git. NON aggiorneranno la modifica in Gerrit.
Ripristina un singolo file
Per ripristinare un singolo file, fai clic sulla X accanto al nome del file nell'elenco Modifiche in attesa.
Figura 9. Sezione Modifiche in attesa
Ripristina tutti i file
Per ripristinare tutti i file contemporaneamente, fai clic su Ripristina tutti i file sotto il riquadro di modifica.
Figura 10. Pulsante Ripristina tutti i file
Si apre una finestra di dialogo popup. Fai clic su Ripristina tutto per ripristinare le modifiche in tutti i file in attesa oppure fai clic su Annulla per conservare le modifiche e continuare a modificare.
Figura 11. Finestra di dialogo di conferma Ripristina tutti i file
Modifica una pagina direttamente dalla ricerca del codice Android
Puoi aprire un file nell'editor di codice sorgente Git direttamente da ricerca del codice Android. Questa opzione è utile se devi individuare il file prima di modificarlo.
Segui questa procedura per modificare un file direttamente dalla ricerca del codice Android.
In Android Code Search (cs.android.com), vai al file che ti interessa modificare.
Fai clic su Modifica codice.
Figura 12. Pulsante Modifica codice di Android Code Search
L'editor di codice sorgente Git si apre con il file preselezionato per la modifica.
Seleziona il ramo Git in cui vuoi modificare il file dall'elenco a discesa Seleziona un ramo Git, quindi fai clic su Scegli ramo.
Figura 13. Selezione di un ramo Git da modificare
Il file si apre nel riquadro di modifica.
Continua a modificare come descritto nella sezione Apporta le modifiche.
Puoi aprire altri file da modificare come descritto nella sezione Carica file.
Risolvi conflitti
Per risolvere i conflitti:
Nell'editor di codice sorgente, vai alla modifica. Dopo il caricamento della modifica, i file in conflitto vengono elencati nella parte inferiore dello schermo. Ad esempio, la Figura 14 mostra che il file
Android.pbpresenta un conflitto.
Figura 14. Conflitto dell'editor di codice sorgente
Fai clic su un file in conflitto. Il file viene caricato e mostra i blocchi di contenuti in conflitto in successione e all'interno dei marcatori Git (
<<<<<<<e>>>>>>>).
Figura 15. Marcatori di conflitto dell'editor di codice sorgente
Risolvi il conflitto modificando il file e rimuovendo manualmente i marcatori di conflitto intorno ai contenuti che vuoi conservare. Rimuovi anche i contenuti e i marcatori di conflitto per i contenuti che non vuoi conservare.
Fai clic su Crea modifica per creare una nuova modifica. Viene visualizzata la finestra di dialogo Crea modifica.
Figura 16. Crea modifica
Digita una descrizione della modifica e fai clic su Crea.
Invia feedback
Utilizza il pulsante per i bug
nell'angolo in alto a destra per fornire feedback sull'editor di codice sorgente Git.