Contribuer à V8
Les informations figurant sur cette page expliquent comment contribuer à V8. Assurez-vous de tout lire avant de nous envoyer une contribution.
Obtenir le code
Voir Vérification du code source de V8.
Avant de contribuer
Posez des questions sur la liste de diffusion de V8 pour obtenir des conseils
Avant de commencer à travailler sur une contribution V8 plus importante, vous devriez d'abord nous contacter via la liste de diffusion des contributeurs de V8 pour que nous puissions vous aider et éventuellement vous guider. Coordonner au préalable rend les choses beaucoup plus faciles et évite les frustrations par la suite.
Signez le CLA
Avant que nous puissions utiliser votre code, vous devez signer l'Accord de Licence de Contributeur Individuel de Google, que vous pouvez faire en ligne. Cela est principalement dû au fait que vous possédez les droits d'auteur de vos modifications, même après que votre contribution devient une partie de notre base de code, nous avons donc besoin de votre permission pour utiliser et distribuer votre code. Nous devons également nous assurer de divers autres points, par exemple que vous nous informerez si vous savez que votre code enfreint les brevets d'autrui. Vous n'avez pas à le faire avant d'avoir soumis votre code pour examen et qu'un membre l'a approuvé, mais vous devrez le faire avant que nous puissions intégrer votre code dans notre base de code.
Les contributions faites par des entreprises sont régies par un accord différent de celui mentionné ci-dessus, l'Accord de Licence de Contributeur Corporatif et de Subvention Logicielle.
Signez-les en ligne ici.
Soumettez votre code
Le code source de V8 suit le Guide de Style C++ de Google, vous devez donc vous familiariser avec ces directives. Avant de soumettre du code, vous devez réussir tous nos tests et accomplir avec succès les vérifications d'avant-soumission:
git cl presubmit
Le script d'avant-soumission utilise un linter de Google, cpplint.py. Il fait partie de depot_tools, et doit être dans votre PATH — donc si vous avez depot_tools dans votre PATH, tout devrait fonctionner.
Téléchargez sur l'outil de revue de code de V8
Toutes les soumissions, y compris celles des membres du projet, nécessitent une révision. Nous utilisons les mêmes outils et processus de revue de code que le projet Chromium. Pour soumettre un patch, vous devez obtenir les depot_tools et suivre ces instructions sur la demande de révision (en utilisant votre espace de travail V8 à la place de l'espace de travail Chromium).
Soyez attentif aux erreurs ou régressions
Une fois que vous avez obtenu l'approbation de la revue de code, vous pouvez intégrer votre patch à l'aide de la file d'attente de commit. Celle-ci exécute une batterie de tests et engage votre patch si tous les tests réussissent. Une fois votre changement intégré, il est judicieux de surveiller la console jusqu'à ce que les bots passent au vert après votre modification, car la console exécute quelques tests supplémentaires par rapport à la file d'attente de commit.