Contribuer au projet WebRTC

Contrat de licence

WebRTC accepte les correctifs/pulls pour les fonctionnalités et les corrections de bugs.

Pour les contributeurs externes à Google, suivez les instructions du Contrat de licence pour les contributeurs individuels Google. Dans tous les cas, les contributeurs doivent signer un accord de licence du contributeur avant qu'une contribution ne puisse être acceptée. Veuillez remplir le contrat pour une personne physique ou une entreprise, le cas échéant.

Envoyer des exemples

Si vous prévoyez d'ajouter un échantillon ou d'apporter des modifications importantes à un échantillon existant, nous vous recommandons de commencer par créer un problème afin que nous puissions en discuter.

Lorsque vous créez un échantillon ou en mettez un à jour, assurez-vous également de créer ou de mettre à jour des tests. Tous les tests de ce dépôt sont implémentés en tant que tests d'interface utilisateur Nightwatch.JS. Veuillez donc suivre la même conception dans le vôtre.

Instructions

Envoyer votre premier correctif

Vous devez effectuer certaines préparations pour pouvoir importer votre premier CL:

• Consulter et compiler le code
• Remplir l'accord Contributor (voir ci-dessus)
• Si vous n'avez jamais envoyé de code auparavant, vous devez ajouter votre nom (ou celui de votre organisation si le contrat de contributeur est signé par votre organisation) et vos coordonnées au fichier AUTHORS.
• Accédez à https://webrtc.googlesource.com/new-password et connectez-vous avec votre compte de messagerie. Il doit s'agir du même compte que celui renvoyé par git config user.email.
• Exécutez ensuite la commande git cl creds-check. Si des erreurs s'affichent, demandez de l'aide sur discuss-webrtc.

Vous n'aurez pas besoin de répéter la procédure ci-dessus. Vous pouvez maintenant importer votre Short:

Importer votre premier correctif

Maintenant que votre compte est configuré, vous pouvez procéder à l'importation:

• Procéder comme suit :

  • En supposant que vous vous trouviez dans la branche principale :
    • git checkout -b my-work-branch

  • Effectuer des modifications, compiler en local et exécuter des tests en local

    • git commit -am "Changed x, and it is working"
    • git cl upload

    Un éditeur de texte s'ouvre et affiche tous les messages de commit locaux. Vous pouvez les modifier avant qu'ils ne deviennent la description de la demande de changement.

    Remplissez correctement le formulaire de signalement de bug. Veuillez spécifier le préfixe du suivi des problèmes et le numéro du problème, séparés par un deux-points (par exemple, webrtc:123 ou chromium:12345). Si vous ne disposez pas d'un préfixe de suivi des problèmes ni d'un numéro de problème, ajoutez simplement None.

    Enregistrez et fermez le fichier pour procéder à l'importation sur le serveur d'examen du code WebRTC.

    La commande affiche un lien tel que https://webrtc-review.googlesource.com/c/src/+/53121 si tout se passe bien.

• Cliquez sur ce lien vers la LM

• Si vous n'êtes pas connecté, cliquez sur le bouton "Se connecter" en haut à droite, puis connectez-vous avec votre adresse e-mail.

• Cliquez sur "Commencer l'examen" et ajoutez un réviseur. Vous pouvez trouver les réviseurs dans les fichiers OWNERS du dépôt (prenez celui qui se rapproche le plus de vos modifications).

• Répondez aux commentaires des examinateurs:

  • Effectuer des modifications, compiler en local et exécuter des tests en local
    • git commit -am "Fixed X and Y"
    • git cl upload

• Une fois que le réviseur a approuvé le correctif, demandez-lui de l'ajouter à la file d'attente de commits.

REMARQUE: Sous Windows, vous devez exécuter la commande ci-dessus dans un shell Git bash pour que gclient trouve le fichier .gitcookies.

Trybots

Si vous travaillez beaucoup avec WebRTC, vous pouvez demander des droits d'essai. Vous pouvez donc exécuter les trybots, qui exécutent tous les tests sur toutes les plates-formes. Pour ce faire, signalez un bug sur bugs.webrtc.org et demandez à l'équipe EngProd de vous accorder des droits d'essai.

Pour exécuter un tryjob, importez un CL comme décrit ci-dessus, puis cliquez sur "CQ dry run" (Exercice CQ) ou "Choose Trybots" (Choisir des trybots) dans l'interface utilisateur Gerrit. Pour ce faire, vous devez disposer des droits d'essai. Sinon, demandez à votre examinateur de désactiver les robots pour vous.