Skip to content

Build iOS App

Before we start the build App process, please make sure you have the following settings ready:

Note

It is highly recommended that you build Android and iOS App in seperate project folders.

Preparing an iOS build

Steps

  1. Open your terminal and cd to the project root.

    cd hamv_mobile

  2. (Skip this step if you have applied your settings in env.sh file) Create a build.json file in your IDE and put it under the root folder.

    {
    "ios":{
        "debug":{
            "developmentTeam": "<your team ID>"
        },
        "release":{
            "developmentTeam": "<your team ID>"
        }
    }
}

  3. (Skip this step if you have applied your settings in env.sh file) Run the following commands one by one.

    npm i app-engine-3.0.0.tgz

    npm i

    ionic cordova platform add ios@6.3.0

    ionic cordova prepare ios

    Update Cocoapods Package

    If you see error message when running ionic cordova platform add ios@6.3.0, please update the Cocoapods package by using pod repo update or pod install --repo-update. 

    [!] CocoaPods could not find compatible versions for pod "FBSDKCoreKit":
In Podfile:
FBSDKCoreKit (= 11.1.0)
None of your spec sources contain a spec satisfying the dependency: `FBSDKCoreKit (= 11.1.0)`.
You have either:
* out-of-date source repos which you can update with `pod repo update` or with `pod install --repo-update`.
    Once updated, remove the previous build files and start from scratch again.

  4. (Skip this step if you have applied your settings in env.sh file) Change the pod project ios deployment target. Go to platform > ios > Podfile. Add this line and put your Apple Team ID to the file:

    config.build_settings["DEVELOPMENT_TEAM"] = "Your Apple Team ID"

  5. (Skip this step if you have applied your settings in env.sh file) Execute the following command. 

    cd platforms/ios && pod install && cd ../..

  6. (Skip this step if you have applied your settings in env.sh file) Open Xcode and select the file name extensions ".xcworkspace" (/platforms > ios > yourApp.xcworkspace)

    Note

    If this is your first time to open Xcode, please agree to the development license by running this command in the Terminal: 

    sudo xcodebuild -license accept

  7. (Skip this step if you have applied your settings in env.sh file) Open Xcode Settings

    (1) Login a developer's Apple ID and select your account and click "Manage Certificates" button.

    (2) Create a new certificate if you don't have one.

    (3) Select Location and make sure the Command Line Tools is Xcode 14.3.1.

  8. (Skip this step if you have applied your settings in env.sh file) Go back to the project, check the following signings are correctly selected, the iOS target is iOS11.0 or above, and the device should show Any iOS Device.

  9. (Optional for Google signin setting, Skip this step if you have applied your settings in env.sh file) Go to Targets →Info tab. Add a URL type by using GoogleService-Info.plist file's REVERSED_CLIENT_ID.

  10. (Skip this step if you have applied your settings in env.sh file) Go to Pods in the side menu and check the following items are with correct signing.

    • AppAuth-AppAuthCore_Privacy
    • BoringSSL-GRPC-openssl_grpc
    • FBSDKCoreKit-FacebookSDKStrings
    • FirebaseABTesting-FirebaseABTesting_Privacy
    • FirebaseCoreExtension-FirebaseCoreExtension_Privacy
    • FirebaseCoreInternal-FirebaseCoreInternal_Privacy
    • FirebaseFirestoreInternal-FirebaseFirestoreInternal_Privacy
    • FirebaseInAppMessaging-InAppMessagingDisplayResources
    • GoogleDataTransport-GoogleDataTransport_Privacy
    • GoogleSignIn-GoogleSignIn
    • GoogleUtilities-GoogleUtilities_Privacy
    • gRPC-C++-gRPCCertificates-Cpp
    • gRPC-C++-grpcpp
    • gRPC-Core-grpc
    • leveldb-library-leveldb_Privacy
    • PromisesObjC-FBLPromises_Privacy
    • PromisesSwift-Promises_Privacy

    Note

    You should still set the signing to avoid any errors, even if you do not use push notification, Facebook login or Google login.

  11. (Skip this step if you have applied your settings in env.sh file) Go to Resources > Images, make sure the Appicon images of 60pt exist.

  12. Run build

    If you have applied your settings in env.sh file, please run the following command:

    sh customer/hamv_mobile_ios.sh

    Or, if you did not apply the env.sh file but modified app configurations in package.json, config.xml, and app.config.ts, you need to build the debug/release version by the following commands:

    Build debug version: 

    ionic cordova build ios --prod --debug --verbose
    Build release version: 
    ionic cordova build ios --prod --release --verbose

Note

If the build failed, please remove the build materials by using this command and repeat step 2 again.
```
rm -rf node_modules/ plugins/ platforms/ .angular/
```

Run App on iOS Devices for Testing

Steps

  1. You should have installed the iOS simulator when setting up enviroment in the previous steps. If not, open your terminal and cd to the project rooot to run this command:

    npm i -g ios-deploy ios-sim

  2. Open ".xcworkspace" in Xcode. The file should be under/platforms/ios/.xcworkspace

  3. Connect your phone via USB and select it as the run target, as pictured below.

  4. You can now run your app on your phone by clicking the play button. Make sure your device remains USB connected and unlocked.

Upload Build to App Store

Steps

  1. After build success, go back to Xcode project and click Product > Archive

  2. Select the archived file, and click Distribute App button.

    (1) Select App Store Connect and click Next.

    (2) Check the information and click Next.

    (3) Choos Automatically manage signing and click Next.

    (4) Click the button Done after seeing Upload Successful

  3. Go back to App Store Connect, select Activity tab, check if the build that you uploaded is already there

    Note

    If the status for the build is Processing, please wait for a while.

  4. Click the tab "App Store", and click "Prepare for Submissions"

  5. Upload your build file

Have more questions? Submit a request