Historique de la page

...

https://play.google.com/store/apps/details?id=org.esupportail.esupnfctagdroid

L'APK envoyée sur Google Play le

...

13 oct. 2023 est la version 1.2.

...

5 disponible également depuis le Tag github 1.2.

...

5.

Si vous êtes responsable d'un serveur esup-nfc-tag d'un établissement de l'ESR que vous souhaitez voir apparaître votre serveur esup-nfc-tag dans la liste des serveurs disponibles depuis cette version esup-nfc-tag-droid fournie sur le google play, vous pouvez en faire la demande au travers d'un Pull Request proposant la modification du listing des urls disponibles :
https://github.com/EsupPortail/esup-nfc-tag-droid/blob/master/src/main/assets/urls

...

1. en utilisant Android Studio  ( https://developer.android.com/studio), au 13/10/2023, Studio Giraffe a été testée avec succès
2. en ligne de commande depuis un linux

Génération de l'APK en ligne de commandes

Pré-requis

...

• OpenJDK 8
• Gradle (4.10.3 ok)

Android SDK API level 28

En dehors d'android studio, la récupération du SDK d'Android peut se faire via le 'Android SDK tools package' en lignes de commandes.

• 11 (par exemple une distribution zulu d'openjdk 11 : https://

...

• www.

...

• azul.com/

...

• downloads/?version=java-11-lts&package=jdk#zulu)

On le télécharge et on le dézippe en tant qu'utilisateur (esup ici pour nous) qui se chargera de compiler/packager l'application android.

Le cmdline-tools est donc disponible ici : /home/esup/cmdline-tools

On installe mainetant le sdk d'android , level 28 : 

[esup@carbonne bin]$ ./sdkmanager 'platforms;android-28' --sdk_root=/home/esup
[esup@carbonne bin]$ ./sdkmanager 'build-tools;28.0.3' --sdk_root=/home/esup 

On accepte au passage la licence proposée.

Le SDK et outils associés ont ainsi été installés dans le home d'esup.

On pourra positionner ANDROID_HOME ainsi dans le .bashrc de l'utilisateur esup : 

[esup@carbonne ~]$ echo 'export ANDROID_HOME=/home/esup' >>  ~/.bashrc

Autres ...

Si à la compilation (cf ci-dessous compilation via gradlew clean assemble), vous trouvez des erreurs types 

java.io.IOException: Cannot run program "/home/esup/build-tools/22.0.1/aapt": error=2, Aucun fichier ou dossier de ce type

Il vous manque sans doute des librairies.

En exécutant /home/esup/build-tools/22.0.1/aapt directement on voit quelle librairie il cherche.

Ensuite un 

yum whatprovides 'libz.so.1'

nous donne le paquet à installer avec yum install.

[root@carbonne ~]# yum install libstdc++* zlib*

Des librairies 32 bits seront à installer notamment. 

Compilation esup-nfc-tag-droid

• esup-nfc-tag-droid génère des logs à destination d'un fichier de logs local au téléphone, à destination d'esupNfcTagServer (envoi de logs par POST au serveur) et à destination d'une adresse mail système. Les éléments paramétrables (mail systeme, serveur esupNfcTagServer) sont à configurer dans ce fichier src/main/assets/logback.xml
• modifier src/main/assets/esupnfctag.properties pour spécifier l'adresse de votre esup-nfc-tag-server
• Vous pouvez spécifier les paramètres de signature de votre APK dans build.gradle, si vous ne souhaitez pas utiliser ceux donnés par défaut (connus de tous). Vous devrez alors créer un keystore : 

keytool -genkey -v -keystore esup-android-apps.keystore -alias LeoDroidApp -keyalg RSA -keysize 2048 -validity 10000

• build de l'APK
  Il vous faut gradle, récupérer un zip de la distribution et le dézipper suffit (dernier test en date via gradle-4.10.3-bin.zip récupéré depuis https://gradle.org/releases/)depuis le répertoire source :

/home/esup/gradle-4.10.3/bin/gradle/gradlew clean assemble

Integration dans esup-nfc-tag-server

• copier l'APK dans EsupNfcTagServer pour le mettre à disposition des utilisateurs :

...

• recompiler et redéployer esup-nfc-tag-server. Au redémarrage d'esup-nfc-tag-server la nouvelle version de l'apk sera prise en compte
• Vous pouvez aussi proposer le lien vers l'APK via esup-sgc (en ajoutant un "navbarapp" depuis l'onglet admin/navbarapp)