Comment afficher et modifier le code source d'une application open source

Publicité

Si vous envisagez de développer des logiciels, opter pour la voie open source est l'un des meilleurs moyens de le faire. Non seulement les gens peuvent voir votre code open source et soumettre leurs propres correctifs, mais vous êtes également encouragés à regarder le code d'autres personnes à utiliser comme cadre ou source d'inspiration.

Bien que l’open source puisse être 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 également en raison des fonctionnalités que GitHub offre. Si vous trouvez une application open source sur GitHub, je vais vous montrer quelques choses que vous pouvez en faire, y compris la visualisation, la modification et la modification du code.

Créer un compte

Avant de commencer à utiliser GitHub, il est préférable de créer un compte avec eux. La création d'un compte est gratuite 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.

Extraire 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 du projet de l'application, y compris les dossiers et fichiers relatifs à l'application, un graphique réseau, une liste de demandes d'extraction, des problèmes ouverts, un wiki et d'autres graphiques. De toute évidence, 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 aurez besoin d'avoir une certaine expérience dans le 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 Caleb Evan jcanvas Manipulez rapidement et facilement l'élément Canvas de HTML5 avec jCanvasLe Web tel que nous le connaissons évolue plus rapidement que jamais. Récemment, HTML5 est entré en scène, offrant la possibilité de développer des applications Web hautement interactives sans avoir besoin de ... Lire la suite projet.

Forker un projet

La modification du code nécessite quelques étapes supplémentaires. Si vous souhaitez copier le code sans le bifurquer officiellement sur GitHub, vous devrez télécharger les fichiers du projet, puis les modifier localement sur votre ordinateur. Cependant, si vous cherchez vraiment à utiliser la source actuellement disponible et à créer votre propre projet avec lui et à aller dans votre propre direction, vous voudrez le bifurquer. Le fork peut être réalisé 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 Linux qui doivent installer le Gil paquet pour leur distribution respective.

Si vous souhaitez récupérer les fichiers du référentiel sur votre ordinateur, vous devrez exécuter la commande git clone https://github.com/username/project_name.git, en remplaçant username par votre nom d'utilisateur GitHub et project_name par le nom du projet d'application que vous venez de bifurquer. 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 dans lequel vous résidez actuellement. Il s'agit d'un autre moyen de télécharger le fichier d'un projet car il ne nécessite pas d'informations d'identification de connexion. Vous pouvez maintenant modifier les fichiers à votre guise à l'aide de n'importe quel éditeur de texte ou IDE. Pour les utilisateurs de Linux, je recommanderais Eclipse ou Geany car ce sont d'excellents éditeurs de programmation - Eclipse étant plus complet et Geany plus léger. Les utilisateurs Windows peuvent également utiliser le client natif GitHub.

Téléchargement des modifications de votre projet

Une fois les modifications terminées, vous pouvez télécharger les fichiers mis à jour sur GitHub à l'aide de la commande git push origin master dans le dossier de l'application. Cela repousse les modifications dans le pointeur «origine» (votre projet forké) et la branche principale (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 que l'on appelle une télécommande supplémentaire. Il s'agit essentiellement 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 d'utilisateur doit être remplacé par le nom d'utilisateur du projet d'origine et project_name doit être remplacé par son nom de projet.

Fusion des 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 avoir exécuté cette commande, vous pouvez immédiatement exécuter git push origin master pour envoyer les mises à jour à votre propre projet.

Demandes de tirage

Si vous souhaitez contribuer à nouveau au projet en amont, il est préférable de proposer des modifications à votre propre fork du projet (ou votre propre branche du projet en amont, mais ce n'est qu'après que l'auteur original a fait une dispositions). Une fois que vous avez transféré ces modifications dans votre référentiel, vous pouvez accéder à GitHub et soumettre une demande d'extraction. Cela signale à l'auteur d'origine du projet en amont que vous souhaitez qu'il / elle examine les modifications que vous avez apportées et lui demande d'intégrer vos modifications dans le projet en amont. C’est une courtoisie courante d’offrir au moins certaines de vos propres modifications au projet en amont pour qu’elles vous remercient d’avoir bousculé leur projet. Qu'ils acceptent votre demande, c'est à eux de décider.

Conclusion

GitHub est un outil fantastique que de nombreux développeurs open source utilisent déjà. Alors que GitHub utilise l'utilitaire Git que n'importe qui peut configurer sur ses propres serveurs, GitHub a vraiment intègre l'aspect communautaire du développement, ce qui est une exigence dans l'open source monde. Cette introduction devrait vous aider à démarrer avec les bases. Si vous souhaitez en savoir plus sur la programmation réelle, vous pouvez consulter cet article sur meilleurs sites pour réviser C ++ 3 sites Web pour commencer à apprendre le langage de programmation C ++Apprendre à programmer 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 fonctionnalité aimez-vous le plus que les gens devraient connaître? Faites le nous savoir dans les commentaires!