Prerequisites

Before you start you should have defined:

• App name

• Production driver portal URL, for example: https://myportal.etrel.com

  • ask KAM or Onboarding Support team if you don’t have one yet

• Stage driver portal URL, for example: https://stage-myportal.etrel.com

  • this is optional and applies only if you will use staging environment

What can you expect and what do we expect?

During this onboarding you will:

• create your Google Cloud Console account

• create Firebase project,

• create Apple accounts & add your apps,

• define your Package name and Bundle ID,

• create your Signing key for Android app and

• setup your billing account on your Google Cloud Console.

We will take care of everything else.

I did it all. What now?

Send everything to your KAM or Onboarding Support team. If we have every access and all infos apps will be delivered within 2 week timeframe or on the delivery date you discussed together with your KAM.

Open

How process usually looks like, where are you now and what else is needed (blue boxes) to create a first build

Android

1 - Create company’s Google account

If you don’t have a company’s Google’s account yet, create one by registering it. You can use either Gmail address or your existing non-gmail company address to create a Google Account. For more information on how to do this, check the link below: https://support.google.com/accounts/answer/27441?hl=en#existingemail

If you have one, skip this step.

2 - Create Google Play Console account

To publish the Android native app on the Google Play Store and even use Google's services you will need to create new Google Play Console account, if you haven’t already created one in the past.

• Create Google Play Console Account by following the process on this link: https://play.google.com/apps/publish/signup

If you have one, skip this step.

2.1 - Add your app to Google Play Console

On a Google Play Console home screen click “Create app”

Open

Click “Create app”

2.2 - Invite Etrel developers to your Google Play Console

To get the application uploaded to your Google console and to get future updates for your app you will have to invite Etrel developers to your store.

You can do this under “Users and permissions” → click on “Invite new users”.

Invite us as Etrel Google Dev profile: app.ocean.etrel@gmail.com

3 - Create Firebase project

1. Login to Firebase with your Google account (from the chapter 1.1)

2. Go to the Firebase Console: Once you are signed in with your Google account, click on the "Go to Console" button in the upper right corner of the Firebase website. This will take you to the Firebase Console.

3. Create a New Project: In the Firebase Console, click the "Add Project" button to create a new project. Name your project by using both your company and your app name: »Company AppName app« (example: Landis eMobility app).

4. Enable Google Analytics: Enable Google Analytics for your project and select account you want to use. You can also create a new one related to your projet.

   1. Google Analytics account connected to your Firebase enables you to get features like crash-free users, breadcrumb logs, and velocity alerts in Crashlytics (Firebase Crash Reporting tool).

5. Accept the Terms and Click "Create Project": Review the terms and conditions, then click "Create Project." Firebase will create your project, which may take a moment.

6. Access Your Firebase Project: Once your project is created, you will be taken to the project dashboard. From here, you can access various Firebase services and set up your app.

3.1 - Invite us to your Firebase Project

1. In Firebase project, enter “Project settings” & go to “Users and Permissions” tab

    

2. Add the following emails with certain roles:

   1. app.ocean.etrel@gmail.com  (role: “Assign Firebase role(s)” → “Firebase Admin”)

   2. n.fosnaric@nchain.com (role: “Editor”)

4 - Define Your Package Name (Android)

Please define it based on the following convention:

Package convention name: domainextension.company.appname

• Etrel example: si.etrel.echarger

• General example: com.microsoft.evcharge

For STG use: domainextension.company.test.appname

5 - Create Signing Key (for Android)

Android requires that all APKs are digitally signed with a certificate before they are installed on a device or updated. If you don't own your own upload key there are several methods on how to create your own.

Please follow the instructions below step by step to create your own key:

https://headjack.io/tutorial/create-android-keystore-file/

Don't forget that the Keystore and Key pair passwords cannot be changed later.

6 - Login & meet your Google Cloud Console

6.1 Set up Billing Account

The only thing you need to setup here is your »Billing Account«. For all the APIs, that we will set in here, to take affect a billing account must be created. To create billing account use this link and follow the Billing instructions.

Everything else that needs to be setup here, we will setup for you.

iOS 🍎

1 - Create Apple Developer Account

To publish the IOS native app on the App Store and also sign in to Apple’s Developer account you first need to create new Apple ID account which will serve you for a login in the Apple’s developer portal. This can be done using the following link: https://appleid.apple.com/account?appId=632&returnUrl=https%3A%2F%2Fdeveloper.apple.com%2Faccount%2F

2 - Enroll in Apple Developer Program

By having only an Apple ID you will not be able to distribute apps in Apple Store Connect, neither test them in Testflight (Apple’s testing environment).

In order to have full access to your app you need to enroll in Apple Developer Program. To do this follow the instructions on this link: .

3 - Define your Bundle ID (or Package Name)

4 - Add your iOS Application

1. Register required Bundle IDs on https://developer.apple.com/account/resources/identifiers/list

2. Click “Add” icon
   
   

3. Select “App IDs” & click “Continue”

    

4. Select “App”

5. Set Bundle ID & Choose only “Push notifications” option → Then “Continue”
   
   

   
   
   

    

6. Repeat the process for STG environment if you have one

You can now add new applications on App Store Connect.

1. Select ‘’My Apps’’

2. Add new application

3. Type in your Bundle ID (the one you chose in sections before)

4. Type in your App name

Repeat process for PROD/STG again to add both apps.

5 - Invite Etrel developers to your Apple Store Connect

After you Enrolled in Apple Developer Program you will be able to invite Etrel developers to your Apple Store Connect which will enable us uploading your app to your portal.

1. Login to App Store Connect with your Apple ID account

2. Go to “Users and Roles”

3. Add our developers with the “Admin” role & select only the app we will work on

   1. Etrel Dev profile: app.ocean.etrel@gmail.com

   2. Etrel iOS Dev profile: ocean.ios@etrel.si