This section guides you through running the Flutter project on Android and iOS devices or emulators, with visual steps and commands.
📱 Run Project on Android #
✅ Requirements #
- Flutter SDK installed
- Android Studio or VS Code
- Android Emulator or real device
- USB debugging enabled (for real devices)
🧭 Steps #
Step 1: Open Project in Terminal or IDE #
cd your_flutter_project/
Step 2: Install Dependencies #
flutter pub get
💡 This fetches all required packages listed in
pubspec.yaml.
Step 3: Start Emulator or Connect a Device #
Use Android Studio → Tools → Device Manager → Launch Emulator
Step 4: Run the App #
flutter run
🍏 Run Project on iOS #
⚠️ iOS builds require macOS with Xcode installed.
✅ Requirements #
- macOS with Xcode
- Flutter SDK
- iPhone (physical) or iOS Simulator
- Apple Developer account (for real device deployment)
Step 1: Open Project Directory #
cd your_flutter_project/
flutter pub get
Step 2: Open Xcode #
open ios/Runner.xcworkspace
Step 3: Set Team & Signing Info #
In Xcode → Select “Runner” project → Go to “Signing & Capabilities” tab
Choose your Apple Developer Team.
Step 4: Run the App #
- Choose a device from the top device bar in Xcode
- Click ▶️ Run
✅ Quick Troubleshooting #
| Problem | Solution |
|---|---|
| Device not detected | Run flutter devices |
| App crashes on launch | Run flutter clean then flutter pub get |
| iOS build fails | Ensure Xcode project has valid signing |
📄 Notes #
Use flutter doctor to diagnose environment issues.
Always run your app in debug mode during development and release mode for production.
