iOS App White Labelling

General setup

  • Open RocketChatRN.xcworkspace on Xcode (13.0 or newer)
  • On the General tab, select “RocketChatRN” and change Display Name, Bundle Identifier, Version and Build
As explained in the Important section, we have two targets and we're going to cover the default one on this doc, which is the Experimental app.
  • Select “ShareRocketChatRN” and change the same properties
    • Display Name and Bundle Identifier are different from the previous target
    • Version and Build must be the same on all targets
  • Select “NotificationService” and change the same properties
    • Display Name and Bundle Identifier are different from the previous target
    • Version and Build must be the same on all targets
  • On Signing and Capabilities, check “Automatically manage signing”, select your app group and add a keychain group
  • Select “ShareRocketChatRN”, check “Automatically manage signing”, select your app group and add the same keychain group
  • Select “NotificationService”, check “Automatically manage signing”, select your app group and add the same keychain group
  • Set the same app group on RocketChatRN/Info.plist, ShareRocketChatRN/Info.plist and NotificationService/Info.plist
  • Set the same keychain group on RocketChatRN/Info.plist, ShareRocketChatRN/Info.plist and NotificationService/Info.plist
  • It needs to be the same on all entitlements
  • Change the app icon on Experimental.xcassets/App Icon
  • Change the app splash screen on Experimental.xcassets/Launch Screen Icon
  • Change the splash background colors on Experimental.xcassets/splashBackgroundColor
  • Set your Bugsnag API key on RocketChatRN/Info.plist

Generating iOS app on Firebase

  • On “General” tab, click on “iOS” button under “Your apps” section
  • Enter your bundle ID and then “Register app”
  • Download config file and move it as instructed
  • Add it to all targets

Running the app

  • Execute the following on project terminal
    • yarn
    • npx pod-install
    • yarn ios

Configuring the Apple Developer Portal

Login to Apple Developer Portal

Creating an App Identifier

  • Add description and Bundle ID
  • On Capabilities, select App Groups and Push notifications
  • Click “Continue” and then “Register”

Creating an App Identifier for our Share Extension

  • Add description and Bundle ID
  • This time, select only App Groups under Capabilities
  • Click “Continue” and then “Register”

Create an App Identifier for our Notification Service

Creating an App Group

  • Enter a description and an Identifier
  • Click “Continue” and then “Register”

Applying App Group

  • Click on the first identifier you created
  • On “App Groups”, click “Configure”
  • Select the App Group you created and click “Continue”
  • Click “Save”
  • Repeat these steps for the second identifier you created for the Share Extension and NotificationService

Creating Push Notifications certificates

Development SSL Certificate

  • Download the certificate and install it on your machine (follow the instructions on the screen)
  • After installing it, “Keychain Access” should have opened automatically on your Mac
  • Export the certificate to generate a .p12 file
  • For simplicity, save it in the same folder of your CSR and .cer. You’ll need it later.

Production SSL Certificate

  • Download the certificate and install it on your machine (follow the instructions on the screen)
  • After installing it, “Keychain Access” should have opened automatically on your mac
  • Export the certificate to generate a .p12 file
  • For simplicity, save it in the same folder of your CSR and .cer. You’ll need it later.
Export as PDF
Copy link
Edit on GitHub
On this page
General setup
Generating iOS app on Firebase
Running the app
Configuring the Apple Developer Portal
Login to Apple Developer Portal
Creating an App Identifier
Creating an App Identifier for our Share Extension
Create an App Identifier for our Notification Service
Creating an App Group
Applying App Group
Creating Push Notifications certificates