chore(release): prepare for 3.41.0

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

.env.example

@@ -2,4 +2,6 @@ FLUTTER_VERSION=3.7.7
 FASTLANE_VERSION=2.213.0
 ANDROID_BUILD_TOOLS_VERSION=30.0.3
 ANDROID_PLATFORM_VERSIONS=28 31 33
-ENABLE_ANALYTICS=true
+ENABLE_ANALYTICS=true
+ANDROID_NDK_VERSION=26.3.11579264
+CMAKE_VERSION=3.22.1

.gitattributes

@@ -0,0 +1,2 @@
+# Normalize all text files to LF in repo, checkout CRLF on Windows
+* text=auto eol=lf

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,127 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at [Insert contact method].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/actions/clean-runner-disk/action.yml

@@ -0,0 +1,66 @@
+name: 'Clean Runner Disk'
+description: 'Cleans the GitHub Actions runner disk by removing unused packages and toolchains to free up space.'
+runs:
+  using: composite
+  steps:
+    - name: Show disk usage before cleaning
+      run: df -h
+      shell: bash
+    - name: List installed packages before cleaning
+      run: dpkg --get-selections | grep -v deinstall
+      shell: bash
+    - name: Clean runner disk
+      run: |
+        # Remove PHP
+        sudo apt-get remove -y 'php.*' --fix-missing || echo "::warning::The command [sudo apt-get remove -y 'php.*' --fix-missing] failed to complete successfully. Proceeding..."
+        # Remove databases
+        sudo apt-get remove -y '^mongodb-.*' --fix-missing || echo "::warning::The command [sudo apt-get remove -y '^mongodb-.*' --fix-missing] failed to complete successfully. Proceeding..."
+        sudo apt-get remove -y '^mysql-.*' --fix-missing || echo "::warning::The command [sudo apt-get remove -y '^mysql-.*' --fix-missing] failed to complete successfully. Proceeding..."
+        # Remove apt packages
+        sudo apt-get autoremove -y || echo "::warning::The command [sudo apt-get autoremove -y] failed to complete successfully. Proceeding..."
+        sudo apt-get clean || echo "::warning::The command [sudo apt-get clean] failed to complete successfully. Proceeding..."
+        # Remove Java (JDKs)
+        sudo rm -rf /usr/lib/jvm
+        # Remove .NET SDKs
+        sudo rm -rf /usr/share/dotnet
+        sudo apt-get remove -y '^aspnetcore-.*' || echo "::warning::The command [sudo apt-get remove -y '^aspnetcore-.*'] failed to complete successfully. Proceeding..."
+        sudo apt-get remove -y '^dotnet-.*' --fix-missing || echo "::warning::The command [sudo apt-get remove -y '^dotnet-.*' --fix-missing] failed to complete successfully. Proceeding..."
+        # Remove Swift toolchain
+        sudo apt-get remove -y '^llvm-.*' --fix-missing || echo "::warning::The command [sudo apt-get remove -y '^llvm-.*' --fix-missing] failed to complete successfully. Proceeding..."
+        sudo rm -rf /usr/share/swift
+        # Remove Haskell (GHC)
+        sudo rm -rf /usr/local/.ghcup
+        # Remove Julia
+        sudo rm -rf /usr/local/julia*
+        # Remove Android SDKs
+        sudo rm -rf /usr/local/lib/android
+        # Remove browsers
+        sudo apt-get remove -y google-chrome-stable firefox --fix-missing || echo "::warning::The command [sudo apt-get remove -y azure-cli google-chrome-stable firefox powershell mono-devel libgl1-mesa-dri --fix-missing] failed to complete successfully. Proceeding..."
+        sudo rm -rf /usr/local/share/chromium /opt/microsoft /opt/google
+        # Remove cloud tools
+        sudo rm -rf /opt/az
+        sudo apt-get remove -y azure-cli mono-devel libgl1-mesa-dri --fix-missing || echo "::warning::The command [sudo apt-get remove -y azure-cli google-chrome-stable firefox powershell mono-devel libgl1-mesa-dri --fix-missing] failed to complete successfully. Proceeding..."
+        sudo apt-get remove -y google-cloud-sdk --fix-missing || echo "::debug::The command [sudo apt-get remove -y google-cloud-sdk --fix-missing] failed to complete successfully. Proceeding..."
+        sudo apt-get remove -y google-cloud-cli --fix-missing || echo "::debug::The command [sudo apt-get remove -y google-cloud-cli --fix-missing] failed to complete successfully. Proceeding..."
+        # Remove PowerShell
+        sudo apt-get remove -y powershell --fix-missing || echo "::warning::The command [sudo apt-get remove -y azure-cli google-chrome-stable firefox powershell mono-devel libgl1-mesa-dri --fix-missing] failed to complete successfully. Proceeding..."
+        sudo rm -rf /usr/local/share/powershell
+        # Remove CodeQL and other toolcaches
+        sudo rm -rf /opt/hostedtoolcache
+        # Remove Kubernetes
+        sudo rm -rf /usr/local/bin/minikube
+        # Remove Rust
+        sudo rm -rf /home/runner/.rustup /etc/skel/.rustup
+      shell: bash
+    - name: Show disk usage after cleaning
+      run: df -h
+      shell: bash
+    - name: Top-level directories after cleaning
+      run: du -h -d1 / | sort -hr | head -n 20 || true
+      shell: bash
+    - name: Detailed file sizes after cleaning
+      run: find / -type f -exec du -h {} + 2>/dev/null | sort -hr | head -n 1000 || true
+      shell: bash
+    - name: List installed packages after cleaning
+      run: dpkg --get-selections | grep -v deinstall
+      shell: bash

.github/renovate.json

@@ -9,13 +9,13 @@
   ],
   "packageRules": [
     {
+      "description": "Schedule Github Actions updates on the first day of the month",
       "groupName": "github-actions",
-      "matchUpdateTypes": [
-        "major",
-        "minor"
-      ],
       "matchDatasources": [
         "github-tags"
+      ],
+      "schedule": [
+        "* 0-3 1 * *"
       ]
     }
   ],
@@ -26,7 +26,7 @@
         "^Dockerfile$"
       ],
       "matchStrings": [
-        "#\\s*renovate:\\s*release=(?<release>.*?) depName=(?<depName>.*?)\\sARG .*?_VERSION=\"(?<currentValue>.*)\"\\s"
+        "#\\s*renovate:\\s*suite=(?<suite>.*?) depName=(?<depName>.*?)\\sARG .*?_VERSION=\"(?<currentValue>.*)\"\\s"
       ],
       "registryUrlTemplate": "https://deb.debian.org/debian?{{#if release }}release={{release}}{{else}}suite=stable{{/if}}&components=main,contrib,non-free&binaryArch=amd64",
       "datasourceTemplate": "deb"

.github/workflows/build.yml

@@ -18,55 +18,51 @@ jobs:
       # Allow to write pull requests for the docker/scout-action to write a comment
       pull-requests: write
       # Allow to write security events for github/codeql-action/upload-sarif to upload SARIF results
-      security-events: write 
+      security-events: write
     runs-on: ubuntu-24.04
     env:
       IMAGE_REPOSITORY_NAME: flutter-android
       VERSION_MANIFEST: config/version.json
     steps:
       - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
 
-      - name: Login to Docker Hub
-        uses: docker/login-action@9780b0c442fbb1117ed29e0efdff1e18412f7567 # v3.3.0
-        with:
-          username: ${{ secrets.DOCKER_HUB_USERNAME }}
-          password: ${{ secrets.DOCKER_HUB_TOKEN }}
- 
-      - name: Login to GitHub Container Registry
-        uses: docker/login-action@9780b0c442fbb1117ed29e0efdff1e18412f7567 # v3.3.0
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ github.token }}
-
-      - name: Setup CUE
-        uses: cue-lang/setup-cue@a93fa358375740cd8b0078f76355512b9208acb1 # v1.0.1
-
-      - name: Read environment variables from version.json with CUE
+      - name: Read environment variables from the version manifest
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         env:
           GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
           IMAGE_REPOSITORY_NAME: ${{ env.IMAGE_REPOSITORY_NAME }}
           VERSION_MANIFEST: ${{ env.VERSION_MANIFEST }}
-        run: ./script/set_environment_variables.sh
+        with:
+          script: |
+            const script = require('./script/setEnvironmentVariables.js')
+            return await script({ core })
+
+      - name: Clean runner disk
+        uses: ./.github/actions/clean-runner-disk
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435 # v3.11.1
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        with:
+          username: ${{ secrets.DOCKER_HUB_USERNAME }}
+          password: ${{ secrets.DOCKER_HUB_TOKEN }}
 
       - name: Load image metadata
-        uses: docker/metadata-action@902fa8ec7d6ecbf8d84d538b9b233a880e428804 # v5.7.0
+        uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5.10.0
         id: metadata
         with:
           images: |
             ${{ env.IMAGE_REPOSITORY_PATH }}
-            ghcr.io/${{ env.IMAGE_REPOSITORY_PATH }}
-            quay.io/${{ env.IMAGE_REPOSITORY_PATH }}
           tags: |
             type=raw,value=${{ env.FLUTTER_VERSION }}
 
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@b5ca514318bd6ebac0fb2aedd5d36ec1b5c232a2 # v3.10.0
-
       - name: Build image and push to local Docker daemon
-        uses: docker/build-push-action@471d1dc4e07e5cdedd4c2171150001c434f0b7a4 # v6.15.0
+        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83 # v6.18.0
         with:
+          file: android.Dockerfile
           load: true
           cache-from: type=gha
           cache-to: type=gha,mode=max
@@ -90,7 +86,7 @@ jobs:
       # TODO: Parallelize testing and vulnerability scanning
       - name: Scan with Docker Scout
         id: docker-scout
-        uses: docker/scout-action@0133ff88fe16d4a412dc4827a8fccbccb6b583e0 # v1.16.3
+        uses: docker/scout-action@f8c776824083494ab0d56b8105ba2ca85c86e4de # v1.18.2
         with:
           command: compare, recommendations
           # Use the Docker Hub image that is the first tag in the metadata
@@ -105,14 +101,18 @@ jobs:
           # debug: true
           # verbose-debug: true
 
-  validate_version:
+  validate_version_files:
     runs-on: ubuntu-24.04
     steps:
       - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
 
       - name: Setup CUE
-        uses: cue-lang/setup-cue@a93fa358375740cd8b0078f76355512b9208acb1 # v1.0.1
+        uses: jaxxstorm/action-install-gh-release@6096f2a2bbfee498ced520b6922ac2c06e990ed2 # v2.1.0
+        with:
+          repo: cue-lang/cue
+          tag: v0.15.0
+          digest: 06925fc1e5174591cef0b1e42ac32cff4271804742cd20893de1793b6d82d460
 
       - name: Validate version.json and flutter_version.json with CUE
         run: |
@@ -123,10 +123,14 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
 
       - name: Setup CUE
-        uses: cue-lang/setup-cue@a93fa358375740cd8b0078f76355512b9208acb1 # v1.0.1
+        uses: jaxxstorm/action-install-gh-release@6096f2a2bbfee498ced520b6922ac2c06e990ed2 # v2.1.0
+        with:
+          repo: cue-lang/cue
+          tag: v0.15.0
+          digest: 06925fc1e5174591cef0b1e42ac32cff4271804742cd20893de1793b6d82d460
 
       - name: Generate test files with CUE
         run: |
@@ -141,14 +145,25 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
-      
-      - name: Setup NodeJS
-        uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a # v4.2.0
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
         with:
-          cache: 'npm'
+          ref: ${{ github.head_ref }}
+
+      - name: Setup NodeJS
+        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        with:
+          cache: npm
           cache-dependency-path: docs/src/package-lock.json
