Update README (#266)

* doc: Update README

* fix: Specify the dev channel version

.github/FUNDING.yml

@@ -1 +1 @@
-open_collective: flutter-action
+github: [subosito]

.github/workflows/workflow.yml

@@ -3,99 +3,144 @@ on:
   push:
     branches:
       - main
+      - dev
   pull_request:
-    branches:
+    paths:
-      - main
+      - setup.sh
+      - action.yml
 jobs:
+  lint_shellcheck:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - uses: ludeeus/action-shellcheck@master
   test_channel:
     runs-on: ${{ matrix.operating-system }}
     strategy:
       matrix:
         operating-system: [ubuntu-latest, windows-latest, macos-latest]
-        channel: [stable, beta]
+        channel: [stable, beta, master]
+        include:
+          - operating-system: ubuntu-latest
+            channel: main
     steps:
-    - name: Checkout
+    - uses: actions/checkout@v4
-      uses: actions/checkout@v3
+    - id: flutter-action
-    - uses: ./
+      uses: ./
       with:
         channel: ${{ matrix.channel }}
-    - name: Print FLUTTER_ROOT
+    - name: Echo outputs
+      run: |
+        echo RUNNER-OS=${{ runner.os }}
+        echo RUNNER-ARCH=${{ runner.arch }}
+
+        echo CACHE-PATH=${{ steps.flutter-action.outputs.CACHE-PATH }}
+        echo CACHE-KEY=${{ steps.flutter-action.outputs.CACHE-KEY }}
+        echo CHANNEL=${{ steps.flutter-action.outputs.CHANNEL }}
+        echo VERSION=${{ steps.flutter-action.outputs.VERSION }}
+        echo ARCHITECTURE=${{ steps.flutter-action.outputs.ARCHITECTURE }}
       shell: bash
-      run: echo "FLUTTER_ROOT set to $FLUTTER_ROOT"
+    - run: dart --version
-    - name: Print PUB_CACHE
       shell: bash
-      run: echo "PUB_CACHE set to $PUB_CACHE"
+    - run: flutter --version
-    - name: Run dart --version
       shell: bash
-      run: dart --version
-    - name: Run flutter --version
-      shell: bash
-      run: flutter --version
-  test_version:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        version: [ 2.5.3, 2.x, 1, v1.12 ]
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v3
-    - uses: ./
-      with:
-        channel: stable
-        flutter-version: ${{ matrix.version }}
-    - name: Run dart --version
-      shell: bash
-      run: dart --version
-    - name: Run flutter --version
-      shell: bash
-      run: flutter --version
-  test_master_channel:
-    runs-on: windows-latest
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v3
-    - uses: ./
-      with:
-        channel: master
-    - name: Run dart --version
-      shell: bash
-      run: dart --version
-    - name: Run flutter --version
-      shell: bash
-      run: flutter --version
-  test_any_channel:
-    runs-on: ubuntu-latest
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v3
-    - uses: ./
-      with:
-        channel: any
-        flutter-version: 2
-    - name: Run dart --version
-      shell: bash
-      run: dart --version
-    - name: Run flutter --version
-      shell: bash
-      run: flutter --version
   test_cache:
     runs-on: ${{ matrix.operating-system }}
     strategy:
       matrix:
         operating-system: [ubuntu-latest, windows-latest, macos-latest]
     steps:
-    - name: Checkout
+    - uses: actions/checkout@v4
-      uses: actions/checkout@v3
     - uses: ./
       with:
         channel: stable
-        flutter-version: 2.5.0
+        flutter-version: '3.10.6'
         cache: true
-        cache-key: key-20220113
+    - run: dart --version
-        cache-path: ${{ runner.tool_cache }}/flutter/2.5.0-stable
-    - name: Run dart --version
       shell: bash
-      run: dart --version
+    - run: flutter --version
-    - name: Run flutter --version
+      shell: bash
+  test_print_output:
+    runs-on: macos-latest
+    steps:
+    - uses: actions/checkout@v4
+    - run: ./setup.sh -t -p                        | grep 'stable'
+      shell: bash
+    - run: ./setup.sh -t -p                        | grep '3.7.7'
+      shell: bash
+    - run: ./setup.sh -t -p                        | grep 'x64'
+      shell: bash
+    - run: ./setup.sh -t -p stable                 | grep 'stable'
+      shell: bash
+    - run: ./setup.sh -t -p beta                   | grep 'beta'
+      shell: bash
+    - run: ./setup.sh -t -p beta                   | grep '3.9.0-0.1.pre'
+      shell: bash
+    - run: ./setup.sh -t -p -n 3.3.10 stable       | grep '3.3.10'
+      shell: bash
+    - run: ./setup.sh -t -p -n 3.3.1 stable        | grep '3.3.1'
+      shell: bash
+    - run: ./setup.sh -t -p -n 2 stable            | grep '2.10.5'
+      shell: bash
+    - run: ./setup.sh -t -p -n 2 beta              | grep '2.13.0-0.4.pre'
+      shell: bash
+    - run: ./setup.sh -t -p -n 2 any               | grep 'beta'
+      shell: bash
+    - run: ./setup.sh -t -p -n 2 any               | grep '2.13.0-0.4.pre'
+      shell: bash
+    - run: ./setup.sh -t -p -n 3 any               | grep 'beta'
+      shell: bash
+    - run: ./setup.sh -t -p -n 3 any               | grep '3.9.0-0.1.pre'
+      shell: bash
+    - run: ./setup.sh -t -p -n 3 -a arm64 any      | grep 'arm64'
+      shell: bash
+    - run: ./setup.sh -t -p -n any -a arm64 stable | grep 'stable'
+      shell: bash
+    - run: ./setup.sh -t -p -n any -a arm64 stable | grep '3.7.7'
+      shell: bash
+    - run: ./setup.sh -t -p -n any -a arm64 stable | grep 'arm64'
+      shell: bash
+    - run: ./setup.sh -t -p -n 1 stable            | grep '1.22.6'
+      shell: bash
+    - run: ./setup.sh -t -p -n 0 any               | grep 'beta'
+      shell: bash
+    - run: ./setup.sh -t -p -n 0 any               | grep '0.11.13'
+      shell: bash
+    - run: ./setup.sh -t -p                        | grep 'flutter-macos-stable-3.7.7-x64-2ad6cd72c040113b47ee9055e722606a490ef0da'
+      shell: bash
+    - run: ./setup.sh -t -p stable                 | grep 'flutter-macos-stable-3.7.7-x64-2ad6cd72c040113b47ee9055e722606a490ef0da'
+      shell: bash
+    - run: ./setup.sh -t -p beta                   | grep 'flutter-macos-beta-3.9.0-0.1.pre-x64-f732038a8cf4562ce38a1d7debb30209ae3da896'
+      shell: bash
+    - run: ./setup.sh -t -p dev                    | grep 'flutter-macos-dev-2.11.0-0.1.pre-x64-b101bfe32f634566e7cb2791a9efe19cf8828b15'
+      shell: bash
+    - run: ./setup.sh -t -p master                 | grep 'flutter-macos-master-any-x64-master'
+      shell: bash
+    - run: ./setup.sh -t -p -n 5b12b74 master      | grep 'flutter-macos-master-5b12b74-x64-master'
+      shell: bash
+    - run: ./setup.sh -t -p -n 3.12.0-12.0.pre master     | grep 'flutter-macos-master-3.12.0-12.0.pre-x64-master'
+      shell: bash
+    - run: ./setup.sh -t -p -n stable master       | grep 'flutter-macos-master-stable-x64-master'
+      shell: bash
+    - run: ./setup.sh -t -p -n 2 any               | grep 'flutter-macos-beta-2.13.0-0.4.pre-x64-25caf1461b8f643092a9f6f5b224453b5c057d10'
+      shell: bash
+    - run: ./setup.sh -t -p -n 1 any               | grep 'flutter-macos-beta-1.26.0-17.8.pre-x64-044f2cf5607a26f8818dab0f766400e85c52bdff'
+      shell: bash
+    - run: ./setup.sh -t -p -n 0 any               | grep 'flutter-macos-beta-0.11.13-x64-58c8489fcdb4e4ef6c010117584c9b23d15221aa'
+      shell: bash
+    - run: ./setup.sh -t -p                        | grep '/Users/runner/work/_temp/flutter/stable-3.7.7-x64'
+      shell: bash
+    - run: ./setup.sh -t -p stable                 | grep '/Users/runner/work/_temp/flutter/stable-3.7.7-x64'
+      shell: bash
+    - run: ./setup.sh -t -p beta                   | grep '/Users/runner/work/_temp/flutter/beta-3.9.0-0.1.pre-x64'
+      shell: bash
+    - run: ./setup.sh -t -p dev                    | grep '/Users/runner/work/_temp/flutter/dev-2.11.0-0.1.pre-x64'
+      shell: bash
+    - run: ./setup.sh -t -p master                 | grep '/Users/runner/work/_temp/flutter/master-any-x64'
+      shell: bash
+    - run: ./setup.sh -t -p -k 'custom-:channel:-:version:-:hash:'       | grep 'custom-stable-3.7.7-2ad6cd72c040113b47ee9055e722606a490ef0da'
+      shell: bash
+    - run: ./setup.sh -t -p -k 'custom-:channel:-:version:-:sha256:'     | grep 'custom-stable-3.7.7-78957b52f023a0d811add27eddc59b1a59d27d2ada5df123f39d0315708fb2d5'
+      shell: bash
+    - run: ./setup.sh -t -p -c '/tmp/flutter/:channel:-:version:-:hash:' | grep '/tmp/flutter/stable-3.7.7-2ad6cd72c040113b47ee9055e722606a490ef0da'
       shell: bash
-      run: flutter --version

README.md

@@ -8,10 +8,10 @@ Use specific version and channel:
 
 ```yaml
 steps:
-- uses: actions/checkout@v3
+- uses: actions/checkout@v4
 - uses: subosito/flutter-action@v2
   with:
-    flutter-version: '2.8.0'
+    flutter-version: '3.16.9'
     channel: 'stable'
 - run: flutter --version
 ```
@@ -20,10 +20,10 @@ Use latest release for particular channel:
 
 ```yaml
 steps:
-- uses: actions/checkout@v3
+- uses: actions/checkout@v4
 - uses: subosito/flutter-action@v2
   with:
-    channel: 'stable' # or: 'beta' or 'master'
+    channel: 'stable' # or: 'beta', 'dev', 'master' (or 'main')
 - run: flutter --version
 ```
 
@@ -31,10 +31,10 @@ Use latest release for particular version and/or channel:
 
 ```yaml
 steps:
-- uses: actions/checkout@v3
+- uses: actions/checkout@v4
 - uses: subosito/flutter-action@v2
   with:
-    flutter-version: '1.22.x' # or, you can use 1.22
+    flutter-version: '1.22.x'
     channel: 'dev'
 - run: flutter --version
 ```
@@ -43,26 +43,34 @@ Use particular version on any channel:
 
 ```yaml
 steps:
-- uses: actions/checkout@v3
+- uses: actions/checkout@v4
 - uses: subosito/flutter-action@v2
   with:
-    flutter-version: '2.x'
+    flutter-version: '3.x'
     channel: 'any'
 - run: flutter --version
 ```
 
+Use particular git reference on master channel:
+
+```yaml
+steps:
+- uses: actions/checkout@v4
+- uses: subosito/flutter-action@v2
+  with:
+    flutter-version: '5b12b74' # tag, commit or branch
+    channel: 'master'
+- run: flutter --version
+```
+
 Build Android APK and app bundle:
 
 ```yaml
 steps:
-- uses: actions/checkout@v3
+- uses: actions/checkout@v4
-- uses: actions/setup-java@v2
-  with:
-    distribution: 'zulu'
-    java-version: '11'
 - uses: subosito/flutter-action@v2
   with:
-    flutter-version: '2.10.4'
+    flutter-version: '3.16.9'
 - run: flutter pub get
 - run: flutter test
 - run: flutter build apk
@@ -76,11 +84,10 @@ jobs:
   build:
     runs-on: macos-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - uses: subosito/flutter-action@v2
       with:
-        flutter-version: '2.10.4'
+        channel: 'stable'
-        architecture: x64
     - run: flutter pub get
     - run: flutter test
     - run: flutter build ios --release --no-codesign
@@ -90,10 +97,10 @@ Build for the web:
 
 ```yaml
 steps:
-- uses: actions/checkout@v3
+- uses: actions/checkout@v4
 - uses: subosito/flutter-action@v2
   with:
-    flutter-version: '2.10.4'
+    channel: 'stable'
 - run: flutter pub get
 - run: flutter test
 - run: flutter build web
@@ -106,11 +113,10 @@ jobs:
  build:
    runs-on: windows-latest
    steps:
-     - uses: actions/checkout@v3
+     - uses: actions/checkout@v4
      - uses: subosito/flutter-action@v2
        with:
-         channel: 'beta'
+         channel: 'stable'
-     - run: flutter config --enable-windows-desktop
      - run: flutter build windows
 ```
 
@@ -121,14 +127,13 @@ jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-     - uses: actions/checkout@v3
+     - uses: actions/checkout@v4
      - uses: subosito/flutter-action@v2
        with:
-         channel: 'beta'
+         channel: 'stable'
      - run: |
         sudo apt-get update -y
         sudo apt-get install -y ninja-build libgtk-3-dev
-     - run: flutter config --enable-linux-desktop
      - run: flutter build linux
 ```
 
@@ -139,12 +144,10 @@ jobs:
  build:
    runs-on: macos-latest
    steps:
-     - uses: actions/checkout@v3
+     - uses: actions/checkout@v4
      - uses: subosito/flutter-action@v2
        with:
-         channel: 'beta'
+         channel: 'stable'
-         architecture: x64
-     - run: flutter config --enable-macos-desktop
      - run: flutter build macos
 ```
 
@@ -152,14 +155,43 @@ Integration with `actions/cache`:
 
 ```yaml
 steps:
-- uses: actions/checkout@v3
+- uses: actions/checkout@v4
 - uses: subosito/flutter-action@v2
   with:
-    flutter-version: '2.10.x'
     channel: 'stable'
     cache: true
-    cache-key: flutter # optional, change this to force refresh cache
+    cache-key: 'flutter-:os:-:channel:-:version:-:arch:-:hash:' # optional, change this to force refresh cache
-    cache-path: ${{ runner.tool_cache }}/flutter # optional, change this to specify the cache path
+    cache-path: '${{ runner.tool_cache }}/flutter/:channel:-:version:-:arch:' # optional, change this to specify the cache path
-    architecture: x64 # optional, x64 or arm64
+    pub-cache-key: 'flutter-pub:os:-:channel:-:version:-:arch:-:hash:' # optional, change this to force refresh cache of dart pub get dependencies
+    pub-cache-path: '${{ runner.tool_cache }}/flutter/:channel:-:version:-:arch:' # optional, change this to specify the cache path
 - run: flutter --version
 ```
+
+Note: `cache-key`, `pub-cache-key`, and `cache-path` has support for several dynamic values:
+
+- `:os:`
+- `:channel:`
+- `:version:`
+- `:arch:`
+- `:hash:`
+- `:sha256:`
+
+Use outputs from `flutter-action`:
+
+```yaml
+steps:
+- uses: actions/checkout@v4
+- id: flutter-action
+  uses: subosito/flutter-action@v2
+  with:
+    channel: 'stable'
+- run: |
+    echo CACHE-PATH=${{ steps.flutter-action.outputs.CACHE-PATH }}
+    echo CACHE-KEY=${{ steps.flutter-action.outputs.CACHE-KEY }}
+    echo CHANNEL=${{ steps.flutter-action.outputs.CHANNEL }}
+    echo VERSION=${{ steps.flutter-action.outputs.VERSION }}
+    echo ARCHITECTURE=${{ steps.flutter-action.outputs.ARCHITECTURE }}
+    echo PUB-CACHE-PATH=${{ steps.flutter-action.outputs.PUB-CACHE-PATH }}
+    echo PUB-CACHE-KEY=${{ steps.flutter-action.outputs.PUB-CACHE-KEY }}
+  shell: bash
+```

action.yml

@@ -16,25 +16,60 @@ inputs:
   cache:
     description: 'Cache the Flutter SDK'
     required: false
+    default: 'false'
   cache-key:
     description: 'Identifier for the Flutter SDK cache'
     required: false
-    default: 'flutter'
+    default: 'flutter-:os:-:channel:-:version:-:arch:-:hash:'
+  pub-cache-key:
+    description: 'Identifier for the Dart .pub-cache cache'
+    required: false
+    default: 'flutter-pub:os:-:channel:-:version:-:arch:-:hash:'
   cache-path:
     description: 'Flutter SDK cache path'
     required: false
-    default: ${{ runner.tool_cache }}/flutter
+    default: '${{ runner.tool_cache }}/flutter/:channel:-:version:-:arch:'
   architecture:
     description: 'The architecture of Flutter SDK executable (x64 or arm64)'
     required: false
-    default: 'x64'
+    default: '${{ runner.arch }}'
+outputs:
+  CACHE-PATH:
+    value: '${{ steps.flutter-action.outputs.CACHE-PATH }}'
+  CACHE-KEY:
+    value: '${{ steps.flutter-action.outputs.CACHE-KEY }}'
+  CHANNEL:
+    value: '${{ steps.flutter-action.outputs.CHANNEL }}'
+  VERSION:
+    value: '${{ steps.flutter-action.outputs.VERSION }}'
+  ARCHITECTURE:
+    value: '${{ steps.flutter-action.outputs.ARCHITECTURE }}'
+  PUB-CACHE-KEY:
+    value: '${{ steps.flutter-action.outputs.PUB-CACHE-KEY }}'
+  PUB-CACHE-PATH:
+    value: '${{ steps.flutter-action.outputs.PUB-CACHE-PATH }}'
 runs:
   using: 'composite'
   steps:
-    - if: ${{ inputs.cache == 'true' }}
+    - run: chmod +x $GITHUB_ACTION_PATH/setup.sh
-      uses: actions/cache@v2
+      shell: bash
-      with:
+    - id: flutter-action
-        path: ${{ inputs.cache-path }}
+      run: $GITHUB_ACTION_PATH/setup.sh -p -c '${{ inputs.cache-path }}' -k '${{ inputs.cache-key }}' -d '${{ inputs.pub-cache-key }}' -n '${{ inputs.flutter-version }}' -a '${{ inputs.architecture }}' ${{ inputs.channel }}
-        key: ${{ inputs.cache-key }}-${{ inputs.channel }}-${{ inputs.flutter-version }}
+      shell: bash
-    - run: $GITHUB_ACTION_PATH/setup.sh -c "${{ inputs.cache-path }}" ${{ inputs.channel }} ${{ inputs.flutter-version }} ${{ inputs.architecture }}
+    - if: ${{ inputs.cache == 'true' }}
+      uses: actions/cache@v4
+      with:
+        path: ${{ steps.flutter-action.outputs.CACHE-PATH }}
+        key: ${{ steps.flutter-action.outputs.CACHE-KEY }}
+        restore-keys: |
+          ${{ steps.flutter-action.outputs.CACHE-KEY }}
+    - if: ${{ inputs.cache == 'true' }}
+      uses: actions/cache@v4
+      with:
+        path: ${{ steps.flutter-action.outputs.PUB-CACHE-PATH }}
+        key: ${{ steps.flutter-action.outputs.PUB-CACHE-KEY }}-${{ hashFiles('**/pubspec.lock') }}
+        restore-keys: |
+          ${{ steps.flutter-action.outputs.PUB-CACHE-KEY }}-${{ hashFiles('**/pubspec.lock') }}
+          ${{ steps.flutter-action.outputs.PUB-CACHE-KEY }}
+    - run: $GITHUB_ACTION_PATH/setup.sh -c '${{ steps.flutter-action.outputs.CACHE-PATH }}' -n '${{ steps.flutter-action.outputs.VERSION }}' -a '${{ steps.flutter-action.outputs.ARCHITECTURE }}' ${{ steps.flutter-action.outputs.CHANNEL }}
       shell: bash

setup.sh

@@ -1,122 +1,194 @@
 #!/bin/bash
 
+check_command() {
+	command -v "$1" >/dev/null 2>&1
+}
+
+if ! check_command jq; then
+	echo "jq not found, please install it, https://stedolan.github.io/jq/download/"
+	exit 1
+fi
+
 OS_NAME=$(echo "$RUNNER_OS" | awk '{print tolower($0)}')
+ARCH_NAME=$(echo "$RUNNER_ARCH" | awk '{print tolower($0)}')
 MANIFEST_BASE_URL="https://storage.googleapis.com/flutter_infra_release/releases"
-MANIFEST_URL="${MANIFEST_BASE_URL}/releases_${OS_NAME}.json"
+MANIFEST_JSON_PATH="releases_$OS_NAME.json"
+MANIFEST_URL="$MANIFEST_BASE_URL/$MANIFEST_JSON_PATH"
 
-# convert version like 2.5.x to 2.5
+filter_by_channel() {
-normalize_version() {
+	jq --arg channel "$1" '[.releases[] | select($channel == "any" or .channel == $channel)]'
-  if [[ $1 == *x ]]; then
-    echo ${1::-2}
-  else
-    echo $1
-  fi
 }
 
-latest_version() {
+filter_by_arch() {
-  jq --arg channel "$1" --arg arch "$ARCH" '.releases | map(select(.channel==$channel) | select(.dart_sdk_arch == null or .dart_sdk_arch == $arch)) | first'
+	jq --arg arch "$1" '[.[] | select(.dart_sdk_arch == $arch or ($arch == "x64" and (has("dart_sdk_arch") | not)))]'
 }
 
-wildcard_version() {
+filter_by_version() {
-  if [ $2 == *"v"* ]; then  # is legacy version format
+	jq --arg version "$1" '.[].version |= gsub("^v"; "") | (if $version == "any" then .[0] else (map(select(.version == $version or (.version | startswith(($version | sub("\\.x$"; "")) + ".")) and .version != $version)) | .[0]) end)'
-    if [[ $1 == any ]]; then
-    jq --arg version "$2" '.releases | map(select(.version | startswith($version) )) | first'
-    else
-    jq --arg channel "$1" --arg version "$2" '.releases | map(select(.channel==$channel) | select(.version | startswith($version) )) | first'
-    fi
-  elif [[ $1 == any ]]; then
-    jq --arg version "$2" --arg arch "$ARCH" '.releases | map(select(.version | startswith($version)) | select(.dart_sdk_arch == null or .dart_sdk_arch == $arch)) | first'    
-  else
-    jq --arg channel "$1" --arg version "$2" --arg arch "$ARCH" '.releases | map(select(.channel==$channel) | select(.version | startswith($version) ) | select(.dart_sdk_arch == null or .dart_sdk_arch == $arch)) | first'
-  fi
 }
 
-get_version() {
+not_found_error() {
-  if [[ $2 == any ]]; then
+	echo "Unable to determine Flutter version for channel: $1 version: $2 architecture: $3"
-    latest_version $1
-  else
-    wildcard_version $1 $2
-  fi
-}
-
-get_version_manifest() {
-  releases_manifest=$(curl --silent --connect-timeout 15 --retry 5 $MANIFEST_URL)
-  version_manifest=$(echo $releases_manifest | get_version $1 $(normalize_version $2))
-
-  if [[ $version_manifest == null ]]; then
-    # fallback through legacy version format
-    echo $releases_manifest | wildcard_version $1 "v$(normalize_version $2)"
-  else
-    echo $version_manifest
-  fi
-}
-
-download_archive() {
-  archive_url="$MANIFEST_BASE_URL/$1"
-  archive_name=$(basename $1)
-  archive_local="$RUNNER_TEMP/$archive_name"
-
-  curl --connect-timeout 15 --retry 5 $archive_url >$archive_local
-
-  # Create the target folder
-  mkdir -p "$2"
-
-  if [[ $archive_name == *zip ]]; then
-    unzip -q -o "$archive_local" -d "$RUNNER_TEMP"
-    # Remove the folder again so that the move command can do a simple rename
-    # instead of moving the content into the target folder.
-    # This is a little bit of a hack since the "mv --no-target-directory"
-    # linux option is not available here
-    rm -r "$2"
-    mv ${RUNNER_TEMP}/flutter "$2"
-  else
-    tar xf "$archive_local" -C "$2" --strip-components=1
-  fi
-
-  rm $archive_local
 }
 
 transform_path() {
-  if [[ $OS_NAME == windows ]]; then
+	if [[ "$OS_NAME" == windows ]]; then
-    echo $1 | sed -e 's/^\///' -e 's/\//\\/g'
+		echo "$1" | sed -e 's/^\///' -e 's/\//\\/g'
-  else
+	else
-    echo $1
+		echo "$1"
-  fi
+	fi
+}
+
+download_archive() {
+	archive_url="$MANIFEST_BASE_URL/$1"
+	archive_name=$(basename "$1")
+	archive_local="$RUNNER_TEMP/$archive_name"
+
+	curl --connect-timeout 15 --retry 5 "$archive_url" >"$archive_local"
+
+	mkdir -p "$2"
+
+	if [[ "$archive_name" == *zip ]]; then
+		EXTRACT_PATH="$RUNNER_TEMP/_unzip_temp"
+		unzip -q -o "$archive_local" -d "$EXTRACT_PATH"
+		# Remove the folder again so that the move command can do a simple rename\
+		# instead of moving the content into the target folder.
+		# This is a little bit of a hack since the "mv --no-target-directory"
+		# linux option is not available here
+		rm -r "$2"
+		mv "$EXTRACT_PATH"/flutter "$2"
+		rm -r "$EXTRACT_PATH"
+	else
+		tar xf "$archive_local" -C "$2" --strip-components=1
+	fi
+
+	rm "$archive_local"
 }
 
 CACHE_PATH=""
+CACHE_KEY=""
+PUB_CACHE_KEY=""
+PRINT_ONLY=""
+TEST_MODE=false
+ARCH=""
+VERSION=""
 
-while getopts 'c:' flag; do
+while getopts 'tc:k:d:pa:n:' flag; do
-  case "${flag}" in
+	case "$flag" in
-  c) CACHE_PATH="$OPTARG" ;;
+	c) CACHE_PATH="$OPTARG" ;;
-  ?) exit 2 ;;
+	k) CACHE_KEY="$OPTARG" ;;
-  esac
+	d) PUB_CACHE_KEY="$OPTARG" ;;
+	p) PRINT_ONLY=true ;;
+	t) TEST_MODE=true ;;
+	a) ARCH="$(echo "$OPTARG" | awk '{print tolower($0)}')" ;;
+	n) VERSION="$OPTARG" ;;
+	?) exit 2 ;;
+	esac
 done
 
-CHANNEL="${@:$OPTIND:1}"
+[[ -z $ARCH ]] && ARCH="$ARCH_NAME"
-VERSION="${@:$OPTIND+1:1}"
-ARCH="${@:$OPTIND+2:1}"
 
-SDK_CACHE="$(transform_path ${CACHE_PATH})"
+ARR_CHANNEL=("${@:$OPTIND:1}")
-PUB_CACHE="$(transform_path ${CACHE_PATH}/.pub-cache)"
+CHANNEL="${ARR_CHANNEL[0]}"
 
-if [[ ! -x "${SDK_CACHE}/bin/flutter" ]]; then
+[[ -z $CHANNEL ]] && CHANNEL=stable
-  if [[ $CHANNEL == master ]]; then
+[[ -z $VERSION ]] && VERSION=any
-    git clone -b master https://github.com/flutter/flutter.git "$SDK_CACHE"
+[[ -z $ARCH ]] && ARCH=x64
-  else
+[[ -z $CACHE_PATH ]] && CACHE_PATH="$RUNNER_TEMP/flutter/:channel:-:version:-:arch:"
-    VERSION_MANIFEST=$(get_version_manifest $CHANNEL $VERSION)
+[[ -z $CACHE_KEY ]] && CACHE_KEY="flutter-:os:-:channel:-:version:-:arch:-:hash:"
-    if [[ $VERSION_MANIFEST == null ]]; then
+[[ -z $PUB_CACHE_KEY ]] && PUB_CACHE_KEY="flutter-pub-:os:-:channel:-:version:-:arch:-:hash:"
-      echo "Unable to determine Flutter version for channel: $CHANNEL version: $VERSION architecture: $ARCH"
+# Here we specifically use `PUB_CACHE` (and not `PUB_CACHE_PATH`), because `PUB_CACHE` is what dart (and flutter) looks for in the environment
-      exit 1
+[[ -z $PUB_CACHE ]] && PUB_CACHE="$HOME/.pub-cache"
-     fi
+
-    ARCHIVE_PATH=$(echo $VERSION_MANIFEST | jq -r '.archive')
+if [[ "$TEST_MODE" == true ]]; then
-    download_archive "$ARCHIVE_PATH" "$SDK_CACHE"
+	RELEASE_MANIFEST=$(cat "$(dirname -- "${BASH_SOURCE[0]}")/test/$MANIFEST_JSON_PATH")
-  fi
+else
+	RELEASE_MANIFEST=$(curl --silent --connect-timeout 15 --retry 5 "$MANIFEST_URL")
 fi
 
-echo "FLUTTER_ROOT=${SDK_CACHE}" >>$GITHUB_ENV
+if [[ "$CHANNEL" == "master" || "$CHANNEL" == "main" ]]; then
-echo "PUB_CACHE=${PUB_CACHE}" >>$GITHUB_ENV
+	VERSION_MANIFEST="{\"channel\":\"$CHANNEL\",\"version\":\"$VERSION\",\"dart_sdk_arch\":\"$ARCH\",\"hash\":\"$CHANNEL\",\"sha256\":\"$CHANNEL\"}"
+else
+	VERSION_MANIFEST=$(echo "$RELEASE_MANIFEST" | filter_by_channel "$CHANNEL" | filter_by_arch "$ARCH" | filter_by_version "$VERSION")
+fi
 
-echo "${SDK_CACHE}/bin" >>$GITHUB_PATH
+if [[ "$VERSION_MANIFEST" == *null* ]]; then
-echo "${SDK_CACHE}/bin/cache/dart-sdk/bin" >>$GITHUB_PATH
+	not_found_error "$CHANNEL" "$VERSION" "$ARCH"
-echo "${PUB_CACHE}/bin" >>$GITHUB_PATH
+	exit 1
+fi
+
+expand_key() {
+	version_channel=$(echo "$VERSION_MANIFEST" | jq -r '.channel')
+	version_version=$(echo "$VERSION_MANIFEST" | jq -r '.version')
+	version_arch=$(echo "$VERSION_MANIFEST" | jq -r '.dart_sdk_arch // "x64"')
+	version_hash=$(echo "$VERSION_MANIFEST" | jq -r '.hash')
+	version_sha_256=$(echo "$VERSION_MANIFEST" | jq -r '.sha256')
+
+	expanded_key="${1/:channel:/$version_channel}"
+	expanded_key="${expanded_key/:version:/$version_version}"
+	expanded_key="${expanded_key/:arch:/$version_arch}"
+	expanded_key="${expanded_key/:hash:/$version_hash}"
+	expanded_key="${expanded_key/:sha256:/$version_sha_256}"
+	expanded_key="${expanded_key/:os:/$OS_NAME}"
+
+	echo "$expanded_key"
+}
+
+CACHE_KEY=$(expand_key "$CACHE_KEY")
+PUB_CACHE_KEY=$(expand_key "$PUB_CACHE_KEY")
+CACHE_PATH=$(expand_key "$(transform_path "$CACHE_PATH")")
+
+if [[ "$PRINT_ONLY" == true ]]; then
+	version_info=$(echo "$VERSION_MANIFEST" | jq -j '.channel,":",.version,":",.dart_sdk_arch // "x64"')
+
+	info_channel=$(echo "$version_info" | awk -F ':' '{print $1}')
+	info_version=$(echo "$version_info" | awk -F ':' '{print $2}')
+	info_architecture=$(echo "$version_info" | awk -F ':' '{print $3}')
+
+	if [[ "$TEST_MODE" == true ]]; then
+		echo "CHANNEL=$info_channel"
+		echo "VERSION=$info_version"
+		echo "ARCHITECTURE=$info_architecture"
+		echo "CACHE-KEY=$CACHE_KEY"
+		echo "CACHE-PATH=$CACHE_PATH"
+		echo "PUB-CACHE-KEY=$PUB_CACHE_KEY"
+		echo "PUB-CACHE-PATH=$PUB_CACHE"
+		exit 0
+	fi
+
+	{
+		echo "CHANNEL=$info_channel"
+		echo "VERSION=$info_version"
+		echo "ARCHITECTURE=$info_architecture"
+		echo "CACHE-KEY=$CACHE_KEY"
+		echo "CACHE-PATH=$CACHE_PATH"
+		echo "PUB-CACHE-KEY=$PUB_CACHE_KEY"
+		echo "PUB-CACHE-PATH=$PUB_CACHE"
+	} >>"$GITHUB_OUTPUT"
+
+	exit 0
+fi
+
+if [[ ! -x "$CACHE_PATH/bin/flutter" ]]; then
+	if [[ "$CHANNEL" == "master" || "$CHANNEL" == "main" ]]; then
+		git clone -b "$CHANNEL" https://github.com/flutter/flutter.git "$CACHE_PATH"
+		if [[ "$VERSION" != "any" ]]; then
+			git config --global --add safe.directory "$CACHE_PATH"
+			(cd "$CACHE_PATH" && git checkout "$VERSION")
+		fi
+	else
+		archive_url=$(echo "$VERSION_MANIFEST" | jq -r '.archive')
+		download_archive "$archive_url" "$CACHE_PATH"
+	fi
+fi
+
+{
+	echo "FLUTTER_ROOT=$CACHE_PATH"
+	echo "PUB_CACHE=$PUB_CACHE"
+} >>"$GITHUB_ENV"
+
+{
+	echo "$CACHE_PATH/bin"
+	echo "$CACHE_PATH/bin/cache/dart-sdk/bin"
+	echo "$PUB_CACHE/bin"
+} >>"$GITHUB_PATH"