Guide till uppdatering av .yml-skript för MSVC141 i GitHub

Uppdatera .yml-skriptet för att inkludera MSVC141 Toolset

GitHub-åtgärder YAML-konfiguration

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\*

Se till att MSVC Toolset är korrekt i GitHub Actions

PowerShell-skript för kontroll och installation av MSVC141

$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

Vanliga frågor och lösningar för att integrera MSVC-verktygsuppsättningar

1. Hur anger jag Visual Studio-versionen i GitHub Actions?
2. Använda sig av vs-version: 2019 i din .yml konfiguration för att ställa in önskad Visual Studio-version.
3. Vad är vswhere.exe och varför används det?
4. vswhere.exe är ett verktyg för att hitta Visual Studio-installationer, vilket säkerställer att de nödvändiga verktygsuppsättningarna är tillgängliga.
5. Hur kan jag automatisera installationen av saknade komponenter?
6. Använda sig av Start-Process i PowerShell för att köra installationsprogrammet med nödvändiga argument för obevakade installationer.
7. Varför är det viktigt att konfigurera NuGet-källor?
8. Konfigurering av NuGet-källor säkerställer att alla projektberoenden löses, vilket är avgörande för framgångsrika konstruktioner.
9. Hur kontrollerar jag om det finns MSVC141-verktygsuppsättning?
10. Använda sig av vswhere.exe i ett skript för att verifiera installationssökvägen för MSVC141-verktygsuppsättningen.
11. Vad gör msbuild-version: 16.x specificera?
12. Den specificerar MSBuild-versionen som ska användas, vilket säkerställer kompatibilitet med MSVC141-verktygsuppsättningen.
13. Hur återställer jag NuGet-paket i GitHub Actions?
14. Använd kommandot nuget restore följt av din lösningsfil, som nuget restore POS.sln.
15. Vad är syftet med Setup MSBuild handling?
16. Den konfigurerar miljön för att använda MSBuild, nödvändigt för att bygga .NET-projekt i GitHub Actions.
17. Hur kan jag byta namn på byggartefakter automatiskt?
18. Använd PowerShell-kommandon som Rename-Item för att byta namn på filer baserat på byggversionen.
19. Varför inkludera distribution: 'temurin' i Java-inställningen?
20. Detta anger JDK-distributionen som ska användas, vilket säkerställer att rätt Java-version är installerad för ditt projekt.

Sista tankar om att integrera MSVC141

Att säkerställa att MSVC141-verktygsuppsättningen ingår i ditt GitHub Actions-arbetsflöde är viktigt för att upprätthålla stabiliteten och funktionaliteten i dina Visual Studio 2019-projekt. Genom att uppdatera dina .yml-skript och automatisera installationsprocessen kan du förhindra vanliga byggfel relaterade till saknade filer. Detta proaktiva tillvägagångssätt sparar inte bara tid utan ökar också effektiviteten i din CI/CD-pipeline, vilket möjliggör smidigare och mer pålitliga projektbyggen.