Comment compiler la version Android

Android SDK : Version minimale du SDK : 21 Version cible du SDK : 29 Outils du SDK cible : 29

Android NDK : 23.

Compiler l’apk Android

1. Configurez d’abord l’environnement de développement.
2. Gradle (ligne de commande) :
   • Spécifiez les variables d’environnement. ANDROID_SDK et ANDROID_HOME sont les emplacements où Android Studio place les éléments :

   export ANDROID_SDK=/[your-path]/Android/sdk
   export ANDROID_NDK=/[your-path]/android-ndk-23
   export ANDROID_HOME=/[your-path]/Android/sdk

   • Compilez avec la ligne de commande

   cd android/OsmAnd && ../gradlew assembleNightlyFreeLegacyFatDebug

3. Android Studio :

import android project and run module flavor `android.OsmAnd`

4. Vous pouvez utiliser notre debug.keystore pour rendre les builds compatibles avec la nightly build.

Tâches/saveurs Gradle

La tâche Gradle assembleNightlyFreeLegacyFatDebug produira l’apk dans android/OsmAnd/build/outputs/apk/ nightlyFreeLegacyFat/debug/OsmAnd-nightlyFree-legacy-fat-debug.apk. Le nom de la tâche assembleNightlyFreeLegacyFatDebug se compose de :

• assemble - tâche standard pour construire l’apk
• nightlyFree - saveur de build décrite ci-dessous
• legacy - legacy / opengl / opengldebug - définit si l’apk produit aura des bibliothèques natives pour utiliser le rendu de carte opengl ou non. Plus d’informations dans le plugin de développement OsmAnd.
• fat - fat (toutes les cibles natives) / armv7 / arm64 / x86 / armonly - sélectionne les bibliothèques natives qui seront dans l’apk.
• debug - debug / release - tâche standard

Pour construire le bundle, vous pouvez utiliser bundle${FLAVOR}LegacyFatRelease.

Saveur	Paquet	Description
nightlyFree	net.osmand.dev	Build gratuite nocturne qui peut être installée à côté des deux versions GPlay pour les tests et l’exploration
androidFull	net.osmand.plus	La version complète d’OsmAnd~ peut être utilisée pour les builds F-Droid. N’utilise pas les services Google Play.
gplayFree	net.osmand	Version Google Play OsmAnd - utilise les services Google Play.
gplayFull	net.osmand.plus	Version Google Play OsmAnd+ - utilise les services Google Play.
huawei	net.osmand	Build spéciale pour le marché Huawei - utilise les services Huawei mais pas Google Play

Débogage

Activer le débogage NDK pour la bibliothèque native héritée (OsmAnd-core-legacy)

Dans OsmAnd/OsmAnd/jni/Application.mk, décommentez les lignes

APP_OPTIM := debug
APP_DEBUG := true

Ajoutez des symboles de débogage dans la configuration du projet Android Studio. Pour cela, allez dans Edit Configuration / dans le menu de gauche, sélectionnez Android App "OsmAnd" / sur le côté droit, sélectionnez l’onglet "Debugger". Et ajoutez OsmAnd/obj/local où les bibliothèques de build pour différentes configurations (arm64-v8a, armeabi-v7a, x86, x86_64).

Compiler la bibliothèque OpenGL

La bibliothèque Opengl est nécessaire pour des cibles comme assembleNightlyFreeOpenglFatDebug et est par défaut téléchargée depuis le répertoire OsmAnd ivy - tâche gradle. Pour le développement local, vous pourriez avoir besoin de compiler ces bibliothèques et de les publier dans le répertoire ivy local.

1. Configurez d’abord l’environnement de développement, voir environnement de développement.
2. Installez les outils.
   • Android SDK - 29.
   • Android NDK - 23.
   • CMake > 3.6 (cmake -version).
   • SWIG - 4.1.1 (ou compatible).
   • Compilateur c++ local (de préférence clang).
   • Outils Bash : wget, curl, python ...
3. Gradle (ligne de commande) :
   • Spécifiez les variables d’environnement. ANDROID_SDK et ANDROID_HOME sont les emplacements où Android Studio place les éléments :

   export ANDROID_SDK=/[your-path]/Android/sdk
   export ANDROID_NDK=/[your-path]/android-ndk-23
   export ANDROID_HOME=/[your-path]/Android/sdk

   • Compilez avec la tâche de build gradle

   cd core/wrappers/android && ../gradlew build

Astuce : La compilation peut prendre beaucoup de temps et vous n’aurez probablement pas besoin de toutes les plateformes, vous pouvez donc commenter les architectures indésirables dans le script et ne construire que pour 1 plateforme (x86, x86_64, arm, arm64) en mode debug ou release.

Débogage

À compléter : comment configurer le débogage Android ndk.

Compiler les exemples d’API

🚧 This article is incomplete

This article is incomplete & needs to be reviewed. You can help by creating a pull request.

OsmAnd fournit 2 types d’exemples d’applications, ils sont tous représentés dans le dépôt Github osmand-api-demo et compilés régulièrement sur OsmAnd Builder.

Script de compilation :

(cd OsmAnd-api-sample && ./gradlew clean assembleRelease)
(cd OsmAnd-map-sample && ./gradlew clean assembleRelease)

• OsmAnd-api-sample - l’application exemple la plus simple qui interagit avec OsmAnd déjà installé via l’interface AIDL et les Intents.
• OsmAnd-map-sample - une application exemple qui a OsmAnd entièrement intégré en tant que SDK. Permet d’utiliser toutes les API internes.

En savoir plus.