XpressHive - Documentation

Apple App Store Deployment Guide

Latest

This guide provides a step-by-step overview of deploying your Flutter application to the Apple App Store. Follow these instructions to configure, build, and publish your iOS application successfully.

Prerequisites

Before starting the iOS deployment process, ensure you have:

Apple Developer Account ($99/year)
Your Flutter application ready for release
Mac computer with Xcode installed
Required application assets:
- App Icon (1024 Ã— 1024 px)
- iPhone Screenshots
- iPad Screenshots (if supported)
Privacy Policy URL
Application Description
Keywords
Support URL
Marketing URL (Optional)
App Store Connect account setup

Deployment

This section provides detailed instructions for deploying your Flutter application to the Apple App Store. Follow each step carefully to ensure a successful iOS deployment and App Store submission.

Step 1: Developer Account Setup

Visit Apple Developer Program and complete your Apple Developer account setup process.

Enroll in Apple Developer Program

Visit Apple Developer Program
Sign in using your Apple ID
Enroll in the developer program
Pay the $99 annual developer fee
Complete organization verification
Set up payment profile
Provide contact information

Configure App Store Connect

Create App Store Connect account
Create application record
Configure basic application information
Configure required application capabilities

Note: Apple Developer account verification may take additional time depending on your account type and region.

Step 2: App Configuration

Before building your Flutter application, update all required configuration files.

Update pubspec.yaml

Open the following file:

pubspec.yaml

Update the application version:

version: 1.0.0+1

Important Version Note:

Version format: version_name+version_code
Example: 1.0.0+1
version_name is displayed publicly to users
version_code is used internally by App Store
Always increase the build number for every new release

Example Version Sequence

First release: 1.0.0+1 Bug fix update: 1.0.1+2 Feature update: 1.1.0+3 Major update: 2.0.0+4

Step 3: Generate App Signing Certificate

Open Xcode and configure your Apple Developer certificates.

Open Xcode
Go to Xcode â†’ Settings â†’ Accounts
Add your Apple ID
Create Development Certificate
Create Distribution Certificate

Provisioning Profiles

Create Development Provisioning Profile
Create App Store Provisioning Profile

Important:

Keep certificates secure
Keep provisioning profiles secure
Backup all signing certificates
Required for future updates

Step 4: Build Your App

Open terminal in your Flutter project root directory and execute the following command:

flutter build ipa --release

Optional Build Flags

--obfuscate --split-debug-info

--obfuscate helps protect your source code
--split-debug-info helps improve crash reporting

Note: Wait for the build process to complete successfully before uploading the IPA file.

Find IPA file at

build/ios/ipa/YourApp.ipa

Step 5: App Store Connect Setup

Configure your application inside App Store Connect before uploading the iOS release build.

Create App Record

Log in to App Store Connect
Click My Apps
Click + to create a new application
Fill all required application information

Basic Application Information

Application Name
Bundle ID
SKU
User Access

XpressHive HR dashboard showing attendance and payroll analytics

Bundle Identifier Configuration

Choose an existing Bundle ID or create a new Bundle Identifier.

Note: Bundle ID creation can also be configured automatically through Xcode by enabling automatic signing inside project settings.

Open Apple Developer Portal
Go to Certificates, Identifiers & Profiles
Open the Identifiers section
Click + to register a new Bundle ID
Enter a unique Bundle Identifier
Select required application capabilities
Register the Bundle ID

Bundle ID Format

com.companyname.appname

Example:
com.example.myapp

Important: Use the same Bundle Identifier in both Xcode and App Store Connect.

Step 6: Complete App Information

Complete all required App Store Connect information before submitting your application for review.

Application Information

Privacy Policy URL
Support URL
Marketing URL (Optional)
App Store Category
Age Rating

Pricing & Availability

Price Tier
Available Territories
Release Date

App Store Screenshots

iPhone screenshots (6.5-inch Display)
iPad screenshots (if supported)
App Preview videos (optional)

Note: Screenshots must follow Apple's required dimensions and device resolution guidelines.

App Description

Name (30 characters max)
Subtitle (30 characters max)
Keywords (100 characters max)
Description (4000 characters max)
What's New in This Version

App Review Information

i. Contact Information

First Name
Last Name
Phone Number
Email Address

ii. Demo Account (If Login Required)

Username or Email
Password
Special login instructions

iii. Notes for Review Team

Application functionality description
Special setup instructions
Test account details
Known issues or clarifications
Beta or Sandbox environment details

App Privacy

Configure privacy and data collection information for your application.

Enter Privacy Policy URL
Complete data collection questionnaire

Important: If your application collects any user data, you must complete the App Privacy section correctly before submitting your application for review.