Panoramica
L'editor di sorgenti Git (ci.android.com/edit) è uno strumento basato su browser per modificare file nell'Android Open Source Project (AOSP) e caricare modifiche su Gerrit. È concepito per apportare piccole modifiche a un numero limitato di file e fornisce un flusso di lavoro più veloce rispetto al download dell'albero dei sorgenti Android . Dovresti avere familiarità con l'intero processo di invio delle modifiche ad AOSP utilizzando Git, Repo e Gerrit prima di utilizzare l'editor di origine Git.
Quando modifichi un file utilizzando l'editor di origine Git, tutto il lavoro avviene sul tuo computer locale, finché non carichi le modifiche per creare un elenco di modifiche Gerrit.
Login
- Carica Git Source Editor in un browser.
Fai clic su Accedi per accedere al tuo account.
Figura 1. Pulsante Accedi
Modifica file e modifiche
Git Source Editor ha questi flussi di lavoro principali:
- Modifica uno o più file a tua scelta, nel ramo che scegli.
- Modifica una modifica. Quando modifichi una modifica, il risultato dipende da chi ha creato la modifica:
- Se hai creato tu la modifica, le modifiche del Git Source Editor verranno applicate alla modifica come un nuovo set di patch.
- Se qualcun altro ha creato la modifica, le modifiche del tuo Git Source Editor creano una nuova modifica di tua proprietà, in base alla modifica che hai caricato.
Carica ciò che vuoi modificare
Avvia una sessione di modifica caricando un file o una modifica.
Carica file
Inserisci l'URL del file che desideri modificare nella casella file/modifica percorso nella parte superiore della pagina.
Percorso file di esempio: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md
Fare clic su Carica file o modifica .
Figura 2. Caricamento di un file o 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
È possibile utilizzare il riquadro di navigazione per aprire più file all'interno dello stesso repository. Se apri più file, ogni file viene visualizzato come una scheda nella riga sopra il riquadro di modifica. Fare clic su una scheda per aprire il file nel riquadro di modifica.
Figura 4. Schede per i file caricati
Carica una modifica
Passare alla modifica che si desidera modificare immettendo l'URL di un elenco di modifiche Gerrit nella casella del percorso del file/modifica nella parte superiore della pagina (vedere Figura 2).
Link di modifica di esempio: https://android-review.googlesource.com/c/platform/build/soong/+/1284176
I file nella modifica si aprono nel riquadro di modifica (vedere Figura 3).
Se la modifica include più file, ogni file viene visualizzato come una scheda nella riga sopra il riquadro di modifica (vedere Figura 4). Fare clic su una scheda per aprire il file nel riquadro di modifica.
Apporta le tue modifiche
Modifica i file utilizzando il riquadro di modifica del testo. I file modificati vengono visualizzati nell'elenco Modifiche in sospeso sotto il riquadro di modifica. Se chiudi accidentalmente la scheda di un file con modifiche, puoi riaprire il file con le modifiche intatte facendo clic sul suo nome nell'elenco Modifiche in sospeso.
Inviare le modifiche
Crei e pubblichi la tua modifica a Gerrit in Git Source Editor. Quindi tieni traccia dell'approvazione della modifica in Gerrit.
Creare e pubblicare le modifiche
Segui questa procedura per creare e pubblicare le modifiche apportate.
Fare 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 lo desideri.
Facoltativamente, deseleziona o seleziona la casella di controllo Pubblica alla creazione .
Questa casella è selezionata per impostazione predefinita.
Se questa casella è selezionata quando crei la modifica, la modifica verrà immediatamente pubblicata su Gerrit. Se la casella non è selezionata, la modifica viene caricata su Gerrit ma non pubblicata.
Fare clic su Crea .
La modifica viene caricata su Gerrit. Se hai selezionato la casella di controllo Pubblica alla creazione , la modifica verrà pubblicata anche in Gerrit. La modifica è collegata in una notifica nella parte superiore dello schermo.
Figura 6. Notifica di modifica creata
Tieni traccia dell'approvazione delle modifiche in Gerrit
Tieni traccia dello 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 dei file
Seleziona la casella Diff sotto il riquadro di modifica per visualizzare le differenze delle modifiche apportate al file attivo nel riquadro di modifica. Ciò è utile quando si modifica un file e quando si modifica una modifica esistente.
Figura 8. Visualizzazione delle differenze dei file
Ripristina file
Puoi annullare le modifiche apportate a un singolo file o a tutti i file nell'elenco delle modifiche in sospeso. Entrambe le opzioni di ripristino ripristinano le modifiche solo in Git Source Editor. NON aggiorneranno la modifica in Gerrit.
Ripristina un singolo file
Per ripristinare un singolo file, fare clic sulla X accanto al nome del file nell'elenco Modifiche in sospeso.
Figura 9. Sezione Modifiche in sospeso
Ripristina tutti i file
Per ripristinare tutti i file contemporaneamente, fare 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. Fare clic su Ripristina tutto per annullare le modifiche in tutti i file in sospeso oppure fare clic su Annulla per mantenere 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 in Git Source Editor direttamente dalla ricerca del codice Android . Ciò è utile se è necessario 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), individua il file che desideri modificare.
Fai clic su Modifica codice .
Figura 12. Pulsante Modifica codice Ricerca codice Android
Git Source Editor si apre con il file preselezionato per la modifica.
Seleziona il ramo Git in cui desideri 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 Apportare le tue modifiche .
È possibile aprire file aggiuntivi da modificare come descritto nella sezione Caricamento file
Risolvere i conflitti
Per risolvere i conflitti:
Nell'editor del codice sorgente, vai alla modifica. Dopo aver caricato la 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 origine
Fare clic su un file in conflitto. Il file carica e mostra blocchi di contenuto in conflitto in successione e all'interno dei marcatori Git (
<<<<<<<e>>>>>>>).
Figura 15. Indicatori di conflitto dell'editor di origine
Risolvi il conflitto modificando il file e rimuovendo manualmente i contrassegni di conflitto attorno al contenuto che desideri conservare. Inoltre, rimuovi i contenuti e gli indicatori di conflitto per i contenuti che non desideri conservare.
Fare clic su Crea modifica per creare una nuova modifica. Viene visualizzata la finestra di dialogo Crea modifica.
Figura 16. Crea modifica
Digitare una descrizione della modifica e fare clic su Crea .
Invia feedback
Usa il pulsante Bug 
nell'angolo in alto a destra per fornire feedback su Git Source Editor.