Add Google Firebase to an iOS Digitise app

This topic provides a basic guide to adding Google Firebase to a Digitise app or pre-configured Digitise Apps Client for the Apple Platform:

Go to https://firebase.google.com/.

Sign in with a Google gmail account. If you don't have one, you can create one from the sign in page, by clicking Create account.

Click Go to console (https://console.firebase.google.com).

If this is the first time you are registering an app with Firebase, click Create a project.

If you have already created one or more Firebase projects, click Add project to create a new project or click on an existing project to use that project instead.

If you have selected an existing project to add your app to, the project page will be displayed and you can add your app, see below for instructions.

If you are creating or adding a new project, enter a name for this project and, if this is your first project, click I accept the Firebase terms.

Click on the 'I confirm that I will use Firebase exclusively for purposes relating to my trade, business, craft, or profession.' check box.

Click Continue.

The Google Analytics for your Firebase project page will be displayed.

Check that Enable Google Analytics for this project is enabled. If you want to use Google Analytics, this option should be selected. If you don't want to collect usage data through the Firebase service, deselect the option.

Click Continue.

The Configure Google Analytics page will be displayed. Select the Default Account for Firebase.

Click Create project.

Once your project is ready, click Continue.

Whether you have added a new project or opted to add your app into an existing project, you will now be at the project page.

If you are using an existing project which already has apps registered, you will see a list of these apps displayed just below the project name at the top of the page. Click on the + button or + Add app button at the end of the list to add a new app. The list of apps will be replaced by a toolbar with a set of buttons.

If you have created a new project, or the project you chose doesn't yet have any apps registered, you will see a 'Get Started' message below the project name with a set of buttons below it.

Click on the iOS button, Picture showing the Add iOS app button., to add your Digitise app/Client to this project.

The Add Firebase to your Apple app page will be displayed.

Enter the Bundle ID for this app or Client in the iOS bundle ID field - you can find the Bundle ID you need from App Studio:

  1. Load your Digitise app in App Studio or if you are adding a pre-configured Digitise Apps Client, you don't need to load an app.

  2. Choose the Ribbon's Publish tab. Click on Request Build → Standalone App → Apple or Request Build → Pre-configured Client → Apple, as appropriate.

  3. The Bundle ID can be found in the Package Name field under the General tab.

  4. You can copy and paste the ID from App Studio into the Firebase Console.

Back in the Firebase Console, enter an App nickname. This is a user-friendly name of your choice used to identify your app in Firebase.

Click Register app.

Click Download GoogleService-Info.plist to download the GoogleService-Info.plist file. Note that you will need to import this file into the Build request dialog box in App Studio when you request a build of your app or pre-configured Client. You need to generate a separate version of this file for each app and another one for any pre-configured Digitise Apps Clients. The file always has the same file name, GoogleService-Info.plist, so you will need to take care not to overwrite one version with another and make sure you use the correct file when building your apps or pre-configured Clients.

Click Next, Next, Next and then Continue to console.

The console will return to the project page and your new app will be listed, with any other apps registered to this project, below the project title.

 

Once you have registered a Digitise app/Client with the Firebase console, you can then include Crashlytics within a Standalone App version of the app or a pre-configured version of the Digitise Apps Client.

If you enable Firebase in a Standalone App or pre-configured Digitise Apps Client, you can access your Crashlytics data and also Analytics data, if you included Analytics when registering your app/Client, from the Firebase web site. Sign in to the web site as described above and then choose the relevant project from the projects displayed. Click on Crashlytics or one of the Analytics options in the left-hand menu to display data for the selected option.

 

You can check within a Standalone App or Digitise Apps Client whether Crashlytics has been enabled. Check Settings → Device from the app/Client's Home page. Look for the Enable Firebase setting. If this option displays Yes, the Crashlytics debugging was enabled when the app/Client was built, if No, it is disabled.