iOS App White Labeling

General setup

As explained in the requirements, the repo contains targets/build flavors to build our experimental and official apps. This guide covers the default flavor, which is the Experimental app.

1. Open RocketChatRN.xcworkspace on Xcode (13.0 or newer)

2. On the General tab, select “RocketChatRN” and change Display Name, Bundle Identifier, Version, and Build.

3. Select “ShareRocketChatRN” and “NotificationService” and change the same properties

   1. Display Name and Bundle Identifier are different from the previous target.

   2. Version and Build must be the same on all targets.
      

      

4. On Signing and Capabilities for “RocketChatRN,” check “Automatically manage signing,” select your app group, and add a keychain group.
   

   

   
   Similarly, on the “ShareRocketChatRN” and “NotificationService” targets, check “Automatically manage signing,” select your app group, and add the same keychain group.

5. Set the same app group on RocketChatRN/Info.plist, ShareRocketChatRN/Info.plist and NotificationService/Info.plist
   

6. Set the same keychain group on RocketChatRN/Info.plist, ShareRocketChatRN/Info.plist and NotificationService/Info.plist

7. It needs to be the same on all entitlements.

8. Change the app icon on Experimental.xcassets/App Icon

9. Change the app splash screen on Experimental.xcassets/Launch Screen Icon
   

   

10. Change the splash background colors on Experimental.xcassets/splashBackgroundColor
    

    

11. Set your Bugsnag API key on RocketChatRN/Info.plist

Generate iOS app on Firebase

1. Visit the project overview on your Firebase console.

2. Go to Settings > Project settings.

   

3. On the “General” tab, click on “iOS” button under “Your apps” section:
   

   

4. Enter your bundle ID and then “Register app”:
   

   

5. Download the config file and move it as instructed:
   

   

6. Add it to all targets:
   

   

Run the app

Execute the following in the project terminal:

yarn
npx pod-install
yarn ios

Configure the Apple developer portal

Login to Apple developer portal

1. Visit your Apple developer account.

2. Enter your credentials.

3. Click Certificates, Identifiers & Profiles.

Create an app identifier

1. Visit the Apple identifier list.

2. Click to add identifier.

3. Select App IDs and click Continue.

   

4. Add a Description and Bundle ID:
   

   

5. On Capabilities, select App Groups and Push notifications.

6. Click Continue and then Register.

Create an app identifier for the share extension version

1. Share extension is a version of the app that opens when you share data from another app to Rocket.Chat. For example, share a photo from the gallery.

2. Visit the resources identifier list.

3. Click to add Identifier.

4. Select App IDs and Continue.

   

5. Add a description and Bundle ID.

   

6. This time, select only App Groups under Capabilities.

7. Click Continue and then Register.

Create an app identifier for our notification service

Create an app group

1. Visit the resources identifier list.

2. Click to add Identifier.

3. Select App IDs and Continue.

   

4. Enter a Description and an Identifier:

   

5. Click Continue and then Register.

Apply app group

1. Visit the resources identifier list.

2. Click on the first identifier you created.

3. On App Groups, click Configure.

4. Select the App Group you created and click Continue.

5. Click Save.

6. Repeat these steps for the second identifier you created for the Share Extension and notification service.

Create push notifications certificates

• Visit the resources identifier list.

• Click on the first identifier you created.

• On Push Notifications, click Configure.

  

Development SSL Certificate

1. On Development SSL Certificate, click Create Certificate.

2. Follow the official tutorial to generate a Certificate Signing Request.

3. Select the certificate you created and click Continue.
   

   

4. Download the certificate and install it on your machine per the on-screen instructions.
   

   

5. After installing it, Keychain Access should have opened automatically on your Mac.

6. Export the certificate to generate a .p12 file.
   

   

7. For simplicity, save it in the same folder of your CSR and .cer. You’ll need it later for SSL/TLS authentication and encryption.

Production SSL Certificate

1. On Production SSL Certificate, click Create Certificate.

2. Follow the official tutorial to generate a Certificate Signing Request.

3. Select the certificate you created and click Continue.
   

   

4. Download the certificate and install it on your machine per the on-screen instructions.
   

   

5. After installing it, Keychain Access should have opened automatically on your Mac.

6. Export the certificate to generate a .p12 file
   

   

7. For simplicity, save it in the same folder of your CSR and .cer. You’ll need it later for SSL/TLS authentication and encryption.