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

1. Cliquez dans le menu de gauche API et services > Bibliothèque

2. Recherchez et activez ces services API à partir de la bibliothèque API :
- Recherchez Maps SDK pour Android dans la bibliothèque API
- Cliquez sur le bouton Activer 
- Retourner à la bibliothèque API 

- Recherchez Firebase Cloud Messaging dans la bibliothèque API
- Cliquez sur le bouton Activer 
- Retourner à la bibliothèque API 

- Recherchez l'API Firebase Installations dans la bibliothèque API
- Cliquez sur le bouton Activer

Si Google vous propose d'essayer la plateforme Google Maps, revenez à la console Google Cloud de votre projet.

1 - Retournez dans le menu API & Services > Tableau de bord
2. Assurez-vous que les 2 API Maps SDK pour Android et Cloud Messaging sont activées dans la liste des API.

1. Connectez vous à votre Google Play console  
2. Select "Accueil"
3. Click "Créer une application".

4. Remplissez les détails de votre application (nom de l'application, langue par défaut, sélectionnez Application pour Application ou Jeu et Gratuit ou payant)
Indiquez si votre application sera téléchargée gratuitement ou à un prix que vous déterminerez*.
5. Cochez les cases de déclarations (Directives relatives au contenu et lois américaines sur l'exportation)
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.

AVERTISSEMENT : ​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 transformer une application payante en application gratuite, mais une fois qu'elle est devenue "gratuite", elle ne peut plus jamais être rétablie en "payante".

1. Comptes de développeurs individuels : accédez au menu Test et Release > Tests > Tests fermés, puis cliquez sur « Gérer le suivi » à côté de « Tests fermés - Alpha »
ou
Comptes d'organisation : accédez au menu Test et Release > Production

2. Cliquez sur « Créer une nouvelle version »
3. Sous Intégrité de l'application, cliquez sur « Choisir la clé de signature »
4. Sélectionnez « Utiliser la clé générée par Google »
5. Accédez au menu Test et Release > Configuration > Signature de l'application
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 Test et publier > Configuration > Signature d'application
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. Accédez à API et services > Informations d'identification 
2. Cliquez sur "Créer des informations d'identification > Clé API"

Une clé API est générée.

3. Cliquez sur « Modifier la clé API »

5. Remplacez le nom par défaut par « Clé Android »
6. Sélectionnez les applications Android sous Restrictions de clé
7. Cliquez sur « Ajouter un "package name et une empreinte de certificat " (doit être effectué deux fois, une fois pour chaque SHA-1)
8. Copiez le package name et l'empreinte digitale des certificats SHA-1 fournis à l'étape 5.3  du processus dans votre back-office GB et collez-les sur la console Google Cloud pour restreindre l'utilisation de votre application Android avec 2 éléments.

9. Sous Restrictions API, sélectionnez Restreindre la clé
10. Dans le menu déroulant, sélectionnez :
- Maps SDK pour Android
- Firebase API Installations

11. Cliquez sur « Enregistrer »

12 - Copiez la clé API et collez-la à l'étape 5.4 de votre processus de soumission Android dans votre backend GoodBarber.

1. Accédez à la « Console Firebase »
2. Cliquez sur « Créer un projet »

3. Cliquez sur « Ajouter Firebase au projet Google Cloud »
4. Cliquez sur « Sélectionner un projet Google Cloud »
Une liste des projets existants s'affiche.

5. Dans cette liste, sélectionnez le projet que vous avez créé à l'étape 3 de cette aide en ligne*
6. Cliquez sur « Continuer » dans les étapes suivantes pour créer votre projet Firebase**

*Lisez cette aide en ligne pour vous assurer de lier le projet Firebase au bon projet Google Cloud.
** C'est à vous de désactiver/activer Google Analytics pour votre application Android maintenant ou vous pouvez toujours activer Google Analytics plus tard).

Depuis le tableau de bord, après avoir vérifié que vous êtes dans le bon projet, cliquez sur le logo Android.

1. Dans la case package name Android, saisissez le package name de votre application indiqué dans 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. Téléchargez le fichier Google-service.json sur votre back office GoodBarber
5. Cliquez sur "Suivant" sur la plateforme Firebase
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 "Passer cette étape", vous n'avez rien à faire à cette étape car l'installation du SDK Firebase est gérée par défaut par GoodBarber.

Accédez aux paramètres de votre projet Firebase :
1. Cliquez sur l'icône en forme de roue à droite de la vue d'ensemble du projet
2. Cliquez sur "Paramètres du projet"

3. Cliquez sur l'onglet "Compte de service"
4. Cliquez sur "Générer une nouvelle clé privée"

5. Téléchargez cette clé privée dans votre back-office

Vous avez terminé de configurer votre application Android, vous pouvez maintenant compiler la version native ad hoc et la tester sur votre appareil.

1 - Valider la dernière étape
2 - Cliquer sur Créer mon application

Une fois votre application créée, une nouvelle page apparaît.

1 - Cliquez sur Tester mon application pour tester la version Ad Hoc

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

Vous pouvez recevoir l’avertissement suivant lorsque vous essayez d’installer le fichier APK ad hoc sur votre téléphone Android : « Play Protect ne reconnaît pas le développeur de cette application. Les applications de développeurs inconnus peuvent parfois être dangereuses ».
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 donc normal, car la version ad hoc n’est pas téléchargée depuis le magasin mais directement depuis votre projet. Ne vous inquiétez pas cependant : GoodBarber est une source sûre !

Vous pouvez continuer et cliquer sur « Installer quand même » pour tester la version ad hoc sur votre téléphone Android.

Si vous avez appuyé sur « OK » par erreur, les installations actuelles et futures de ce fichier APK spécifique seront bloquées, mais il existe toujours une solution :

1. Supprimez le fichier APK existant du menu « Téléchargements » de votre appareil Android,
2. Téléchargez à nouveau le fichier depuis GoodBarber,
3. Cliquez sur « Installer quand même » lorsqu’on vous demande de choisir.

Après le test, retournez dans Canaux de vente > Application Android > Publier .

Modifier mon application - cette action déverrouille votre backend GoodBarber, vous pouvez donc modifier votre application et la reconstruire (si vous le faites, vous n'aurez pas à modifier vos clés API).

Soumettre mon application - cette action vous permettra de procéder à la publication de votre application.
Votre backend est verrouillé jusqu'à ce que votre application soit publiée sur le Google Play Store. Une confirmation vous est demandée afin de ne pas verrouiller votre backend par erreur. Il ne vous reste plus qu'à soumettre votre application Android sur le Google Play Store .

Lorsque le projet est prêt, cliquez sur Continuer pour afficher le tableau de bord.