iOS Setup & Installation Guide

This guide provides a simplified iOS setup process for AeroKites Edu. All known iOS build issues have been pre-configured and resolved in the included ios/ folder.

🖥️ System Requirements:

Flutter Version: 3.35.1 Latest Stable
Dart Version: 3.9.0
Xcode Version: 16.x (Latest)
macOS: Sequoia 15.6
Firebase SDK: 10.25.0
iOS Deployment Target: 13.0+

✅ Pre-Configured iOS Build Fixes

All known iOS build issues have been resolved in the included ios/ folder:

gRPC Compilation Issues: ✅ The -G flag error is gone
C++ Template Parsing: ✅ The C++ template parsing error is gone
Firebase Integration: ✅ Modular headers and build settings optimized
Xcode 16 Compatibility: ✅ All compiler flags and settings pre-configured

No manual troubleshooting required! The project is ready to build immediately.

Step 13: iOS Setup & Dependencies

Prerequisites

macOS with Xcode 16.x - Latest version recommended
CocoaPods - Install via: sudo gem install cocoapods
Flutter 3.35.1 - Ensure Flutter is properly installed
Firebase Project - Configured in Firebase Console

💡 Why This Setup is Simplified

Our project includes all common iOS build fixes pre-configured in the ios/ folder, eliminating the need for complex troubleshooting steps. This allows developers to focus on building and deploying their app rather than solving build configuration issues.

Installation Steps

Step 1: Install Flutter Dependencies

From your project root directory:

flutter pub get

Step 2: Install iOS Dependencies

Navigate to the iOS folder and install CocoaPods dependencies:

cd ios
pod install --repo-update
cd ..

⚠️ Important: The --repo-update flag ensures you get the latest pod versions and applies all pre-configured fixes automatically.

Step 3: Verify iOS Build

Test that everything builds correctly:

flutter build ios --no-codesign

🎉 Build Success!

If the build completes without errors, your iOS setup is complete and ready for development and testing.

Testing Your iOS App

Simulator Testing

Run the app on iOS Simulator:

flutter run -d "iPhone 15 Pro"

Device Testing

For physical device testing, ensure your device is connected and run:

flutter devices
flutter run -d [DEVICE_ID]

Common Commands

Clean Build (Recommended for First Time)

flutter clean
flutter pub get
cd ios && pod install --repo-update && cd ..
flutter build ios --no-codesign

Update Dependencies

flutter pub get
cd ios && pod install && cd ..

Troubleshooting

🔧 If You Encounter Issues

Since all known iOS build issues are pre-fixed, any problems are likely environment-related:

Verify Flutter Version: flutter --version
Check Xcode Version: xcode-select --print-path
Verify CocoaPods: pod --version
Clean and Rebuild: Use the clean build commands above

What's Pre-Configured

The included ios/ folder contains:

Podfile - Optimized for Xcode 16 and Firebase 10.25.0
Build Settings - Pre-configured for compatibility
gRPC Fixes - Community-validated solutions applied
C++ Compiler Settings - Xcode 16 optimization
Firebase Integration - Modular headers and dependencies

🎨 Customizing iOS App Icons

Before building your iOS app, customize the app icons with your school's branding:

iOS App Icons

Replace all files in: ios/Runner/Assets.xcassets/AppIcon.appiconset/

Required Sizes:

Icon-App-20x20@1x.png (20x20 px)
Icon-App-20x20@2x.png (40x40 px)
Icon-App-20x20@3x.png (60x60 px)
Icon-App-29x29@1x.png (29x29 px)
Icon-App-29x29@2x.png (58x58 px)
Icon-App-29x29@3x.png (87x87 px)
Icon-App-40x40@1x.png (40x40 px)
Icon-App-40x40@2x.png (80x80 px)
Icon-App-40x40@3x.png (120x120 px)
Icon-App-60x60@2x.png (120x120 px)
Icon-App-60x60@3x.png (180x180 px)
Icon-App-76x76@1x.png (76x76 px)
Icon-App-76x76@2x.png (152x152 px)
Icon-App-83.5x83.5@2x.png (167x167 px)
Icon-App-1024x1024@1x.png (1024x1024 px) - Most Important for App Store

💡 iOS Icon Requirements

Format: PNG only
Background: No transparency (Apple adds rounded corners)
Design: Simple, recognizable at small sizes
Colors: Avoid using too many colors

⚠️ Important: The 1024x1024 px icon is mandatory for App Store submission. Icon changes require a full app restart.

🚀 Ready for Production

Your iOS setup is now complete and optimized for:

✅ Development and testing
✅ App Store deployment
✅ Firebase integration
✅ Modern iOS versions