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

Please be in mind that both 64 bit CPU and 64 bit OS are mandatory condition. If your system DOES NOT meet this condition, you have to change affected hardware or software or the whole system. It is strongly recommended to use SSD (Solid State Disk) instead of HDD (Hard Disk Drive) because it will take less time when you are building the APS installation apk file. Recommended is just recommended and it is not a mandatory. However, you may still use a HDD when you are building apk file but note that the building process can take a long time to complete, although once started, you can leave it running unattended.

---

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

In general, the steps necessary to build the APK file:

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

Detailed description of the steps necessary to build the APK file.

Installer git (si vous ne l’avez pas)

Follow the manual on the git installation page.

Installer Android Studio

The following screenshots have been taken from Android Studio Version Arctic Fox | 2020.3.1. Screens can change in future versions of Android Studio. But you should be able to find your way through. Help from the community is provided.

One of the most important things when installing Android Studio: Be patient! During installation and setup Android Studio is downloading a lot of stuff which will take its time.

Download Android Studio from here and install it on your computer.

On first start you will find the setup wizard:

Select « Do not import settings » as you have not used it before.

Decide whether you want to share data with Google or not.

On the following screen click « Next ».

Select « Standard » installation and click « Next ».

Select the theme for the user interface you like. (In this manual we used « Light ».) Then click « 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.

Click « Finish » on the « Verify Settings » dialog.

Wait while Android Studio downloads additional components and be patient. Once everything is downloaded button « Finish » turns blue. Click the button now.

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.

On the Android Studio welcome screen click « Customize » (1) on the left and then select the link « 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é

Signing means that you indicate your app to be your own creation but in a digital way as a kind of digital fingerprint within the app itself. That is necessary because Android has a rule that it only accepts signed code to run for security reasons. For more information on this topic, follow this link.

• 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

Easiest way to transfer app-full-release.apk to your phone is via USB cable or Google Drive. Please note that transfer by mail might cause difficulties and is not the preferred way.

On your phone you have to allow installation from unknown sources. Manuals how to do this can be found on the internet (i.e. here or here).

Résolution de problèmes

See separate page troubleshooting Android Studio.