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

• Installez Git
• Installez et configurez Android Studio.
• Utilisez git pour cloner le code source du répertoire central Github où les développeurs ont mis le code réel pour l’application.
• Ouvrez le projet cloné dans Android Studio comme projet actif.
• Construisez l’APK signé.
• Transférez l’APK généré sur votre téléphone.

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.1.3. Votre écran peut être un peu différent selon la version d’Android Studio que vous utilisez. Mais vous devriez y arriver. L’aide de la communauté est fournie par exemple dans le groupe Facebook AndroidAPS et à d’autres endroits.

Installez Android Studio et configurez au premier démarrage.

Sélectionnez “Ne pas importer les paramètres” car vous n’avez pas eu d’utilisation préalable.

Cliquez sur “Suivant”.

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

Sélectionnez le thème de l’interface utilisateur que vous souhaitez. (Dans ce manuel, nous avons utilisé “Intellij”. Puis cliquez sur “Suivant”. 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 “Suivant” dans la boîte de dialogue “Vérifier les paramètres”.

L’émulateur Android (pour émuler le smartphone sur votre PC ou Mac) n’est pas utilisé pour construire l’APK. Vous pouvez cliquer sur “Finish” pour terminer l’installation et lire la documentation plus tard sur demande.

Android Studio télécharge beaucoup de composants logiciels qu’il utilise. Vous pouvez cliquer sur le bouton “Show Details” pour voir ce qui se passe, mais ce n’est pas important.

Une fois les téléchargements terminés, cliquez sur le bouton “Finish”.

• Applaudissements! applaudissements!!! vous avez maintenant terminé l’installation Android Studio et vous pouvez commencer à cloner le code source. Peut-être une courte pause serait la bienvenue ?

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

Windows

• Donnez l’information à Studio où git.exe est situé : Fichier - Paramètres

  

• Dans la fenêtre suivante : Contrôle de version - Git (Version Control - Git)

• Choisissez le chemin correct : .../Git/bin

• Assurez-vous que la méthode de mise à jour “Fusion” (merge) est sélectionnée.

  

Mac

• 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 et les composants supplémentaires

• Utilisez git clone dans Android Studio comme indiqué dans les captures d’écran ci-dessous. Sélectionnez “Check out project from Version Control” avec “Git” comme système de contrôle de version.

Renseignez l’URL vers l’adresse de base d’AndroidAPS (“https: //github.com/MilosKozak/AndroidAPS ”) Et cliquez sur “clone”.

Android Studio va commencer le clonage. Ne cliquez pas sur “Background”, car c’est rapide et cela rend les choses plus compliquées.

Terminez la commande à partir du contrôle de version en ouvrant le projet en cliquant sur “Yes”.

Utilisez le standard “default gradle wrapper” et cliquez sur “OK”.

Lisez et fermez l’écran “Tip of Day” d’Android Studio en appuyant sur “Close”.

• Excellent, vous avez votre propre copie du code source et êtes prêt à démarrer la compilation.
• Maintenant, nous approchons de notre premier message d’erreur. Heureusement, Android Studio nous donnera directement la solution pour cela.

Cliquez sur “Install missing platform(s) and sync project” car Android Studio a besoin d’installer une plateforme manquante.

Acceptez le contrat de licence en sélectionnant “Accept” et en cliquant sur “Next”.

Comme il est dit dans la boîte de dialogue, veuillez patienter jusqu’à ce que le téléchargement soit terminé.

Maintenant, c’est fini. Veuillez cliquer sur “Finish”.

Aaaahhh, prochaine erreur. Mais Android Studio propose une solution similaire. Cliquez sur “Install Build Tools and sync project” car Android Studio a besoin de télécharger des outils complémentaires.

Comme il est dit dans la boîte de dialogue, veuillez patienter jusqu’à ce que le téléchargement soit terminé.

Maintenant, c’est fini. Veuillez cliquer sur “Finish”.

Et une autre erreur à gérer car Android Studio a à nouveau besoin de télécharger une plateforme manquante. Cliquez sur “Install missing platform(s) and sync project”.

Comme il est dit dans la boîte de dialogue, veuillez patienter jusqu’à ce que le téléchargement soit terminé.

Maintenant, c’est fini. Veuillez cliquer sur “Finish”.

Cliquez sur “Install Build Tools and sync project” car Android Studio a besoin de télécharger des outils complémentaires.

Comme il est dit dans la boîte de dialogue, veuillez patienter jusqu’à ce que le téléchargement soit terminé.

Maintenant, c’est fini. Veuillez cliquer sur “Finish”.

Yes, les messages d’erreur sont partis et la première construction de gradle est en cours. Peut-être est-il temps de boire un peu d’eau?

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

Veuillez cliquer sur “Don’t remind me again for this project”.

La construction est à nouveau en cours d’exécution.

Yes, la première construction est réussie, mais ce n’est pas encore terminé.

Générer un APK signé

Dans le menu , sélectionnez “Build” puis “Generate Signed Bundle / APK...”. (Le menu d’Android Studio a changé en septembre 2018. Dans les versions plus anciennes, sélectionnez “Build” puis “Generate Signed APK...”.)

Signer signifie que vous signez votre application générée mais de manière numérique comme une sorte d’empreinte digitale 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 le lien ici. La sécurité est un sujet important et complexe et vous n’avez pas besoin de cela maintenant.

Dans la boite de dialogue suivante, sélectionnez “APK” à la place de “Android App Bundle” et cliquez sur le bouton “Next”.

Sélectionnez “app” et cliquez sur “Next”.

Cliquez sur “Create new...” pour commencer la création de votre fichier de clés. Un fichier de clés dans cette affaire n’est rien de plus qu’un fichier dans lequel les informations de signature est stockée. Il est crypté et les informations sont sécurisées avec des mots de passe. Nous vous conseillons de le stocker dans votre dossier personnel et de vous rappeler des mots de passe, mais si vous perdez cette information, ce n’est pas très grave car vous devrez juste en créer un nouveau. Une bonne pratique consiste à sauvegarder ces informations avec soin.

• Renseignez les informations de la boîte de dialogue suivante.
  • Key store path : chemin d’accès au fichier de clés. Ne pas enregistrer dans le même dossier que celui du projet. Vous devez utiliser un répertoire différent!
  • Les champs password en dessous permettent une double vérification du mot de passe pour éviter les erreurs de frappe.
  • Alias est un nom pour la clé dont vous avez besoin. Vous pouvez laisser la valeur par défaut ou lui donner un nom spécifique.
  • Les champs password en dessous de la clé sont pour la clé elle-même. Comme précédemment double contrôle pour éviter les erreurs de frappe.
  • Vous pouvez laisser la validité par défaut de 25 ans.
  • Vous n’avez qu’à remplir le prénom et le nom de famille, mais n’hésitez pas à compléter les autres informations. Puis cliquez sur “OK”.

Renseignez les informations de la dernière boîte de dialogue et cliquez sur “Next”.

Sélectionnez “full” (ou “fullRelease”) comme favori pour l’application générée. Sélectionnez V1 “Jar Signature” (V2 est optionnel) et cliquez sur “Finish”. Les informations suivantes peuvent être importantes pour une utilisation ultérieure.

• ‘Release’ devrait être votre choix par défaut pour “Build Variants”, ‘Debug’ est juste pour les personnes qui codent.
• Sélectionnez le type de génération que vous souhaitez complier.
  • full / fullRelease (c’est-à-dire recommandations automatiquement adoptées en boucle fermée)
  • openloop (c’est à dire les recommandations données à l’utilisateur commandes manuelles)
  • pumpcontrol (c’est-à-dire télécommande pour la pompe, pas pour le bouclage)
  • nsclient (c’est-à-dire que les données de bouclage d’un autre utilisateur sont affichées et que des entrées de careportal peuvent être ajoutées)

Dans le journal des événements, vous voyez que l’APK signé a été généré avec succès.

Cliquez sur le lien “locate” dans le journal des événements.

Transférer le fichier APK sur le smartphone

Une fenêtre du gestionnaire de fichiers s’ouvre. Comme j’utilise Linux, il se peut que ce soit un peu différent sur votre système. Sur Windows, il y aura l’Explorateur de fichiers et sur Mac OS X le Finder. Vous devez voir le répertoire avec le fichier APK généré. Malheureusement, c’est le mauvais endroit car “wear-release.apk” n’est pas l’application signée “app” APK que nous recherchons.

Veuillez sélectionner le répertoire AndroidAPS/app/full/release pour trouver le fichier “app-full-release.apk”. Transférez ce fichier sur votre smartphone Android. Vous pouvez le faire comme vous voulez, c-à-d.

• Bluetooth
• envoi dans le cloud (Google Drive ou autres services cloud)
• connection de l’ordinateur et du téléphone par câble
• par mail (Notez que certaines applications de messagerie ne permettent pas les pièces jointes apk, dans ce cas utiliser une autre méthode de transfert.)

Dans cet exemple, Gmail est utilisé car c’est assez simple. Pour installer l’application “auto-signée”, vous devez autoriser Android sur votre smartphone à effectuer cette installation même si ce fichier est reçu via Gmail, ce qui est interdit par défaut. Si vous utilisez une autre solution, veuillez procéder en conséquence.

Dans les paramètres de sécurité votre smartphone, il y a un paramètre “Sources inconnues” qu’il faut autoriser pour donner le droit d’installer les fichiers APK reçus par Gmail ou copiés manuellement sur le téléphone.

Autorisez “Sources inconnues”. Après l’installation, vous pouvez le désactiver à nouveau.

La dernière étape consiste à cliquer sur le fichier APK obtenu via Gmail et installer l’application. Si l’APK ne s’installe pas et que vous avez une version plus ancienne d’AndroidAPS sur votre téléphone (signé avec une autre clé), vous devrez au préalable la désinstaller. N’oubliez pas dans ce cas d’exporter vos paramètres auparavant !

Yes, vous l’avez et pouvez maintenant commencer à configurer AndroidAPS pour votre utilisation (MGC, pompe à insuline), etc.

Identify receiver if using xDrip+

See xDrip+ page

Dépannage

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