Utiliser AppVeyor pour gérer les add-on NVDA

Publié le Dimanche 10 Janvier 2021

Coucou mes amis du blog de BlindHelp!
Voici un post dédié au service AppVeyor pour gérer les add-on NVDA Fait à la base par @ abdel792 et autres contributeurs (en anglais), et je viens de le traduire au vol en français, et je le partage avec vous tous, et vous le trouverez ci-dessous.
Je vous souhaite une bonne lecture.

Utiliser AppVeyor pour gérer les add-on NVDA

Procédure pour construire et attacher des fichiers nvda-addon aux versions sur GitHub

Cela peut être utilisé pour automatiser la construction d’extensions NVDA (fichiers binaires avec l’extension .nvda-addon), qui seront téléchargés depuis Appveyor vers GitHub et attachés à la version créée.

Cela fonctionne pour les add-ons basés sur le modèle (template) de add-on.

Configuration d’AppVeyor pour les add-ons

  1. Obtenez le code d’un add-on.
    Exemple:
    git clone https://github.com/username/repo
    git pull
  2. Dans la racine du dossier de l’extension (où le fichier sconstruct est placé), collez ce fichier de configuration AppVeyor (appveyor.yml).
  3. Si vous ne le possédez pas, créez un jeton (token) d’accès à l’API personnelle et cryptez-le.
  4. Dans le fichier appveyor.yml, remplacez la valeur fournie pour la clé sécurisée par votre jeton (token) crypté. Par exemple, au lieu de:

    auth_token:
    secure: 3yxF2EQ/wfLKNEobcRfdNL6srjXjoMdRa/LSQ7z2PJNqOL3IEyiFtlnxxHeIQskH

    auth_token:
    secure: votreEncryptedToken

    Maintenant, vous pouvez coller votre fichier appveyor.yml dans n’importe quel add-on publié sur votre compte GitHub.
  5. Connectez-vous (Sign in) avec AppVeyor.
  6. Dans AppVeyor, sélectionnez New Project (Nouveau projet). (Si nécessaire, choisissez GitHub et autorisez-le).
  7. Localisez le nom du référentiel (dépôt) qui vous intéresse, déplacez la souris dessus (par exemple, en appuyant sur NVDA + numpadDivide ou NVDA + shift + m) et activez le lien “Add” ci-dessous.

Libération

Pour publier une nouvelle version d’un add-on, vous pouvez créer un tag et le transmettre à GitHub:

Exemple
git tag 1.0
git push origin 1.0

Maintenant, la version sera créée et le binary-1.0.nvda-addon sera attaché sur GitHub.

En bonus, Abdel a créé un fichier appveyorPourFTP.yml pour libérer

Procédure pour recevoir des notifications sur les commits

Pour les notifications sur les événements Push (recommandé pour la révision des add-ons), veuillez consulter ce wiki (en anglais):
https://github.com/nvdaaddons/nvdaaddons.github.io/wiki/githubWebhooks

Quoi qu’il en soit, si vous souhaitez utiliser AppVeyor:

  1. Créez une adresse email pour recevoir les notifications. Par exemple, vous pouvez utiliser l’intégration de messagerie groups.io.
  2. Dans le fichier appveyor.yml, ajoutez ces lignes:
    notifications:
    - provider:
    Email to:
    - notificationsEmailAddress.example.com
    Remplacez notificationsEmailAddress.example.com par une adresse électronique valide.
    Voici un sujet dans la liste de diffusion groups.io (en anglais) comme exemple réel.

Références (en anglais)

Remerciements

Merci à @ abdel792, @derekriemer et @tuukao pour avoir rendu cela possible.


Récapitulatif des instructions a tout fin utile

  1. Inscrivez-vous sur Appveyor. Confirmer l’E-Mail de vérification , sinon de nouveaux projets ne peuvent pas être enregistrés.
    Une fois fait, Connectez-vous à votre compte en utilisant cette URL:
    https://ci.appveyor.com/login
  2. Créez un jeton (token) avec les autorisations suivantes. notifications, public_repo, repo:status, repo_deployment
    https://github.com/settings/tokens
  3. Chiffrer le jeton (token) généré.
    https://ci.appveyor.com/tools/encrypt
  4. Placez la clé cryptée dans le fichier appveyor.yml.
    auth_token:
    secure: yourEncryptedToken
  5. Créez un nouveau projet sur Appveyor.
    https://ci.appveyor.com/projects/new
    5.1. Sur le titre cloud, sélectionnez github. Activer le bouton:
    autorize github.
    5.2. Sur l’écran GitHub qui s’ouvre, accorder les autorisations demandées.
  6. Sélectionnez le projet, vous devez mettre la souris sur le titre du projet pour afficher le bouton Add. Nous activons le bouton Add.

Envoyer une mise à jour. Une fois que les commits nécessaires ont été fait, utilisez les commandes: git tag, git push origin.
Par exemple:
git tag 1.0
git push origin 1.0


Voilà,
Je vous souhaite une bonne utilisation de AppVeyor afin de bien gérer les add-on NVDA :)
@+
BlindHelp!


Nous espérons vous revoir bientôt sur le
Blog de BlindHelp!
ou sur votre nouveau espace via GitHub:
BlindHelp.github.io


Chargement en cours...