Condividi tramite


Esercitazione: Aggiungere una porta al registro open source vcpkg

Questa esercitazione illustra come creare un pacchetto di una libreria per vcpkg usando una sovrimpressione personalizzata. È consigliabile leggere l'esercitazione sulla creazione di pacchetti di una libreria prima di procedere.

Prerequisiti

  • Un terminale
  • Git

1 - Creare una copia tramite fork del repository vcpkg

  1. Passare al repository GitHub vcpkg.
  2. Fare clic sul pulsante "Fork" nell'angolo superiore destro della pagina.
  3. Scegliere l'account GitHub come destinazione per il fork.

2 - Aggiungere il fork come remoto

Passare alla directory in cui è stato clonato il repository vcpkg originale, quindi aggiungere il fork come remoto. Sostituire <Your-GitHub-Username> con il nome utente di GitHub:

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

È possibile verificare che il telecomando sia stato aggiunto correttamente eseguendo:

git remote -v

Dovrebbe essere visualizzato myfork un elenco tra i remoti.

3 - Creare un ramo di argomenti

Prima di apportare modifiche, in genere è consigliabile creare un nuovo ramo:

git checkout -b <topic-branch-name>

4 - Copiare la porta di sovrapposizione nella ports directory

Aggiungere la vcpkg-sample-library porta creata nell'esercitazione sulla creazione di pacchetti di una libreria alla vcpkg\ports directory :

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 - Eseguire il commit e il push delle modifiche

  1. Eseguire il commit delle modifiche:

     git add ports/<library-name>
     git commit -m "Add vcpkg-sample-library to vcpkg"
    
  2. Eseguire vcpkg x-add-version:

    vcpkg x-add-version vcpkg-sample-library
    
  3. Eseguire il commit delle modifiche alla versione

     git commit -m "version database"
    
  4. Eseguire il push delle modifiche nel fork:

    git push myfork <topic-branch-name>
    

6 - Creare una richiesta pull

  1. Passare al repository con fork in GitHub.
  2. Fare clic sul pulsante "Confronta e richiesta pull".
    1. Verificare le modifiche
    2. Aggiungere un titolo descrittivo e commenti
    3. Compilare l'elenco di controllo per la revisione pr
  3. Fare clic su "Crea richiesta pull".

Ecco fatto! È stato aggiunto un oggetto port al registro curato di vcpkg.

Passaggi successivi

Per altre informazioni, vedi: