Panoramica
Git Source Editor (ci.android.com/edit) è uno strumento basato su browser per modificare i file nell'Android Open Source Project (AOSP) e caricare le modifiche su Gerrit. È progettato per apportare piccole modifiche a un numero ridotto di file e offre un flusso di lavoro più rapido rispetto al download dell'albero di origine di Android. Prima di utilizzare l'editor di sorgenti Git, devi conoscere la procedura completa di invio delle modifiche ad AOSP utilizzando Git, Repo e Gerrit.
Quando modifichi un file utilizzando l'editor di sorgenti Git, tutto il lavoro viene eseguito sul tuo computer locale, fino a quando non carichi le modifiche per creare un elenco di modifiche di Gerrit.
Accedi
- Carica Git Source Editor in un browser.
Fai clic su Accedi per accedere al tuo account.
Figura 1. Pulsante Accedi
Modificare 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.
- Modificare una modifica. Quando modifichi una modifica, il risultato dipende da chi l'ha creata:
- Se hai creato la modifica, le modifiche apportate in Git Source Editor vengono applicate come nuovo set di patch.
- Se la modifica è stata creata da qualcun altro, le modifiche apportate in Git Source Editor creano una nuova modifica di tua proprietà, in base a quella che hai caricato.
Carica ciò che vuoi modificare
Avvia una sessione di modifica caricando un file o una modifica.
Caricare file
Inserisci l'URL del file da modificare nella casella file/change path (File/modifica percorso) nella parte superiore della pagina.
Percorso del file di esempio: https://android.googlesource.com/platform/build/+show/refs/heads/main/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
Vai alla modifica che vuoi modificare inserendo l'URL di un elenco di modifiche di Gerrit nella casella file/change path (percorso file/modifica) nella parte superiore della pagina (vedi Figura 2).
Link alla modifica di esempio: 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.
Apportare 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 modifiche, puoi riaprirlo mantenendo inalterate le modifiche facendo clic sul nome nell'elenco Modifiche in attesa.
Invia modifiche
Creando e pubblicando la modifica in Gerrit in Git Source Editor. 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.
Viene visualizzata 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 modificare la relativa descrizione, se vuoi.
Se vuoi, deseleziona o seleziona 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 su Gerrit, ma non viene pubblicata.
Fai clic su Crea.
La modifica viene caricata su 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. Modificare la notifica creata
Monitorare l'approvazione delle modifiche in Gerrit
Monitora lo stato di invio delle modifiche direttamente in Gerrit, come faresti con qualsiasi altra modifica.
Figura 7. Monitoraggio dello stato di invio delle modifiche in Gerrit
Visualizzare le differenze nei file
Seleziona la casella di controllo Differenza sotto il riquadro di modifica per visualizzare le differenze tra le modifiche apportate al file attivo nel riquadro di modifica. Questa operazione è utile quando si modifica un file e quando si modifica una modifica esistente.
Figura 8. Visualizzazione delle differenze nei file
Ripristinare i file
Puoi annullare le modifiche di un singolo file o di tutti i file nell'elenco delle modifiche in attesa. Entrambe le opzioni di ripristino annullano le modifiche solo nell'editor di codice sorgente Git. NON aggiorneranno la modifica in Gerrit.
Ripristinare un singolo file
Per ripristinare un singolo file, fai clic sull'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
Viene visualizzata una finestra di dialogo popup. Fai clic su Ripristina tutto per ripristinare le modifiche in tutti i file in attesa oppure su Annulla per mantenere le modifiche e continuare a modificare.
Figura 11. Finestra di dialogo di conferma del ripristino di tutti i file
Modificare una pagina direttamente dalla ricerca del codice Android
Puoi aprire un file in Editor di codice sorgente Git direttamente dalla 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 Ricerca codice Android (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 branco Git e poi fai clic su Scegli ramo.
Figura 13. Selezionare un ramo Git da modificare
Il file si apre nel riquadro di modifica.
Continua a modificare come descritto nella sezione Effettuare le modifiche.
Puoi aprire altri file da modificare come descritto nella sezione Caricamento dei file.
Risolvere i conflitti
Per risolvere i conflitti:
Nell'editor di origine, 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 di editor di origine
Fai clic su un file in conflitto. Il file viene caricato e mostra blocchi di contenuti in conflitto in successione e all'interno degli indicatori Git (
<<<<<<<e>>>>>>>).
Figura 15. Marcatori dei conflitti dell'editor di origine
Risolvi il conflitto modificando il file e rimuovendo manualmente gli indicatori di conflitto intorno ai contenuti che vuoi conservare. Rimuovi anche i contenuti e gli indicatori di conflitto relativi ai 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 su Git Source Editor.