Guia para atualizar scripts .yml para MSVC141 no GitHub

Atualize o script .yml para incluir o conjunto de ferramentas MSVC141

Configuração YAML de ações do GitHub

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

Garanta o conjunto de ferramentas MSVC correto nas ações do GitHub

Script do PowerShell para verificação e instalação do 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

Perguntas comuns e soluções para integração de conjuntos de ferramentas MSVC

1. Como especifico a versão do Visual Studio em GitHub Actions?
2. Usar vs-version: 2019 na tua .yml configuração para definir a versão desejada do Visual Studio.
3. O que é vswhere.exe e por que é usado?
4. vswhere.exe é um utilitário para localizar instalações do Visual Studio, garantindo que os conjuntos de ferramentas necessários estejam disponíveis.
5. Como posso automatizar a instalação de componentes ausentes?
6. Usar Start-Process no PowerShell para executar o instalador com os argumentos necessários para instalações autônomas.
7. Por que é importante configurar fontes NuGet?
8. A configuração de fontes do NuGet garante que todas as dependências do projeto sejam resolvidas, o que é crucial para compilações bem-sucedidas.
9. Como verifico a presença do conjunto de ferramentas MSVC141?
10. Usar vswhere.exe em um script para verificar o caminho de instalação do conjunto de ferramentas MSVC141.
11. O que msbuild-version: 16.x especificamos?
12. Especifica a versão do MSBuild a ser usada, garantindo compatibilidade com o conjunto de ferramentas MSVC141.
13. Como restauro pacotes NuGet em GitHub Actions?
14. Use o comando nuget restore seguido pelo seu arquivo de solução, como nuget restore POS.sln.
15. Qual é o propósito do Setup MSBuild Ação?
16. Ele configura o ambiente para usar o MSBuild, necessário para construir projetos .NET em GitHub Actions.
17. Como posso renomear artefatos de construção automaticamente?
18. Use comandos do PowerShell como Rename-Item para renomear arquivos com base na versão de compilação.
19. Por que incluir distribution: 'temurin' na configuração do Java?
20. Isso especifica a distribuição JDK a ser usada, garantindo que a versão correta do Java esteja instalada para o seu projeto.

Considerações finais sobre a integração do MSVC141

Garantir que o conjunto de ferramentas MSVC141 esteja incluído no fluxo de trabalho do GitHub Actions é essencial para manter a estabilidade e a funcionalidade dos seus projetos do Visual Studio 2019. Ao atualizar seus scripts .yml e automatizar o processo de instalação, você pode evitar erros comuns de compilação relacionados a arquivos ausentes. Essa abordagem proativa não apenas economiza tempo, mas também aumenta a eficiência do seu pipeline de CI/CD, permitindo construções de projetos mais suaves e confiáveis.