Android - Compiler et tester l'application en version ad hoc

La procédure ci-dessous concerne le mode Solo, ce qui signifie que vous êtes en charge de la génération et soumission de votre app sur Google Play Store.
Si vous préférez que notre équipe s'en charge pour vous, vous pouvez souscrire au service "GoodBarber s'en occupe  ".

Dans les deux cas (Solo ou GBTC), pour créer votre application de test Android, vous devez posséder un compte Google Publisher .

Google utilise différentes plates-formes, vous devrez accéder à 3 d'entre elles pour créer votre application Android :
-Console Google Cloud  
- Console Google Play  (nécessite un compte éditeur Google payant)
- Console Firebase  
Nous vous recommandons d'utiliser le même e-mail pour créer des projets et des applications sur toutes ces plateformes.

Mode Solo :

Vous trouverez ci-dessous les étapes nécessaires pour la compilation de votre application Android. Après avoir suivi ce procédé, vous pourrez tester votre application Android native sur votre appareil avant de l'envoyer sur le Google Play Store.
Aller sur la page Canaux de vente > App Android  > Publier  . 

0. PREMIÈRE FOIS?

• C’est la première fois que cette application sera mise en ligne sur Google Play - choisissez cette option si vous publiez votre application pour la première fois.
• Cette application est une mise à jour d’une application créée ailleurs que sur GoodBarber - choisissez cette option si vous mettez à jour une application existante déjà publiée sur Google Play  .

1. KEYSTORE
Ne suivez cette étape que si vous mettez à jour une application existante déjà qui a déjà été publiée sur Google Play.

Comment puis-je obtenir le fichier Keystore ?
Si vous avez fait votre demande auprès d'un autre concurrent de GoodBarber, vous devez lui demander de vous fournir le fichier keystore.
 
Que faire si je n'ai pas le fichier Keystore ?
Si vous ne pouvez pas obtenir le fichier Keystore, veuillez sélectionner C'est la première fois que cette application sera disponible sur Google Play et votre application sera publiée comme une toute nouvelle application.

2. PACKAGE NAME

Le processus vous amène automatiquement à l'étape 3. Toutefois, vous pouvez modifier le Package Name à l'étape 2.

Par défaut, le package name est défini comme suit: com.goodbarber.yourprojectname.
Attention: il apparaît dans l'URL du Google Play Store.

Exemple:
Si le nom de votre projet GoodBarber est myapp, le package name sera com.goodbarber.myapp.
L'URL du Google Play sera ainsi : https://play.google.com/store/apps/details?id=com.goodbarber.myapp

Pour modifier le package name :
1. Retournez à l'étape 2.PACKAGE NAME
2. Modifiez le package name en suivant les indications données sur le lien suivant : Android - Modifier le package name d'une app 
3. Cliquez sur Suivant

Rendez-vous dans votre console Google Cloud.

Vos informations d'identification sont les mêmes que celles que vous utilisez pour vous connecter à votre compte Google. Si vous êtes déjà connecté à votre environnement Google, vous serez automatiquement redirigé à votre console Google Cloud.

Si vous n'avez pas de compte Google, créez-en un afin de poursuivre le tutoriel.

1 - ​ Cliquez sur Sélectionner un projet. 

2 - Cliquez sur NOUVEAU PROJET

3 - Définissez un Nom de projet
4 - Sélectionnez l'Organisation à joindre à votre projet
5 - Sélectionnez sa Localisation
6 - Cliquez sur Créer

7 - Ouvrez le projet depuis la barre d'outils

Vous êtes maintenant sur votre tableau de bord.

8 - Prenez note de votre numéro de projet (et non du "Project ID")
Dans l'exemple ci-dessous, il s'agit du numéro suivant : 820232276143.
9 - Copiez-le dans le champ approprié à l'étape 3.1 de votre processus de soumission Android dans votre back office GoodBarber.
10 - Cliquez sur Etape suivante dans votre back office GoodBarber.

