チュートリアル: vcpkg オープンソース レジストリにポートを追加する

このチュートリアルでは、カスタム オーバーレイを使用して vcpkg 用のライブラリをパッケージ化する方法について説明します。 先に進む前に、ライブラリのパッケージ化に関するチュートリアルを参照することをお勧めします。

前提条件

• ターミナル
• Git

1 - vcpkg リポジトリをフォークする

1. vcpkg GitHub リポジトリに 移動します。
2. ページの右上隅にある [フォーク] ボタンをクリックします。
3. フォークの宛先として GitHub アカウントを選択します。

2 - フォークをリモートとして追加する

元の vcpkg リポジトリを複製したディレクトリに移動し、フォークをリモートとして追加します。 GitHub ユーザー名に置き換えます <Your-GitHub-Username> 。

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 - pull request を作成する

1. GitHub でフォークされたリポジトリに移動します。
2. [比較と pull request] ボタンをクリックします。
   1. 変更を確認する
   2. わかりやすいタイトルとコメントを追加する
   3. pr review チェックlist に入力します
3. [Pull request の作成] をクリックします。

これで完了です。 vcpkg のキュレーションされたレジストリに a が正常に追加 port されました。

次のステップ

詳細については、次を参照してください。

• CMake のガイドライン
• メンテナー ガイド
• ポート
• プライベート Git レジストリへの発行