# iOS Build and Publish

## **Publishing Your iOS App to the App Store**

This guide focuses **primarily on eMOBIQ AI’s iOS publishing workflow**. For detailed iOS Apple steps, follow the linked official documents.

For Apple Developer setup, follow [official Apple Docs](https://developer.apple.com/documentation/appstoreconnectapi)

Ensure you have:

* An **Apple Developer Account** ($99/year)
* **Xcode** installed (for certificate generation)

***

### **1. Build an App Store Version in eMOBIQ AI**

#### **Prerequisites**

* **Signing assets** from Apple:
  * `.p12` private key + password. Generated from an [Apple Device](https://developer.apple.com/help/account/certificates/create-a-certificate-signing-request/)
  * `.mobileprovision` file. Generated from [Apple Developer Account](https://developer.apple.com/account/resources/certificates/list)

#### **Steps in eMOBIQ AI**

1. **Go to**: `Publish` → `Settings` → `iOS` → `Build Settings`
2. **Upload/Enter**:
   * **Code Sign Identity** (Common Name from certificate)
   * **Team ID** (10-character ID from Apple Developer account)
   * **Provisioning Profiles**:
     * Debug: `.mobileprovision` file
     * Release: `.mobileprovision` file
   * **Private Key**: `.p12` file
   * **Private Key Password** (used when exporting `.p12`)
3. Click **Save**

<figure><img src="https://1183608340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsUDFGj32EEDxm4CJ43yZ%2Fuploads%2Fgit-blob-560cd81e0fd957750e3c89ac56bfab66d3669b81%2FUntitled%20design%20(4).gif?alt=media" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
***Security Note**: Store your `.p12` password securely—it’s required for updates*
{% endhint %}

***

### **2. Publish to App Store in eMOBIQ AI**

#### **Option A: Manual Upload** *(One-time)*

1. **Prepare App Store Listing**:
   * [Complete metadata in App Store Connect](https://developer.apple.com/help/app-store-connect/)
2. **Upload `.ipa`**:

.ipa file can be found on the build page of eMOBIQ AI once the app has been successfully built

<figure><img src="https://1183608340-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsUDFGj32EEDxm4CJ43yZ%2Fuploads%2Fgit-blob-44956f98d6015fc337c1c2ca662f0320b5dd0474%2Fimage%20(1)%20(1)%20(1)%20(2).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

* Use **Apple’s Transporter App** ([download here](https://apps.apple.com/us/app/transporter/id1450874784))
* Wait 24-48 hours for Apple to review your app

**Option B: Auto-Publishing** *(Recommended)*

1. **Link App Store Connect to eMOBIQ AI**:
   * [Generate an App Store Connect API Key](https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api)
   * Download `.p8` file (save **Key ID** and **Issuer ID**)
2. **Configure in eMOBIQ AI**:
   * Go to `Settings` → `iOS` → `Publish Settings`
   * Upload:
     * `.p8` file (Account Private File)
     * Key ID
     * Issuer ID
     * App metadata *(must match App Store Connect)*

{% hint style="info" %}
***First-time requirement**: Manual upload before auto-publishing.*
{% endhint %}

***

**Need Help?**

* [Apple Developer Support](https://developer.apple.com/support/)
* Create a Ticket: [eMOBIQ Support Page](https://main.emobiq.com/support)

For TestFlight troubleshooting, view [Apple’s Official guide](https://developer.apple.com/testflight/)