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.
- Make sure that you’ve covered Apple’s guidelines for releasing an app on the app store.
- Have your app’s icons and launch screens ready.
- Have an Apple Developer account.
1- Prepare for building
Before you can build and release your app on the App Store, you need to set up a place 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 set up a place for your app on the App Store Connect. Log in to the App Store Connect.
- Select My Apps.
- Select + then select 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 section, make sure Automatically manage signing is checked and select your team.
- Fill out the rest of the information as needed.
- Next, you'll update your app’s icon. This can be done 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 ios
- Then go back to Xcode and reopen Runner.xcworkspace
- Select Product -> Scheme -> Runner.
- Select Product -> Destination -> Generic iOS Device.
- Select Product -> Archive to produce a build archive.
- From the Xcode Organizer window, select your iOS app from the sidebar, then select the build archive you just produced.
- Select the Validate… button to build.
- Once the archive is successfully validated, select Upload to App Store.
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 have all your app’s assets ready.
1- Prepare for release
Before you can publish your Flutter app to Google Play, the app needs 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 info:
- 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.
Learn more to improve mobile app performance
- 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.
Visit our sandbox or book a demo to see how Instabug can help your app