Leitfaden zum Aktualisieren von .yml-Skripts für MSVC141 in GitHub

Aktualisieren Sie das .yml-Skript, um das MSVC141-Toolset einzuschließen

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

Stellen Sie sicher, dass das MSVC-Toolset in den GitHub-Aktionen korrekt ist

PowerShell-Skript zum Überprüfen und Installieren von 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

Häufige Fragen und Lösungen zur Integration von MSVC-Toolsets

1. Wie lege ich die Visual Studio-Version in GitHub Actions fest?
2. Verwenden vs-version: 2019 in deinem .yml Konfiguration, um die gewünschte Visual Studio-Version festzulegen.
3. Was ist vswhere.exe und warum wird es verwendet?
4. vswhere.exe ist ein Dienstprogramm zum Auffinden von Visual Studio-Installationen und stellt sicher, dass die erforderlichen Toolsets verfügbar sind.
5. Wie kann ich die Installation fehlender Komponenten automatisieren?
6. Verwenden Start-Process in PowerShell, um das Installationsprogramm mit den erforderlichen Argumenten für unbeaufsichtigte Installationen auszuführen.
7. Warum ist es wichtig, NuGet-Quellen zu konfigurieren?
8. Durch die Konfiguration von NuGet-Quellen wird sichergestellt, dass alle Projektabhängigkeiten aufgelöst werden, was für erfolgreiche Builds von entscheidender Bedeutung ist.
9. Wie überprüfe ich, ob das MSVC141-Toolset vorhanden ist?
10. Verwenden vswhere.exe in einem Skript, um den Installationspfad des MSVC141-Toolsets zu überprüfen.
11. Was macht msbuild-version: 16.x angeben?
12. Es gibt die zu verwendende MSBuild-Version an und gewährleistet so die Kompatibilität mit dem MSVC141-Toolset.
13. Wie kann ich NuGet-Pakete in GitHub Actions wiederherstellen?
14. Verwenden Sie den Befehl nuget restore gefolgt von Ihrer Lösungsdatei, z nuget restore POS.sln.
15. Was ist der Zweck des Setup MSBuild Aktion?
16. Es konfiguriert die Umgebung für die Verwendung von MSBuild, das zum Erstellen von .NET-Projekten in GitHub Actions erforderlich ist.
17. Wie kann ich Build-Artefakte automatisch umbenennen?
18. Verwenden Sie PowerShell-Befehle wie Rename-Item um Dateien basierend auf der Build-Version umzubenennen.
19. Warum einschließen distribution: 'temurin' im Java-Setup?
20. Dies gibt die zu verwendende JDK-Distribution an und stellt sicher, dass die richtige Java-Version für Ihr Projekt installiert ist.

Abschließende Gedanken zur Integration von MSVC141

Um die Stabilität und Funktionalität Ihrer Visual Studio 2019-Projekte aufrechtzuerhalten, ist es wichtig sicherzustellen, dass das MSVC141-Toolset in Ihrem GitHub Actions-Workflow enthalten ist. Indem Sie Ihre .yml-Skripte aktualisieren und den Installationsprozess automatisieren, können Sie häufige Build-Fehler im Zusammenhang mit fehlenden Dateien verhindern. Dieser proaktive Ansatz spart nicht nur Zeit, sondern steigert auch die Effizienz Ihrer CI/CD-Pipeline und ermöglicht eine reibungslosere und zuverlässigere Projekterstellung.