Samouczek: dodawanie portu do rejestru open source vcpkg

Ten samouczek zawiera instrukcje dotyczące tworzenia pakietów biblioteki dla programu vcpkg przy użyciu niestandardowej nakładki. Zalecamy przeczytanie samouczka Tworzenie pakietów biblioteki przed kontynuowaniem.

Wymagania wstępne

1 — Rozwidlenie repozytorium vcpkg

  1. Przejdź do repozytorium github vcpkg.
  2. Kliknij przycisk "Rozwidlenie" w prawym górnym rogu strony.
  3. Wybierz konto usługi GitHub jako miejsce docelowe rozwidlenia.

2 — Dodawanie rozwidlenia jako zdalnego

Przejdź do katalogu, w którym sklonujesz oryginalne repozytorium vcpkg, a następnie dodaj rozwidlenie jako zdalne. Zastąp <Your-GitHub-Username> ciąg nazwą użytkownika usługi GitHub:

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

Możesz sprawdzić, czy zdalne zostało poprawnie dodane, uruchamiając polecenie:

git remote -v

Powinna zostać wyświetlona myfork na liście zdalnego.

3 — Tworzenie gałęzi tematu

Przed wprowadzeniem zmian zwykle warto utworzyć nową gałąź:

git checkout -b <topic-branch-name>

4 — Kopiowanie portu nakładki do ports katalogu

vcpkg-sample-library Dodaj port utworzony w samouczku dotyczącym tworzenia pakietów biblioteki do vcpkg\ports katalogu:

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 — Zatwierdzanie i wypychanie zmian

  1. Zatwierdź zmiany:

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

    vcpkg x-add-version vcpkg-sample-library
    
  3. Zatwierdzanie zmian wersji

     git commit -m "version database"
    
  4. Wypchnij zmiany do rozwidlenia:

    git push myfork <topic-branch-name>
    

6 — Tworzenie żądania ściągnięcia

  1. Przejdź do rozwidlenia repozytorium w usłudze GitHub.
  2. Kliknij przycisk "Porównaj i żądanie ściągnięcia".
    1. Weryfikowanie zmian
    2. Dodawanie opisowego tytułu i komentarzy
    3. Wypełnij listę kontrolną przeglądu żądania ściągnięcia
  3. Kliknij pozycję "Utwórz żądanie ściągnięcia".

I już! Pomyślnie dodano element port do nadzorowanego rejestru vcpkg.

Następne kroki

Aby uzyskać więcej informacji, zobacz: