...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
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
| Info |
|---|
Staging environment is not mandatory but recommended as it allows you to test your driver apps, its new functionalities and provide the best solution to your users. |
What can you expect and what do we expect?
| Tip |
|---|
Copy the tables below and use it as a helper when collecting every item we need from you. If you send everything back to us in this format it will be awesome. 🎉 |
...
We will take care of everything else.
TABLE OF OUTPUTS WE NEED FROM YOU - GENERAL | |
GENERAL INFO | |
| Your app name |
All emails will be added to our email list & to all app testers email lists. | Send us a list of emails which will be responsible for receiving app updates, email infos regarding apps, new test builds, release notes, … |
| example: https://myportal.etrel.com |
| example: https://stage-myportal.etrel.com |
TABLE OF OUTPUTS WE NEED FROM YOU - ANDROID | |
GOOGLE CLOUD CONSOLE | |
| |
| |
FIREBASE - GENERAL INFO | |
| Type in your Firebase project name |
| |
PACKAGE NAME (ANDROID) | |
| Type in your Package name |
KEYSTORE (ANDROID) | |
| Type in your alias |
| Upload your .keystore file here |
| Type in your keystore password |
| Type in your key pair password |
| Extract and type in your SHA-1 fingerprint that you have in your .keystore file and paste it here. You will need it in later steps. |
TABLE OF OUTPUTS WE NEED FROM YOU - iOS | |
APPLE ACCOUNTS & BUNDLE ID | |
| |
| |
| Type in your Bundle ID name |
| |
| |
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.
...
...
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
What is Google Play Console?
Google Play Console is used to prepare apps for being published to Google Play Store, perform extended testing, gather and setup info on app details being displayed to users inside the store, filling out all legal forms related or required by Google, …
...
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”
...
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.
...
| Note |
|---|
After we accept your invitation you may have to confirm it again, before we get the access. Tell us once you do this as we need to accept invitation link, otherwise it will expire |
3 - Create Firebase project
What is Firebase?
Firebase is a Google-owned platform that provides a variety of cloud-based services for mobile and web app development. We will use it mainly for notification service and use their tools Crashlytics (crash tracking tool) and App distribution, a tool to deliver an app to your hands.
...
Login to Firebase with your Google account (from the chapter 1.1)
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.
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).
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.
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).
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.
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
In Firebase project, enter “Project settings” & go to “Users and Permissions” tab
Add the following emails with certain roles:
app.ocean.etrel@gmail.com (role: “Assign Firebase role(s)” → “Firebase Admin”)
n.fosnaric@nchain.com (role: “Editor”)
4 - Define Your Package Name (Android)
Package name will define your app in Google Play Store. You don’t need to insert it or type it in anywhere in Google Console, but only define it yourself and tell us waht you choosed, so our developers can use it during your app set up.
THIS SECTION OUTPUTS | |
Package Name PROD | Type in your domainextension.company.appname |
Package Name STG | Type in your domainextension.company.test.appname |
Please define it based on the following convention:
...
| Note |
|---|
Note, that this is a unique name that defines your application identity and can’t be changed later. Changing it later would create and entirely different app and users with previous app would not be able to update it. |
5 - Create Signing Key (for Android)
KEYSTORE | |
2 Keystore alias | Type in your alias |
3 Your .keystore file | Upload your .keystore file here |
4 Keystore password | Type in your keystore password |
5 Key pair password | Type in your key pair password |
Release SHA-1 certificate | Extract and type in your SHA-1 fingerprint that you have in your .keystore file and paste it here. You will need it in later steps. |
...
| Note |
|---|
Set the validity to a longer period (preferable 5 years or more - best 20 years) since the key identifies the app. After this period your app will practically “die”. Save your alias, .keystore file, Keystore and Key pair passwords on a safe place where you can always find it in case we will need it anytime in the future. |
6 - Login & meet your Google Cloud Console
What is Google Cloud Console?
Google Cloud Console is used to collect APIs for your apps' Google Maps, handle billings for API access, and so on. We can say that in Google Cloud Console you will do all the “administration” or “background” work and set ups required for your app while in Google Play Console you could “play” with your app and manage or perform different tests, upload your app to review and also create releases for Play Store.
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
- Create Apple Developer Account (if you don’t have one yet)
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
- Enroll in Apple Developer Program (if you didn’t yet)
...
| Info |
|---|
Additional Apple Developer Resources
|
3 - Define your Bundle ID (or Package Name)
THIS SECTION OUTPUTS | |
Bundle ID (or Package Name) PROD | Type in your domainextension.company.appname |
Bundle ID (or Package Name) STG (if you will have STG environment) | Type in your domainextension.company.test.appname |
You already created a package name during Android onboarding and Bundle ID is the same thing just in the Apple’s language. Please refer to Android onboarding page and you can use the same name in here.
4 - Add your iOS Application
Register required Bundle IDs on https://developer.apple.com/account/resources/identifiers/list
Click “Add” icon
Select “App IDs” & click “Continue”
Select “App”
Set Bundle ID & Choose only “Push notifications” option → Then “Continue”
Repeat the process for STG environment if you have one
...
| Info |
|---|
Learn more on how to handle your apps in App Store Connect on https://help.apple.com/app-store-connect |
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.
...