iOS App White Labelling

General setup

  • Open RocketChatRN.xcworkspace on Xcode (11.7 or newer)
  • On General tab, select “RocketChatRN” and change Display Name, Bundle Identifier, Version and Build
    • Note: as explained on 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 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 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.
Last modified 27d ago