Wrapply logo Wrapply Tutorials
🍎 iOS from Flutter source code

How to create an iOS app from your Wrapply Flutter source code

If you purchased the complete Flutter source code, you can build an iOS app using Flutter, Xcode and an Apple Developer account. This guide explains the basic workflow: open the project, configure the iOS bundle identifier, set signing, test on device and generate an IPA.

Before you start

iOS builds require Apple-specific tools and signing configuration. Unlike Android APK generation, iOS distribution depends on Apple certificates, provisioning profiles and a valid Apple Developer account.

macOS computer
iOS builds must be created on macOS because Xcode is required.
Xcode installed
Install Xcode from the Mac App Store or Apple Developer portal.
Flutter SDK
Flutter must be installed and correctly configured on your Mac.
Apple Developer account
Required for real device signing, TestFlight and App Store publishing.
Wrapply can generate and prepare iOS builds on request, but final Apple distribution may still require your Apple Developer account, certificates, App Store Connect access and review compliance.

Step-by-step iOS build flow

Use this workflow after extracting the ZIP file containing your Wrapply Flutter source code.

Open the project in Visual Studio Code

Extract the source code ZIP, open the project folder in VS Code and make sure the Flutter and Dart extensions are installed.

Install Flutter dependencies

Run flutter pub get from the project root to download the required packages.

Open the iOS project in Xcode

Open ios/Runner.xcworkspace in Xcode. Do not open only the .xcodeproj file because Flutter iOS projects use CocoaPods.

Update the Bundle Identifier

In Xcode, select Runner, open Signing & Capabilities and set a unique Bundle Identifier such as com.yourcompany.yourapp.

Configure signing

Select your Apple Developer Team and enable automatic signing when possible. Xcode will create or use the correct provisioning profile.

Test the app

Run the app on an iPhone simulator or a real device. For real devices, signing must be correctly configured.

Build the IPA

When the project is ready, generate the iOS release build using Flutter or archive the app directly from Xcode.

Basic commands:
flutter pub get
flutter doctor
cd ios
pod install
cd ..
flutter build ios --release
flutter build ipa --release

Where to change iOS app settings

Most iOS-specific settings are inside the ios folder or in Xcode under the Runner target.

Bundle Identifier
Change it in Xcode under Runner → Signing & Capabilities.
App display name
Usually configured in ios/Runner/Info.plist.
App icon
Replace iOS icon assets in ios/Runner/Assets.xcassets/AppIcon.appiconset.
Permissions
Add required usage descriptions in Info.plist before using camera, photos, location or notifications.
Signing team
Select your Apple Developer Team in Xcode.
Version and build number
Update version values in pubspec.yaml or Xcode build settings depending on your workflow.

Common iOS build issues

iOS builds can fail when Xcode, CocoaPods, signing or Apple account configuration is incomplete. These are the most common areas to check.

Signing error
Check Apple Developer Team, Bundle Identifier and provisioning profiles in Xcode.
CocoaPods error
Run cd ios, then pod install, then return to the project root.
Flutter doctor issues
Run flutter doctor and fix missing Xcode, CocoaPods or iOS toolchain warnings.
App Store upload issue
Check version number, bundle identifier, signing certificate and App Store Connect app configuration.

Managed iOS build and publishing

If you do not want to manage Xcode, certificates and publishing manually, Wrapply can assist with iOS IPA preparation and App Store publishing. This is useful when you need a production-ready workflow but prefer to avoid Apple signing complexity.

FAQ

Can I build an iOS app on Windows?

No. iOS builds require Xcode, and Xcode runs on macOS. You need a Mac or a managed build service.

Do I need an Apple Developer account?

Yes, for real device distribution, TestFlight and App Store publishing. A free Apple account may work for limited local testing, but production distribution requires the paid developer program.

Does Wrapply generate IPA files automatically?

iOS IPA generation is handled on request because Apple signing requires certificates, provisioning profiles and account-specific configuration.

Can I modify the iOS app after generation?

Yes. If you have the Flutter source code, you can update the Flutter UI, app configuration, bundle identifier, icons, permissions and integrations before rebuilding.