So you've built a Flutter app and you're ready to release it out into the world — congratulations! This guide will show you how to deploy your Flutter app on the App Store and Google Play.
- Have an Apple Developer account.
- Make sure you adhere to Apple’s guidelines for releasing an app on the app store.
- Prepare your app’s icons and launch screens.
1- Prepare for building
Before you can build and release your app on the App Store, you need to create a record for it using App Store Connect. But first, you need to register a unique bundle ID for your app. This can be done by logging into your Apple Developer account and following these steps:
- Open the App IDs page.
- Select + to create a new Bundle ID.
- Fill out the needed information: App Name and Explicit App ID.
- If your app needs specific services, select them then select Continue.
- Review the details and select Register to finish.
Now that we have a unique bundle ID, it’s time to create a record for your app on the App Store Connect.
- Log in to the App Store Connect.
- Select My Apps.
- Select + then New App.
- Fill in your app details and make sure iOS is selected, then select Create.
- From the sidebar, select App Information.
- In the "General Information" section, select the Bundle ID that you registered above.
2- Adjust Xcode project settings for release
You’ve set everything up from Apple’s side, and next you'll adjust your Xcode project’s settings to prepare your app for release. Go ahead and fire up Xcode.
- Open Runner.xcworkspace that is inside your app’s iOS folder.
- From the Xcode project navigator, select the Runner project.
- Then, select the Runner target in the main view sidebar.
- Go to the General tab.
- In the Identity section, fill out the information and make sure the Bundle Identifier is the one registered on App Store Connect.
- In the Signing & Capabilities section, make sure Automatically manage signing is checked and select your team.
- Go to the Deployment section of the Build Settings tab and set iOS Deployment Target to the minimum iOS version you support.
- Fill out the rest of the information as needed.
- Next, you'll update your app’s icon and launch image by selecting Assets.xcassets in the Runner folder from Xcode’s project navigator.
3- Build and upload your app
At this point, all the settings have been updated for release and there is a placeholder ready on App Store Connect, which means you can build and release.
- From the command line, run flutter build ipa to generate an Xcode build archive.
- You can also append --build-name and --build-number to override the default version and build numbers, respectively.
- Then go back to Xcode and open the newly created archive from your project's archive directory.
- Check the information then select Validate to build.
- Once the archive is successfully validated, select Distribute App.
Back on App Store Connect, check the status of your build from the Activities tab. Once it’s ready to release:
- Go to Pricing and Availability and fill out the required information.
- From the sidebar, select the status.
- Select Prepare for Submission and complete all required fields.
- Select Submit for Review.
That’s it! Your app will now be uploaded to the App Store. Apple will review your app before releasing and keep you updated on the status of your app.
- Have an Android app ready for release.
- Add a launcher icon and prepare all your app’s assets.
1- Prepare for release
Before you can publish your Flutter app to Google Play, you need to add a digital signature.
If you don’t already have a keystore, create one
On Mac, use the following command:
On Windows, use the following command:
Create a file named /android/key.properties that will reference your keystore, it will look like this:
Configure signing in Gradle
You will find your Gradle file at /android/app/build.gradle. Start editing and follow these steps:
Replace this block:
With the keystore information that we just created:
Then, replace this block:
With the signing configuration:
- Then, go to the defaultConfig block.
- Enter a final unique applicationId.
- Give your app a versionName and versionCode.
- Specify the minimum SDK API level that the app needs to run.
Your app’s Gradle file is now configured and your release builds will be signed automatically.
Review the app manifest and make sure everything is ready
The file AndroidManifest.xml will be located in /android/app/src/main. Open it and review the values and permissions you need before building.
2- Build and release the app
Now you'll build your app’s APK so it can be uploaded to the Google Play Store. Go to your command line and follow these steps:
- Enter cd
- Run flutter build apk
If everything goes well, you will have an APK ready at /build/app/outputs/apk/release/app.apk
3- Publish to the Google Play Store
Your app is ready! Next, follow this step-by-step guide to upload an APK to the Google Play Store.
- 12 Essential Tools for the Flutter Mobile App Developer
- What is mobile application performance monitoring?
- App performance metrics and KPIs
- Mobile app quality: An essential guide
Instabug empowers mobile teams to maintain industry-leading apps with mobile-focused, user-centric stability and performance monitoring.