Callbook 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. npm run keygen is plain Node and works the same in PowerShell. 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 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 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 checks were flutter build ios --no-codesign and flutter build apk --release (debug-signed). Signed store builds are yours to run.

04Listing wording

Describe the app as a private ledger that keeps receipts of market calls and scores them against public daily prices. Keep to what the app does: it records and checks, it does not advise. Do not describe it as a source of tips, do not promise any outcome, and say that stock and ETF prices depend on the price-data account you configure.