Skip to main content

Create white branded mobile apps (beta)

DronaHQ provides an automated way to create your own white branded Mobile Apps for Android and iOS platforms from DronaHQ console.

Please Note

White branded mobile apps creation is only available on Business plan of DronaHQ cloud edition.

We will soon enable this feature on Self-hosted dashboard as well for Business plan users.

Contact us here in case you would want to try out the beta for your organization.

Prerequisites​

Below are the prerequisites you will need to create your white branded mobile app

General Prerequisites​

  1. App Icon for your app - 1024px x 1024px
  2. SSO Login & Callback URL (Optional)

Android Prerequisites​

  1. App Notification Icon for your app - 128px x 128px. Should have transparent background and logo should have only white color. It appears in Android Notification Bar when any notification is received by the App. View Sample Image

  2. Key Store For Signing App (Optional) - Refer this to create one

    1. Key Store file (.jks)
    2. Key Store password
    3. Key store alias
    4. Key store alias password

iOS Prerequisites​

  1. Main App Provisioning Profile (.mobileprovision)

    Create an App Identifier on Apple developer account with unique Bundle ID of your choice with following capabilities to be Enabled - Push Notifications, Sirikit and App groups Capabilities. For example if App bundle id mentioned above is com.company.testapp then Create an App identifier named - com.company.testapp. Once, App id is created, you can create App Store/Ad Hoc Distribution Provisioning profile for above App id depending on your Build Type and download it.

  2. Rich Notification Extension Provisioning Profile (.mobileprovision) (Optional)

    Required, if you want your App to support App Notifications with Images. Create App Identifier on Apple developer account with Bundle ID - <Bundle Id of App>.Rich-Noti-Extension and Enable Push Notifications Capabilities. For example if App bundle id is com.company.testapp then Create an App identifier named - com.company.testapp.Rich-Noti-Extension. Once, App id is created, you can create App Store/Ad Hoc Distribution Provisioning profile for above App id depending on your Build Type and download it.

  3. Siri Extension Provisioning Profile (.mobileprovision) & Siri UI Extension Provisioning Profile File (.mobileprovision) (Optional)

    Required, if you want to use Siri shortcuts in your app to open MicroApp quickly using Siri. Create 2 App Identifiers on Apple developer account with Bundle ID - <Bundle Id of App>.Shortcuts-Siri and <Bundle Id of App>.ShortcutsSiri-UI. For example, if App bundle id is com.company.testapp then Create an App identifier named - com.company.testapp.Shortcuts-Siri and com.company.testapp.ShortcutsSiri-UI. Once, App id is created, you can create App Store/Ad Hoc Distribution Provisioning profile for above App ids depending on your Build Type and download it.

  4. Status App Widget Extension Provisioning Profile (.mobileprovision) (Optional) Required, if you want to be able to add widgets of Status App in your phone's home screen. Create App Identifier on Apple developer account with Bundle ID - <Bundle Id of App>.StatusAppWidget-Extension For example if App bundle id is com.company.testapp then Create an App identifier named - com.company.testapp.StatusAppWidget-Extention. Once, App id is created, you can create App Store/Ad Hoc Distribution Provisioning profile for above App id depending on your Build Type and download it.

  5. Status App Widget Extension Provisioning Profile (.mobileprovision) (Optional) Required, if you want to be able to add widgets of Recent Opened MicroApp in your phone's home screen. Create App Identifier on Apple developer account with Bundle ID - <Bundle Id of App>.MicroAppWidget-Extention. For example if App bundle id is com.company.testapp then Create an App identifier named - com.company.testapp.MicroAppWidget-Extention. Once, App id is created, you can create App Store/Ad Hoc Distribution Provisioning profile for above App id depending on your Build Type and download it.

  6. Apple Distribution certificate (.p12)

  7. Key ID, API Key (.p8) and Issuer ID (Optional) Required, if you want to upload App directly on Appstore.

    • Create an App on Appstore Connect with same bundle id used above.
    • Refer this link for Creating App Store Connect API key
TIP

This is useful in case you don't have Mac machine to upload generated IPA using Transporter App to Appstore connect.

Creating white branded mobile App​

You can access this feature from Account settings -> Domain & Branding -> WHITE BRANDED MOBILE APP CREATION

Click on + CREATE and select App Type and fill below forms -

Please Note

You can either create only Android App or only iOS App or both App types while inputting white branded mobile app form.

COMMON​

FieldDescription
App nameProvide App Name which you want to provide for your App.
Bundle IdentifierPlease enter unique identifier for your app. Should be same for both android and ios. Bundle identifier or Package name once set, cannot be updated later. eg - com.company.appname.
About the AppEnter your App description.
Support Email IDProvide support email id that will be displayed to your end users in case they face any issues in app signin.
Url SchemeIt should be a unique text without any space or special characters, that can be used by any other app to invoke this App. For example, if you enter helloworld then dhq-helloworld will be your App's url scheme to invoke this app.
App Sign-inEnable this if you have Custom SSO Implemented in your account and you want users to directly land on this SSO page for Sign-in into the App.
SSO Login URLOptional. Enter you SSO login URL for your users to Sign IN if App Sign-in is enabled.
Callback URL for SSO LoginOptional. Enter you SSO Callback URL if App Sign-in is enabled.
Hide Sign In HeaderOptional. Enable this if you want your SSO Page to be displayed full screen. If disabled, default Sign In Header is displayed.
App Background ThemeSelect App theme color which will be used in launch screen background color and few other places.
App Icon (png)App Icon for your app. Only Image with 1024 x 1024 px is supported.