-          node-version-file: docs/src/package.json
+          node-version: lts/*
+
+      - name: Generate authentication token with GitHub App to trigger Actions
+        uses: actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf # v2.2.1
+        id: app-token
+        with:
+          app-id: ${{ secrets.VERIFIED_COMMIT_ID }}
+          private-key: ${{ secrets.VERIFIED_COMMIT_KEY }}
+          repositories: ${{ github.event.repository.name }}
+          owner: ${{ github.repository_owner }}
 
       - name: Update documentation
         working-directory: docs/src
@@ -156,10 +171,13 @@ jobs:
           npm ci --prefer-offline
           npm run build
 
-      - name: Check if there are any changes in the git working tree
-        run: |
-          git add -A  
-          git diff --exit-code HEAD
+      - name: Commit and push documentation
+        uses: grafana/github-api-commit-action@b1d81091e8480dd11fcea8bc1f0ab977a0376ca5 # v1.0.0
+        with:
+          commit-message: 'docs: generate documentation files'
+          success-if-no-changes: true
+          stage-all-files: true
+          token: ${{ steps.app-token.outputs.token }}
 
   test_gradle:
     permissions:
@@ -173,13 +191,13 @@ jobs:
         password: ${{ github.token }}
     steps:
       - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
 
       - name: Read version.json
         id: version-json
         run: |
           {
-            echo "content<<EOF" 
+            echo "content<<EOF"
             cat ./config/version.json
             echo "EOF"
           } >> $GITHUB_OUTPUT
@@ -206,7 +224,11 @@ jobs:
           ./gradlew --warning-mode all updateAndroidVersions
 
       - name: Setup CUE
-        uses: cue-lang/setup-cue@a93fa358375740cd8b0078f76355512b9208acb1 # v1.0.1
+        uses: jaxxstorm/action-install-gh-release@6096f2a2bbfee498ced520b6922ac2c06e990ed2 # v2.1.0
+        with:
+          repo: cue-lang/cue
+          tag: v0.15.0
+          digest: 06925fc1e5174591cef0b1e42ac32cff4271804742cd20893de1793b6d82d460
 
       - name: Validate version.json with CUE
         run: cue vet config/version.cue -d '#Version' config/version.json

.github/workflows/changelog.yml

@@ -0,0 +1,61 @@
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - config/version.json
+  workflow_dispatch:
+
+jobs:
+  changelog:
+    runs-on: ubuntu-24.04
+    env:
+      IMAGE_REPOSITORY_NAME: flutter-android
+      VERSION_MANIFEST: config/version.json
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          # TODO: Fetch only a few commits after using --unreleased in git-cliff
+          # Fetch all commits to use as input for the changelog generation
+          fetch-depth: 0
+          # Fetch all tags to use as input for the changelog generation
+          fetch-tags: true
+      
+      - name: Setup git-cliff
+        uses: jaxxstorm/action-install-gh-release@6096f2a2bbfee498ced520b6922ac2c06e990ed2 # v2.1.0
+        with:
+          repo: orhun/git-cliff
+          tag: v2.10.1
+          digest: 6abe8a3e112b266dd00abf9089a8052ddf7314f39e1c53e192edf0652abca4eb
+
+      - name: Read environment variables from the version manifest
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        env:
+          GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
+          IMAGE_REPOSITORY_NAME: ${{ env.IMAGE_REPOSITORY_NAME }}
+          VERSION_MANIFEST: ${{ env.VERSION_MANIFEST }}
+        with:
+          script: |
+            const script = require('./script/setEnvironmentVariables.js')
+            return await script({ core })
+      
+      - name: Update changelog
+        run: |
+          git-cliff -v --tag ${{ env.FLUTTER_VERSION }} --github-repo ${{ github.repository }} --output changelog.md
+      
+      - name: Generate authentication token with GitHub App to trigger Actions
+        uses: actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf # v2.2.1
+        id: app-token
+        with:
+          app-id: ${{ secrets.VERIFIED_COMMIT_ID }}
+          private-key: ${{ secrets.VERIFIED_COMMIT_KEY }}
+          repositories: ${{ github.event.repository.name }}
+          owner: ${{ github.repository_owner }}
+
+      - name: Commit and push changelog
+        uses: grafana/github-api-commit-action@b1d81091e8480dd11fcea8bc1f0ab977a0376ca5 # v1.0.0
+        with:
+          commit-message: "chore(release): prepare for ${{ env.FLUTTER_VERSION }}"
+          stage-all-files: true
+          token: ${{ steps.app-token.outputs.token }}

.github/workflows/ci.yml

@@ -2,6 +2,8 @@ on:
   push:
     branches:
       - main
+    paths-ignore:
+      - changelog.md
   workflow_dispatch:
 
 # Read-only permissions by default
@@ -19,55 +21,51 @@ jobs:
       ANDROID_BUILD_TOOLS_VERSION: 30.0.3
     steps:
       - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
 
       - name: Login to Docker Hub
-        uses: docker/login-action@9780b0c442fbb1117ed29e0efdff1e18412f7567 # v3.3.0
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
         with:
           username: ${{ secrets.DOCKER_HUB_USERNAME }}
           password: ${{ secrets.DOCKER_HUB_TOKEN }}
 
-      - name: Login to GitHub Container Registry
-        uses: docker/login-action@9780b0c442fbb1117ed29e0efdff1e18412f7567 # v3.3.0
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ github.token }}
-
-      - name: Login to Quay.io
-        uses: docker/login-action@9780b0c442fbb1117ed29e0efdff1e18412f7567 # v3.3.0
-        with:
-          registry: quay.io
-          username: ${{ secrets.QUAY_USERNAME }}
-          password: ${{ secrets.QUAY_ROBOT_TOKEN }}
-
       - name: Setup CUE
-        uses: cue-lang/setup-cue@a93fa358375740cd8b0078f76355512b9208acb1 # v1.0.1
+        uses: jaxxstorm/action-install-gh-release@6096f2a2bbfee498ced520b6922ac2c06e990ed2 # v2.1.0
+        with:
+          repo: cue-lang/cue
+          tag: v0.15.0
+          digest: 06925fc1e5174591cef0b1e42ac32cff4271804742cd20893de1793b6d82d460
 
-      - name: Read environment variables from version.json with CUE
+      - name: Read environment variables from the version manifest
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         env:
           GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
           IMAGE_REPOSITORY_NAME: ${{ env.IMAGE_REPOSITORY_NAME }}
           VERSION_MANIFEST: ${{ env.VERSION_MANIFEST }}
-        run: ./script/set_environment_variables.sh
+        with:
+          script: |
+            const script = require('./script/setEnvironmentVariables.js')
+            return await script({ core })
+
+      - name: Clean runner disk
+        uses: ./.github/actions/clean-runner-disk
 
       - name: Load image metadata
-        uses: docker/metadata-action@902fa8ec7d6ecbf8d84d538b9b233a880e428804 # v5.7.0
+        uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5.10.0
         id: metadata
         with:
           images: |
             ${{ env.IMAGE_REPOSITORY_PATH }}
-            ghcr.io/${{ env.IMAGE_REPOSITORY_PATH }}
-            quay.io/${{ env.IMAGE_REPOSITORY_PATH }}
           tags: |
             type=raw,value=${{ env.FLUTTER_VERSION }}
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@b5ca514318bd6ebac0fb2aedd5d36ec1b5c232a2 # v3.10.0
+        uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435 # v3.11.1
 
       - name: Build image and push to local Docker daemon
-        uses: docker/build-push-action@471d1dc4e07e5cdedd4c2171150001c434f0b7a4 # v6.15.0
+        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83 # v6.18.0
         with:
+          file: android.Dockerfile
           load: true
           cache-from: type=gha
           cache-to: type=gha,mode=max
@@ -87,41 +85,3 @@ jobs:
         with:
           image: ${{ fromJSON(steps.metadata.outputs.json).tags[0] }}
           config: test/android.yml
-
-  create_git_tag:
-    permissions:
-      # Allow to write contents to push tags
-      contents: write
-    needs: test_image
-    runs-on: ubuntu-24.04
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
-
-      - name: Generate authentication token with GitHub App to trigger Actions
-        uses: actions/create-github-app-token@21cfef2b496dd8ef5b904c159339626a10ad380e # v1.11.6
-        id: generate-token
-        with:
-          app-id: ${{ secrets.VERIFIED_COMMIT_ID }}
-          private-key: ${{ secrets.VERIFIED_COMMIT_KEY }}
-
-      - name: Setup CUE
-        uses: cue-lang/setup-cue@a93fa358375740cd8b0078f76355512b9208acb1 # v1.0.1
-
-      - name: Read environment variables from version.json with CUE
-        env:
-          GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
-          IMAGE_REPOSITORY_NAME: ${{ env.IMAGE_REPOSITORY_NAME }}
-          VERSION_MANIFEST: ${{ env.VERSION_MANIFEST }}
-        run: ./script/set_environment_variables.sh
-      
-      - name: Create Tag for a New Flutter Version
-        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
-        env:
-          OLD_FLUTTER_VERSION: ${{ vars.FLUTTER_VERSION }}
-          NEW_FLUTTER_VERSION: ${{ env.FLUTTER_VERSION }}
-        with:
-          github-token: ${{ steps.generate-token.outputs.token }}
-          script: |
-            const script = require('./script/createGitTag.js')
-            await script({ core, context, github })

.github/workflows/release.yml

@@ -1,20 +1,21 @@
 on:
   push:
     tags:
-    - '*'
+      - '*'
   workflow_dispatch:
 
 # Read-only permissions by default
 permissions:
   contents: read
 
+env:
+  FLUTTER_VERSION: ${{ github.ref_name }}
+
 jobs:
   release_android:
     permissions:
       # Allow to write packages to push the container image to the Github Container Registry
       packages: write
-      # Allow to write security events to upload the results to code-scanning dashboard.
-      security-events: write
     runs-on: ubuntu-24.04
     env:
       IMAGE_REPOSITORY_NAME: flutter-android
@@ -22,47 +23,21 @@ jobs:
       VERSION_MANIFEST: config/version.json
     steps:
       - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
 
-      - name: Generate authentication token with GitHub App
-        uses: actions/create-github-app-token@21cfef2b496dd8ef5b904c159339626a10ad380e # v1.11.6
-        id: generate-token
-        with:
-          app-id: ${{ secrets.VERIFIED_COMMIT_ID }}
-          private-key: ${{ secrets.VERIFIED_COMMIT_KEY }}
-
-      - name: Login to Docker Hub
-        uses: docker/login-action@9780b0c442fbb1117ed29e0efdff1e18412f7567 # v3.3.0
-        with:
-          username: ${{ secrets.DOCKER_HUB_USERNAME }}
-          password: ${{ secrets.DOCKER_HUB_TOKEN }}
-
-      - name: Login to GitHub Container Registry
-        uses: docker/login-action@9780b0c442fbb1117ed29e0efdff1e18412f7567 # v3.3.0
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ github.token }}
-
-      - name: Login to Quay.io
-        uses: docker/login-action@9780b0c442fbb1117ed29e0efdff1e18412f7567 # v3.3.0
-        with:
-          registry: quay.io
-          username: ${{ secrets.QUAY_USERNAME }}
-          password: ${{ secrets.QUAY_ROBOT_TOKEN }}
-
-      - name: Setup CUE
-        uses: cue-lang/setup-cue@a93fa358375740cd8b0078f76355512b9208acb1 # v1.0.1
-
-      - name: Read environment variables from version.json with CUE
+      - name: Read environment variables from the version manifest
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         env:
           GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
           IMAGE_REPOSITORY_NAME: ${{ env.IMAGE_REPOSITORY_NAME }}
           VERSION_MANIFEST: ${{ env.VERSION_MANIFEST }}
-        run: ./script/set_environment_variables.sh
+        with:
+          script: |
+            const script = require('./script/setEnvironmentVariables.js')
+            return await script({ core })
 
       - name: Load image metadata
-        uses: docker/metadata-action@902fa8ec7d6ecbf8d84d538b9b233a880e428804 # v5.7.0
+        uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5.10.0
         id: metadata
         with:
           images: |
@@ -73,11 +48,32 @@ jobs:
             type=raw,value=${{ env.FLUTTER_VERSION }}
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@b5ca514318bd6ebac0fb2aedd5d36ec1b5c232a2 # v3.10.0
+        uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435 # v3.11.1
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        with:
+          username: ${{ secrets.DOCKER_HUB_USERNAME }}
+          password: ${{ secrets.DOCKER_HUB_TOKEN }}
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ github.token }}
+
+      - name: Login to Quay.io
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        with:
+          registry: quay.io
+          username: ${{ secrets.QUAY_USERNAME }}
+          password: ${{ secrets.QUAY_ROBOT_TOKEN }}
 
       - name: Build image and push it to registries
-        uses: docker/build-push-action@471d1dc4e07e5cdedd4c2171150001c434f0b7a4 # v6.15.0
+        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83 # v6.18.0
         with:
+          file: android.Dockerfile
           push: true
           cache-from: type=gha
           cache-to: type=gha,mode=max
@@ -92,8 +88,29 @@ jobs:
             android_ndk_version=${{ env.ANDROID_NDK_VERSION }}
             cmake_version=${{ env.CMAKE_VERSION }}
 
+  update_description:
+    runs-on: ubuntu-24.04
+    needs: release_android
+    env:
+      IMAGE_REPOSITORY_NAME: flutter-android
+      VERSION_MANIFEST: config/version.json
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Read environment variables from the version manifest
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        env:
+          GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
+          IMAGE_REPOSITORY_NAME: ${{ env.IMAGE_REPOSITORY_NAME }}
+          VERSION_MANIFEST: ${{ env.VERSION_MANIFEST }}
+        with:
+          script: |
+            const script = require('./script/setEnvironmentVariables.js')
+            return await script({ core })
+
       - name: Update Docker Hub description
-        uses: peter-evans/dockerhub-description@e98e4d1628a5f3be2be7c231e50981aee98723ae # v4.0.0
+        uses: peter-evans/dockerhub-description@1b9a80c056b620d92cedb9d9b5a223409c68ddfa # v5.0.0
         with:
           username: ${{ secrets.DOCKER_HUB_USERNAME }}
           password: ${{ secrets.DOCKER_HUB_TOKEN }}
@@ -101,54 +118,98 @@ jobs:
           short-description: ${{ github.event.repository.description }}
           readme-filepath: readme.md
 
+  record_image:
+    permissions:
+      # Allow to write code scanning results to GitHub's code scanning dashboard
+      security-events: write
+    runs-on: ubuntu-24.04
+    needs: release_android
+    env:
+      IMAGE_REPOSITORY_NAME: flutter-android
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        with:
+          username: ${{ secrets.DOCKER_HUB_USERNAME }}
+          password: ${{ secrets.DOCKER_HUB_TOKEN }}
+
       - name: Record image in Docker Scout environment
-        id: docker-scout-environment
-        uses: docker/scout-action@0133ff88fe16d4a412dc4827a8fccbccb6b583e0 # v1.16.3
+        uses: docker/scout-action@f8c776824083494ab0d56b8105ba2ca85c86e4de # v1.18.2
         with:
           command: environment, cves
-          # Use the Docker Hub image that is the first tag in the metadata
-          image: registry://${{ fromJson(steps.metadata.outputs.json).tags[0] }}
+          image: registry://${{ github.repository_owner }}/${{ env.IMAGE_REPOSITORY_NAME }}:${{ env.FLUTTER_VERSION }}
           environment: prod
           only-fixed: true
           organization: ${{ secrets.DOCKER_HUB_USERNAME }}
           sarif-file: sarif.json
-      
-      - name: Update bootstrap image tag in environment variable
-        run: gh variable set FLUTTER_VERSION --body "${{ env.FLUTTER_VERSION }}"
-        env:
-          GH_TOKEN: ${{ steps.generate-token.outputs.token }}
 
-      # Upload the results to GitHub's code scanning dashboard (optional).
-      # Commenting out will disable upload of results to your repo's Code Scanning dashboard
-      - name: Upload to code-scanning
-        uses: github/codeql-action/upload-sarif@b56ba49b26e50535fa1e7f7db0f4f7b4bf65d80d # v3.28.10
+      - name: Upload the results to GitHub's code scanning dashboard
+        uses: github/codeql-action/upload-sarif@cf1bb45a277cb3c205638b2cd5c984db1c46a412 # v4.31.7
         with:
           sarif_file: sarif.json
 
-      # TODO: Use kaniko for building and pushing after slowness is solved
-      # TODO: https://github.com/GoogleContainerTools/kaniko/issues/970
-      # TODO: https://github.com/GoogleContainerTools/kaniko/issues/875
-      # TODO: Use kaniko for building and pushing after pushing to Docker daemon is solved, to be able to test Docker image, with the following issues
-      # TODO: https://github.com/GoogleContainerTools/kaniko/issues/1331
-      # - name: Build image and push it to registries
-      #   uses: int128/kaniko-action@v1
-      #   with:
-      #     push: true
-      #     cache: true
-      #     cache-repository: ${{ steps.ecr-cache.outputs.repository-uri }}
-      #     tags: ${{ steps.metadata.outputs.tags }}
-      #     labels: ${{ steps.metadata.outputs.labels }}
-      #     build-args: |
-      #       flutter_version=${{ env.FLUTTER_VERSION }}
-      #       android_build_tools_version=${{ env.ANDROID_BUILD_TOOLS_VERSION }}
-      #       android_platform_versions=${{ env.ANDROID_PLATFORM_VERSIONS }}
-      #     kaniko-args: |
-      #       --skip-unused-stages=true
-      #       --use-new-run=true
-      #       --snapshotMode=redo
-      #     target: android
-      #     executor: gcr.io/kaniko-project/executor:latest
-# TODO: https://github.com/snok/container-retention-policy
-# TODO: Push a build image before the final image
-# TODO: Run basic tests with build image
-# TODO: Push final image only if tests pass https://redhat-cop.github.io/ci/publishing-images.html
+  set_bootstrap_image:
+    runs-on: ubuntu-24.04
+    needs: release_android
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Generate authentication token with GitHub App to trigger Actions
+        uses: actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf # v2.2.1
+        id: app-token
+        with:
+          app-id: ${{ secrets.VERIFIED_COMMIT_ID }}
+          private-key: ${{ secrets.VERIFIED_COMMIT_KEY }}
+          repositories: ${{ github.event.repository.name }}
+          owner: ${{ github.repository_owner }}
+
+      - name: Update bootstrap image tag in environment variable
+        run: gh variable set FLUTTER_VERSION --body "${{ env.FLUTTER_VERSION }}"
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+
+  create_github_release:
+    permissions:
+      # Allow to create releases and upload assets to them
+      contents: write
+    runs-on: ubuntu-24.04
+    needs: release_android
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          # TODO: Fetch only a few commits after using --unreleased in git-cliff
+          # Fetch all commits to use as input for the changelog generation
+          fetch-depth: 0
+          # Fetch all tags to use as input for the changelog generation
+          fetch-tags: true
+
+      - name: Setup git-cliff
+        uses: jaxxstorm/action-install-gh-release@6096f2a2bbfee498ced520b6922ac2c06e990ed2 # v2.1.0
+        with:
+          repo: orhun/git-cliff
+          tag: v2.10.1
+          digest: 6abe8a3e112b266dd00abf9089a8052ddf7314f39e1c53e192edf0652abca4eb
+
+      - name: Get the tag details
+        id: get-tag-details
+        run: |-
+          # Store the changelog in a temporary directory to not pollute the working directory
+          mkdir -p "${{ runner.temp }}/git-cliff"
+          changelog_file="${{ runner.temp }}/git-cliff/changelog.md"
+          echo "changelog_file=${changelog_file}" >>$GITHUB_OUTPUT
+
+          git-cliff -v --latest --strip all --no-exec --github-repo "${{ github.repository }}" --output "$changelog_file"
+
+      - name: Create Github release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |-
+          gh release create "${{ env.FLUTTER_VERSION }}" \
+            --title="${{ env.FLUTTER_VERSION }}" \
+            --notes-file="${{ steps.get-tag-details.outputs.changelog_file }}"

.github/workflows/scorecard.yml

@@ -34,12 +34,12 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
         with:
           persist-credentials: false
 
       - name: Run analysis
-        uses: ossf/scorecard-action@f49aabe0b5af0936a0987cfb85d86b75731b0186 # v2.4.1
+        uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3
         with:
           results_file: results.sarif
           results_format: sarif
@@ -61,7 +61,7 @@ jobs:
       # Upload the results as artifacts (optional). Commenting out will disable uploads of run results in SARIF
       # format to the repository Actions tab.
       - name: Upload artifact
-        uses: actions/upload-artifact@4cec3d8aa04e39d1a68397de0c4cd6fb9dce8ec1 # v4.6.1
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
         with:
           name: SARIF file
           path: results.sarif
@@ -70,6 +70,6 @@ jobs:
       # Upload the results to GitHub's code scanning dashboard (optional).
       # Commenting out will disable upload of results to your repo's Code Scanning dashboard
       - name: Upload to code-scanning
-        uses: github/codeql-action/upload-sarif@b56ba49b26e50535fa1e7f7db0f4f7b4bf65d80d # v3.28.10
+        uses: github/codeql-action/upload-sarif@cf1bb45a277cb3c205638b2cd5c984db1c46a412 # v4.31.7
         with:
           sarif_file: results.sarif

.github/workflows/tag.yml

@@ -0,0 +1,48 @@
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - changelog.md
+  workflow_dispatch:
+
+jobs:
+  create_git_tag:
+    runs-on: ubuntu-24.04
+    env:
+      IMAGE_REPOSITORY_NAME: flutter-android
+      VERSION_MANIFEST: config/version.json
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Generate authentication token with GitHub App to trigger Actions
+        uses: actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf # v2.2.1
+        id: app-token
+        with:
+          app-id: ${{ secrets.VERIFIED_COMMIT_ID }}
+          private-key: ${{ secrets.VERIFIED_COMMIT_KEY }}
+          repositories: ${{ github.event.repository.name }}
+          owner: ${{ github.repository_owner }}
+
+      - name: Read environment variables from the version manifest
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        env:
+          GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
+          IMAGE_REPOSITORY_NAME: ${{ env.IMAGE_REPOSITORY_NAME }}
+          VERSION_MANIFEST: ${{ env.VERSION_MANIFEST }}
+        with:
+          script: |
+            const script = require('./script/setEnvironmentVariables.js')
+            return await script({ core })
+      
+      - name: Create Tag for a New Flutter Version
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        env:
+          OLD_FLUTTER_VERSION: ${{ vars.FLUTTER_VERSION }}
+          NEW_FLUTTER_VERSION: ${{ env.FLUTTER_VERSION }}
+        with:
+          github-token: ${{ steps.app-token.outputs.token }}
+          script: |
+            const script = require('./script/createGitTag.js')
+            await script({ core, context, github })

.github/workflows/update_flutter_dependencies.yml

@@ -1,107 +0,0 @@
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - .github/workflows/update_flutter_dependencies.yml
-      - config/flutter_version.json
-  workflow_dispatch:
-
-# Declare default permissions as read only.
-permissions:
-  contents: read
-
-jobs:
-  update_version:
-    permissions:
-      # Allow to write contents to push commits
-      contents: write
-      # Allow to read packages to pull the container image from GitHub Container Registry
-      packages: read
-      # Allow to write pull requests to create a pull request
-      pull-requests: write
-    runs-on: ubuntu-24.04
-    container:
-      image: ghcr.io/${{ github.repository_owner }}/flutter-android:${{ vars.FLUTTER_VERSION }}
-      credentials:
-        username: ${{ github.actor }}
-        password: ${{ github.token }}
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
-
-      - name: Generate authentication token with GitHub App to trigger Actions
-        uses: actions/create-github-app-token@21cfef2b496dd8ef5b904c159339626a10ad380e # v1.11.6
-        id: generate-token
-        with:
-          app-id: ${{ secrets.VERIFIED_COMMIT_ID }}
-          private-key: ${{ secrets.VERIFIED_COMMIT_KEY }}
-
-      - name: Copy Flutter version into version manifest and export FLUTTER_* environment variables
-        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
-        with:
-          script: |
-            const script = require('./script/copyFlutterVersion.js')
-            await script({core})
-
-      - name: Update latest Fastlane version
-        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
-        with:
-          script: |
-            const script = require('./script/updateFastlaneVersion.js')
-            await script({core, fetch})
-
-      - name: Setup Flutter
-        run: |
-          cd $FLUTTER_ROOT
-          git fetch origin ${{ env.FLUTTER_VERSION }}:${{ env.FLUTTER_VERSION }}
-          git switch --discard-changes ${{ env.FLUTTER_VERSION }}
-
-      # TODO: Create test app in specific folder with step id, to allow parallel execution
-      - name: Create test application
-        run: |
-          flutter create test_app
-
-      # TODO: Cache gradle https://github.com/gradle/gradle-build-action
-      - name: Update default Android platform versions in Flutter
-        working-directory: test_app/android
-        run: |
-          cat ../../script/updateAndroidVersions.gradle.kts >> app/build.gradle.kts
-          ./gradlew --warning-mode all updateAndroidVersions
-
-      - name: Clean test application
-        run: |
-          rm -rf test_app
-
-      - name: Setup CUE
-        uses: cue-lang/setup-cue@a93fa358375740cd8b0078f76355512b9208acb1 # v1.0.1
-
-      - name: Validate version.json with CUE
-        run: cue vet config/version.cue -d '#Version' config/version.json
-
-      - name: Setup NodeJS
-        uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a # v4.2.0
-        with:
-          cache: 'npm'
-          cache-dependency-path: docs/src/package-lock.json
-          node-version-file: docs/src/package.json
-
-      - name: Update documentation
-        working-directory: docs/src
-        run: |
-          npm ci --prefer-offline
-          npm run build
-
-      - name: Create commit message variable
-        run: |
-          echo "COMMIT_MESSAGE=chore: update flutter dependencies in version.json for ${{ env.FLUTTER_VERSION }}" >> $GITHUB_ENV
-
-      # TODO: Generate changelog for the new flutter version, that will be the new tag
-      - name: Create pull request if there are changes
-        uses: peter-evans/create-pull-request@dd2324fc52d5d43c699a5636bcf19fceaa70c284 # v7.0.7
-        with:
-          commit-message: ${{ env.COMMIT_MESSAGE }}
-          branch: update-flutter-dependencies/${{ env.FLUTTER_VERSION }}
-          sign-commits: true
-          title: ${{ env.COMMIT_MESSAGE }}
-          token: ${{ steps.generate-token.outputs.token }}

.github/workflows/update_flutter_version.yml

@@ -1,53 +0,0 @@
-on:
-  schedule:
-    - cron: '0 0 * * MON-FRI'
-  workflow_dispatch:
-
-# Declare default permissions as read only.
-permissions:
-  contents: read
-
-jobs:
-  update_flutter_version:
-    permissions:
-      # Allow to write contents to push commits
-      contents: write
-      # Allow to write pull requests to push commits and write comments
-      pull-requests: write
-    runs-on: ubuntu-24.04
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
-
-      - name: Generate authentication token with GitHub App to trigger Actions
-        uses: actions/create-github-app-token@21cfef2b496dd8ef5b904c159339626a10ad380e # v1.11.6
-        id: generate-token
-        with:
-          app-id: ${{ secrets.VERIFIED_COMMIT_ID }}
-          private-key: ${{ secrets.VERIFIED_COMMIT_KEY }}
-
-      - name: Update latest Flutter version
-        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
-        with:
-          script: |
-            const script = require('./script/updateFlutterVersion.js')
-            await script({core, fetch})
-
-      - name: Setup CUE
-        uses: cue-lang/setup-cue@a93fa358375740cd8b0078f76355512b9208acb1 # v1.0.1
-
-      - name: Validate version.json with CUE
-        run: cue vet config/version.cue -d '#FlutterVersion' config/flutter_version.json
-
-      - name: Create commit message variable
-        run: |
-          echo "COMMIT_MESSAGE=chore: update flutter version in flutter_version.json to ${{ env.FLUTTER_VERSION }}" >> $GITHUB_ENV
-
-      - name: Create pull request if there are changes
-        uses: peter-evans/create-pull-request@dd2324fc52d5d43c699a5636bcf19fceaa70c284 # v7.0.7
-        with:
-          commit-message: ${{ env.COMMIT_MESSAGE }}
-          branch: update-flutter-version/${{ env.FLUTTER_VERSION }}
-          sign-commits: true
-          title: ${{ env.COMMIT_MESSAGE }}
-          token: ${{ steps.generate-token.outputs.token }}

.github/workflows/update_version.yml

@@ -0,0 +1,260 @@
+on:
+  schedule:
+    - cron: '0 0 * * MON-FRI'
+  workflow_dispatch:
+
+# Declare default permissions as read only.
+permissions:
+  contents: read
+
+jobs:
+  update_flutter_version:
+    permissions:
+      # Allow to write contents to push commits
+      contents: write
+      # Allow to write pull requests to push commits and write comments
+      pull-requests: write
+    runs-on: ubuntu-24.04
+    outputs:
+      new_version: ${{ steps.update_flutter_version.outputs.result }}
+      flutter_version_artifact_id: ${{ steps.upload-version.outputs.artifact-id }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Update latest Flutter version
+        id: update_flutter_version
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        with:
+          script: |
+            const script = require('./script/updateFlutterVersion.js')
+            return await script({core, fetch})
+
+      - name: Setup CUE
+        if: ${{ steps.update_flutter_version.outputs.result == 'true' }}
+        uses: jaxxstorm/action-install-gh-release@6096f2a2bbfee498ced520b6922ac2c06e990ed2 # v2.1.0
+        with:
+          repo: cue-lang/cue
+          tag: v0.15.0
+          digest: 06925fc1e5174591cef0b1e42ac32cff4271804742cd20893de1793b6d82d460
+
+      - name: Validate version.json with CUE
+        if: ${{ steps.update_flutter_version.outputs.result == 'true' }}
+        run: cue vet config/version.cue -d '#FlutterVersion' config/flutter_version.json
+
+      - name: Upload artifact with the new Flutter version
+        if: ${{ steps.update_flutter_version.outputs.result == 'true' }}
+        id: upload-version
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
+        with:
+          name: flutter_version.json
+          path: config/flutter_version.json
+
+  update_android_version:
+    permissions:
+      # Allow to write contents to push commits
+      contents: write
+      # Allow to read packages to pull the container image from GitHub Container Registry
+      packages: read
+      # Allow to write pull requests to create a pull request
+      pull-requests: write
+    needs: update_flutter_version
+    if: ${{ needs.update_flutter_version.outputs.new_version == 'true' }}
+    outputs:
+      version_artifact_id: ${{ steps.upload-version.outputs.artifact-id }}
+      android_test_artifact_id: ${{ steps.upload-android-test.outputs.artifact-id }}
+    runs-on: ubuntu-24.04
+    container:
+      image: ghcr.io/${{ github.repository_owner }}/flutter-android:${{ vars.FLUTTER_VERSION }}
+      credentials:
+        username: ${{ github.actor }}
+        password: ${{ github.token }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      # TODO: Workaround because actions/download-artifact can't overwrite existing files
+      # Check if this workaround can be removed after the following issues are fixed:
+      # https://github.com/actions/download-artifact/issues/225
+      # https://github.com/actions/download-artifact/issues/138
+      - name: Delete flutter_version.json
+        run: rm config/flutter_version.json
+
+      - name: Download artifact with the new Flutter version
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
+        with:
+          artifact-ids: ${{ needs.update_flutter_version.outputs.flutter_version_artifact_id }}
+          path: config
+
+      - name: Copy Flutter version into version manifest and export FLUTTER_* environment variables
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        with:
+          script: |
+            const script = require('./script/copyFlutterVersion.js')
+            await script({core})
+
+      - name: Update latest Fastlane version
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        with:
+          script: |
+            const script = require('./script/updateFastlaneVersion.js')
+            await script({core, fetch})
+
+      - name: Setup Flutter
+        run: |
+          cd $FLUTTER_ROOT
+          git fetch origin ${{ env.FLUTTER_VERSION }}:${{ env.FLUTTER_VERSION }}
+          git switch --discard-changes ${{ env.FLUTTER_VERSION }}
+
+      # TODO: Create test app in specific folder with step id, to allow parallel execution
+      - name: Create test application
+        run: |
+          flutter create test_app
+
+      # TODO: Cache gradle https://github.com/gradle/gradle-build-action
+      - name: Update default Android platform versions in Flutter
+        working-directory: test_app/android
+        run: |
+          cat ../../script/updateAndroidVersions.gradle.kts >> app/build.gradle.kts
+          ./gradlew --warning-mode all updateAndroidVersions
+
+      - name: Clean test application
+        run: |
+          rm -rf test_app
+
+      - name: Setup CUE
+        uses: jaxxstorm/action-install-gh-release@6096f2a2bbfee498ced520b6922ac2c06e990ed2 # v2.1.0
+        with:
+          repo: cue-lang/cue
+          tag: v0.15.0
+          digest: 06925fc1e5174591cef0b1e42ac32cff4271804742cd20893de1793b6d82d460
+
+      - name: Generate test files with CUE
+        run: |
+          ./script/update_test.sh
+
+      - name: Upload artifact with the updated version.json
+        id: upload-version
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
+        with:
+          name: version.json
+          path: config/version.json
+
+      - name: Upload the test artifact for Android
+        id: upload-android-test
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
+        with:
+          name: android.yml
+          path: test/android.yml
+
+  validate_config_version:
+    needs: update_android_version
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      # TODO: Workaround because actions/download-artifact can't overwrite existing files
+      # Check if this workaround can be removed after the following issues are fixed:
+      # https://github.com/actions/download-artifact/issues/225
+      # https://github.com/actions/download-artifact/issues/138
+      - name: Delete version.json
+        run: rm config/version.json
+
+      - name: Download artifact with the new Flutter version
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
+        with:
+          artifact-ids: ${{ needs.update_android_version.outputs.version_artifact_id }}
+          path: config
+
+      - name: Setup CUE
+        uses: jaxxstorm/action-install-gh-release@6096f2a2bbfee498ced520b6922ac2c06e990ed2 # v2.1.0
+        with:
+          repo: cue-lang/cue
+          tag: v0.15.0
+          digest: 06925fc1e5174591cef0b1e42ac32cff4271804742cd20893de1793b6d82d460
+
+      - name: Validate version.json with CUE
+        run: cue vet config/version.cue -d '#Version' config/version.json
+
+  update_docs_and_create_pr:
+    needs:
+      - update_flutter_version
+      - update_android_version
+      - validate_config_version
+    runs-on: ubuntu-24.04
+    env:
+      IMAGE_REPOSITORY_NAME: flutter-android
+      VERSION_MANIFEST: config/version.json
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      # TODO: Workaround because actions/download-artifact can't overwrite existing files
+      # Check if this workaround can be removed after the following issues are fixed:
+      # https://github.com/actions/download-artifact/issues/225
+      # https://github.com/actions/download-artifact/issues/138
+      - name: Delete flutter_version.json and version.json
+        run: |-
+          rm config/flutter_version.json config/version.json test/android.yml
+
+      - name: Download configuration artifacts
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
+        with:
+          artifact-ids: ${{ needs.update_flutter_version.outputs.flutter_version_artifact_id }},${{ needs.update_android_version.outputs.version_artifact_id }}
+          path: config
+          # Download to the configured path instead of separated directories by artifact id
+          merge-multiple: true
+
+      - name: Download test artifacts
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
+        with:
+          artifact-ids: ${{ needs.update_android_version.outputs.android_test_artifact_id }}
+          path: test
+
+      - name: Setup NodeJS
+        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        with:
+          cache: npm
+          cache-dependency-path: docs/src/package-lock.json
+          node-version: lts/*
+
+      - name: Update documentation
+        working-directory: docs/src
+        run: |
+          npm ci --prefer-offline
+          npm run build
+
+      - name: Read environment variables from the version manifest
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        env:
+          GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
+          IMAGE_REPOSITORY_NAME: ${{ env.IMAGE_REPOSITORY_NAME }}
+          VERSION_MANIFEST: ${{ env.VERSION_MANIFEST }}
+        with:
+          script: |
+            const script = require('./script/setEnvironmentVariables.js')
+            return await script({ core })
+
+      - name: Create commit message variable
+        run: |
+          echo "COMMIT_MESSAGE=chore(release): upgrade flutter to ${{ env.FLUTTER_VERSION }}" >> $GITHUB_ENV
+
+      - name: Generate authentication token with GitHub App to trigger Actions
+        uses: actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf # v2.2.1
+        id: app-token
+        with:
+          app-id: ${{ secrets.VERIFIED_COMMIT_ID }}
+          private-key: ${{ secrets.VERIFIED_COMMIT_KEY }}
+          repositories: ${{ github.event.repository.name }}
+          owner: ${{ github.repository_owner }}
+
+      # TODO: Generate changelog for the new flutter version, that will be the new tag
+      - name: Create pull request if there are changes
+        uses: peter-evans/create-pull-request@22a9089034f40e5a961c8808d113e2c98fb63676 # v7.0.11
+        with:
+          commit-message: ${{ env.COMMIT_MESSAGE }}
+          branch: update-flutter-dependencies/${{ env.FLUTTER_VERSION }}
+          sign-commits: true
+          title: ${{ env.COMMIT_MESSAGE }}
+          token: ${{ steps.app-token.outputs.token }}

.github/workflows/windows.yml

@@ -0,0 +1,99 @@
+on:
+  pull_request:
+  workflow_dispatch:
+
+# Read-only permissions by default
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
+jobs:
+  test_windows:
+    permissions:
+      # Allow to write packages for the docker/scout-action to write a comment
+      packages: write
+      # Allow to write pull requests for the docker/scout-action to write a comment
+      pull-requests: write
+      # Allow to write security events for github/codeql-action/upload-sarif to upload SARIF results
+      security-events: write 
+    runs-on: windows-2025
+    env:
+      IMAGE_REPOSITORY_NAME: flutter-android
+      VERSION_MANIFEST: config/version.json
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        with:
+          username: ${{ secrets.DOCKER_HUB_USERNAME }}
+          password: ${{ secrets.DOCKER_HUB_TOKEN }}
+
+      - name: Read environment variables from the version manifest
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        env:
+          GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
+          IMAGE_REPOSITORY_NAME: ${{ env.IMAGE_REPOSITORY_NAME }}
+          VERSION_MANIFEST: ${{ env.VERSION_MANIFEST }}
+        with:
+          script: |
+            const script = require('./script/setEnvironmentVariables.js')
+            return await script({ core })
+
+      # - name: Load image metadata
+      #   uses: docker/metadata-action@902fa8ec7d6ecbf8d84d538b9b233a880e428804 # v5.7.0
+      #   id: metadata
+      #   with:
+      #     images: |
+      #       ${{ env.IMAGE_REPOSITORY_PATH }}
+      #     tags: |
+      #       type=raw,value=${{ env.FLUTTER_VERSION }}
+
+      # - name: Set up Docker Buildx
+      #   uses: docker/setup-buildx-action@b5ca514318bd6ebac0fb2aedd5d36ec1b5c232a2 # v3.10.0
+
+      - name: Build image and push to local Docker daemon
+        shell: powershell
+        run: |
+          docker build . -f windows.Dockerfile --build-arg flutter_version=${{ env.FLUTTER_VERSION }} -t ${{ env.IMAGE_REPOSITORY_PATH }}
+
+      # - name: Build image and push to local Docker daemon
+      #   uses: docker/build-push-action@471d1dc4e07e5cdedd4c2171150001c434f0b7a4 # v6.15.0
+      #   with:
+      #     file: windows.Dockerfile
+      #     load: true
+      #     cache-from: type=gha
+      #     cache-to: type=gha,mode=max
+      #     labels: ${{ steps.metadata.outputs.labels }}
+      #     tags: ${{ steps.metadata.outputs.tags }}
+      #     target: android
+      #     build-args: |
+      #       flutter_version=${{ env.FLUTTER_VERSION }}
+
+    #   - name: Test image
+    #     uses: plexsystems/container-structure-test-action@c0a028aa96e8e82ae35be556040340cbb3e280ca # v0.3.0
+    #     with:
+    #       image: ${{ fromJSON(steps.metadata.outputs.json).tags[0] }}
+    #       config: test/android.yml
+
+    #   # TODO: Parallelize testing and vulnerability scanning
+    #   - name: Scan with Docker Scout
+    #     id: docker-scout
+    #     uses: docker/scout-action@0133ff88fe16d4a412dc4827a8fccbccb6b583e0 # v1.16.3
+    #     with:
+    #       command: compare, recommendations
+    #       # Use the Docker Hub image that is the first tag in the metadata
+    #       image: local://${{ fromJson(steps.metadata.outputs.json).tags[0] }}
+    #       # github-token is needed to be able to write the PR comment
+    #       github-token: ${{ github.token }}
+    #       only-fixed: true
+    #       organization: ${{ secrets.DOCKER_HUB_USERNAME }}
+    #       # sarif-file: output.sarif.json
+    #       to-env: prod
+    #       # Enable debug logging when needed
+    #       # debug: true
+    #       # verbose-debug: true

LICENSE.md

@@ -2,7 +2,7 @@
 
 MIT License
 
-Copyright (c) 2023-2025 Eligio Alejandro Mariño Garcés
+Copyright (c) 2023 Eligio Alejandro Mariño Garcés
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

android.Dockerfile

@@ -1,19 +1,19 @@
-FROM debian:12.9-slim@sha256:12c396bd585df7ec21d5679bb6a83d4878bc4415ce926c9e5ea6426d23c60bdc AS flutter
+FROM debian:13.2-slim@sha256:4bcb9db66237237d03b55b969271728dd3d955eaaa254b9db8a3db94550b1885 AS flutter
 
 SHELL ["/bin/bash", "-euxo", "pipefail", "-c"]
 
 ENV LANG=C.UTF-8
 
-# renovate: release=bullseye depName=curl
-ARG CURL_VERSION="7.88.1-10+deb12u8"
-# renovate: release=bullseye depName=git
-ARG GIT_VERSION="1:2.39.5-0+deb12u2"
-# renovate: release=bullseye depName=lcov
-ARG LCOV_VERSION="1.16-1"
-# renovate: release=bullseye depName=ca-certificates
-ARG CA_CERTIFICATES_VERSION="20230311"
-# renovate: release=bullseye depName=unzip
-ARG UNZIP_VERSION="6.0-28"
+# renovate: suite=trixie depName=curl
+ARG CURL_VERSION="8.14.1-2+deb13u2"
+# renovate: suite=trixie depName=git
+ARG GIT_VERSION="1:2.47.3-0+deb13u1"
+# renovate: suite=trixie depName=lcov
+ARG LCOV_VERSION="2.3.1-1"
+# renovate: suite=trixie depName=ca-certificates
+ARG CA_CERTIFICATES_VERSION="20250419"
+# renovate: suite=trixie depName=unzip
+ARG UNZIP_VERSION="6.0-29"
 
 USER root
 RUN apt-get update \
@@ -65,6 +65,7 @@ RUN git clone \
     "$FLUTTER_ROOT" \
     && chown -R flutter:flutter "$FLUTTER_ROOT" \
     && flutter --version \
+    && flutter config --no-cli-animations \
     && dart --disable-analytics \
     && flutter config \
     --no-cli-animations \
@@ -79,10 +80,10 @@ RUN git clone \
     --no-enable-macos-desktop \
     && flutter doctor
 
-COPY --chown=flutter:flutter ./script/docker-entrypoint.sh "$HOME/docker-entrypoint.sh"
-RUN chmod +x "$HOME/docker-entrypoint.sh"
+COPY --chown=flutter:flutter ./script/docker_linux_entrypoint.sh "$HOME/docker_entrypoint.sh"
+RUN chmod +x "$HOME/docker_entrypoint.sh"
 
-ENTRYPOINT [ "/home/flutter/docker-entrypoint.sh" ]
+ENTRYPOINT [ "/home/flutter/docker_entrypoint.sh" ]
 
 #-----------------------------------------------
 #-----------------------------------------------
@@ -92,14 +93,14 @@ FROM flutter AS fastlane
 
 SHELL ["/bin/bash", "-euxo", "pipefail", "-c"]
 
-# renovate: release=bullseye depName=ruby-dev
-ARG RUBY_VERSION="1:3.1"
-# renovate: release=bullseye depName=build-essential
-ENV BUILD_ESSENTIAL_VERSION="12.9"
+# renovate: suite=trixie depName=ruby-dev
+ARG RUBY_VERSION="1:3.3"
+# renovate: suite=trixie depName=build-essential
+ENV BUILD_ESSENTIAL_VERSION="12.12"
 
 USER root
 RUN apt-get update \
-    && apt-get install -y --no-install-recommends \ 
+    && apt-get install -y --no-install-recommends \
     # Fastlane dependencies
     ruby-full="$RUBY_VERSION" \
     build-essential="$BUILD_ESSENTIAL_VERSION" \
@@ -141,19 +142,21 @@ FROM fastlane AS android
 
 SHELL ["/bin/bash", "-euxo", "pipefail", "-c"]
 
-# TODO: Get JAVA_HOME dinamically from a JDK binary 
+# TODO: Get JAVA_HOME dinamically from a JDK binary
 # TODO: Use `dirname $(dirname $(readlink -f $(which javac)))` after the following issue is fixed
 # TODO: https://github.com/moby/moby/issues/29110
 ENV ANDROID_HOME="$SDK_ROOT/android-sdk" \
     JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
 ENV PATH="$PATH:$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$HOME/.local/bin"
 
-# renovate: release=bullseye depName=openjdk-17-jdk-headless
-ARG OPENJDK_17_JDK_HEADLESS_VERSION="17.0.14+7-1~deb12u1"
-# renovate: release=bullseye depName=sudo
-ARG SUDO_VERSION="1.9.13p3-1+deb12u1"
+# renovate: suite=bookworm depName=openjdk-17-jdk-headless
+ARG OPENJDK_17_JDK_HEADLESS_VERSION="17.0.18+8-1~deb12u1"
+# renovate: suite=trixie depName=sudo
+ARG SUDO_VERSION="1.9.16p2-3"
 
 USER root
+# Add debian 12 bookworm repository alongside debian 13 trixie to install Java 17
+COPY config/debian_12_bookworm.sources /etc/apt/sources.list.d/debian_12_bookworm.sources
 RUN apt-get update \
     && apt-get install -y --no-install-recommends \
     # For Android x86 emulators
@@ -171,6 +174,8 @@ RUN apt-get update \
     # To allow changing ownership in GitLab CI /builds
     sudo="$SUDO_VERSION" \
     && rm -rf /var/lib/apt/lists/* \
+    # Delete debian 12 bookworm repository after installing Java 17
+    && rm /etc/apt/sources.list.d/debian_12_bookworm.sources \
     # To allow changing ownership in GitLab CI /builds
     && echo "flutter ALL= NOPASSWD:/bin/chown -R flutter /builds, /bin/chown -R flutter /builds/*" >> /etc/sudoers.d/flutter
 

config/android.cue

@@ -1,3 +1,17 @@
+package config
+
+import "list"
+
+#CommandTests: {
+	name: _
+	setup?: _
+	teardown?: _
+	command: _
+	args: _
+	expectedOutput?: [string]
+	excludedOutput?: _
+}
+
 #FileContentTests: {
 	name: string
 	path: _
@@ -6,24 +20,47 @@
 
 #ContainerStructureTest: {
 	schemaVersion: _
-	commandTests: _
+	commandTests: [...#CommandTests]
 	fileContentTests: [...#FileContentTests]
 }
 
 input: #ContainerStructureTest
 
-android_cmdline_tools_version: string @tag(android_cmdline_tools_version)
 android_cmdline_tools_test_expected_content: string @tag(android_cmdline_tools_test_expected_content)
+android_cmdline_tools_version: string @tag(android_cmdline_tools_version)
+android_ndk_version: string @tag(android_ndk_version)
+android_sdk_build_tools_version: string @tag(android_sdk_build_tools_version)
 
 output: {
 	schemaVersion: input.schemaVersion
-	commandTests: input.commandTests
-	fileContentTests: [
-		{
-			name: "Android SDK Command-line Tools is version \(android_cmdline_tools_version)"
-			path: input.fileContentTests[0].path
-			expectedContents: [android_cmdline_tools_test_expected_content]
+	
+	commandTests: list.Concat([
+		list.Take(input.commandTests, 1),
+		[
+			{
+				name: input.commandTests[1].name
+				command: input.commandTests[1].command
+				args: input.commandTests[1].args
+				expectedOutput: [android_sdk_build_tools_version]
+			},
+			{
+				name: input.commandTests[2].name
+				command: input.commandTests[2].command
+				args: input.commandTests[2].args
+				expectedOutput: [android_ndk_version]
+			}
+		],
+		list.Drop(input.commandTests, 3),
+	])
+	
+	fileContentTests: list.Concat([
+		if len(input.fileContentTests) > 0 {
+			[{
+				name: "Android SDK Command-line Tools is version \(android_cmdline_tools_version)"
+				path: input.fileContentTests[0].path
+				expectedContents: [android_cmdline_tools_test_expected_content]
+			}],
 		},
-		input.fileContentTests[1]
-	]
+		list.Drop(input.fileContentTests, 1),
+	])
 }

config/debian_12_bookworm.sources

@@ -0,0 +1,13 @@
+# Add debian 12 bookworm repository alongside debian 13 trixie to install Java 17
+
+Types: deb
+URIs: http://deb.debian.org/debian
+Suites: bookworm bookworm-updates
+Components: main contrib non-free non-free-firmware
+Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
+
+Types: deb
+URIs: http://deb.debian.org/debian-security
+Suites: bookworm-security
+Components: main contrib non-free non-free-firmware
+Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

config/flutter_version.json

@@ -1,7 +1,7 @@
 {
     "flutter": {
         "channel": "stable",
-        "commit": "c23637390482d4cf9598c3ce3f2be31aa7332daf",
-        "version": "3.29.2"
+        "commit": "44a626f4f0027bc38a46dc68aed5964b05a83c18",
+        "version": "3.41.0"
     }
 }

config/version.json

@@ -1,32 +1,32 @@
 {
     "flutter": {
         "channel": "stable",
-        "commit": "c23637390482d4cf9598c3ce3f2be31aa7332daf",
-        "version": "3.29.2"
+        "commit": "44a626f4f0027bc38a46dc68aed5964b05a83c18",
+        "version": "3.41.0"
     },
     "android": {
         "platforms": [
             {
-                "version": 35
+                "version": 36
             }
         ],
         "gradle": {
-            "version": "8.10.2"
+            "version": "8.14"
         },
         "buildTools": {
-            "version": "34.0.0"
+            "version": "35.0.0"
         },
         "cmdlineTools": {
-            "version": "12.0"
+            "version": "20.0"
         },
         "ndk": {
-            "version": "26.3.11579264"
+            "version": "28.2.13676358"
         },
         "cmake": {
             "version": "3.22.1"
         }
     },
     "fastlane": {
-        "version": "2.227.0"
+        "version": "2.232.1"
     }
 }

docker-compose.yml

@@ -1,7 +1,7 @@
 services:
   flutter:
     build:
-      context: .
+      dockerfile: ./android.Dockerfile
       target: flutter
       args:
         flutter_version: $FLUTTER_VERSION
@@ -10,7 +10,6 @@ services:
   
   fastlane:
     build:
-      context: .
       target: fastlane
       args:
         flutter_version: $FLUTTER_VERSION
@@ -20,7 +19,7 @@ services:
   
   android:
     build:
-      context: .
+      dockerfile: ./android.Dockerfile
       target: android
       args:
         flutter_version: $FLUTTER_VERSION
@@ -31,3 +30,9 @@ services:
         cmake_version: $CMAKE_VERSION
     environment:
       ENABLE_ANALYTICS: $ENABLE_ANALYTICS
+
+  windows:
+    build:
+      dockerfile: ./windows.Dockerfile
+      args:
+        flutter_version: $FLUTTER_VERSION

docs/contributing.md

@@ -6,4 +6,10 @@
 
 When adding new Github Actions the `.github\renovate.json` needs to be checked and add the new action to:
 
-* the automerge array if it's not an important action
+* the automerge array if it's not an important action
+
+### Dockerfile stages
+
+1. `flutter` stage hast only the dependencies required to install flutter and common tools used by flutter internal commands, like `git`.
+2. `fastlane` stage has the dependencies required to install fastlane but doesn't install fastlane.
+3. `android` stage has the dependencies required to install the Android SDK and to develop Flutter apps for Android.

docs/src/compile.js

@@ -0,0 +1,31 @@
+import { writeFile } from 'node:fs/promises'
+import { mdxToMd } from 'mdx-to-md'
+import { resolve } from 'node:path'
+import remarkGfm from 'remark-gfm'
+import remarkToc from 'remark-toc'
+
+/**
+ * @see https://github.com/kentcdodds/mdx-bundler?tab=readme-ov-file#mdxoptions
+ */
+function mdxOptions(options) {
+  options.remarkPlugins = [
+    ...(options.remarkPlugins ?? []),
+    remarkGfm,
+    remarkToc,
+  ]
+
+  return options
+}
+
+const args = process.argv.slice(2)
+const sourceRelativePath = args[0]
+const outputRelativePath = args[1]
+const markdown = await mdxToMd(resolve(sourceRelativePath), {
+  mdxOptions,
+})
+const banner = `This markdown file was auto-generated from "${sourceRelativePath}"`
+const readme = `<!--- ${banner} -->\n\n${markdown}`
+
+await writeFile(outputRelativePath, readme)
+
+console.log(`📝 Converted ${sourceRelativePath} -> ${outputRelativePath}`)

