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

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

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.

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

On first start you will find the setup wizard:

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

Ne pas importer les paramètres

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

Partager des données avec Google

Dans l’écran suivant, cliquez sur “Next”.

Écran d'accueil

Sélectionnez l’installation “Standard” et cliquez sur “Next”.

Installation standard

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

Note: This is just the color scheme. You can select whatever you like (i.e. “Darcula” for dark mode). This selection has no influence on building the APK but the following screenshots might look different.

Couleur de l'interface

Cliquez sur “Finish” dans la boite de dialogue “Verify Settings”.

Vérifiez les paramètres

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.

Téléchargement des composants

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):

Paramètres Android Studio à partir de l'écran d'accueil

Windows

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

  • Double-click “Version Control” (1) to open the sub-menu.

  • Cliquez sur Git (2).

  • Make sure update method “Merge” (3) is selected.

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

    Paramètres Android Studio

  • If automatic setting is successful git version will be displayed next to the path.

    Git version displayed

  • Eventually git.exe cannot be found automatically or the Test will result in an error (1):

    Git not found

    In this case click on the folder icon (2).

  • Use search function in windows explorer to find “git.exe” if you are unsure where git has been installed. You are looking for a file named “git.exe”, located in \bin folder.

  • Select path to git.exe and make sure you selected the one in ** \bin\ ** folder (3) and click “OK” (4).

    Select git manually

  • Check your selected git path again with the “Test” button as described above.

  • When the git version is displayed next to the path (see screenshot above), close settings window by clicking “OK” button (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).

    Android Studio wizard

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

      Charger le projet à partir du contrôle de version dans Android Studio

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

      Clone Git

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

    Cloner le répertoire

  • 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”!

    Trust project

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

    Tâches d'arrière-plan

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

    Autorisation java dans le pare-feu

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

    Licence SDK

    Don’t worry, this will be solved soon!

Télécharger Android SDK

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

    Ouvrir les paramètres

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

    Paramètres SDK

  • Confirmez les modifications en cliquant sur OK.

    Confirmer les modifications SDK

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

    Accepter la licence SDK

  • Wait until the SDK download and installation is finished.

    Attendre lors de l'installation du SDK

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

    Terminer l'installation du SDK

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

    No gradle update

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

    No gradle update

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

    Wait for background tasks

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

    Gradle Sync Error

  • Click “Build” (1) in the menu bar and select “Generate Signed Bundle / APK...” (2).

    Génération de l'apk

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

    APK au lieu du bundle

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

    Créer le fichier de clés

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

    Créer le fichier de clés

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

    Créer le fichier de clés

    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. Select key store path

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

    Mémoriser les mots de passe

  • Select build variant “fullRelease” (1) and press “Finish”.

    Select build variant

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

    Gradle Running

  • Android Studio will display the information “Generate Signed APK” after build is finished.

    Build 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”.

    Locate build

    • If the notification is gone, you can always open the “Event log” and select the same link there. Génération réussie - journal des événements
  • Your file manager/explorer will open. Navigate to the directory “full” (1) > “release” (2).

    Emplacement du fichier apk

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