{"id":169,"date":"2021-08-20T21:13:30","date_gmt":"2021-08-20T21:13:30","guid":{"rendered":"https:\/\/www.louismarchand.me\/?page_id=169"},"modified":"2022-08-22T18:50:05","modified_gmt":"2022-08-22T18:50:05","slug":"les-projets-android","status":"publish","type":"page","link":"https:\/\/www.louismarchand.me\/index.php\/les-projets-android\/","title":{"rendered":"Les projets Android"},"content":{"rendered":"

Introduction<\/h2>\n

La structure d’un projet Android peut \u00eatre assez complexe. Dans cette page, je t\u00e2cherai de vous expliquer les diff\u00e9rents aspects importants dans un projet Android.<\/p>\n

Cr\u00e9ation d’un nouveau projet<\/h2>\n

Pour cr\u00e9er un nouveau projet, appuyez sur le bouton \u00ab\u00a0Start a new Android project\u00a0\u00bb si vous \u00eates sur l’\u00e9cran d’accueil d’Android Studio, ou s\u00e9lectionnez le menu \u00ab\u00a0File->New->New Project…\u00a0\u00bb.<\/p>\n

\"\"<\/p>\n

\"\"<\/p>\n

Ensuite, s\u00e9lectionnez le type d’activit\u00e9 que vous souhaitez faire pour votre activit\u00e9 par d\u00e9faut. Nous verrons ce qu’est une activit\u00e9 Android plus tard dans le cours. Il est toujours possible de passer d’un type d’activit\u00e9 \u00e0 un autre en modifiant le code source de votre projet. \u00c7a n’a donc pas beaucoup d’importance.<\/p>\n

\"\"<\/p>\n

Ensuite, s\u00e9lectionnez un nom d’application et nom de \u00ab\u00a0Package\u00a0\u00bb.<\/p>\n

Le nom de \u00ab\u00a0Package\u00a0\u00bb est g\u00e9n\u00e9ralement li\u00e9 au nom du domaine Web de l’entreprise ou du d\u00e9veloppeur qui cr\u00e9e l’application. Cette r\u00e8gle n’est pas obligatoire et dans le cas, ou vous n’aviez pas de nom de domaine, vous pouvez mettre un identificateur vous repr\u00e9sentant. Par exemple, je pourrais mettre \u00ab\u00a0marchandl.mon_application\u00a0\u00bb si je n’avais pas de nom de domaine.<\/p>\n

\"\"<\/p>\n

Ensuite, dans le cadre du cours, vous devez sp\u00e9cifier le langage de programmation \u00e0 utiliser. La programmation Android de base peut se faire avec les langages Java ou Kotlin. Dans le c\u00e2dre de ce cours, nous allons utiliser le langage Java.<\/p>\n

Le dernier \u00e9l\u00e9ment \u00e0 prendre en compte, c’est l’API minimum du syst\u00e8me. Pour cette valeur, je vous recommande de prendre un API assez ancien afin de supporter le maximum d’appareil et d’utilisateur. \u00c9galement, nous allons voir plus loin qu’on peut mettre un API cible en plus d’un API minimum, ce qui nous permettra d’avoir plus de fonctionnalit\u00e9, sans avoir \u00e0 restreindre les utilisateurs avec des appareils anciens.<\/p>\n

La structure des r\u00e9pertoires<\/h2>\n

Le r\u00e9pertoire racine du projet contient des scripts et des fichiers de configurations du syst\u00e8me de compilation Gradle. Peu d’information de ce r\u00e9pertoire peut vous \u00eatre utile dans le cours. Par contre, les fichiers scripts \u00ab\u00a0gladlew\u00a0\u00bb et \u00ab\u00a0gladlew.bat\u00a0\u00bb sont des scripts pouvant \u00eatre utilis\u00e9s en ligne de commande et qui peuvent vous permettre de compiler votre projet sans n\u00e9cessiter l’utilisation d’Android Studio; ce qui peut \u00eatre tr\u00e8s utile si vous utilisez un serveur de compilation ou un service d’int\u00e9gration continue. \u00c9galement, le r\u00e9pertoire \u00ab\u00a0gradle\u00a0\u00bb contient des fichiers de configuration et des librairies n\u00e9cessaires au bon fonctionnement du syst\u00e8me de compilation.<\/p>\n

\"\"<\/p>\n

Le r\u00e9pertoire \u00ab\u00a0app\u00a0\u00bb contient les fichiers et r\u00e9pertoire qui vous seront utiles en tant que programmeur.<\/p>\n

\"\"<\/p>\n

Le r\u00e9pertoire \u00ab\u00a0libs\u00a0\u00bb contient les librairies Java (et parfois natives) qui permettent de bien faire fonctionner le code source qui se trouve dans le r\u00e9pertoire \u00ab\u00a0src\u00a0\u00bb.<\/p>\n

Le fichier \u00ab\u00a0build.gradle\u00a0\u00bb est le fichier de configuration principal de votre application. Il peut \u00eatre tr\u00e8s int\u00e9ressant d’explorer les diff\u00e9rentes informations que ce fichier contient (ou peut contenir). Nous verrons cela plus bas. Le fichier \u00ab\u00a0proguard-rules.pro\u00a0\u00bb est utilis\u00e9 par l’utilitaire \u00ab\u00a0R8\u00a0\u00bb afin de faire de l’optimisation du programme, lors de la cr\u00e9ation du \u00ab\u00a0package\u00a0\u00bb d’installation. La configuration ProGuard n’est pas pr\u00e9vue dans ce cours, mais si c’est un aspect qui vous int\u00e9resse, vous pouvez voir la documentation \u00e0 ici<\/a>.<\/p>\n

Le code source de l’application se trouve dans le r\u00e9pertoire \u00ab\u00a0src\u00a0\u00bb. Dans ce r\u00e9pertoire, on y trouve un r\u00e9pertoire \u00ab\u00a0main\u00a0\u00bb contenant le code source du projet, un r\u00e9pertoire \u00ab\u00a0test\u00a0\u00bb contenant des fichiers de test Java standard et un r\u00e9pertoire \u00ab\u00a0androidTest\u00a0\u00bb, contenant des tests pour les modules Android.<\/p>\n

\"\"<\/p>\n

Les 3 r\u00e9pertoires contiennent une structure de r\u00e9pertoire de vos \u00ab\u00a0Package\u00a0\u00bb Java. Il est important de noter que le syst\u00e8me de \u00ab\u00a0Package\u00a0\u00bb de java est directement reli\u00e9 \u00e0 la structure de r\u00e9pertoire. Par exemple, le fichier source de mon activit\u00e9 \u00ab\u00a0main\u00a0\u00bb se trouve dans le \u00ab\u00a0Package\u00a0\u00bb \u00ab\u00a0me.louismarchand.mon_application\u00a0\u00bb et se trouve donc dans le r\u00e9pertoire source du projet \u00ab\u00a0me\/louismarchand\/mon_application\u00a0\u00bb.<\/p>\n

\"\"<\/p>\n

En plus des fichiers sources, le r\u00e9pertoire \u00ab\u00a0main\u00a0\u00bb contient les ressources utilis\u00e9es dans l’application ainsi que le fichier \u00ab\u00a0AndroidManifest.xml\u00a0\u00bb qui est un fichier tr\u00e8s important dans le d\u00e9veloppement Android. Nous verrons l’utilisation de ce fichier ainsi que des ressources plus tard dans le cours.<\/p>\n

Il est \u00e0 noter que tous ces fichiers sont accessibles directement dans l’\u00e9diteur Android Studio. Il n’est donc g\u00e9n\u00e9ralement pas n\u00e9cessaire de naviguer cette structure de r\u00e9pertoires.<\/p>\n

Le fichier \u00ab\u00a0build.gradle\u00a0\u00bb<\/h2>\n

Le fichier \u00ab\u00a0build.gradle\u00a0\u00bb permet entre autres de changer l’API minimal et l’API cible utilis\u00e9 dans votre projet. Notez que les termes API et SDK sont souvent m\u00e9lang\u00e9s dans la technologie Android. Ils repr\u00e9sentent presque la m\u00eame chose et leurs num\u00e9ros sont les m\u00eames (l’API 15 est impl\u00e9ment\u00e9 par le SDK 15).<\/p>\n

\"\"<\/p>\n

Le fichier \u00ab\u00a0AndroidManifest.xml\u00a0\u00bb<\/h2>\n

Ce fichier contient la configuration principale du code source du projet. On y retrouve des configurations comme: le nom et le nom de l\u2019ic\u00f4ne de l’application, l’activit\u00e9 principale \u00e0 lancer lors de l’ex\u00e9cution de l’application, les activit\u00e9s de service de l’application, les permissions de l’application (cam\u00e9ra, avoir acc\u00e8s aux fichiers de l’utilisateur, calendrier, contacts, etc.) et bien d’autres.<\/p>\n

\"\"<\/p>\n

Pour plus de d\u00e9tail sur ce que le manifeste Android peut contenir comme configuration, voir la documentation officielle ici<\/a>.<\/p>\n

Les fichiers de ressources<\/h2>\n

Dans le r\u00e9pertoire \u00ab\u00a0res\u00a0\u00bb, on y trouve les ressources visuelles (par exemple: images), les informations de mise en page (layouts) ainsi que les diff\u00e9rentes constantes utilis\u00e9es dans l’application (par exemple, les chaines de caract\u00e8res, les couleurs, etc.).<\/p>\n

\"\"<\/p>\n

Une fois une ressource cr\u00e9\u00e9e, ses \u00e9l\u00e9ments peuvent \u00eatre acc\u00e9d\u00e9s dans le code java en utilisant la r\u00e9f\u00e9rence retourn\u00e9 par le singleton \u00ab\u00a0R\u00a0\u00bb (nom tr\u00e8s peu significatif \u00e0 mon avis), ainsi que des fonctions comme \u00ab\u00a0getRessource\u00a0\u00bb. Par exemple, voici une constante texte appel\u00e9 \u00ab\u00a0bonjour\u00a0\u00bb cr\u00e9\u00e9 dans le fichier \u00ab\u00a0strings.xml\u00a0\u00bb:<\/p>\n

\"\"<\/p>\n

Si je veux faire afficher cette valeur dans un Popup Android (appel\u00e9 \u00ab\u00a0Toast\u00a0\u00bb) voici ce que je peux faire en Java (noter que tous le code permettant l’acc\u00e8s aux ressources se trouve dans la premi\u00e8re ligne de l’exemple):<\/p>\n

\n
CharSequence<\/span> lBonjour<\/span> =<\/span> getResources<\/span>().<\/span>getText<\/span>(<\/span>R<\/span>.<\/span>string<\/span>.<\/span>bonjour<\/span>);<\/span>\r\nToast<\/span> lPopup<\/span> =<\/span> Toast<\/span>.<\/span>makeText<\/span>(<\/span>getApplicationContext<\/span>(),<\/span> lBonjour<\/span>,<\/span> Toast<\/span>.<\/span>LENGTH_LONG<\/span>);<\/span>\r\nlPopup<\/span>.<\/span>show<\/span>();<\/span>\r\n<\/pre>\n<\/div>\n
\"\"<\/p>\n
Voici le r\u00e9sultat en ex\u00e9cution (le \u00ab\u00a0Toast\u00a0\u00bb est point\u00e9 par la fl\u00e8che rouge):<\/p>\n
\"\"<\/p>\n
\u00c0 propos des versions d’API<\/h2>\n
Malgr\u00e9 qu’il est g\u00e9n\u00e9ralement mieux de permettre l’utilisation de l’application au plus grand nombre de personnes, il peut arriver qu’une fonctionnalit\u00e9 soit souhait\u00e9e, pour les appareils qui peuvent le g\u00e9rer. Par exemple, voici un bout de code qui permettrait d’ex\u00e9cuter une m\u00e9thode particuli\u00e8re (\u00ab\u00a0clearData\u00a0\u00bb) dans le cas o\u00f9 l’appareil aurait trop peu d’espaces m\u00e9moire vive libres:<\/p>\n
\"\"<\/p>\n
On voit que la m\u00e9thode ne peut pas \u00eatre ex\u00e9cut\u00e9e sur les machines ayant un API inf\u00e9rieur \u00e0 19. Puisque notre API minimal est de 16, ce programme ne peut pas \u00eatre compil\u00e9. Deux solutions s’offrent \u00e0 nous pour r\u00e9gler cette erreur.<\/p>\n
La premi\u00e8re, dans le cas o\u00f9 la fonctionnalit\u00e9 est n\u00e9cessaire au bon fonctionnement de l’application, il sera n\u00e9cessaire de modifier le SDK minimal du projet afin de le monter \u00e0 19 (voir la section sur le fichier \u00ab\u00a0build.gradle\u00a0\u00bb).<\/p>\n
La seconde solution est utilisable dans le cas o\u00f9 la fonctionnalit\u00e9 n’est pas n\u00e9cessaire, mais tout de m\u00eame int\u00e9ressante \u00e0 ajout\u00e9 \u00e0 l’application si l’appareil de l’utilisateur le permet. On peut donc encapsuler l’instruction fautive dans un \u00ab\u00a0if\u00a0\u00bb, avec la condition:<\/p>\n
if (Build.VERSION.SDK_INT >= API_NUMBER) {<\/pre>\n
Dans notre exemple, on pourrait faire:<\/p>\n
\"\"Ou, pour enlever le \u00ab\u00a0if\u00a0\u00bb inutilement imbriqu\u00e9:<\/p>\n
\"\"<\/p>\n
Retour<\/a><\/p>\n
\n
Auteur: Louis Marchand
\n\"Creative<\/a>
\nSauf pour les sections sp\u00e9cifi\u00e9es autrement, ce travail est sous licence Creative Commons Attribution 4.0 International<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
Introduction La structure d’un projet Android peut \u00eatre assez complexe. Dans cette page, je t\u00e2cherai de vous expliquer les diff\u00e9rents aspects importants dans un projet Android. Cr\u00e9ation d’un nouveau projet Pour cr\u00e9er un nouveau projet, appuyez sur le bouton \u00ab\u00a0Start a new Android project\u00a0\u00bb si vous \u00eates sur l’\u00e9cran d’accueil d’Android Studio, ou s\u00e9lectionnez le… Continue reading Les projets Android<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-169","page","type-page","status-publish","hentry","entry"],"_links":{"self":[{"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/pages\/169","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/comments?post=169"}],"version-history":[{"count":23,"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/pages\/169\/revisions"}],"predecessor-version":[{"id":645,"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/pages\/169\/revisions\/645"}],"wp:attachment":[{"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/media?parent=169"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}