Tutoriel : Ajouter un port au registre open source vcpkg

  • Article

Ce tutoriel vous guide sur la façon de empaqueter une bibliothèque pour vcpkg à l’aide d’une superposition personnalisée. Nous vous recommandons de lire le didacticiel Empaquetage d’une bibliothèque avant de continuer.

Prérequis

  • Un terminal
  • Git

1 - Fork the vcpkg Repository

  1. Accédez au référentiel GitHub vcpkg.
  2. Cliquez sur le bouton « Fork » en haut à droite de la page.
  3. Choisissez votre compte GitHub comme destination pour la duplication.

2 - Ajouter votre fourche en tant que distant

Accédez au répertoire dans lequel vous avez cloné le référentiel vcpkg d’origine, puis ajoutez votre fourche en tant que distant. Remplacez <Your-GitHub-Username> par votre nom d’utilisateur GitHub :

git remote add myfork https://github.com/<Your-GitHub-Username>/vcpkg.git

Vous pouvez case activée que la télécommande a été correctement ajoutée en exécutant :

git remote -v

Vous devriez voir myfork répertorié parmi les distances.

3 - Créer une branche de rubrique

Avant d’apporter des modifications, il est généralement judicieux de créer une branche :

git checkout -b <topic-branch-name>

4 - Copier le port de superposition dans le ports répertoire

Ajoutez le vcpkg-sample-library port créé dans l’empaquetage d’un didacticiel de bibliothèque dans le vcpkg\ports répertoire :

cp -R <path/to/vcpkg-sample-library> <ports/vcpkg-sample-library>

xcopy <path/to/vcpkg-sample-library> <ports/vcpkg-sample-library> /E

Copy-Item -Path <path/to/vcpkg-sample-library> -Destination <ports/vcpkg-sample-library> -Recurse

5 - Valider et envoyer (push) les modifications

  1. Validez les modifications :

     git add ports/<library-name>
 git commit -m "Add vcpkg-sample-library to vcpkg"

  2. Exécutez vcpkg x-add-version :

    vcpkg x-add-version vcpkg-sample-library

  3. Valider les modifications de version

     git commit -m "version database"

  4. Envoyez les modifications à votre fourche :

    git push myfork <topic-branch-name>

6 - Créer une demande de tirage (pull request)

  1. Accédez à votre référentiel dupliqué sur GitHub.
  2. Cliquez sur le bouton « Comparer & pull request ».
    1. Vérifier les modifications
    2. Ajouter un titre descriptif et des commentaires
    3. Renseignez la liste des case activée de révision de la demande
  3. Cliquez sur « Créer une demande de tirage ».

Et voilà ! Vous avez ajouté un port au registre organisé de vcpkg.

Étapes suivantes

Pour plus d’informations, consultez l’article suivant :