Руководство. Добавление порта в реестр с открытым кодом vcpkg

В этом руководстве описано, как упаковать библиотеку для vcpkg с помощью пользовательского наложения. Мы рекомендуем ознакомиться с руководством по упаковке библиотеки , прежде чем продолжить.

Необходимые компоненты

  • Терминал
  • Git

1. Вилку репозитория vcpkg

  1. Перейдите к репозиторию vcpkg GitHub.
  2. Нажмите кнопку "Форк" в правом верхнем углу страницы.
  3. Выберите учетную запись GitHub в качестве места назначения для вилки.

2. Добавление вилки в качестве удаленного

Перейдите в каталог, где вы клонировали исходный репозиторий vcpkg, а затем добавьте вилку в качестве удаленного. Замените <Your-GitHub-Username> имя пользователя GitHub:

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

Вы можете проверка, что удаленный был добавлен правильно, выполнив следующую команду:

git remote -v

Вы должны увидеть myfork список среди удаленных элементов.

3. Создание ветви раздела

Перед внесением изменений обычно рекомендуется создать новую ветвь:

git checkout -b <topic-branch-name>

4. Копирование порта наложения в ports каталог

vcpkg-sample-library Добавьте порт, созданный в упаковке учебника по библиотекеvcpkg\ports, в каталог:

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. Фиксация и отправка изменений

  1. Примените изменения:

     git add ports/<library-name>
     git commit -m "Add vcpkg-sample-library to vcpkg"
    
  2. Запустите vcpkg x-add-version.

    vcpkg x-add-version vcpkg-sample-library
    
  3. Фиксация изменений версии

     git commit -m "version database"
    
  4. Отправьте изменения в вилку:

    git push myfork <topic-branch-name>
    

6. Создание запроса на вытягивание

  1. Перейдите в вилку репозитория на сайте GitHub.
  2. Нажмите кнопку "Сравнить и запрос на вытягивание".
    1. проверка изменений.
    2. Добавление описательного заголовка и комментариев
    3. Заполните список проверка проверки pr
  3. Нажмите кнопку "Создать запрос на вытягивание".

Вот и все! Вы успешно добавили в курируемый port реестр vcpkg.

Дальнейшие действия

Дополнительные сведения см. в разделе: