GitHub で MSVC141 の .yml スクリプトを更新するためのガイド

MSVC141 ツールセットを含めるように .yml スクリプトを更新する

GitHub アクションの YAML 構成

name: Pull request - Windows
on:
  pull_request:
    paths-ignore:
      - 'Engine/Engine.Android/'
      - 'Mobile/'
jobs:
  build:
    runs-on: windows-2022
    defaults:
      run:
        shell: pwsh
    env:
      DEFAULT_VERSION: v17.4.500
      SolutionDir: ${{ github.workspace }}
    steps:
      - name: Checkout
        uses: actions/checkout@v3
        with:
          token: ${{ secrets.RS_GITHUB_TOKEN }}
          submodules: true
      - uses: actions/setup-java@v4
        with:
          distribution: 'temurin'
          java-version: '11'
      - name: Setup MSBuild
        uses: microsoft/setup-msbuild@v1.1
      - name: Install Visual Studio
        uses: microsoft/setup-msbuild@v1.1
        with:
          vs-version: 2019
          msbuild-version: 16.x
      - name: Setup NuGet sources
        uses: extenda/actions/setup-nuget-sources@v0
        with:
          config-file: NuGet.Config
          sources: |
            [{
              "name": "Nexus",
              "source": "https://repo.extendaretail.com/repository/nuget-hosted/",
              "username": "${{ secrets.NEXUS_USERNAME }}",
              "password": "${{ secrets.NEXUS_PASSWORD }}",
              "apikey": "${{ secrets.NUGET_API_KEY }}"
            }]
      - name: Restore NuGet packages
        run: nuget restore POS.sln
      - name: Determine version
        id: ver
        run: .\Build\determine-version.ps1
      - name: Update assemblies
        run: .\Build\update-assemblies.ps1 ${{ steps.ver.outputs.version }} ${{ steps.ver.outputs.full-version }}
      - name: Generate database template
        run: |
          .\Common\Database\AppVeyor\gen-databases.ps1 Common\Database abcDb
          Copy-Item abcDb\Template.db -Destination Common\Database
      - name: Build solution
        run: msbuild POS.sln @Build\WindowsBuildParams.rsp
      - name: Build installation packages
        run: |
          .\Build\exit-on-failure.ps1
          msbuild Installation\Installation.sln @Build\WindowsBuildParams.rsp -p:BuildNumber=${{ steps.ver.outputs.full-version }}
          ExitOnFailure
          Get-ChildItem Installation\Bin\Release
          Rename-Item -Path Installation\Bin\Release\abc.msi -NewName abc-v${{ steps.ver.outputs.full-version }}.msi
          Rename-Item -Path Installation\Bin\Release\abc.exe -NewName abc-v${{ steps.ver.outputs.full-version }}.exe
          Rename-Item -Path Installation\Bin\Release\VRRSSurfaceComponentsEditor.msi -NewName SurfaceComponentsEditor-v${{ steps.ver.outputs.full-version }}.msi
      - name: Generate customization package
        run: .\Common\Database\AppVeyor\gen-customization-zip.ps1 Common\Database ${{ steps.ver.outputs.full-version }}
      - name: Save abc Installer
        uses: actions/upload-artifact@v3
        with:
          name: abcInstaller-v${{ steps.ver.outputs.full-version }}
          path: Installation\Bin\Release\abc-*.msi
      - name: Save abc Setup
        uses: actions/upload-artifact@v3
        with:
          name: abcSetup-v${{ steps.ver.outputs.full-version }}
          path: Installation\Bin\Release\abc-*.exe
      - name: Save Database
        uses: actions/upload-artifact@v3
        with:
          name: Database-v${{ steps.ver.outputs.full-version }}
          path: Common\Database\CustomizationTemplate\*

GitHub アクションで正しい MSVC ツールセットを確認する

MSVC141 を確認してインストールするための PowerShell スクリプト

$vswherePath = "C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe"
if (-Not (Test-Path $vswherePath)) {
    Write-Error "vswhere.exe not found at $vswherePath"
    exit 1
}
$vsInstallPath = & $vswherePath -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath
if (-Not $vsInstallPath) {
    Write-Output "MSVC141 not found. Installing..."
    Start-Process -FilePath "cmd.exe" -ArgumentList "/c start /wait vs_installer.exe --quiet --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --includeRecommended --includeOptional" -Wait
    if ($?) {
        Write-Output "MSVC141 installation completed."
    }
    else {
        Write-Error "Failed to install MSVC141."
        exit 1
    }
} else {
    Write-Output "MSVC141 already installed at $vsInstallPath"
}
exit 0

MSVC ツールセットの統合に関する一般的な質問と解決策

1. GitHub Actions で Visual Studio のバージョンを指定するにはどうすればよいですか?
2. 使用 vs-version: 2019 あなたの中で .yml 構成を使用して、目的の Visual Studio バージョンを設定します。
3. とは vswhere.exe そしてなぜそれが使われるのでしょうか？
4. vswhere.exe は、Visual Studio のインストールを見つけて、必要なツールセットが利用可能であることを確認するユーティリティです。
5. 不足しているコンポーネントのインストールを自動化するにはどうすればよいですか?
6. 使用 Start-Process PowerShell で、無人インストールに必要な引数を指定してインストーラーを実行します。
7. NuGet ソースを構成することが重要なのはなぜですか?
8. NuGet ソースを構成すると、すべてのプロジェクトの依存関係が確実に解決されます。これは、ビルドを成功させるために非常に重要です。
9. MSVC141 ツールセットの存在を確認するにはどうすればよいですか?
10. 使用 vswhere.exe スクリプト内で MSVC141 ツールセットのインストール パスを確認します。
11. どういうことですか msbuild-version: 16.x 特定？
12. 使用する MSBuild バージョンを指定し、MSVC141 ツールセットとの互換性を確保します。
13. GitHub Actions で NuGet パッケージを復元するにはどうすればよいですか?
14. コマンドを使用する nuget restore 続いてソリューション ファイルが続きます。 nuget restore POS.sln。
15. の目的は何ですか Setup MSBuild アクション？
16. GitHub Actions で .NET プロジェクトをビルドするために必要な MSBuild を使用する環境を構成します。
17. ビルド アーティファクトの名前を自動的に変更するにはどうすればよいですか?
18. 次のような PowerShell コマンドを使用します Rename-Item ビルド バージョンに基づいてファイルの名前を変更します。
19. なぜ含めるのか distribution: 'temurin' Javaのセットアップで？
20. これにより、使用する JDK ディストリビューションが指定され、プロジェクトに正しい Java バージョンがインストールされるようになります。

MSVC141 の統合に関する最終的な考え

MSVC141 ツールセットが GitHub Actions ワークフローに含まれていることを確認することは、Visual Studio 2019 プロジェクトの安定性と機能を維持するために不可欠です。 .yml スクリプトを更新し、インストール プロセスを自動化することで、ファイルの欠落に関連する一般的なビルド エラーを防ぐことができます。このプロアクティブなアプローチにより、時間が節約されるだけでなく、CI/CD パイプラインの効率も向上し、よりスムーズで信頼性の高いプロジェクトのビルドが可能になります。