1 - Cliquez sur Accéder à l'aperçu des API ou rendez-vous dans le menu de navigation de gauche : API et services > Tableau de bord.

2 - Cliquez sur Activer les API et les services.

3. Recherchez et activez ces APIs à partir de la bibliothèque d'API  :

- Recherchez Maps SDK for Android dans la bibliothèque d'API
- Cliquez sur le bouton Activer
- Revenez sur la bibliothèque d'API

- Recherchez Cloud Messaging dans la bibliothèque d'API
- Cliquez sur le bouton Activer
- Revenez sur la bibliothèque d'API

1. Retournez au tableau de bord des API et services > Tableau de bord  
2. Assurez-vous que les 2 APIs Maps SDK pour Android et Cloud Messaging sont activées dans la liste API :

1. Connectez-vous à votre console Google Play  
2. Sélectionnez "Toutes les applications"
3. Cliquez sur "Créer une application".

4. Remplissez les détails de votre application (nom de l'application, langue par défaut, sélectionnez App pour Application ou Jeu et gratuite ou payante)
Indiquez si votre application sera téléchargée gratuitement ou à un prix que vous déterminerez*.
5. Cochez les cases des déclarations (Conseils de contenu et lois américaines sur les exportations)
6. Cliquez sur "Créer une application"

*Pour publier des applications payantes, il vous sera demandé de créer un compte marchand .
Cliquez sur le lien fourni dans votre console Google Play et suivez les instructions de Google.

ATTENTION : ​Vous ne pouvez jamais transformer une application gratuite en une application payante !
Si vous configurez votre application GRATUITEMENT sur le Play Store, c'est pour toujours !
Vous pouvez changer une application payante en une application gratuite - mais une fois qu'elle est changée en "gratuite", elle ne peut plus jamais être redéfinie en "payante".

1. Allez dans le menu Release > Production

2. Cliquez sur "Créer une release"
3. Sous "Intégrité de l'appli" cliquez sur « Modifier la clé de signature de l'app »
4. Cliquez sur "Utiliser une clé générée par Google"
5. Allez dans le menu Publier > Configuration > Intégrité de l'application :: Onglet App Signing 
6. Cliquez sur l'icône de copie à côté de l'empreinte du certificat SHA-1

7. Collez cette empreinte de certificat SHA-1 dans le champ dédié de votre back office GoodBarber .
 

Toujours depuis le menu Google Play Release > Setup > App integrity :: Onglet "App Signing"
1. Cliquez sur l'icône de copie à côté de l'empreinte digitale du certificat SHA-256
2. Collez cette empreinte de certificat SHA-256 dans le champ dédié de votre back office GoodBarber.
3. Cliquez sur "Suivant" dans votre back office GoodBarber pour accéder à l'étape 5.3 du processus de compilation Android.

Revenez à votre console Google Cloud  , sélectionnez le projet lié à cette application.
1. Allez dans API & Services > Identifiants  
2. Cliquez sur Créer des identifiants
3. Sélectionnez l'option clé API

Une clé API est générée.
4 - Cliquez sur "Modifiez la clé API"

5. Remplacer le nom par "Android Key"
6. Sélectionnez Applications Android sous Restrictions relatives aux application
7. Cliquez sur "Ajouter nom du package et empreinte" (Doit être fait deux fois, une fois pour chaque SHA-1)
8. Copiez le package name et l'empreinte du certificat SHA-1 fourni à l'étape 5.3   du processus dans votre back office GB et collez le dans la console Google Cloud pour restreindre l'usage de votre app Android avec 2 items. 

9. Sous restrictions relatives aux API, sélectionnez Restreindre la clé
10. Dans le menu déroulant, sélectionnez "Maps SDK for Android"
11. Cliquez sur Sauvegarder

12 - Copiez la clé API et collez-la à l'étape 5.2 de votre processus de soumission Android dans votre back office GoodBarber

1. Rendez-vous sur la  "Firebase Console"
2. Cliquez sur "Ajouter un projet"

3. Dans la fenêtre Ajouter un projet, cliquez sur la flèche déroulante dans le champ Nom du projet.
Une liste des projets existants s'affiche.

4. Dans cette liste, sélectionnez le projet que vous avez créé à l'étape 3 de cette aide en ligne 
5. Acceptez les termes et conditions
6. Cliquez sur "Créer un projet"

Depuis la page Firebase, après avoir vérifié que vous êtes dans le bon projet, cliquez sur le logo Android. 

1. Dans le champ package name Android, indiquez le package name de votre application donné sur votre back office
2. Cliquez sur "Enregistrer l'application" sur la console Firebase

3. Cliquez sur le bouton "Télécharger google-services.json" pour télécharger le fichier de configuration. 

4. Ajoutez sur votre back office le fichier Google-service.json que vous venez de télécharger sur Firebase
5. Cliquez sur Suivant 
6. Cliquez sur Suivant, vous n'avez rien à faire à cette étape car le SDK Firebase est inclus par défaut dans les applications GoodBarber.
7. Cliquez sur Ignorer cette étape, vous n'avez rien à faire à cette étape car l'installation du SDK Firebase est gérée par défaut par GoodBarber.

Rendez-vous dans le menu settings de votre projet Firebase.
1. Cliquez sur l'icône située à droite de "Project Overview"
2. Choisissez "Paramètres du projet"

3. Affichez le contenu de l'onglet "Cloud Messaging". 
4. Dans le bloc "Identifiants du projet", identifiez la "Clé de serveur" 
5. Copiez la valeur du token (jeton) associé en cliquant sur l'icône.

6. Ajoutez le token de cette clé serveur à l'étape 6.3 de votre processus de soumission Android dans votre back office GoodBarber.

La configuration sur la console Google Cloud est terminée, vous pouvez à présent générer votre application dans votre back office GoodBarber.

1 - Valider la dernière étape
2 - Cliquez sur Générer mon application.

Une fois votre application créée, une nouvelle page s'affiche.
 
1 - Cliquez sur Tester mon application pour tester la version Ad Hoc

2 - Suivez les instructions affichées dans la fenêtre

Il est possible que le message d'avertissement suivant apparaisse quand vous tenterez d'installer la version ad hoc sur votre téléphone Android :
“Play Protect doesn’t recognize this app’s developer. Apps from unknown developers can sometimes be unsafe”.

Google Play Protect considère comme potentiellement dangereuse toute application téléchargée depuis une autre source que le Play Store.
Cet avertissement est par conséquent normal, puisque la version ad hoc est téléchargée non pas du store mais directement depuis votre projet.

Il n'y a pas à s'inquiéter: GoodBarber est une source sure!
 
Vous pouvez continuer et cliquer sur “Install anyway” pour tester la version ad hoc sur votre téléphone Android.

Au cas où vous auriez choisi “OK”par erreur, toutes les installations de ce fichier APK seront bloquées.
Il existe néanmoins une solution:
1/ Supprimez le fichier APK existant du menu “Downloads” / "Téléchargements" de votre appareil Android,
2/ Téléchargez le à nouveau depuis GoodBarber
3/ Cliquez sur “Install anyway” quand le choix se présentera de nouveau.

Après le test, revenez dans Canaux de vente >  App  Android > Publier : 

1. Modifier mon application - cette action déverrouille votre backend GoodBarber, vous pouvez ainsi modifier votre application et la recompiler (vous n'aurez pas à créer vos clés API de nouveau).

2. Soumettez mon application - cette action vous permettra de procéder à la publication de votre application.
Votre backend est bloqué jusqu'à ce que votre application soit publiée sur le Google Play Store. Une confirmation est demandée afin de ne pas bloquer votre backend par erreur. Tout ce qui reste à faire est de soumettre votre application Android sur le Google Play Store .