Building
Flutter Server Box uses a custom build system (fl_build) for cross-platform builds.
Prerequisites
Section titled “Prerequisites”- Flutter SDK (stable channel)
- Platform-specific tools (Xcode for iOS, Android Studio for Android)
- Rust toolchain (for some native dependencies)
Development Build
Section titled “Development Build”# Run in development modeflutter run
# Run on specific deviceflutter run -d <device-id>Production Build
Section titled “Production Build”The project uses fl_build for building:
# Build for specific platformdart run fl_build -p <platform>
# Available platforms:# - ios# - android# - macos# - linux# - windowsPlatform-Specific Builds
Section titled “Platform-Specific Builds”dart run fl_build -p iosRequires:
- macOS with Xcode
- CocoaPods
- Apple Developer account for signing
Android
Section titled “Android”dart run fl_build -p androidRequires:
- Android SDK
- Java Development Kit
- Keystore for signing
dart run fl_build -p macosdart run fl_build -p linuxWindows
Section titled “Windows”dart run fl_build -p windowsRequires Windows with Visual Studio.
Pre/Post Build
Section titled “Pre/Post Build”The make.dart script handles:
- Metadata generation
- Version string updates
- Platform-specific configurations
Troubleshooting
Section titled “Troubleshooting”Clean Build
Section titled “Clean Build”flutter cleandart run build_runner build --delete-conflicting-outputsflutter pub getVersion Mismatch
Section titled “Version Mismatch”Ensure all dependencies are compatible:
flutter pub upgradeRelease Checklist
Section titled “Release Checklist”- Update version in
pubspec.yaml - Run code generation
- Run tests
- Build for all target platforms
- Test on physical devices
- Create GitHub release