Construire l’APK

Construire vous-même au lieu de télécharger

AndroidAPS n’est pas disponible en téléchargement en raison de la réglementation concernant les dispositifs médicaux. Il est légal de construire l’application pour votre usage personnel, mais vous ne devez en aucun cas donner une copie à d’autres personnes ! Voir la page FAQ pour plus de détails.

Remarques importantes

• Utilisez Android Studio Version 2020.3.1 ou une version plus récente pour construire l’apk.

• Windows 10 32-bit systems are not supported by Android Studio 2020.3.1

Configuration recommandée de l’ordinateur pour construire un fichier apk

OS (seulement 64 bits)	Windows 8 ou supérieur	Mac OS 10.14 ou supérieur	N'importe quel Linux prend en charge Gnome, KDE, ou Unity DE;  GNU C Library 2.31 ou ultérieure
CPU (seulement 64 bits)	architecture processeur x86_64 ; Core Intel de 2ème génération ou plus récente, ou processeur AMD prenant en charge un Hypervisor Windows	Intel Core de 2ème génération ou plus récente, ou processeur AMD prenant en charge un Hypervisor.Framework	architecture du processeur x86_64, Intel Core de 2ème génération ou plus récent ou processeur AMD avec support pour la virtualisation AMD (AMD-V) et SSSE3
RAM	8GB or more
Disque	Au moins 30 Go d'espace libre. Un SSD est recommandé.
Résolution	Minimum 1280 x 800
Internet	Haut débit

Veuillez garder à l’esprit que le processeur 64 bits et le système d’exploitation 64 bits sont des conditions obligatoires. Si votre système ne répond pas à cette condition, vous devez modifier le matériel ou le logiciel affecté ou tout le système. Il est fortement recommandé d’utiliser un SSD (Solid State Disk) au lieu d’un HDD (Hard Disk Drive) car cela prendra moins de temps lorsque vous construisez le fichier apk d’installation d’AAPS. Recommandé signifie que ce n’est pas obligatoire. Cependant, vous pouvez toujours utiliser un disque dur lorsque vous construisez un fichier apk, mais notez que le processus de construction peut prendre beaucoup de temps à s’exécuter, si bien qu’une fois démarré, vous pouvez le laisser fonctionner sans surveillance.

---

Cet article est divisé en deux parties.

• La partie « aperçu » indique les étapes nécessaires pour construire le fichier APK.

• Dans la partie « pas à pas », vous trouverez les captures d’écran d’une installation complète. Les versions d’Android Studio - l’environnement de développement logiciel que nous utiliserons pour construire l’APK - changent très rapidement. Les exemples ne seront donc pas identiques à votre installation, mais cela devrait vous donner un bon point de départ. Android Studio fonctionne sous Windows, Mac OS X et Linux et il peut y avoir de petites différences entre chaque plateforme. Si vous trouvez que quelque chose d’important qui est incorrect ou manquant, merci d’informer le groupe facebook « utilisateurs AndroidAPS » ou dans les chats Discord Android APS ou AndroidAPSwiki afin que nous puissions y remédier.

Aperçu

En général, les étapes nécessaires pour construire le fichier APK sont :

1. Installer Git

2. Installer Android Studio

3. Définir le chemin d’accès git dans Android Studio

4. Télécharger le code AndroidAPS

5. Télécharger Android SDK

6. Build the app (generate signed apk)

7. Transférer le fichier apk sur votre téléphone

8. Identifier le récepteur si vous utilisez xDrip+

Démarche pas à pas

Description détaillée des étapes nécessaires à la construction du fichier APK.

Installer git (si vous ne l’avez pas)

Follow the manual on the git installation page.

Installer Android Studio

Les captures d’écran suivantes ont été prises à partir de Android Studio Version Arctic Fox | 2020.3.1. Les écrans peuvent changer dans les versions futures d’Android Studio. Mais vous devriez y arriver. Vous pouvez demande de l’aide auprès de la commauté.

Une des choses les plus importantes lors de l’installation d’Android Studio : Soyez patient ! Au cours de l’installation et de la configuration, Android Studio télécharge beaucoup de choses ce qui prendra du temps.

Téléchargez Android Studio ici et installez le sur votre ordinateur.

Au premier démarrage, vous trouverez l’assistant d’installation :

Sélectionnez « Do not import settings » car vous n’avez pas eu d’utilisation préalable.

Décidez si vous voulez partager les données avec Google ou non.

Dans l’écran suivant, cliquez sur « Next ».

Sélectionnez l’installation « Standard » et cliquez sur « Next ».

