Comment afficher et modifier le code source d'une application Open Source

Publicité

Si vous envisagez de développer un logiciel, l'utilisation de la méthode open source est l'une des meilleures façons de le faire. Non seulement les utilisateurs peuvent consulter votre code source libre et soumettre leurs propres correctifs, mais vous êtes également encouragé à regarder le code d'autres personnes à utiliser comme cadre ou source d'inspiration.

Bien que l'Open Source soit un bon choix, vous devrez également investir dans la bonne communauté. GitHub est l'un des meilleurs endroits pour le faire, non seulement en raison du grand nombre d'utilisateurs qui visitent le site, mais aussi à cause des fonctionnalités offertes par GitHub. Si vous trouvez une application open source sur GitHub, je vais vous montrer quelques choses que vous pouvez faire avec, y compris l'affichage, l'édition et le forking du code.

Créer un compte

Avant de commencer à utiliser GitHub, il est préférable de créer un compte avec eux. Créer un compte est gratuit et vous permettra de profiter de nombreuses fonctionnalités telles que le forking. GitHub a également différents niveaux d'adhésion en plus de celui gratuit, mais un compte gratuit devrait être plus que suffisant pour un usage personnel.

Vérification d'un projet

Une fois que vous avez un compte, vous pouvez plonger directement dans une application open source trouvée sur GitHub. Ici vous pouvez voir la page de projet de l'application, y compris les dossiers et les fichiers relatifs à l'application, un graphique de réseau, une liste de demandes d'extraction, des problèmes ouverts, un wiki et d'autres graphiques. Évidemment, si vous voulez voir le code dans les fichiers, vous devez cliquer dessus et le code source complet vous sera présenté. En ce qui concerne l'interprétation du code, vous devez avoir une certaine connaissance du langage de programmation dans lequel l'application est écrite, que ce soit Java, C ++, Python ou autre chose. Pour ceux qui se demandent, la capture d'écran montre jcanvas de Caleb Evan rapidement et facilement Manipuler l'élément Canvas de HTML5 avec jCanvas Manipuler rapidement et facilement l'élément Canvas de HTML5 avec jCanvas Le Web tel que nous le connaissons évolue plus rapidement que jamais. À la fin, le HTML5 arrive sur la scène, offrant la possibilité de développer des applications Web hautement interactives sans avoir besoin ... Read More project.

Forking un projet

L'édition du code nécessite des étapes supplémentaires. Si vous souhaitez copier le code sans le forcer officiellement sur GitHub, vous devrez télécharger les fichiers du projet, puis les modifier localement sur votre ordinateur. Cependant, si vous envisagez vraiment d'utiliser la source actuellement disponible et de créer votre propre projet avec celle-ci et d'aller dans votre propre direction, vous aurez envie de le faire. Forking peut être accompli avec un compte, et en cliquant sur "Fork" sur la page du projet, comme indiqué dans la capture d'écran. Les instructions suivantes sont destinées aux utilisateurs de Linux qui doivent installer le paquet G it pour leur distribution respective.

Si vous souhaitez récupérer les fichiers du référentiel sur votre ordinateur, vous devez exécuter la commande git clone https://github.com/username/project_name.git, en remplaçant le nom d'utilisateur par votre nom d'utilisateur GitHub et le nom du projet par le nom de l'application projet que vous venez de fourchir. Exécutez cette commande dans un dossier qui devrait contenir tous vos projets GitHub, car chaque commande git clone créera un nouveau dossier dans celui que vous résidez actuellement. C'est une autre façon de télécharger le fichier d'un projet car il ne nécessite pas d'informations d'identification de connexion. Maintenant, vous pouvez changer les fichiers à votre guise en utilisant n'importe quel éditeur de texte ou IDE. Pour les utilisateurs de Linux, je recommande Eclipse ou Geany car ce sont d'excellents éditeurs de programmation - Eclipse étant plus complet et Geany étant plus léger. Les utilisateurs Windows peuvent également utiliser le client GitHub natif.

Télécharger des modifications à votre projet

Une fois que vous avez terminé les modifications, vous pouvez télécharger les fichiers mis à jour vers GitHub en utilisant la commande git push origin master dans le dossier de l'application. Cela repousse les modifications dans le pointeur "origine" (votre projet fork) et dans la branche master (emplacement par défaut du code source).

Garder la trace de l'amont

Si vous souhaitez suivre le projet en amont (celui que vous avez créé pour créer le vôtre), vous devrez ajouter ce qu'on appelle une télécommande supplémentaire. Il s'agit simplement d'un autre mot-clé que vous pouvez utiliser lorsque vous êtes dans le dossier de votre application. Pour créer la nouvelle télécommande, exécutez la commande git remote add upstream https://github.com/username/project_name.git, où nom_utilisateur doit être remplacé par le nom d'utilisateur du projet d'origine, et nom_projet doit être remplacé par son nom de projet.

Fusionner les modifications en amont

Si vous remarquez que le projet en amont a été mis à jour et que vous souhaitez intégrer les modifications, vous pouvez exécuter git pull upstream après avoir créé la télécommande supplémentaire, et GitHub téléchargera et fusionnera les modifications en amont dans les fichiers de votre projet. Si tout fonctionne parfaitement après l'exécution de cette commande, vous pouvez immédiatement lancer git push origin master pour envoyer les mises à jour à votre propre projet.

Tirer des demandes

Si vous souhaitez contribuer de nouveau au projet en amont, il est préférable d'apporter les modifications à votre propre branche du projet (ou à votre propre branche du projet en amont, mais seulement après que l'auteur original ait pris des dispositions spéciales). Une fois que vous avez transféré ces modifications dans votre référentiel, vous pouvez accéder à GitHub et soumettre une demande de pull. Cela indique à l'auteur original du projet en amont que vous souhaitez qu'il revoie les modifications que vous avez apportées et qu'il les transfère dans le projet en amont. C'est une courtoisie commune d'offrir au moins quelques-unes de vos propres modifications au projet en amont pour qu'ils vous remercient d'avoir abandonné leur projet. Qu'ils acceptent votre demande, c'est à eux de décider.

Conclusion

GitHub est un outil fantastique qu'un grand nombre de développeurs open source utilisent déjà. Alors que GitHub utilise l'utilitaire Git que tout le monde peut configurer sur ses propres serveurs, GitHub intègre vraiment l'aspect communautaire du développement, ce qui est une exigence dans le monde open source. Cette introduction devrait vous aider à commencer avec les bases. Si vous souhaitez en savoir plus sur la programmation réelle, vous pouvez consulter cet article sur les sites principaux pour rafraîchir sur C ++ 3 Sites Web Pour commencer à apprendre le langage de programmation C ++ 3 Sites Web pour commencer l'apprentissage C ++ Programming Language Apprendre au programme peut être difficile pour beaucoup, même avec des langages de programmation relativement faciles. Alors que Java est plus facile à démarrer (où nous avons de nombreux articles ici à MakeUseOf pour Java ainsi que ... Lire la suite.

Avez-vous utilisé GitHub? Quelle caractéristique aimez-vous le plus que les gens devraient connaître? Faites le nous savoir dans les commentaires!