mirror of
https://github.com/dart-lang/setup-dart.git
synced 2026-04-02 19:29:01 +02:00
A GitHub Action to install and setup a Dart SDK.
- Dart 92.6%
- JavaScript 7.4%
cb71272895Bumps the github-actions group with 2 updates: [dart-lang/setup-dart](https://github.com/dart-lang/setup-dart) and [flutter-actions/setup-flutter](https://github.com/flutter-actions/setup-flutter). Updates `dart-lang/setup-dart` from 1.7.1 to 1.7.2 <details> <summary>Release notes</summary> <p><em>Sourced from <a href="https://github.com/dart-lang/setup-dart/releases">dart-lang/setup-dart's releases</a>.</em></p> <blockquote> <h2>v1.7.2</h2> <ul> <li>Update Node.js requirement to Node 24.</li> <li>Fix open Dependabot alerts by bumping <code>undici</code> to <code>>=6.24.0</code>.</li> <li>Update GitHub Action dependencies (<code>@actions/core</code>, <code>@actions/exec</code>, <code>@actions/tool-cache</code>, <code>@actions/http-client</code>).</li> <li>Update workflow actions to their latest versions (<code>actions/checkout</code> v6, <code>setup-flutter</code>).</li> </ul> </blockquote> </details> <details> <summary>Changelog</summary> <p><em>Sourced from <a href="https://github.com/dart-lang/setup-dart/blob/main/CHANGELOG.md">dart-lang/setup-dart's changelog</a>.</em></p> <blockquote> <h2>v1.7.2</h2> <ul> <li>Update Node.js requirement to Node 24.</li> <li>Fix open Dependabot alerts by bumping <code>undici</code> to <code>>=6.24.0</code>.</li> <li>Update GitHub Action dependencies (<code>@actions/core</code>, <code>@actions/exec</code>, <code>@actions/tool-cache</code>, <code>@actions/http-client</code>).</li> <li>Update workflow actions to their latest versions (<code>actions/checkout</code> v6, <code>setup-flutter</code>).</li> </ul> <h2>v1.7.1</h2> <ul> <li>Roll <code>undici</code> dependency to address <a href="https://github.com/nodejs/undici/security/advisories/GHSA-c76h-2ccp-4975">CVE-2025-22150</a>.</li> <li>Update to the latest npm dependencies.</li> <li>Recompile the action using the new Dart / JavaScript interop.</li> </ul> <h2>v1.7.0</h2> <ul> <li> <p>Install flutter sdk in publishing step, allowing Flutter packages to be published (<a href="https://redirect.github.com/dart-lang/setup-dart/issues/68">#68</a>[])</p> <p><a href="https://redirect.github.com/dart-lang/setup-dart/issues/68">#68</a>: <a href="https://redirect.github.com/dart-lang/setup-dart/issues/68">dart-lang/setup-dart#68</a></p> </li> </ul> <h2>v1.6.5</h2> <ul> <li>Fix zip path handling on Windows 11 (<a href="https://redirect.github.com/dart-lang/setup-dart/issues/118">#118</a>[])</li> </ul> <p><a href="https://redirect.github.com/dart-lang/setup-dart/issues/118">#118</a>: <a href="https://redirect.github.com/dart-lang/setup-dart/issues/118">dart-lang/setup-dart#118</a></p> <h2>v1.6.4</h2> <ul> <li>Rebuild JS code.</li> </ul> <h2>v1.6.3</h2> <ul> <li>Roll <code>undici</code> dependency to address <a href="https://github.com/nodejs/undici/security/advisories/GHSA-m4v8-wqvr-p9f7">CVE-2024-30260</a> and <a href="https://github.com/nodejs/undici/security/advisories/GHSA-9qxr-qj54-h672">CVE-2024-30261</a>.</li> </ul> <h2>v1.6.2</h2> <ul> <li>Switch to running the workflow on <code>node20`` from </code>node16`. See also <a href="https://github.blog/changelog/2023-09-22-github-actions-transitioning-from-node-16-to-node-20/">Transitioning from Node 16 to Node 20</a>.</li> </ul> <h2>v1.6.1</h2> <ul> <li>Updated the google storage url for <code>main</code> channel releases.</li> </ul> </blockquote> <p>... (truncated)</p> </details> <details> <summary>Commits</summary> <ul> <li><a href=" |
||
|---|---|---|
| .github | ||
| dist | ||
| example | ||
| lib | ||
| tool | ||
| .gitattributes | ||
| .gitignore | ||
| action.yml | ||
| analysis_options.yaml | ||
| CHANGELOG.md | ||
| CONTRIBUTING.md | ||
| DEVELOPING.md | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| pubspec.yaml | ||
| README.md | ||
setup-dart
setup-dart installs and sets up a Dart SDK for use in GitHub Actions; it:
- downloads the Dart SDK
- adds the
darttool to the system path
Usage
To install the latest stable Dart SDK and run typical checks:
name: Dart
on:
pull_request:
branches: [main]
push:
branches: [main]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: dart-lang/setup-dart@v1
- run: dart pub get
- run: dart format --output=none --set-exit-if-changed .
- run: dart analyze
- run: dart test
Inputs
The action takes the following inputs:
-
sdk: Which SDK version to setup. Can be specified using one of three forms:- A release channel, which will install the latest build from that channel.
Available channels are
stable,beta,dev, andmain. See the Dart SDK archive for details. - An SDK release version - e.g.
2.19or3.1. This will install the latest patch release for that specific release version. - A specific SDK version, e.g.
2.19.0or2.12.0-1.4.beta.
- A release channel, which will install the latest build from that channel.
Available channels are
-
flavor: Which build flavor to setup.- The available build flavors are
releaseandraw. - The
releaseflavor contains published builds. - The
rawflavor contains unpublished builds; these can be used by developers to test against SDK versions before a signed release is available. Note that themainrelease channel only supports therawbuild flavor.
- The available build flavors are
-
architecture: The CPU architecture to setup support for.- Valid options are
x64,ia32,arm, andarm64. - Note that not all CPU architectures are supported on all operating systems; see the Dart system requirements for valid combinations.
- Valid options are
Outputs
The action produces the following output:
dart-version: The version of the Dart SDK that was installed.
Matrix testing example
You can create matrix jobs that run tests on multiple operating systems, and multiple versions of the Dart SDK.
The following example creates a matrix across two dimensions:
- three major operating systems: Linux, MacOS, and Windows
- several Dart SDK versions: a specific version, the latest stable, beta, and dev
name: Dart
on:
push:
branches: [main]
pull_request:
branches: [main]
jobs:
test:
runs-on: ${{ matrix.os }}
strategy:
matrix:
os: [ubuntu-latest, macos-latest, windows-latest]
sdk: [3.1, stable, beta]
steps:
- uses: actions/checkout@v4
- uses: dart-lang/setup-dart@v1
with:
sdk: ${{ matrix.sdk }}
- name: Install dependencies
run: dart pub get
- name: Run tests
run: dart test
License
See the LICENSE file.
Contributing
Contributions are welcome! Please see CONTRIBUTING.md.
Version history
Please see our CHANGELOG.md file.