Come visualizzare e modificare il codice sorgente di un'app open source

Annuncio pubblicitario

Se stai guardando lo sviluppo di software, il percorso open source è uno dei modi migliori per farlo. Non solo le persone possono visualizzare il tuo codice open source e inviare le proprie correzioni, ma sei anche incoraggiato a guardare il codice di altre persone da utilizzare come framework o ispirazione.

Mentre aprire l'open source potrebbe essere una buona scelta, dovrai anche investire nella comunità giusta. GitHub è uno dei posti migliori per farlo, non solo per l'enorme quantità di utenti che visitano il sito, ma anche per le funzionalità offerte da GitHub. Se trovi un'app open source su GitHub, ti mostrerò alcune cose che puoi fare con esso, inclusa la visualizzazione, la modifica e la forking del codice.

Crea un account

Prima di iniziare a utilizzare GitHub, è meglio creare un account con loro. La creazione di un account è gratuita e ti permetterà di sfruttare numerose funzionalità come il biforcarsi. GitHub ha anche diversi livelli di iscrizione oltre a quello gratuito, ma un account gratuito dovrebbe essere più che sufficiente per l'uso personale.

Controllo di un progetto

Una volta che hai un account puoi tuffarti direttamente in un'applicazione open source trovata su GitHub. Qui puoi vedere la pagina del progetto dell'applicazione, comprese le cartelle e i file relativi all'applicazione, un grafico di rete, un elenco di richieste pull, problemi aperti, una wiki e altri grafici. Ovviamente, se vuoi vedere il codice all'interno dei file, devi cliccare su di essi e ti verrà presentato il codice sorgente completo. Per quanto riguarda l'interpretazione del codice, è necessario avere un po 'di esperienza nel linguaggio di programmazione in cui è scritta l'applicazione, che si tratti di Java, C ++, Python o qualcos'altro. Per coloro che si chiedono, lo screenshot mostra i jcanvas di Caleb Evan. Manipola rapidamente e facilmente l'elemento Canvas di HTML5 con jCanvas Manipola rapidamente e facilmente l'elemento Canvas di HTML5 con jCanvas Il web come lo conosciamo si sta evolvendo più velocemente che mai. Di recente, HTML5 sta entrando in scena, fornendo la possibilità di sviluppare applicazioni web altamente interattive senza la necessità di ... Leggi altro progetto.

Forking a Project

La modifica del codice richiede alcuni passaggi aggiuntivi. Se desideri copiare il codice senza installarlo ufficialmente su GitHub, dovrai scaricare i file del progetto e quindi modificarli localmente sul tuo computer. Tuttavia, se stai veramente guardando usando la fonte attualmente disponibile e creando il tuo progetto con esso e andando nella tua stessa direzione, ti consigliamo di biforcarlo. Il fork può essere realizzato con un account e facendo clic su "Fork" sulla pagina del progetto come mostrato nello screenshot. Le prossime istruzioni sono per gli utenti Linux che dovrebbero installare il pacchetto G it per la loro rispettiva distribuzione.

Se desideri recuperare i file del repository sul tuo computer, dovrai eseguire il comando git clone https://github.com/username/project_name.git, sostituendo il nome utente con il tuo nome utente GitHub e nome_progetto con il nome dell'applicazione progetto che hai appena biforcuto. Esegui questo comando all'interno di una cartella che dovrebbe contenere tutti i tuoi progetti GitHub, poiché ogni comando git clone creerà una nuova cartella all'interno di quella che stai attualmente risiedendo. Questo è un altro modo di scaricare il file di un progetto in quanto non richiede credenziali di accesso. Ora puoi cambiare i file come preferisci usando qualsiasi editor di testo o IDE. Per gli utenti Linux, consiglierei Eclipse o Geany in quanto sono grandi editor di programmazione: Eclipse è più completo e Geany è più snello. Gli utenti Windows possono anche utilizzare il client GitHub nativo.

Upload delle modifiche al tuo progetto

Dopo aver apportato le modifiche, puoi caricare nuovamente i file aggiornati su GitHub utilizzando il comando git push origin master all'interno della cartella dell'applicazione. Riporta le modifiche nel puntatore "origine" (il progetto biforcuto) e nel ramo principale (posizione predefinita del codice sorgente).

Tenere traccia di Upstream

Se desideri tenere traccia del progetto upstream (quello che hai biforcato per crearne uno tuo), dovrai aggiungere quello che viene chiamato un ulteriore telecomando. Questa è fondamentalmente solo un'altra parola chiave che puoi usare mentre sei all'interno della cartella dell'applicazione. Per creare il nuovo telecomando, eseguire il comando git remote add upstream https://github.com/username/project_name.git, dove username deve essere sostituito dal nome utente del progetto originale e project_name deve essere sostituito dal nome del progetto.

Unione di modifiche a monte

Se si nota che il progetto upstream è stato aggiornato e si desidera incorporare le modifiche, è possibile eseguire git pull upstream dopo aver creato il telecomando aggiuntivo e GitHub scaricherà e unirà le modifiche da upstream nei file del progetto. Se tutto funziona perfettamente dopo aver eseguito quel comando, è possibile avviare immediatamente git push origin master per inviare gli aggiornamenti al proprio progetto.

Pull Requests

Se vuoi contribuire di nuovo al progetto upstream, è meglio spingere qualsiasi modifica al tuo fork del progetto (o al tuo ramo del progetto upstream, ma solo dopo che l'autore originale ha preso accordi speciali). Dopo aver trasferito tali modifiche nel tuo repository, puoi andare su GitHub e inviare una richiesta di pull. Questo notifica all'autore originale del progetto upstream che vorresti che lui / lei rivedesse le modifiche che hai apportato e che facesse ritirare le tue modifiche nel progetto upstream. È una cortesia comune quella di offrire almeno alcune delle proprie modifiche al progetto upstream per farle ringraziare per aver forgiato il loro progetto. Se accettano la tua richiesta dipende da loro.

Conclusione

GitHub è uno strumento fantastico che già utilizza una grande quantità di sviluppatori open source. Mentre GitHub utilizza l'utilità Git che chiunque può configurare sui propri server, GitHub incorpora davvero l'aspetto di sviluppo della comunità, qualcosa che è un requisito nel mondo dell'open source. Questa introduzione dovrebbe aiutarti a iniziare con le basi. Se vuoi saperne di più sulla programmazione vera e propria, puoi consultare questo articolo sui migliori siti per rispolverare i siti Web C ++ 3 per iniziare con l'apprendimento del linguaggio di programmazione C ++ 3 siti web per iniziare con l'apprendimento della programmazione in C ++. difficile per molti, anche con linguaggi di programmazione relativamente facili. Mentre Java è più facile da iniziare (dove abbiamo numerosi articoli qui su MakeUseOf per Java e ... Per saperne di più.

Hai usato GitHub? Quale caratteristica ti piace di più di cui la gente dovrebbe sapere? Fateci sapere nei commenti!