ADT Flutter Tools

A desktop GUI utility (Python + Tkinter) that automates the routine work around Flutter projects: building releases for all platforms, bumping versions, updating the changelog, pushing to git, regenerating json_serializable code, and adding non-breaking spaces to translation files.

It targets the workflow used at AppsDevTeam, where each Flutter project carries an adt_tools_config.env file describing its package name, flavors, environments, Firebase App IDs, dart-defines and per-flavor GoogleService-Info.plist paths.

Features

The app is organised into three tabs.

Build

Runs a parametrised Flutter build with all the steps you would normally chain by hand.

• Targets: apk, appbundle, ipa, web, macos, linux, windows.
• Modes: release, debug, profile.
• Flavors and environments resolved from adt_tools_config.env — FIREBASE_APP_ID, IOS_PLIST_*, DART_DEFINES_* are picked per <flavor>_<env> and copied / passed to the Flutter command.
• Version bumping: major / minor / patch / build directly in pubspec.yaml, with automatic revert if the build fails.
• CHANGELOG.md update — appends the new version with the bumped number.
• Obfuscation toggle (--obfuscate --split-debug-info) for mobile builds.
• Symbol upload to Firebase Crashlytics — Android via the Firebase CLI (crashlytics:symbols:upload), iOS via the upload-symbols script that ships with the FirebaseCrashlytics CocoaPod.
• CocoaPods install for iOS (clean reinstall before the build).
• Git push of pubspec.yaml and CHANGELOG.md after a successful build.
• Web extras: optional check for the sqlite3.wasm file expected by some apps.
• Presets — saved combinations of the above so you can reproduce a release with one click.

The full output of every step is streamed into an in-app console.

JsonSerializable

Runs the standard codegen sequence in order:

flutter clean
flutter packages pub get
dart run build_runner build --delete-conflicting-outputs

Non-breaking spaces (Nezalomitelná mezera)

Walks translation JSON files (cs, sk, en, de) and inserts   after one-letter prepositions and conjunctions (a, i, k, o, s, u, v, z for Czech/Slovak; language-specific lists for the others). Skips strings that already contain a non-breaking space or a newline.

Project configuration

Each Flutter project the tool operates on contains an adt_tools_config.env file at its root. Example:

PACKAGE_NAME="com.yourcompany.yourapp"

# Optional: desktop binary name
# DESKTOP_APP_NAME="MyApp"

# Per-flavor / per-env Firebase App IDs (used for symbol upload)
FIREBASE_APP_ID_cashdesk_prod="1:..."
FIREBASE_APP_ID_cashdesk_prerelease="1:..."

# Per-flavor / per-env dart defines
DART_DEFINES_SHOW_BANNER_prod=false
DART_DEFINES_SHOW_BANNER_prerelease=true

# Per-flavor / per-env GoogleService-Info.plist
IOS_PLIST_DEFAULT=ios/Firebase/GoogleService-Info.plist
IOS_PLIST_cashdesk_prod=ios/Firebase/GoogleService-Info.plist
IOS_PLIST_cashdesk_prerelease=ios/Firebase/GoogleService-Info-Prerelease.plist

Keys without a flavor/env suffix are used as a fallback. The tool will create a stub file the first time you point it at a project.

Requirements

• Required: Python 3, Tkinter, Git, Flutter SDK.
• Optional: Firebase CLI (Crashlytics symbol upload), CocoaPods (iOS builds, macOS only).

Setup

Run the interactive installer once. It detects your OS and the available package managers (brew, npm, gem, apt, dnf, pacman, zypper, snap, winget, scoop, choco) and offers to install everything that is missing. When more than one option is available it asks which one you want to use.

./setup.sh

If the script is not executable (e.g. after downloading a ZIP), make it executable first:

chmod +x setup.sh

On Windows use Git Bash, WSL, or bash setup.sh from PowerShell.

Running

python3 main.py

On first launch, point the project selector at a Flutter project directory. The tool remembers it for next time.

Building a release binary

A PyInstaller spec is included. The repository's release helper does the work:

python3 build_release.py

The output binary is placed in dist/.

Repository layout

main.py             — entry point
setup.sh            — interactive dependency installer
build_release.py    — PyInstaller wrapper
src/
  constants.py      — config keys and the adt_tools_config.env template
  config_manager.py — persisted UI settings (config.json)
  ui/               — Tkinter app, main window, project selector, in-app logger
  logic/
    build_logic.py  — orchestrates the full build pipeline
    build_common.py — pubspec parsing, version bumping, changelog, git push
    build_android.py / build_ios.py / build_web.py / build_desktop.py
    serializable_logic.py — JsonSerializable tab actions
    nbsp_logic.py         — non-breaking space insertion