Repository files navigation

This action checks whetherArduino sketches compile and produces a report of data from the compilations.

• Inputs
  • cli-version
  • fqbn
  • platforms
    • Supported platform sources:
      • Boards Manager
      • Local path
      • Repository
      • Archive download
  • libraries
    • Supported library sources:
      • Library Manager
      • Local path
      • Repository
      • Archive download
  • sketch-paths
  • cli-compile-flags
  • verbose
  • sketches-report-path
  • github-token
  • enable-deltas-report
    • How it works
  • enable-warnings-report
• Example usage
• Additional resources

The version ofArduino CLI to use.

Default:"latest"

The fully qualified board name to use when compiling.

Default:"arduino:avr:uno"

If the board is from one of the platforms provided by Arduino'sdefault package index, the board's platform dependency will be automatically detected and the latest version installed. For boards of platforms not in the default package index, previous versions, or other platform sources, the platform dependency must be defined via theplatforms input.

YAML-format list of platform dependencies to install.

Default: The board's dependency will be automatically determined from thefqbn input and the latest version of that platform will be installed via Boards Manager.

If a platform dependency from a non-Boards Manager source of the same name as another Boards Manager source platform dependency is defined, they will both be installed, with the non-Boards Manager dependency overwriting the Boards Manager platform installation. This permits testing against a non-release version of a platform while using Boards Manager to install the platform's tools dependencies.Example:

platforms:|  # Install the latest release of Arduino SAMD Boards and its toolchain via Boards Manager  - name: "arduino:samd"  # Install the platform from the root of the repository, replacing the BM installed platform  - source-path: "."    name: "arduino:samd"

Keys:

• name - (required) platform name in the form ofVENDOR:ARCHITECTURE (e.g.,arduino:avr).
• version - version of the platform to install.
  • Default: the latest version.
• source-url - Boards Manager URL of the platform.
  • Default: Arduino's package index, which allows installation of all official platforms.

Keys:

• source-path - (required) path to install as a platform. Relative paths are assumed to be relative to the root of the repository.
• name - (required) platform name in the form ofVENDOR:ARCHITECTURE (e.g.,arduino:avr).

Keys:

• source-url - (required) URL to clone the repository from. It must start withgit:// or end with.git.
• name - (required) platform name in the form ofVENDOR:ARCHITECTURE (e.g.,arduino:avr).
• version -Git ref of the repository to checkout. The special version namelatest will cause the latest tag to be used.
  • Default: the repository is checked out to the tip of the default branch.
• source-path - path to install as a platform. Paths are relative to the root of the repository.
  • Default: root of the repository.

Keys:

• source-url - (required) download URL for the archive (e.g.,https://github.com/arduino/ArduinoCore-avr/archive/master.zip).
• name - (required) platform name in the form ofVENDOR:ARCHITECTURE (e.g.,arduino:avr).
• source-path - path to install as a platform. Paths are relative to the root folder of the archive, or the root of the archive if it has no root folder.
  • Default: root folder of the archive.

YAML-format list of library dependencies to install.

Default:"- source-path: ./"This causes the repository to be installed as a library. If there are no library dependencies and you want to override the default, set thelibraries input to an empty list (- libraries: '[]').

Libraries are installed under the Arduino user folder at~/Arduino/libraries.

Note: when the deprecated space-separated list format of this input is used, the repository under test will always be installed as a library.

Keys:

• name - (required) name of the library, as defined in thename field of itslibrary.properties metadata file.
• version - version of the library to install.
  • Default: the latest version.

Notes:

• The library will be installed to a folder matching its name, but with any spaces replaced by_.
• If the library's author defined dependencies, those libraries will be installed automatically.

Keys:

• source-path - (required) path to install as a library. Relative paths are assumed to be relative to the root of the repository.
• destination-name - folder name to install the library to.
  • Default: the folder will be named according to the source repository or subfolder name.

Keys:

• source-url - (required) URL to clone the repository from. It must start withgit:// or end with.git.
• version -Git ref of the repository to checkout. The special version namelatest will cause the latest tag to be used.
  • Default: the tip of the default branch.
• source-path - path to install as a library. Paths are relative to the root of the repository.
  • Default: root of the repository.
• destination-name - folder name to install the library to.
  • Default: named according to the source repository or subfolder name.

Keys:

• source-url - (required) download URL for the archive (e.g.,https://github.com/arduino-libraries/Servo/archive/master.zip).
• source-path - path to install as a library. Paths are relative to the root folder of the archive, or the root of the archive if it has no root folder.
  • Default: root folder of the archive.
• destination-name - folder name to install the library to.
  • Default: named according to the source archive or subfolder name.

YAML-format list of paths containing sketches to compile. These paths will be searched recursively.

Default:"- examples"

YAML-format list of flags to add to the Arduino CLI command used to compile the sketches. For the available flags, seethe Arduino CLI command reference.

Default:""

Set to true to show verbose output in the log.

Default:false

Path in which to save a JSON formatted file containing data from the sketch compilations. Should be used only to store reports. Relative paths are relative toGITHUB_WORKSPACE. The folder will be created if it doesn't already exist.

This report is used by thearduino/report-size-deltas action.

Default:"sketches-reports"

GitHub access token used to get information from the GitHub API. Only needed for private repositories withenable-deltas-report set totrue. It will be convenient to use${{ secrets.GITHUB_TOKEN }}.

Default:""

Set totrue to cause the action to determine the change in memory usage and compiler warnings of the compiled sketches.

If the workflow is triggered by apull_request event, the comparison is between the pull request branch and the tip of the pull request's base branch.

If the workflow is triggered by apush event, the comparison is between the pushed commit and its immediate parent.

The deltas will be displayed in the GitHub Actions build log.

This report may be used with thearduino/report-size-deltas action.

Default:false

The sketch is first compiled with the repository in$GITHUB_WORKSPACE at the state it was at before the action's step. Data from the compilation is recorded in the sketches report. Next, a [git checkout] to theGit ref used as the base of the comparison is done and the compilation + data recording process repeated. The delta is the change in the data between the two compilations.

Dependencies defined via thelibraries orplatforms inputs are installed viasymlinks, meaning dependencies from local paths under$GITHUB_WORKSPACE reflect the deltas checkouts even though they are installed outside$GITHUB_WORKSPACE.

Set totrue to cause the action to record the compiler warning count for each sketch compilation in the sketches report.

Default:false

-uses:arduino/compile-sketches@v1with:fqbn:"arduino:avr:uno"libraries:|      - name: Servo      - name: Stepper        version: 1.1.3

• Introductory article aboutarduino/compile-sketches
• Frequently asked questions aboutarduino/compile-sketches
• GitHub Actions documentation
• Discuss or request assistance onArduino Forum