Lernprogramm: Hinzufügen eines Ports zur Open-Source-Registrierung von vcpkg

  • Artikel

In diesem Lernprogramm erfahren Sie, wie Sie eine Bibliothek für vcpkg mithilfe einer benutzerdefinierten Überlagerung verpacken. Es wird empfohlen, das Lernprogramm zum Verpacken einer Bibliothek zu lesen, bevor Sie fortfahren.

Voraussetzungen

  • Ein Terminal
  • Git

1 – Verzweigung des vcpkg-Repositorys

  1. Navigieren Sie zum vcpkg GitHub-Repository.
  2. Klicken Sie auf die Schaltfläche "Verzweigung" in der oberen rechten Ecke der Seite.
  3. Wählen Sie Ihr GitHub-Konto als Ziel für die Verzweigung aus.

2 – Hinzufügen ihrer Verzweigung als Remote

Navigieren Sie zu dem Verzeichnis, in dem Sie das ursprüngliche vcpkg-Repository geklont haben, und fügen Sie dann Ihre Verzweigung als Remote hinzu. Ersetzen Sie ihren <Your-GitHub-Username> GitHub-Benutzernamen:

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

Sie können überprüfen, ob die Remote ordnungsgemäß hinzugefügt wurde, indem Sie Folgendes ausführen:

git remote -v

Sie sollten unter den Remoten aufgeführt sein myfork .

3 – Erstellen einer Themenverzweigung

Bevor Sie Änderungen vornehmen, ist es in der Regel gut, eine neue Verzweigung zu erstellen:

git checkout -b <topic-branch-name>

4 – Kopieren des Überlagerungsports in das ports Verzeichnis

Fügen Sie den Port hinzu, der vcpkg-sample-library in der Verpackung eines Bibliothekslernprogramms erstellt wurde, zum vcpkg\ports Verzeichnis:

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 – Commit und Pushänderungen

  1. Führen Sie für die Änderungen einen Commit aus:

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

  2. Führen Sie vcpkg x-add-version aus:

    vcpkg x-add-version vcpkg-sample-library

  3. Übernehmen von Versionsänderungen

     git commit -m "version database"

  4. Pushen Sie die Änderungen an Ihre Verzweigung:

    git push myfork <topic-branch-name>

6 – Erstellen einer Pullanforderung

  1. Navigieren Sie zu Ihrem verzweigten Repository auf GitHub.
  2. Klicken Sie auf die Schaltfläche "Vergleich & Pullanforderung".
    1. Überprüfen der Änderungen
    2. Hinzufügen eines beschreibenden Titels und Kommentares
    3. Füllen Sie die Prüfliste für pr-Überprüfungen aus.
  3. Klicken Sie auf "Pullanforderung erstellen".

Das ist alles! Sie haben die port kuratierte Registrierung von vcpkg erfolgreich hinzugefügt.

Nächste Schritte

Weitere Informationen finden Sie unter