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.
• Les systèmes d’exploitation Windows 10 32 bits ne sont pas pris en charge par 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. Générer l’application (générer un fichier apk signé)
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)

Suivez le manuel sur la page d’installation de git.

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

Assurez-vous que git est installé sur votre ordinateur et que vous avez redémarré votre ordinateur après l’installation.

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

Windows

• En tant qu’utilisateur de Windows, assurez-vous que vous avez redémarré votre ordinateur après avoir installé 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

• On the Android Studio welcome screen select “Projects” (1) on the left and then “Get from VCS” (2).

  

  • If you already opened Android Studio and do not see the welcome screen anymore select File (1) > New (2) > Project from Version Control... (3)

    

  • We will now tell Android Studio were to get the code from:

  • Make sure you have selected “Repository URL” on the left (1).

  • Check if “Git” is selected as version control (2).

  • Copy and paste the URL https://github.com/nightscout/AndroidAPS to the main AndroidAPS repository into the URL textbox (3).

  • Choose the directory where you want to save the cloned code (4).

    

• Cliquez sur le bouton “Clone” (5).

  

• Ne cliquez pas sur “Background” pendant que le répertoire est cloné !

• After the repository is cloned successfully, Android Studio will open the cloned project.

• You will be asked whether you want to trust the project. Click on “Trust project”!

  

• In the status bar at the bottom you will see the information that Android Studio is running background tasks.

  

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

  

• Once the background tasks are finished you will probably see an error saying that errors occurred (1) or (2) or (3).

  

  Don’t worry, this will be solved soon!

Télécharger Android SDK

• In the menu, go to File (1) > Settings (2).

  

• Double-click on Appearance & Behaviour to open its submenu (1).

• Double-click on System Settings (2) and select Android SDK (3).

• Tick the box left of “Android 9.0 (Pie)” (4) (API Level 28).

  

• Confirmez les modifications en cliquant sur OK.

  

• Accept licence agreement (1) and click “Next” (2).

  

• Wait until the SDK download and installation is finished.

  

• 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”. Never update gradle! This will lead to difficulties!

• If you see an information on the lower right side of your Android Studio window that Android Gradle Plugin is ready to update click on the text “update” (1).

  

• In the dialog box the select “Don’t remind me again for this project” (2).

  

• Restart Android Studio before you continue.

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.

• After Android Studio is started, wait until all background tasks are finished.

  

  • 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.