Skip to content

README.md

Latest commit

 

History

History
172 lines (117 loc) · 4.26 KB

README.md

File metadata and controls

172 lines (117 loc) · 4.26 KB

flutter-tool (community-distro)

A zero-dependency CLI tool that downloads, installs, and manages Flutter SDK on ARM64 Linux — powered by community-maintained GitHub releases.

Default source: zhzhzhy/Flutter-SDK-ARM64

System Requirements

Requirement Details
OS Linux
Architecture ARM64
Shell Bash
Dependencies wget, unzip, tar
Optional jq (faster GitHub API parsing)

Installation

curl -L https://github.com/dev-boffin-io/flutter-tool-dev/raw/refs/heads/master/bin/flutter-tool \
  -o flutter-tool

chmod +x flutter-tool
sudo mv flutter-tool /usr/local/bin/

Usage

flutter-tool <command> [flags]

Commands

Command Description
install Install Flutter ARM64
upgrade Upgrade existing Flutter installation
update Check for a newer version
doctor Run flutter doctor
purge Completely uninstall Flutter
version, -v Show installer version
help, -h Show help menu

Flags

Flag Description
--yes, -y Auto-confirm all prompts
--no-api Skip GitHub API; use fallback download URL
--purge-cache Also remove the cache directory during purge
--upgrade Upgrade Flutter if already installed
--fix-dart Replace bundled Dart SDK with the official ARM64 binary

Examples

# Install Flutter
flutter-tool install

# Install and fix Dart SDK for ARM64 compatibility
flutter-tool install --fix-dart

# Auto-upgrade if a newer version is available
flutter-tool update --yes

# Install without using the GitHub API
flutter-tool install --no-api

# Completely remove Flutter including cache
flutter-tool purge --purge-cache

Post-Installation

After installation, two helper functions are added to your ~/.bashrc:

# Reload your terminal
source ~/.bashrc

# Add Flutter to PATH
flutter-on

# Remove Flutter from PATH
flutter-off

Environment Variables

Use a custom source repo or pin a specific version:

export FLUTTER_REPO_URL="username/my-flutter-arm64-repo"
export FLUTTER_VERSION="3.19.0"

flutter-tool install
Variable Default Description
FLUTTER_REPO_URL zhzhzhy/Flutter-SDK-ARM64 GitHub owner/repo
FLUTTER_VERSION latest Specific release tag or latest

Installation Paths

Purpose Path
Flutter SDK ~/.flutter-tool/flutter/
Flutter binary ~/.flutter-tool/flutter/bin/flutter
Cache ~/.cache/flutter-tool/
Bin dir ~/.local/bin/

When to Use --fix-dart

Some Flutter releases bundle a Dart SDK that is not compatible with ARM64. If you encounter Dart-related errors after installation, run:

flutter-tool install --fix-dart

This downloads the official ARM64 Dart SDK from Google's storage and replaces the bundled one.

How It Works

flutter-tool install
  │
  ├── 1. Detect latest release tag via GitHub API
  ├── 2. Find and download the ARM64 asset (.zip or .tar.xz)
  ├── 3. Extract to ~/.flutter-tool/flutter/
  ├── 4. Run Flutter preflight (cache warmup)
  ├── 5. Optionally replace Dart SDK (--fix-dart)
  ├── 6. Run flutter doctor
  └── 7. Inject flutter-on / flutter-off into ~/.bashrc

🙏 Special Thanks

This tool wouldn't exist without the incredible work of the community members who build and maintain ARM64 Flutter SDK releases. Huge, heartfelt thanks to:

zhzhzhy — zhzhzhy/Flutter-SDK-ARM64

The backbone of this project. zhzhzhy consistently builds and publishes Flutter SDK releases compiled for ARM64 Linux — something the official Flutter team doesn't provide. Without this repository, running Flutter on ARM64 hardware would be a painful, manual process for thousands of developers. This tool is essentially a polished wrapper around their incredible effort.

If you find their work useful, please consider starring their repository and showing your appreciation.

License

See the LICENSE file for license details.