Rearchitect vcpkg port for official submission

.gitattributes

@@ -87,6 +87,16 @@ GNUmakefile             text
 *.xml                   text
 *.cfg                   text
 
+## Keep GitHub source tarballs limited to what's needed to build the SDK.
+## The vcpkg portfile records a SHA512 of the tarball, so excluding content the
+## build never uses (the port files themselves, tests, docs, examples) both
+## solves the portfile chicken-and-egg and avoids churning that hash when those
+## non-build files change.
+tools/ports/            export-ignore
+tests/                  export-ignore
+docs/                   export-ignore
+examples/               export-ignore
+
 ## Self-reference =)
 .gitignore              text
 .gitattributes          text

.github/workflows/test-vcpkg.yml

@@ -0,0 +1,114 @@
+name: Vcpkg port tests
+
+on:
+  push:
+    branches:
+    - master
+    - main
+    - dev
+    - dev/*
+    - release/*
+    - buildme/*
+
+  pull_request:
+    branches:
+    - master
+    - main
+    - dev
+
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  windows:
+    runs-on: windows-latest
+    name: Windows (x64-windows-static)
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Bootstrap vcpkg
+      run: |
+        git clone https://github.com/microsoft/vcpkg.git ${{ runner.temp }}\vcpkg
+        & "${{ runner.temp }}\vcpkg\bootstrap-vcpkg.bat" -disableMetrics
+      shell: pwsh
+
+    - name: Run vcpkg port test
+      run: .\tests\vcpkg\test-vcpkg-windows.ps1 -VcpkgRoot "${{ runner.temp }}\vcpkg"
+      shell: pwsh
+
+  linux:
+    runs-on: ubuntu-latest
+    name: Linux (x64-linux)
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Bootstrap vcpkg
+      run: |
+        git clone https://github.com/microsoft/vcpkg.git "${{ runner.temp }}/vcpkg"
+        "${{ runner.temp }}/vcpkg/bootstrap-vcpkg.sh" -disableMetrics
+
+    - name: Run vcpkg port test
+      env:
+        VCPKG_ROOT: ${{ runner.temp }}/vcpkg
+      run: |
+        chmod +x tests/vcpkg/test-vcpkg-linux.sh
+        ./tests/vcpkg/test-vcpkg-linux.sh
+
+  macos:
+    runs-on: macos-latest
+    name: macOS (native)
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Bootstrap vcpkg
+      run: |
+        git clone https://github.com/microsoft/vcpkg.git "${{ runner.temp }}/vcpkg"
+        "${{ runner.temp }}/vcpkg/bootstrap-vcpkg.sh" -disableMetrics
+
+    - name: Run vcpkg port test
+      env:
+        VCPKG_ROOT: ${{ runner.temp }}/vcpkg
+      run: |
+        chmod +x tests/vcpkg/test-vcpkg-macos.sh
+        ./tests/vcpkg/test-vcpkg-macos.sh
+
+  ios:
+    runs-on: macos-latest
+    name: iOS (arm64-ios cross-compile)
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Bootstrap vcpkg
+      run: |
+        git clone https://github.com/microsoft/vcpkg.git "${{ runner.temp }}/vcpkg"
+        "${{ runner.temp }}/vcpkg/bootstrap-vcpkg.sh" -disableMetrics
+
+    - name: Run vcpkg port test (device)
+      env:
+        VCPKG_ROOT: ${{ runner.temp }}/vcpkg
+      run: |
+        chmod +x tests/vcpkg/test-vcpkg-ios.sh
+        ./tests/vcpkg/test-vcpkg-ios.sh
+
+  android:
+    runs-on: ubuntu-latest
+    name: Android (arm64-v8a API 23 cross-compile)
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Bootstrap vcpkg
+      run: |
+        git clone https://github.com/microsoft/vcpkg.git "${{ runner.temp }}/vcpkg"
+        "${{ runner.temp }}/vcpkg/bootstrap-vcpkg.sh" -disableMetrics
+
+    - name: Install Android test prerequisites
+      run: sudo apt-get update && sudo apt-get install -y ninja-build
+
+    - name: Run vcpkg port test
+      env:
+        VCPKG_ROOT: ${{ runner.temp }}/vcpkg
+      run: |
+        chmod +x tests/vcpkg/test-vcpkg-android.sh
+        ./tests/vcpkg/test-vcpkg-android.sh arm64-v8a 23

.gitignore

@@ -405,3 +405,6 @@ build/.cmake/api/v1/query/client-vscode/query.json
 
 #Test files generated locally.
 *.ses
+
+# vcpkg test build directories
+tests/vcpkg/build-*/

.gitmodules

@@ -1,7 +1,3 @@
-[submodule "tools/vcpkg"]
-	path = tools/vcpkg
-	url = https://github.com/Microsoft/vcpkg
-
 [submodule "lib/modules"]
 	path = lib/modules
 	url = ../cpp_client_telemetry_modules.git