Chargeline docs
v1.0.0
Get help
● Ship

Release builds
signing and uploading.

The commands that build a release, and how to sign it with your own keys.

APKApp BundleIPA

01Version number

In app/pubspec.yaml the line version: 1.0.0+1 is name + build number. Raise the build number for every upload.

02Android

Windows users

Flutter runs natively on Windows: use PowerShell for the flutter commands and Android builds (iOS builds need a Mac). For the server, either install Node.js 22.12+ for Windows and use PowerShell (replace cp .env.example .env with Copy-Item .env.example .env; there is no openssl by default, so use WSL or any random 64-character hex string), or run the commands in WSL 2 (Ubuntu) or Docker. macOS and Linux users can ignore this note.

  1. Create an upload key (keep it and its passwords safe, forever):
    keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
  2. Create app/android/key.properties with storePassword, keyPassword, keyAlias, storeFile, and edit app/android/app/build.gradle.kts so the release build type uses a signingConfig built from it. As shipped, release builds are signed with the debug key (line signingConfig = signingConfigs.getByName("debug")) and Play will refuse them.
  3. Build an App Bundle for Play:
    cd app
    flutter build appbundle --release \
      --dart-define=API_BASE_URL=https://your-server.example
    or an APK: flutter build apk --release. Result: build/app/outputs/.
  4. Upload the .aab in Play Console, fill in the data safety form and the foreground service declaration (text), and release to a test track first.

Do not commit key.properties or the keystore.

03iOS

  1. Set your team and bundle id in Xcode (Rename).
  2. Build:
    cd app
    flutter build ipa --release --dart-define=API_BASE_URL=https://your-server.example
    or open ios/Runner.xcworkspace, choose Any iOS Device, Product, Archive.
  3. Upload the archive with Xcode Organizer (Distribute App, App Store Connect) or Transporter.
  4. In App Store Connect add the in-app purchases to the version, screenshots, and the privacy details.

The author's check was flutter build ios --no-codesign (it works) and flutter build apk --release (55.8 MB, debug-signed). Signed store builds are yours to run.

04Listing wording

Describe the app as a charging log with a Night Strip. Keep to what the app does: it records charges. Do not promise that background logging works on every phone.