Quickstart: Create a build validation GitHub workflow

 In this quickstart, you will learn how to create a GitHub workflow to validate the compilation of your .NET source code in GitHub. Compiling your .NET code is one of the most basic validation steps that you can take to help ensure the quality of updates to your code. If code doesn't compile (or build), it's an easy deterrent and should be a clear sign that the code needs to be fixed.

Create a workflow file

In the GitHub repository, add a new YAML file to the .github/workflows directory. Choose a meaningful file name, something that will clearly indicate what the workflow is intended to do.

Here are several good examples of workflow file names:

 Important:

GitHub requires that workflow composition files to be placed within the .github/workflows directory.

Create a new file named build-validation.yml, copy and paste the following YML contents into it:

yml

name: build

on:

  push:

  pull_request:

    branches: [ main ]

    paths:

    - '**.cs'

    - '**.csproj'

env:

  DOTNET_VERSION: '6.0.401' # The .NET SDK version to use

jobs:

  build:

    name: build-${{matrix.os}}

    runs-on: ${{ matrix.os }}

    strategy:

      matrix:

        os: [ubuntu-latest, windows-latest, macOS-latest]

    steps:

    - uses: actions/checkout@v3

    - name: Setup .NET Core

      uses: actions/setup-dotnet@v3

      with:

        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Install dependencies

      run: dotnet restore

      

    - name: Build

      run: dotnet build --configuration Release --no-restore