Sélectionnez le thème de l’interface utilisateur que vous souhaitez (dans ce manuel, nous avons utilisé « Light »). Cliquez ensuite sur « Next ».

Remarque : Ce n’est que le modèle de couleurs. Vous pouvez choisir n’importe quel type (par ex. « Darcula » pour le mode sombre). Cette sélection n’a aucune influence sur la construction de l’APK, mais les captures d’écran suivantes peuvent être différentes.

Cliquez sur « Finish » dans la boite de dialogue « Verify Settings ».

Attendez qu’Android Studio télécharge des composants supplémentaires et soyez patient. Une fois que tout est téléchargé, le bouton « Finish » devient bleu. Cliquez sur le bouton maintenant.

Définir le chemin de git dans les préférences

Make sure git is installed on your computer and you have restarted your computer after installing.

Sur l’écran d’accueil d’Android Studio cliquez sur « Customize » (1) à gauche, puis sélectionnez le lien « All settings… » (2):

Windows

• As windows user, make sure you have restarted your computer after installing Git.

• Double-cliquez sur « Version Control » (1) pour ouvrir le sous-menu.

• Cliquez sur Git (2).

• Assurez-vous que la méthode de mise à jour « Merge » (3) est sélectionnée.

• Vérifiez si Android Studio peut localiser le chemin d’accès à git.exe automatiquement en cliquant sur le bouton « Test » (4).

  

• Si la configuration automatique est réussie, la version de git s’affiche sous chemin d’accès.

  

• Éventuellement git.exe peut ne pas être trouvé automatiquement ou le test entraînera une erreur (1) :

  

  Dans ce cas, cliquez sur l’icône de dossier (2).

• Utilisez la fonction de recherche dans l’explorateur windows pour trouver « git.exe » si vous n’êtes pas sûr de l’endroit ou il a été installé. Vous cherchez un fichier nommé « git.exe », situé dans le dossier \bin.

• Sélectionnez le chemin d’accès à git.exe et vérifiez que vous avez sélectionné le dossier ** \bin\ ** (3) et cliquez sur « OK » (4).

  

• Vérifiez à nouveau votre chemin d’accès git sélectionné avec le bouton « Test » comme décrit ci-dessus.

• Lorsque la version de git est affichée sous le chemin (voir la capture d’écran ci-dessus), fermez la fenêtre de configuration en cliquant sur le bouton « OK » (5).

Mac

• N’importe quelle version de git devrait fonctionner. Par exemple https://git-scm.com/download/mac.

• Utilisez homebrew pour installer git: $ brew install git.

• Pour plus de détails sur l’installation de git, voir la documentation officielle.

• Si vous installez git via homebrew, il n’est pas nécessaire de modifier les préférences. Juste au cas où : on peut y accéder ici : Android Studio - Preferences.

Télécharger le code AndroidAPS

• Sur l’écran d’accueil d’Android Studio, sélectionnez « Projects » (1) à gauche, puis « Get from VCS » (2).

  

  • Si vous avez déjà ouvert Android Studio et que vous ne voyez plus l’écran d’accueil, sélectionnez File (1.) > New (2.) > Project from Version Control … (3)

    

  • Nous allons maintenant indiquer à Android Studio d’où recevoir le code :

  • Assurez-vous d’avoir sélectionné « Repository URL » sur la gauche (1).

  • Vérifier si « Git » est sélectionné comme contrôle de version (2).

  • Copiez et collez l’URL https://github.com/nightscout/AndroidAPS dans le dépôt principal d’AndroidAPS dans la zone de texte d’URL (3).

  • Choisissez le répertoire dans lequel vous voulez enregistrer le code cloné (4).

    

• Cliquez sur le bouton « Clone » (5).

  

• Ne cliquez pas sur « Background » pendant que le répertoire est cloné !

• Une fois que le dépôt a été cloné avec succès, Android Studio ouvrira le projet cloné.

• On vous demandera si vous voulez faire confiance au projet. Cliquez sur « Trust project » !

  

• Dans le coin inférieur droit, vous verrez l’information qu’Android Studio exécute les tâches d’arrière-plan.

  

• Accorder l’accès si votre pare-feu demande l’autorisation.

  

• Une fois que les tâches de fond sont terminées, vous verrez probablement une erreur indiquant que des erreurs se sont produites (1) ou (2) ou (3).

  

  Ne vous inquiétez pas, cela sera bientôt résolu!

Télécharger Android SDK

• Dans le menu, allez dans « File » (1) > « Settings » (2).

  

