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 4.1.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 4.1.1.
Configuration on demand n’est pas pris en charge par la version actuelle du plug-in Android Gradle !
Si votre construction échoue avec une erreur concernant la “configuration sur demande”, faites les actions suivantes :
- Ouvrez la fenêtre Préférences en cliquant sur File > Settings (sur Mac, Android Studio > Preferences).
- Dans le panneau de gauche, cliquez sur Build, Execution, Deployment > Compiler.
- Décochez la case Configure on demand.
- Cliquez sur Appliquer ou OK.
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 concrè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 est incorrect ou manquant, merci d’informer le groupe facebook “utilisateurs AndroidAPS” ou dans les chats Gitter 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 :
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.
Installez Android Studio¶
Les captures d’écran suivantes ont été prises à partir d’Android Studio Version 3.6.1. Votre écran peut être un peu différent selon la version d’Android Studio que vous utilisez. 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.
Installez Android Studio et configurez le au premier démarrage.
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”.
Select the theme for the user interface you like. (dans ce manuel, nous avons utilisé “Light”). Cliquez ensuite sur “Next”. C’est juste le jeu 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.
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.
Sur l’écran d’accueil d’Android Studio, cliquez sur le petit triangle (1. de la capture d’écran ci-dessous) et sélectionnez “Settings” (2.).
Windows¶
Cliquez sur le petit triangle en regard de 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.
Cliquez sur “OK” dans la boîte de dialogue (1.) et sur “OK” dans la fenêtre des paramètres (2.).
Si le fichier git.exe n’est pas trouvé, cliquez sur “OK” dans la boite de diablogue (1.) puis sur le bouton avec les 3 petits points (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 est. Vous chercher un fichier git.exe situé dans un 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.).
Fermez la fenêtre des paramètres en cliquant sur le bouton “OK” (5.).
Redémarrez votre PC pour mettre à jour l’environnement système.
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¶
Si vous n’avez pas encore redémarré votre ordinateur après avoir défini le chemin d’accès à git dans les préférences, faites le maintenant. L’environnement système doit être mis à jour.
Il y a deux options pour démarrer un nouveau projet :
Sur l’écran d’accueil d’Android Studio, cliquez sur “Get from version control”
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.)
Renseignez l’URL vers l’adresse de base d’AndroidAPS (https://github.com/nightscout/AndroidAPS) (1.).
Choisissez le répertoire dans lequel vous voulez enregistrer le code cloné. (2.)
Cliquez sur le bouton “Clone” (3.).
Ne cliquez pas sur “Background” pendant que le répertoire est cloné !
Une fois le clonage du répertoire réussi, ouvrez votre copie locale en cliquant sur “Yes”.
Dans le coin inférieur droit, vous verrez qu’Android Studio exécute les tâches d’arrière-plan en information.
Accorder l’accès si votre pare-feu demande l’autorisation.
Une fois les tâches en arrière-plan terminées, vous verrez probablement le message d’erreur suivant :
Télécharger Android SDK¶
Cliquez sur File > Settings.
Cliquez sur le petit triangle à côté de Appearance & Behaviour (1.).
Cliquez sur le petit triangle à côté de 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.
Accepter le contrat de licence (1.) et cliquer sur “Next” (2.).
Attendez que l’installation soit terminée.
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 dans le coin inférieur droit une information indiquant que le plugin Android Gradle Plugin est près à être mis à jour, cliquez sur le texte “update” (1.) et dans la boite de dialogue sur “Don’t remind me again for this project” (2.).
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.
Cliquez sur “Build” dans la barre de menus et sélectionnez “Generate Signed Bundle / APK ...”.
Sélectionnez “APK” (1.) au lieu de “Android App Bundle” et cliquez sur “Suivant” (2.).
Assurez-vous que le module est défini sur “app” (1.).
Cliquez sur “Create new...” (2.) pour commencer la création de votre fichier de clés.
Un fichier de clés dans ce cas n’est rien de plus qu’un fichier dans lequel les informations de signature sont stockées. Il est crypté et les informations sont sécurisées avec des mots de passe.
Cliquez sur le symbole de dossier (1.) pour sélectionner votre chemin d’accès au fichier de clés.
Sélectionnez le répertoire dans lequel votre fichier de clés doit être sauvé (2.). Ne pas le mettre dans le même répertoire que celui du projet. Vous devez utiliser un autre répertoire ! Une option peut être dans votre dossier d’accueil.
Entrez le nom de votre fichier de clés (3.).
Cliquez sur “OK” (4.).
Les mots de passe pour le fichier de clés et la clé ne doivent pas être très compliqués. Assurez vous de bien vous en souvenir ou notez le dans un endroit sûr. Si plus tard vous avez oublié vos mots de passe, allez voir la page Dépannages d’Android Studio - Certificats perdus.
Entrez (5.) et confirmez (6.) le mot de passe de votre fichier de clé.
Faites de même pour votre clé (7. + 8.).
La validité (9.) est de 25 ans par défaut. Vous n’avez pas à modifier la valeur par défaut.
Le prénom et le nom sont obligatoires (10.). Toutes les autres informations sont facultatives.
Cliquez sur “OK” (11.) lorsque vous avez terminé.
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.).
Sélectionnez la variante “fullRelease” (1.).
Cochez les cases V1 et V2 pour les versions de signature (2.).
Cliquez sur “Finish”. (3.)
Android Studio affiche l’information “APK(s) generated successfully...” quand la génération est terminée.
Dans le cas ou la génération n’a pas réussie, référez vous à la section dépannage.
La façon la plus facile de trouver l’apk est de cliquer sur “Event log”.
Dans la section “event log” cliquez sur “locate”.
Le fichier que vous cherchez est “app-full-release.apk”.
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).
Identifier le récepteur si vous utilisez xDrip+¶
Troubleshooting¶
Voir la page spécifique dépannage Android Studio.