Docs/Build & run

Build & run

FoxTalk is a standard Flutter project — one Dart codebase that builds for both iOS and Android. This page is the shortest path from clone to running on a real device.

Verified on the following toolchain:

Flutter SDK

3.x (match pubspec.lock)

Dart SDK

3.x (bundled with Flutter)

Xcode

16+ (iOS device / Archive)

Android Studio

2024.x (Android SDK 34)

JDK

17 (Gradle 8.13 / Kotlin 2.2)

CocoaPods

1.15+ (iOS dependency manager)

Clone and install dependencies

git clone https://github.com/TangSengDaoDao/TangSengDaoDaoFlutter.git
cd TangSengDaoDaoFlutter
flutter pub get

Android device install

Use a debug APK + adb install — more reliable than flutter run. Get DEVICE_ID from adb devices.

flutter build apk --debug
ADB="$HOME/Library/Android/sdk/platform-tools/adb"
"$ADB" -s <DEVICE_ID> install -r build/app/outputs/flutter-apk/app-debug.apk
"$ADB" -s <DEVICE_ID> shell monkey -p com.example.app 1

iOS device install

Prefer flutter build + xcrun devicectl over flutter run on iOS — avoids occasional hangs over wireless. Release mode picks up the signing team already configured in Runner.xcodeproj.

flutter build ios --release
xcrun devicectl device install app \
  --device <DEVICE_UDID> \
  build/ios/iphoneos/Runner.app

Find the device UDID with flutter devices. The signing team and CODE_SIGN_STYLE=Automatic are written into ios/Runner.xcodeproj/project.pbxproj, so no --team-id flag is needed.

free vs pro entry points

lib/main.dart is the default entry with all modules. Two extra flavor entries — main_free.dart and main_pro.dart — reference module_profile_free.dart / module_profile_pro.dart to ship different module combinations for commercial builds.

# Default entry (all modules via app_modules.dart)
flutter run -t lib/main.dart

# Open-source flavor (core modules only)
flutter run -t lib/main_free.dart

last updated · 2026-06