ANDROID​

FieldDescription
App Notification Icon UploadApp Notification Icon for your app. Only Image with 128 x 128 px is supported. View Sample Image.
Build TypeRelease or MicroApp debuggable. Use Release version to upload it on Playstore. MicroApp debuggable is for troubleshooting use case.
Build Generation TypeApk or Bundle. Use Bundle for uploading App on Google Playstore.
Use My Signing KeystoreEnable this if you want to provide your own signing keystore to sign the Apk/Bundle. If disabled, we will use our keystore to sign the app. Check this for creating your own signing keystore
Key Store (.jks)Optional, Provide .jks file that will be used for signing this app. Please store this .jks file securely for using it in future.
Keystore password for signing the apkOptional, Keystore password for Keystore file.
Key store aliasOptional, Keystore Alias name.
Key store alias passwordOptional, Password for Keystore alias.

IOS​

FieldDescription
Build TypeAppstore or Adhoc build type.
Main App Provisioning Profile (.mobileprovision)App's Main provisioning profile file. Check prerequisites on how to create this file.
Enable Rich NotificationEnable this if you want your App to support App Notifications with Images.
Rich Notification Extension Provisioning Profile (.mobileprovision)Optional, App's Rich Notification extension provisioning profile file. Check prerequisites on how to create this file.
Enable SiriEnable this if you want to use Siri shortcuts in your app to open MicroApp quickly using Siri.
Siri Extension Provisioning Profile (.mobileprovision) & Siri UI Extension Provisioning Profile File (.mobileprovision)Optional, App's Siri and Siri UI extension provisioning profile files. Check prerequisites on how to create this 2 files.
Enable Status App WidgetEnable this if you want to be able to add widgets of Status App in your phone's home screen.
Status App Widget Extension Provisioning Profile (.mobileprovision)Optional, App's Status App extension provisioning profile file. Check prerequisites on how to create this file.
Enable Recents MicroApp WidgetEnable this if you want to be able to add widgets of Recent Opened MicroApp in your phone's home screen.
Status App Widget Extension Provisioning Profile (.mobileprovision)Optional, App's Status App Widget extension provisioning profile file. Check prerequisites on how to create this file.
Apple Distribution certificateApple Distribution certificate file with .p12 extension of your Apple account.
Distribution Certificate PasswordPassword for importing your Apple distribution certificate.
Upload iPA to App Store ConnectEnable this to upload this iPA to Appstore connect.
Key ID, API Key (.p8) and Issuer IDCheck prerequisites on how to get this id and file which is required by DronaHQ to upload the App on your Apple Appstoreconnect account..

Once, you submit the form successfully, your request for creating apps will be queued and you will receive an email once your individual Android or iOS App is generated.

You can also check the status of your App in Account settings -> Domain & Branding -> WHITE BRANDED MOBILE APP CREATION page.

App Creation List
App Creation List

For Apps, showing status as completed, you can also download the App from the App Link column.

Testing and Publishing​

Once the app status is downloaded, you can install it in your Android/iOS device and test how your app's branding and colors are set in your App. Once you are satisfied with your app, you can choose to distribute using Android Playstore and iOS App store respectively.

Please Note
  • For installing App on iOS device, you can either choose Adhoc distribution to directly install or choose testflight installation for release app type.
  • You will require Android Playstore Developer account to distribute using Android Playstore.
  • You will require Apple Developer/Enterprise account to distribute using iOS Appstore.

Creating Keystore (.jks) file​

Java Key Store (JKS) file is required to sign your Android Application (Apk / Bundle). If you already have a Keystore file generated or you want DronaHQ to create one, you can skip this step. This steps involves creating a private key from your computer. We will be using Java Keytool utility that comes with any standard JDK distribution and can be located at %JAVA_HOME%\bin

From a command prompt, we can type the following to get a JKS.

keytool -genkey -v -keystore my-release-key.jks -storetype JKS -alias alias_name -keyalg RSA -keysize 2048 -validity 10000

Where you need to provide the following details:

  1. Keystore password – you’ll need this to unlock this Keystore again in the future. If you lose this password, it is pretty much impossible to recover it.
  2. Re-enter Keystore password.
  3. Your First Name and Last Name.
  4. Name of the Organization Unit.
  5. Name of the Organization.
  6. Name of the City or Locality.
  7. Name of the State or Province.
  8. Two letter Country Code.
  9. Confirmation of above details, enter yes.
  10. Key password (It can be same as Keystore password).

Here,

  • 10000 is the number of days this keystore will be valid for.
  • my-release-key.jks is the name of the keystore file that will be generated.
  • alias_name is the Alias name for your keystore. you can give any friendly name of your choice instead.
Last updated on