• Double-cliquez sur « Appearance & Behaviour » pour ouvrir son sous-menu (1).

• Double-cliquez sur « System Settings » (2) et sélectionnez « Android SDK » (3).

• Cochez la case à gauche de « Android 9.0 (Pie) » (4.) (API niveau 28).

  

• Confirmez les modifications en cliquant sur OK.

  

• Acceptez le contrat de licence (1) et cliquez sur « Next» (2).

  

• Attendez que le téléchargement et l’installation du SDK soient terminés.

  

• Lorsque l’installation du SDK est terminée, le bouton « Finish » devient bleu. Cliquez sur ce bouton.

  

• Android Studio recommande de mettre à jour le « gradle system ». Ne jamais mettre à jour gradle ! Cela pourrait entraîner des difficultés !

• Si vous voyez une information sur le côté inférieur droit de votre fenêtre Android Studio qui indique que le plugin Android Gradle est prêt à mettre à jour, cliquez sur le texte « update » (1).

  

• Dans la boîte de dialogue sélectionnez « Don’t remind me again for this project » (2).

  

• Redémarrez Android Studio avant de continuer.

Générer un APK signé

Signer signifie que vous signez votre application générée mais d’une façon numérique comme une sorte d’empreinte digitale intégrée dans l’application elle-même. C’est nécessaire car Android a une règle qui impose de n’accepter que du code signé pour des raisons de sécurité. Pour plus d’informations sur ce sujet, suivez ce lien.

• Après le démarrage d’Android Studio, attendez que toutes les tâches en arrière-plan soient terminées.

  

  • Warning: If errors occur, do not continue with the following steps. \ Consult the troubleshooting section for known problems!

  

• Click « Build » (1) in the menu bar and select « Generate Signed Bundle / APK… » (2).

  

• Select « APK » (1) instead of « Android App Bundle » and click « Next » (2).

  

• Make sure that module is set to « AndroidAPS.app » (1).

• Click « Create new… » (2) to start creating your key store.

  Note: A key store in this case is nothing more than a file in which the information for signing is stored. Il est crypté et les informations sont sécurisées avec des mots de passe.

  

• Click the folder symbol to select a path on your computer for your key store.

  

• Sélectionnez le répertoire dans lequel votre fichier de clés doit être sauvé (1).

  

  Warning: Do not save in same folder as project. You must use a different directory! A good location would be your home folder.

• Type a file name for your key store (2) and confirm with « OK » (3).

• Enter (2) and confirm (3) the password for your key store.

  Note: Passwords for key store and key do not have to be very sophisticated. Assurez vous de bien vous en souvenir ou notez le dans un endroit sûr. In case you will not remember your passwords in the future, see troubleshooting for lost key store.

• Enter an alias (4) for your key. Choose whatever you like.

• Enter (5) and confirm (6) the password for your key

• Validity (7) is 25 years by default. Vous n’avez pas à modifier la valeur par défaut.

• Le prénom et le nom sont obligatoires (8). Toutes les autres informations sont facultatives.

• Click « OK » (9) when you are done.

• Assurez-vous que la case permettant de mémoriser les mots de passe est cochée (1). Ainsi vous n’aurez pas à les saisir à nouveau la prochaine fois que vous génèrerez le fichier apk (par ex. en faisant une mise à jour avec une nouvelle version d’AndroidAPS).

• Cliquez sur « Next » (2).

  

• Select build variant « fullRelease » (1) and press « Finish ».

  

• Android Studio will show « Gradle Build running » at the bottom. This takes some time, depending on your computer and internet connection. Be patient!

  

• Android Studio will display the information « Generate Signed APK » after build is finished.

  

• Dans le cas ou la génération n’a pas réussie, référez vous à la section dépannage.

• Click on the notification to expand it.

• Click on the link « locate ».

  

  • If the notification is gone, you can always open the « Event log » and select the same link there.

• Your file manager/explorer will open. Navigate to the directory « full » (1) > « release » (2).

  

• « app-full-release.apk » (3) is the file you are looking for!

Transférer le fichier APK sur le smartphone

La façon la plus facile de transférer le fichier app-full-release.apk dans votre téléphone est via un câble USB ou Google Drive. Veuilez noter que le transfert par email peut entraîner des difficultés et n’est pas la méthode conseillée.

Sur votre téléphone, vous devez autoriser l’installation à partir de sources inconnues. Les explications peuvent être trouvées sur internet (par ex. ici ou ici).

Résolution de problèmes

Voir la page spécifique dépannage Android Studio.