docs/src/content.mdx

@@ -5,7 +5,9 @@ export const androidJson = versionJson.android
 export const gradleVersion = androidJson.gradle.version
 export const buildToolsVersion = androidJson.buildTools.version
 export const repositoryPath = 'gmeligio/flutter-android'
-export const imageUri = `${repositoryPath}:${flutterVersion}`
+export const dockerHubUri = `${repositoryPath}:${flutterVersion}`
+export const githubUri = `ghcr.io/${dockerHubUri}`
+export const quayUri = `quay.io/${dockerHubUri}`
 export const androidPlatformVersions = androidJson.platforms.map(p => p.version).join(', ')
 export const androidNdkVersion = androidJson.ndk.version
 export const dockerHubUrl = `https://hub.docker.com/r/${repositoryPath}`
@@ -17,6 +19,8 @@ Docker images for Flutter Continuous Integration (CI). The source is available [
 
 The images includes the minimum tools to run Flutter and build apps. The versions of the tools installed are based on the official [Flutter](https://github.com/flutter/flutter) repository. The final goal is that Flutter doesn't need to download anything like tools or SDKs when running the container.
 
+## Contents
+
 ## Features
 
 - Installed Flutter SDK {flutterVersion}.
@@ -32,50 +36,40 @@ Predownloaded SDKs and tools in Android:
 - Android NDK: {androidNdkVersion}
 - Gradle: {gradleVersion}
 
-## Alpha Stability
-
-The images are experimental and are in active development. They are being used for small projects but there is no confirmation of production usage yet.
-
 ## Running Containers
 
-Registries:
-
-- <a href={dockerHubUrl}>Docker Hub</a>
-- [Github Container Registry](https://github.com/gmeligio/flutter-docker-image/pkgs/container/flutter-android)
-- <a href={quayUrl}>Quay</a>
+| Registry                  | flutter-android                                        |
+|---------------------------|--------------------------------------------------------|
+| Docker Hub                | <a href={dockerHubUrl}>{dockerHubUri}</a>    |
+| GitHub Container Registry | <a href="https://github.com/gmeligio/flutter-docker-image/pkgs/container/flutter-android">{githubUri}</a> |
+| Quay                      | <a href={quayUrl}>{quayUri}</a> |
 
 On the terminal:
 <pre><code className="language-bash">
-{`# From Docker Hub
-docker run --rm -it ${imageUri} bash
-
-# From GitHub Container Registry
-docker run --rm -it ghcr.io/${imageUri} bash
-
-# From Quay.io
-docker run --rm -it quay.io/${imageUri} bash`}
+{`# From GitHub Container Registry
+docker run --rm -it ${githubUri} bash`}
 </code></pre>
 
 On a workflow in GitHub Actions:
 <pre><code className="language-yaml">
 {`jobs:
-  build:
-    runs-on: ubuntu-22.04
-    container:
-      image: ghcr.io/${imageUri}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-      - name: Build
-        run: flutter build apk`}
+    build:
+      runs-on: ubuntu-22.04
+      container:
+        image: ${githubUri}
+      steps:
+        - name: Checkout
+          uses: actions/checkout@v2
+        - name: Build
+          run: flutter build apk`}
 </code></pre>
 
 On a `.gitlab-ci.yml` in GitLab CI:
 <pre><code className="language-yaml">
 {`build:
-  image: ghcr.io/${imageUri}
-  script:
-    - flutter build apk`}
+    image: ${githubUri}
+    script:
+      - flutter build apk`}
 </code></pre>
 
 Fastlane:
@@ -89,45 +83,37 @@ bundle install --prefer-local
 bundle exec fastlane`}
 </code></pre>
 
-## Versions
+## Tags
 
-There is no `latest` Docker tag on purpose. You need to specify the version of the image you want to use. The reason for that is that `latest` is a dynamic tag that can be confusing when reading the image URI because doesn't necessarily point to the latest image built and can cause unexpected behavior when rerunning a past CI job that runs with an overwritten latest tags. There are multiple articles explaining more about this reasoning like [What's Wrong With The Docker :latest Tag?](https://vsupalov.com/docker-latest-tag/) and [The misunderstood Docker tag: latest](https://medium.com/@mccode/the-misunderstood-docker-tag-latest-af3babfd6375).
-
-The tag is composed of the Flutter version used to build the image. For example:
-- Docker image: {imageUri}
+Every new tag on the flutter stable channel gets built. The tag is composed of the Flutter version used to build the image:
+- Docker image: {dockerHubUri}
 - Flutter version: {flutterVersion}
 
-## Developing Locally
+## Building Locally
 
-### Running The Container
+The android.Dockerfile expects a few arguments:
 
-The Dockerfile expects a few parameters:
 - `flutter_version <string>`: The version of Flutter to use when building. Example: {flutterVersion}
 - `android_build_tools_version <string>`: The version of the Android SDK Build Tools to install. Example: {buildToolsVersion}
-- `android_platform_versions <list>`: The versions of the Android SDK Platforms to install, separated by spaces. Example: 28 31 33
+- `android_platform_versions <list>`: The versions of the Android SDK Platforms to install, separated by spaces. Example: {androidPlatformVersions}
   
 <pre><code className="language-bash">
 {`# Android
 docker build --target android --build-arg flutter_version=${flutterVersion} --build-arg fastlane_version=${fastlaneVersion} --build-arg android_build_tools_version=${buildToolsVersion} --build-arg android_platform_versions="${androidPlatformVersions}" -t android-test .`}
 </code></pre>
 
-### Dockerfile stages
-
-The base image is `debian/debian:12-slim` and from there multiple stages are created:
-1. `flutter` stage hast only the dependencies required to install flutter and common tools used by flutter internal commands, like `git`.
-1. `fastlane` stage has the dependencies required to install fastlane but doesn't install fastlane.
-1. `android` stage has the dependencies required to install the Android SDK and to develop Flutter apps for Android.
-
 ## Roadmap
 
 - Minimal image with predownloaded SDKs and tools ready to run `flutter` commands for the platforms:
-   - [ ] iOS
-   - [ ] Linux
-   - [ ] Windows
-   - [ ] Web
+   
+   - iOS
+   - Linux
+   - Windows
+   - Web
 
 - Android features:
-   - [ ] Android emulator
+   
+   - Android emulator
 
 ## FAQ
 
@@ -135,24 +121,14 @@ The base image is `debian/debian:12-slim` and from there multiple stages are cre
 
 The storage of the images starts to cost after 50 GB and increases with every pushed image because the AWS Free Tier covers up to 50 GB of total storage for free in ECR Public.
 
+### Why there is no dynamic tag like `latest`?
+
+There is no `latest` Docker tag on purpose. You need to specify the version of the image you want to use. The reason for that is that `latest` can cause unexpected behavior when rerunning a past CI job that was expected to use the old build of the `latest` tag. There are multiple articles explaining more about this reasoning like [What's Wrong With The Docker :latest Tag?](https://vsupalov.com/docker-latest-tag/) and [The misunderstood Docker tag: latest](https://medium.com/@mccode/the-misunderstood-docker-tag-latest-af3babfd6375).
+
 ## Contributing
 
 See [Contributing](docs/contributing.md).
 
-## Other Docker projects for mobile development
-
-- [docker-android-fastlane](https://github.com/softartdev/docker-android-fastlane)
-
-## Acknowledgments
-
-- [docker-android-build-box](https://github.com/mingchen/docker-android-build-box)
-- [flutter-fastlane-android](https://github.com/gmemstr/flutter-fastlane-android)
-- [circleci-images](https://github.com/circleci/circleci-images)
-- [docker-images-android](https://github.com/cirruslabs/docker-images-android)
-- [docker-images-flutter](https://github.com/cirruslabs/docker-images-flutter)
-- [flutter-docker-image](https://github.com/instrumentisto/flutter-docker-image)
-- [DockerFlutter](https://github.com/fischerscode/DockerFlutter)
-
 ## License
 
 Flutter is licensed under [BSD 3-Clause "New" or "Revised" license](https://github.com/flutter/flutter/blob/master/LICENSE).
@@ -161,4 +137,4 @@ As with all Docker images, these likely also contain other software which may be
 
 As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.
 
-The [sources](https://github.com/gmeligio/flutter-docker-image) for producing gmeligio/flutter-android Docker images are licensed under [MIT License](LICENSE.md).
+The [sources](https://github.com/gmeligio/flutter-docker-image) for producing {repositoryPath} Docker images are licensed under [MIT License](LICENSE.md).

docs/src/contributing.mdx

@@ -5,3 +5,9 @@
 When adding new Github Actions the `.github\renovate.json` needs to be checked and add the new action to:
 
 - the automerge array if it's not an important action
+
+### Dockerfile stages
+
+1. `flutter` stage hast only the dependencies required to install flutter and common tools used by flutter internal commands, like `git`.
+2. `fastlane` stage has the dependencies required to install fastlane but doesn't install fastlane.
+3. `android` stage has the dependencies required to install the Android SDK and to develop Flutter apps for Android.

docs/src/license.mdx

@@ -1,8 +1,6 @@
-export const year = new Date().getFullYear()
-
 MIT License
 
-Copyright (c) 2023-{year} Eligio Alejandro Mariño Garcés
+Copyright (c) 2023 Eligio Alejandro Mariño Garcés
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -20,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

docs/src/package.json

@@ -1,22 +1,34 @@
 {
-  "name": "doc",
-  "version": "1.0.0",
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "build": "npm run readme && npm run contributing && npm run license",
-    "readme": "cross-env NODE_ENV=production mdx-to-md readme.mdx ../../readme.md",
-    "license": "cross-env NODE_ENV=production mdx-to-md license.mdx ../../LICENSE.md",
-    "contributing": "cross-env NODE_ENV=production mdx-to-md contributing.mdx ../contributing.md",
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "author": "",
-  "license": "ISC",
-  "dependencies": {
-    "cross-env": "^7.0.3",
-    "mdx-to-md": "^0.3.2"
-  },
-  "volta": {
-    "node": "22.14.0"
-  }
+    "name": "doc",
+    "version": "1.0.0",
+    "description": "",
+    "main": "index.js",
+    "type": "module",
+    "scripts": {
+        "build": "npm run readme && npm run contributing && npm run license",
+        "readme": "cross-env NODE_ENV=production node compile.js readme.mdx ../../readme.md",
+        "license": "cross-env NODE_ENV=production node compile.js license.mdx ../../LICENSE.md",
+        "contributing": "cross-env NODE_ENV=production node compile.js contributing.mdx ../contributing.md",
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "author": "",
+    "license": "ISC",
+    "dependencies": {
+        "cross-env": "^10.0.0",
+        "mdx-to-md": "^0.5.0",
+        "react": "^19.1.0",
+        "react-dom": "^19.1.0",
+        "remark-gfm": "^4.0.1",
+        "remark-toc": "^9.0.0"
+    },
+    "devEngines": {
+        "runtime": {
+            "name": "node",
+            "onFail": "error"
+        },
+        "packageManager": {
+            "name": "npm",
+            "onFail": "error"
+        }
+    }
 }

readme.md

@@ -8,44 +8,47 @@ Docker images for Flutter Continuous Integration (CI). The source is available [
 
 The images includes the minimum tools to run Flutter and build apps. The versions of the tools installed are based on the official [Flutter](https://github.com/flutter/flutter) repository. The final goal is that Flutter doesn't need to download anything like tools or SDKs when running the container.
 
+## Contents
+
+* [Features](#features)
+* [Running Containers](#running-containers)
+* [Tags](#tags)
+* [Building Locally](#building-locally)
+* [Roadmap](#roadmap)
+* [FAQ](#faq)  
+   * [Why the images are not published in the AWS ECR Public registry?](#why-the-images-are-not-published-in-the-aws-ecr-public-registry)  
+   * [Why there is no dynamic tag like latest?](#why-there-is-no-dynamic-tag-like-latest)
+* [Contributing](#contributing)
+* [License](#license)
+
 ## Features
 
-* Installed Flutter SDK 3.29.2.
+* Installed Flutter SDK 3.41.0.
 * Analytics disabled by default, opt-in if `ENABLE_ANALYTICS` environment variable is passed when running the container.
 * Rootless user `flutter:flutter`, with permissions to run on Github workflows and GitLab CI.
-* Cached Fastlane gem 2.227.0.
+* Cached Fastlane gem 2.232.1.
 * Minimal image with predownloaded SDKs and tools ready to run `flutter` commands for the Android platform.
 
 Predownloaded SDKs and tools in Android:
 
 * Licenses accepted
-* Android SDK Platforms: 35
-* Android NDK: 26.3.11579264
-* Gradle: 8.10.2
-
-## Alpha Stability
-
-The images are experimental and are in active development. They are being used for small projects but there is no confirmation of production usage yet.
+* Android SDK Platforms: 36
+* Android NDK: 28.2.13676358
+* Gradle: 8.14
 
 ## Running Containers
 
-Registries:
-
-* [Docker Hub](https://hub.docker.com/r/gmeligio/flutter-android)
-* [Github Container Registry](https://github.com/gmeligio/flutter-docker-image/pkgs/container/flutter-android)
-* [Quay](https://quay.io/repository/gmeligio/flutter-android)
+| Registry                  | flutter-android                                                                                                            |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| Docker Hub                | [gmeligio/flutter-android:3.41.0](https://hub.docker.com/r/gmeligio/flutter-android)                                       |
+| GitHub Container Registry | [ghcr.io/gmeligio/flutter-android:3.41.0](https://github.com/gmeligio/flutter-docker-image/pkgs/container/flutter-android) |
+| Quay                      | [quay.io/gmeligio/flutter-android:3.41.0](https://quay.io/repository/gmeligio/flutter-android)                             |
 
 On the terminal:
 
 ```bash
-# From Docker Hub
-docker run --rm -it gmeligio/flutter-android:3.29.2 bash
-
 # From GitHub Container Registry
-docker run --rm -it ghcr.io/gmeligio/flutter-android:3.29.2 bash
-
-# From Quay.io
-docker run --rm -it quay.io/gmeligio/flutter-android:3.29.2 bash
+docker run --rm -it ghcr.io/gmeligio/flutter-android:3.41.0 bash
 ```
 
 On a workflow in GitHub Actions:
@@ -55,7 +58,7 @@ jobs:
   build:
     runs-on: ubuntu-22.04
     container:
-      image: ghcr.io/gmeligio/flutter-android:3.29.2
+      image: ghcr.io/gmeligio/flutter-android:3.41.0
     steps:
       - name: Checkout
         uses: actions/checkout@v2
@@ -67,7 +70,7 @@ On a `.gitlab-ci.yml` in GitLab CI:
 
 ```yaml
 build:
-  image: ghcr.io/gmeligio/flutter-android:3.29.2
+  image: ghcr.io/gmeligio/flutter-android:3.41.0
   script:
     - flutter build apk
 ```
@@ -84,47 +87,35 @@ bundle install --prefer-local
 bundle exec fastlane
 ```
 
-## Versions
+## Tags
 
-There is no `latest` Docker tag on purpose. You need to specify the version of the image you want to use. The reason for that is that `latest` is a dynamic tag that can be confusing when reading the image URI because doesn't necessarily point to the latest image built and can cause unexpected behavior when rerunning a past CI job that runs with an overwritten latest tags. There are multiple articles explaining more about this reasoning like [What's Wrong With The Docker :latest Tag?](https://vsupalov.com/docker-latest-tag/) and [The misunderstood Docker tag: latest](https://medium.com/@mccode/the-misunderstood-docker-tag-latest-af3babfd6375).
+Every new tag on the flutter stable channel gets built. The tag is composed of the Flutter version used to build the image:
 
-The tag is composed of the Flutter version used to build the image. For example:
+* Docker image: gmeligio/flutter-android:3.41.0
+* Flutter version: 3.41.0
 
-* Docker image: gmeligio/flutter-android:3.29.2
-* Flutter version: 3.29.2
+## Building Locally
 
-## Developing Locally
+The android.Dockerfile expects a few arguments:
 
-### Running The Container
-
-The Dockerfile expects a few parameters:
-
-* `flutter_version <string>`: The version of Flutter to use when building. Example: 3.29.2
-* `android_build_tools_version <string>`: The version of the Android SDK Build Tools to install. Example: 34.0.0
-* `android_platform_versions <list>`: The versions of the Android SDK Platforms to install, separated by spaces. Example: 28 31 33
+* `flutter_version <string>`: The version of Flutter to use when building. Example: 3.41.0
+* `android_build_tools_version <string>`: The version of the Android SDK Build Tools to install. Example: 35.0.0
+* `android_platform_versions <list>`: The versions of the Android SDK Platforms to install, separated by spaces. Example: 36
 
 ```bash
 # Android
-docker build --target android --build-arg flutter_version=3.29.2 --build-arg fastlane_version=2.227.0 --build-arg android_build_tools_version=34.0.0 --build-arg android_platform_versions="35" -t android-test .
+docker build --target android --build-arg flutter_version=3.41.0 --build-arg fastlane_version=2.232.1 --build-arg android_build_tools_version=35.0.0 --build-arg android_platform_versions="36" -t android-test .
 ```
 
-### Dockerfile stages
-
-The base image is `debian/debian:12-slim` and from there multiple stages are created:
-
-1. `flutter` stage hast only the dependencies required to install flutter and common tools used by flutter internal commands, like `git`.
-2. `fastlane` stage has the dependencies required to install fastlane but doesn't install fastlane.
-3. `android` stage has the dependencies required to install the Android SDK and to develop Flutter apps for Android.
-
 ## Roadmap
 
 * Minimal image with predownloaded SDKs and tools ready to run `flutter` commands for the platforms:  
-   * \[ \] iOS  
-   * \[ \] Linux  
-   * \[ \] Windows  
-   * \[ \] Web
+   * iOS  
+   * Linux  
+   * Windows  
+   * Web
 * Android features:  
-   * \[ \] Android emulator
+   * Android emulator
 
 ## FAQ
 
@@ -132,24 +123,14 @@ The base image is `debian/debian:12-slim` and from there multiple stages are cre
 
 The storage of the images starts to cost after 50 GB and increases with every pushed image because the AWS Free Tier covers up to 50 GB of total storage for free in ECR Public.
 
+### Why there is no dynamic tag like `latest`?
+
+There is no `latest` Docker tag on purpose. You need to specify the version of the image you want to use. The reason for that is that `latest` can cause unexpected behavior when rerunning a past CI job that was expected to use the old build of the `latest` tag. There are multiple articles explaining more about this reasoning like [What's Wrong With The Docker :latest Tag?](https://vsupalov.com/docker-latest-tag/) and [The misunderstood Docker tag: latest](https://medium.com/@mccode/the-misunderstood-docker-tag-latest-af3babfd6375).
+
 ## Contributing
 
 See [Contributing](docs/contributing.md).
 
-## Other Docker projects for mobile development
-
-* [docker-android-fastlane](https://github.com/softartdev/docker-android-fastlane)
-
-## Acknowledgments
-
-* [docker-android-build-box](https://github.com/mingchen/docker-android-build-box)
-* [flutter-fastlane-android](https://github.com/gmemstr/flutter-fastlane-android)
-* [circleci-images](https://github.com/circleci/circleci-images)
-* [docker-images-android](https://github.com/cirruslabs/docker-images-android)
-* [docker-images-flutter](https://github.com/cirruslabs/docker-images-flutter)
-* [flutter-docker-image](https://github.com/instrumentisto/flutter-docker-image)
-* [DockerFlutter](https://github.com/fischerscode/DockerFlutter)
-
 ## License
 
 Flutter is licensed under [BSD 3-Clause "New" or "Revised" license](https://github.com/flutter/flutter/blob/master/LICENSE).

script/build_windows.sh

@@ -0,0 +1,5 @@
+# cmake generate
+cmake -S . -B ../build/windows/x64 -G "Visual Studio 16 2019" -A x64 -DFLUTTER_TARGET_PLATFORM=windows-x64
+
+# cmake build
+cmake --build ../build/windows/x64 --config Release --target INSTALL --verbose

script/copyFlutterVersion.js

@@ -1,27 +1,46 @@
+const fs = require('fs')
+const path = require('path')
+
 module.exports = async ({ core }) => {
-  const fs = require('fs')
+  try {
+    const flutterVersionPath = 'config/flutter_version.json'
 
-  const flutterVersionPath = 'config/flutter_version.json'
-  const flutterVersionData = fs.readFileSync(flutterVersionPath, 'utf8')
-  const fluterVersionJson = JSON.parse(flutterVersionData)
+    if (
+      !fs.existsSync(flutterVersionPath) ||
+      fs.lstatSync(flutterVersionPath).isDirectory()
+    ) {
+      throw new Error(`${flutterVersionPath} is missing or is a directory.`)
+    }
 
-  const versionPath = 'config/version.json'
-  const versionData = fs.readFileSync(versionPath, 'utf8')
-  let versionJson = JSON.parse(versionData)
+    const flutterVersionData = fs.readFileSync(flutterVersionPath, 'utf8')
+    const flutterVersionJson = JSON.parse(flutterVersionData)
 
-  const resultPath = 'config/version.json'
-  const result = {
-    ...versionJson,
-    ...fluterVersionJson,
+    const versionPath = 'config/version.json'
+    if (
+      !fs.existsSync(versionPath) ||
+      fs.lstatSync(versionPath).isDirectory()
+    ) {
+      throw new Error(`${versionPath} is missing or is a directory.`)
+    }
+
+    const versionData = fs.readFileSync(versionPath, 'utf8')
+    let versionJson = JSON.parse(versionData)
+
+    const resultPath = 'config/version.json'
+    const result = {
+      ...versionJson,
+      ...flutterVersionJson,
+    }
+
+    const resultJson = JSON.stringify(result, null, 4)
+    fs.writeFileSync(resultPath, `${resultJson}\n`)
+
+    const version = flutterVersionJson.flutter.version
+    const channel = flutterVersionJson.flutter.channel
+
+    core.exportVariable('FLUTTER_VERSION', version)
+    core.exportVariable('FLUTTER_CHANNEL', channel)
+  } catch (error) {
+    core.setFailed(`Error in copyFlutterVersion script: ${error.message}`)
   }
-
-  resultJson = JSON.stringify(result, null, 4)
-  fs.writeFileSync(resultPath, `${resultJson}\n`)
-
-  const version = fluterVersionJson.flutter.version
-  const channel = fluterVersionJson.flutter.channel
-
-  // Export FLUTTER_VERSION and FLUTTER_CHANNEL for the next workflow steps
-  core.exportVariable('FLUTTER_VERSION', version)
-  core.exportVariable('FLUTTER_CHANNEL', channel)
 }

script/docker_windows_entrypoint.ps1

@@ -0,0 +1,26 @@
+$analytic_tools_str = "Dart, Flutter and Fastlane"
+
+if ($env:ENABLE_ANALYTICS -eq "true") {
+    Write-Output "Received 'ENABLE_ANALYTICS=true'.`nEnabling analytics for $analytic_tools_str."
+
+    dart --enable-analytics
+    flutter config --analytics
+
+    if (Test-Path env:FASTLANE_OPT_OUT_USAGE) {
+        Remove-Item env:FASTLANE_OPT_OUT_USAGE
+    }
+}
+else {
+    dart --disable-analytics
+    flutter --disable-analytics
+    $env:POWERSHELL_TELEMETRY_OPTOUT = 1
+    $env:FASTLANE_OPT_OUT_USAGE = "YES"
+    # TODO: $env:COCOAPODS_DISABLE_STATS = 1
+}
+
+if ($args.length -gt 0) {
+    Invoke-Expression "$args"
+}
+else {
+    powershell
+}

script/java_version.sh

@@ -0,0 +1 @@
+java -version 2>&1 | awk -F[\".] '/version/ {print $2}'

script/jq_flutter_latest_version.sh

@@ -0,0 +1 @@
+jq -r '.releases[] | select(.channel=="stable") | max_by(.release_date) | .version'

script/latest_android_sdk_build_tools.sh

@@ -1 +1,4 @@
 sdkmanager --list | grep 'build-tools' | awk '{print $1}' | grep -oP 'build-tools;\d+\.\d+\.\d+$' | tail -1
+
+# Get 36.0.0 from `build-tools;36.0.0:build-tools`
+curl -s https://raw.githubusercontent.com/flutter/flutter/refs/tags/3.35.1/engine/src/flutter/tools/android_sdk/packages.txt | grep 'build-tools' | awk -F'[;:]' '{print $2}'

script/setEnvironmentVariables.js

@@ -0,0 +1,43 @@
+module.exports = async ({ core }) => {
+  const { VERSION_MANIFEST, GITHUB_REPOSITORY_OWNER, IMAGE_REPOSITORY_NAME } =
+    process.env
+
+  if (!VERSION_MANIFEST) {
+    core.setFailed('Environment variable VERSION_MANIFEST is required.')
+    return false
+  }
+
+  if (!GITHUB_REPOSITORY_OWNER) {
+    core.setFailed('Environment variable GITHUB_REPOSITORY_OWNER is required.')
+    return false
+  }
+
+  if (!IMAGE_REPOSITORY_NAME) {
+    core.setFailed('Environment variable IMAGE_REPOSITORY_NAME is required.')
+    return false
+  }
+
+  const fs = require('fs')
+  const text = fs.readFileSync(VERSION_MANIFEST, 'utf8')
+  const data = JSON.parse(text)
+
+  const platforms = data.android.platforms
+    .map((platform) => platform.version)
+    .join(' ')
+
+  core.exportVariable('FLUTTER_VERSION', data.flutter.version)
+  core.exportVariable('FASTLANE_VERSION', data.fastlane.version)
+  core.exportVariable(
+    'ANDROID_BUILD_TOOLS_VERSION',
+    data.android.buildTools.version
+  )
+  core.exportVariable('ANDROID_PLATFORM_VERSIONS', platforms)
+  core.exportVariable('ANDROID_NDK_VERSION', data.android.ndk.version)
+  core.exportVariable('CMAKE_VERSION', data.android.cmake.version)
+  core.exportVariable(
+    'IMAGE_REPOSITORY_PATH',
+    `${GITHUB_REPOSITORY_OWNER}/${IMAGE_REPOSITORY_NAME}`
+  )
+
+  return true
+}

script/set_environment_variables.sh

@@ -1,17 +0,0 @@
-#!/usr/bin/env bash
-
-{
-    echo "FLUTTER_VERSION=$(cue eval -e 'flutter.version' "$VERSION_MANIFEST" | tr -d '"')"
-
-    echo "FASTLANE_VERSION=$(cue eval -e 'fastlane.version' "$VERSION_MANIFEST" | tr -d '"')"
-
-    echo "ANDROID_BUILD_TOOLS_VERSION=$(cue eval -e 'android.buildTools.version' "$VERSION_MANIFEST" | tr -d '"')"
-
-    echo "ANDROID_PLATFORM_VERSIONS=$(cue eval -e 'strings.Join([for p in android.platforms {"\(p.version)"}], " ")' "$VERSION_MANIFEST" | tr -d '"\n')"
-
-    echo "ANDROID_NDK_VERSION=$(cue eval -e 'android.ndk.version' "$VERSION_MANIFEST" | tr -d '"')"
-
-    echo "CMAKE_VERSION=$(cue eval -e 'android.cmake.version' "$VERSION_MANIFEST" | tr -d '"')"
-
-    echo "IMAGE_REPOSITORY_PATH=$GITHUB_REPOSITORY_OWNER/$IMAGE_REPOSITORY_NAME"
-} >>"$GITHUB_ENV"

script/updateFlutterVersion.js

@@ -10,22 +10,21 @@ module.exports = async ({ core, fetch }) => {
    * @param {*} fileUrl
    * @returns object|boolean
    */
-  async function downloadReleases(fileUrl) {
+  async function downloadReleases(core, fileUrl) {
     try {
       const response = await fetch(fileUrl)
 
       return response.json()
     } catch (error) {
-      console.error(
-        `An error occurred while requesting the file URL: ${fileUrl}`,
-        error
+      core.error(
+        `An error occurred while requesting the file URL ${fileUrl}: ${error}`
       )
 
       return false
     }
   }
 
-  const linuxReleasesResponse = await downloadReleases(linuxReleasesUrl)
+  const linuxReleasesResponse = await downloadReleases(core, linuxReleasesUrl)
 
   if (linuxReleasesResponse === false) {
     core.setFailed(
@@ -46,6 +45,12 @@ module.exports = async ({ core, fetch }) => {
 
   const { version, channel, hash: commit } = latestRelease
 
+  if (oldJson.flutter.version === version) {
+    core.info(`Flutter version ${version} is already set.`)
+
+    return false
+  }
+
   // Update result file, i.e. version.json
   const newJson = {
     ...oldJson,
@@ -60,4 +65,6 @@ module.exports = async ({ core, fetch }) => {
   resultJson = JSON.stringify(newJson, null, 4)
   fs.writeFileSync(resultPath, `${resultJson}\n`)
   core.exportVariable('FLUTTER_VERSION', version)
+
+  return true
 }

script/update_changelog.sh

@@ -1,3 +1,3 @@
 # TODO: Add image registry URLs to the release changelog
 
-npx git-cliff -t 3.29.2 -c github-keepachangelog -o changelog.md
+npx git-cliff -t 3.29.3 -o changelog.md

script/update_test.sh

@@ -1,5 +1,4 @@
 #!/usr/bin/env sh
-
 # TODO: Update all versions used in android.yml from version.json, like NDK, CMake, etc.
 
 # Path to the JSON and YAML files
@@ -12,6 +11,8 @@ android_cmdline_tools_version=$(cue eval -e 'android.cmdlineTools.version' "$ver
 android_cmdline_tools_test_expected_content="Pkg.Revision=$android_cmdline_tools_version
 Pkg.Path=cmdline-tools;$android_cmdline_tools_version
 Pkg.Desc=Android SDK Command-line Tools"
+android_ndk_version=$(cue eval -e 'android.ndk.version' "$version_file_path" | tr -d '"')
+android_sdk_build_tools_version=$(cue eval -e 'android.buildTools.version' "$version_file_path" | tr -d '"')
 
 # Check if the version value is not empty
 if [ -z "$android_cmdline_tools_version" ]; then
@@ -21,8 +22,8 @@ fi
 
 
 # Update the version YAML file using cue
-cue export config/android.cue -l input: ./test/android.yml -t android_cmdline_tools_version="$android_cmdline_tools_version" -t android_cmdline_tools_test_expected_content="$android_cmdline_tools_test_expected_content" -e output --out yaml >"$temp_file_path"
+cue export config/android.cue -l input: ./test/android.yml -t android_cmdline_tools_version="$android_cmdline_tools_version" -t android_cmdline_tools_test_expected_content="$android_cmdline_tools_test_expected_content" -t android_ndk_version="$android_ndk_version" -t android_sdk_build_tools_version="$android_sdk_build_tools_version" -e output --out yaml >"$temp_file_path"
 mv "$temp_file_path" "$test_file_path"
 
 # Write progress
-echo "Updated $test_file_path with android_cmdline_tools_version: $android_cmdline_tools_version"
+echo "Updated $test_file_path with android_cmdline_tools_version=$android_cmdline_tools_version, android_ndk_version=$android_ndk_version"

test/android.yml

@@ -24,13 +24,13 @@ commandTests:
     args:
       - /home/flutter/sdks/android-sdk/build-tools
     expectedOutput:
-      - 34.0.0
+      - 35.0.0
   - name: Android NDK is pinned
     command: ls
     args:
       - /home/flutter/sdks/android-sdk/ndk
     expectedOutput:
-      - 26.3.11579264
+      - 28.2.13676358
   - name: CMake is pinned
     command: ls
     args:
@@ -84,12 +84,12 @@ commandTests:
     excludedOutput:
       - Sending anonymous analytics information
 fileContentTests:
-  - name: Android SDK Command-line Tools is version 12.0
+  - name: Android SDK Command-line Tools is version 20.0
     path: /home/flutter/sdks/android-sdk/cmdline-tools/latest/source.properties
     expectedContents:
       - |-
-        Pkg.Revision=12.0
-        Pkg.Path=cmdline-tools;12.0
+        Pkg.Revision=20.0
+        Pkg.Path=cmdline-tools;20.0
         Pkg.Desc=Android SDK Command-line Tools
   - name: Dart and Flutter analytics are disabled
     path: /home/flutter/.dart-tool/dart-flutter-telemetry.config

windows.Dockerfile

@@ -0,0 +1,88 @@
+# escape=`
+
+FROM mcr.microsoft.com/windows/servercore:ltsc2025@sha256:eb8ed8a3de3aad8458468075c3e0b7755174867e96705c4f2553e98ec5d55d95 as flutter
+
+SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]
+
+ARG git_version=2.46.0
+ARG git_installation_path="C:\Program Files\Git"
+
+# TODO: Find a way to pass $env:USERPROFILE instead of hardcoding C:\Users\ContainerUser. It's hardcoded because  environment variables in Windows container works by setting for the Machine scope and that will have $env:USERPROFILE as C:\Users\ContainerAdministrator instead.
+ENV USERPROFILE="C:\Users\ContainerUser"
+ENV SDK_ROOT="${USERPROFILE}\sdks"
+ENV FLUTTER_ROOT="${SDK_ROOT}\flutter"
+# Set FLUTTER_GIT_URL to fix warning: "Upstream repository unknown source is not a standard remote. Set environment variable "FLUTTER_GIT_URL" to unknown source to dismiss this error."
+ENV FLUTTER_GIT_URL="unknown source"
+
+WORKDIR "$USERPROFILE"
+
+# Install Git because is required by Flutter
+RUN $installer = \"MinGit-${env:git_version}-busybox-64-bit.zip\"; `
+    $url = \"https://github.com/git-for-windows/git/releases/download/v${env:git_version}.windows.1/${installer}\"; `
+    Invoke-WebRequest -Uri "$url" -OutFile "$installer"; `
+    Expand-Archive -Path "$installer" -DestinationPath "$env:git_installation_path"; `
+    Remove-Item -Path "$installer"; 
+
+# The user ContainerAdministrator must be used because is the one that has permissions to set the system PATH
+USER ContainerAdministrator
+
+# The PATH variable will be updated in the next shell session, so the RUN command that sets the PATH needs to be separated from the one that uses it
+RUN [Environment]::SetEnvironmentVariable('PATH', \"${env:PATH};${env:git_installation_path}\cmd;${env:git_installation_path}\usr\bin;${env:FLUTTER_ROOT}\bin;${env:FLUTTER_ROOT}\bin\cache\dart-sdk\bin;C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\msbuild\current\bin\", 'Machine');
+
+# MinGit has a circular reference in its global configuration, which causes git to crash
+# See https://github.com/git-for-windows/git/issues/2387#issuecomment-679367609
+# hadolint ignore=DL3059
+RUN $env:GIT_CONFIG_NOSYSTEM=1; git config --system --unset-all include.path;
+
+# Switch to the non-admin user when the admin user is not needed anymore
+USER ContainerUser
+
+ARG flutter_version
+
+RUN git clone `
+    --depth 1 `
+    --branch "$env:flutter_version" `
+    https://github.com/flutter/flutter `
+    "$env:FLUTTER_ROOT"; `
+    # To fix fatal: detected dubious ownership in repository at 'C:/Users/ContainerUser/sdks/flutter/.git' owned by BUILTIN/Administrators but the current user is: User Manager/ContainerUser
+    git config --global --add safe.directory "$env:FLUTTER_ROOT"; `
+    flutter --version; `
+    dart --disable-analytics; `
+    flutter config `
+    --no-cli-animations `
+    --no-analytics `
+    --no-enable-android `
+    --no-enable-web `
+    --no-enable-linux-desktop `
+    --enable-windows-desktop `
+    --no-enable-fuchsia `
+    --no-enable-custom-devices `
+    --no-enable-ios `
+    --no-enable-macos-desktop; `
+    flutter doctor --verbose; `
+    flutter precache --windows; `
+    flutter create build_app;
+
+
+# The user ContainerAdministrator must be used because is the one that has permissions to install with vs_BuildTools
+USER ContainerAdministrator
+# Download the Build Tools bootstrapper
+# See https://learn.microsoft.com/en-us/visualstudio/install/build-tools-container?view=vs-2022
+RUN Invoke-WebRequest -Uri https://aka.ms/vs/17/release/vs_buildtools.exe -OutFile vs_BuildTools.exe; `
+    Start-Process vs_BuildTools.exe -ArgumentList '--quiet --wait --norestart --nocache `
+    --add Microsoft.VisualStudio.Component.VC.CMake.Project `
+    --add Microsoft.VisualStudio.Component.Windows11SDK.22621 `
+    --add Microsoft.VisualStudio.Workload.VCTools' `
+    -Wait; `
+    Remove-Item vs_BuildTools.exe;
+USER ContainerUser
+
+WORKDIR "$USERPROFILE/build_app"
+RUN flutter build windows;
+
+WORKDIR "$USERPROFILE"
+COPY ./script/docker_windows_entrypoint.ps1 "docker_entrypoint.ps1"
+
+ENTRYPOINT "C:\Users\ContainerUser\docker_entrypoint.ps1"
+
+RUN Remove-Item -Recurse build_app;

windows.md

@@ -0,0 +1,124 @@
+# Windows
+
+## Swich between Linux and Windows containers
+
+& $Env:ProgramFiles\Docker\Docker\DockerCli.exe -SwitchDaemon
+
+## TODO
+
+1. Install tools
+
+```powershell`
+   # # needed? No
+#    --add Microsoft.Component.MSBuild' `
+   # # needed? No
+   # --add Microsoft.VisualStudio.Component.TestTools.BuildTools `
+   # # needed? No
+   # --add Microsoft.VisualStudio.Component.VC.ASAN `
+   # # needed? no
+   # # --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 `
+RUN Invoke-WebRequest -Uri https://aka.ms/vs/17/release/vs_buildtools.exe -OutFile vs_BuildTools.exe; `
+    Start-Process vs_BuildTools.exe -ArgumentList '--quiet --wait --norestart --nocache `
+   # # needed? yes
+   # --add Microsoft.VisualStudio.Component.VC.CMake.Project `
+   # # needed? Yes
+   # --add Microsoft.VisualStudio.Component.Windows11SDK.22621 `
+   # # needed?
+   # --add Microsoft.VisualStudio.Workload.VCTools' `
+    -Wait; `
+    Remove-Item vs_BuildTools.exe;
+```
+
+1. Check how it can be run in Github actions.
+1. Check how it can be run in Gitlab CI/CD.
+1. Test where is installed.
+1. Test that path to powershell.exe exists.
+1. Test with a snapshot of flutter config to determine if new feature flags should be enabled or disabled.
+1. Test that Build Tools were installed in C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\msbuild\current\bin
+1. Check [Windows installation requirements for Flutter](https://docs.flutter.dev/get-started/install/windows/desktop)
+1. Add docs explaining to use `$VerbosePreference = 'Continue';` in the SHELL to debug unexpected pwsh problems.
+
+## Open issue in windows Docker images repo
+
+1. Some images can be pulled while others give error:
+
+    ```text
+    Error response from daemon: Get "https://mcr.microsoft.com/v2/": read tcp [2a0c:5a84:e100:e501::a97c]:58039->[2603:1061:f:101::10]:443: wsarecv: An existing connection was forcibly closed by the remote host.
+    ```
+
+Debug with `curl -A github165 -v https://mcr.microsoft.com/v2/powershell/manifests/lts-nanoserver-ltsc2022`
+
+## Contribute flutter upstream
+
+1. Remove `WHERE` in bin\internal\shared.bat and use instead:
+
+    ```batch
+    pwsh.exe -Command "exit" >nul 2>&1 && (
+            SET powershell_executable=pwsh.exe
+        ) || powershell.exe -Command "exit" >nul 2>&1 && (
+            SET powershell_executable=PowerShell.exe
+        ) || (
+            ECHO Error: PowerShell executable not found.                        1>&2
+            ECHO        Either pwsh.exe or PowerShell.exe must be in your PATH. 1>&2
+            EXIT 1
+        )
+    ```
+
+1. Find if the executable should be pwsh or powershell and put it in a service to remove the hardcoded "powershell" in multiple places, like in:
+
+    - dev\devicelab\lib\framework\running_processes.dart
+    - packages\flutter_tools\lib\src\windows\windows_version_validator.dart
+
+## Steps to reproduce in Docker
+
+1. Enable Windows Developer Settings to solve error:
+
+    >Building with plugins requires symlink support.
+    >
+    >Please enable Developer Mode in your system settings. Run
+    > start ms-settings:developers
+    >to open settings.
+
+    ```powershell
+    reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowDevelopmentWithoutDevLicense" /d "1"
+    ```
+
+1. For CI/CD
+
+    1. Docker version must be pinned in Github workflow to avoid breaking changes: with escaping `\"` syntax inside RUN directive, etc.
+
+    1. Packaging tool in Windows: <https://pub.dev/packages/msix> . It uses the executables:
+
+        - [makeappx.exe](https://learn.microsoft.com/en-us/windows/win32/appxpkg/make-appx-package--makeappx-exe-)
+        - [makepri.exe](https://learn.microsoft.com/en-us/windows/uwp/app-resources/makepri-exe-command-options)
+        - [signtool.exe](https://learn.microsoft.com/en-us/dotnet/framework/tools/signtool-exe)
+
+        - certificate
+            - Make a note that --install-certificate should be "false" or configured because the certificate can't be installed as ContainerUser.
+            
+            ```powershell
+            # OK
+            Import-PfxCertificate -FilePath "C:\Users\ContainerUser\AppData\Local\Pub\Cache\hosted\pub.dev\msix-3.16.8\lib\assets\test_certificate.pfx" -Password (ConvertTo-SecureString -AsPlainText -Force "1234") -CertStoreLocation Cert:\LocalMachine\Root
+
+            # Doesn't work
+            Import-PfxCertificate -FilePath "C:\Users\ContainerUser\AppData\Local\Pub\Cache\hosted\pub.dev\msix-3.16.8\lib\assets\test_certificate.pfx" -Password (ConvertTo-SecureString -AsPlainText -Force "1234")
+            ```
+
+    1. Install msstore CLI https://github.com/microsoft/msstore-cli It seems behind StoreBroker but it looks that it's going to be the primary and recommended way to publish to Microsoft Store
+        
+        - According to the [msstore guide](https://learn.microsoft.com/en-us/windows/apps/publish/msstore-dev-cli/commands?pivots=msstoredevcli-installer-linux#installation), It will be needed to install Microsoft.NetCore.Component.Runtime.8.0 with vs_BuildTools
+
+    1. From <https://github.com/tauu/flutter-windows-builder/blob/main/Dockerfile> => install <https://github.com/microsoft/StoreBroker> This is currently the primary tool to publish to Microsoft Store
+
+        - Not installed right now
+
+    1. Install the [Windows App Certification Kit](https://learn.microsoft.com/en-us/windows/uwp/debug-test-perf/windows-app-certification-kit) or the [Windows SDK that already includes it](https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/)
+        
+        - Installed currently by one of the workloads in vs_BuildTools
+
+## References
+
+- [How environment variables work on Windows containers?](https://blog.sixeyed.com/windows-weekly-dockerfile-14-environment-variables/)
+- [Windows deployment in Flutter](https://docs.flutter.dev/deployment/windows)
+- [vs_BuildTools workloads](https://learn.microsoft.com/en-us/visualstudio/install/workload-component-id-vs-build-tools?view=vs-2022&preserve-view=true)
+- Useful Dockerfile https://git.openprivacy.ca/openprivacy/flutter-desktop/src/branch/main/windows/Dockerfile