Merge branch 'release/2.6.0'

CHANGELOG.md

@@ -1,17 +1,127 @@
 # Changelog
 
+## [2.6.0](https://github.com/PnX-SI/gn_mobile_occtax/releases/tag/2.6.0) (2023-05-08, release)
+
+### 🚀 Nouveautés
+
+* Support Android 13 (API 33).
+* Support des fonds Geoportail (https://github.com/PnX-SI/gn_mobile_maps/issues/8).
+  Le module ["maps"](https://github.com/PnX-SI/gn_mobile_maps/tree/develop/maps) supporte
+  officiellement les fonds suivants :
+  * [Geoportail WMTS](https://www.geoportail.gouv.fr)
+  * [OpenTopoMap](https://www.opentopomap.org)
+  * [OpenStreetMap](https://www.openstreetmap.org)
+  * [Wikimedia Maps](https://maps.wikimedia.org)
+* Gestion automatique des attributions sur les fonds en ligne (https://github.com/PnX-SI/gn_mobile_occtax/issues/191).
+  L'attribution est définie automatiquement selon la nature de la source si aucune n'a été précisée
+  dans la configuration. L'attribution n'est valable que pour les fonds en ligne.
+* Petites améliorations sur la documentation, notamment sur la gestion, la configuration et
+    l'ordonnancement des couches coté module ["maps"](https://github.com/PnX-SI/gn_mobile_maps/tree/develop/maps)
+    (https://github.com/PnX-SI/gn_mobile_occtax/issues/192)
+* La synchronisation périodique de l'ensemble des données issues de GeoNature est configuré par
+    défaut à 7 jours. Cette configuration n'est active uniquement que si la synchronisation périodique
+    n'est pas configurée (les paramètres `sync_periodicity_data` et `sync_periodicity_data_essential`
+    ne sont pas renseignés).
+* La synchronisation des données est maintenant décoléré de la synchronisation des relevés (https://github.com/PnX-SI/gn_mobile_occtax/issues/133).
+* La synchronisation des relevés se fait à la demande de l'utilisateur (https://github.com/PnX-SI/gn_mobile_occtax/issues/137).
+* La synchronisation des données s'exécute mantenant dans un contexte transactionnel afin de
+  toujours garantir une cohérence des données présentes localement.
+* Refonte de l'écran d'accueil pour mettre en valeur les relevés en cours ou prêt à être
+  synchronisés. La partie paramétrage et synchronisation des données sont déportées dans le menu
+  latéral.
+
+### 🐛 Corrections
+
+* Meilleur support de la taille des textes de l'interface selon la densité et la configuration
+  d'affichage du terminal (https://github.com/PnX-SI/gn_mobile_occtax/issues/217).
+
+### ⚠️ Notes de version
+
+* Code de version : 3200
+* Depuis sa version 2.12.0, GeoNature permet de gérer le contenu de la table
+  `gn_commons.t_mobile_apps` directement dans le backoffice du module "Admin" de GeoNature (https://github.com/PnX-SI/gn_mobile_occtax/issues/214)
+* Dans cette même version, les médias (incluant le dossier `mobile/` comprenant les fichiers APK et
+  le fichier `settings.json` d'Occtax-mobile) ont été déplacés du dossier `~/geonature/backend/static/`
+  à `~/geonature/backend/media/` (https://github.com/PnX-SI/gn_mobile_occtax/issues/214)
+
+## [2.6.0-rc2](https://github.com/PnX-SI/gn_mobile_occtax/releases/tag/2.6.0-rc2) (2023-04-29, pre-release)
+
+### 🚀 Nouveautés
+
+* La synchronisation périodique de l'ensemble des données issues de GeoNature est configuré par
+  défaut à 7 jours. Cette configuration n'est active uniquement que si la synchronisation périodique
+  n'est pas configurée (les paramètres `sync_periodicity_data` et `sync_periodicity_data_essential`
+  ne sont pas renseignés).
+
+### 🐛 Corrections
+
+* Meilleur support de la taille des textes de l'interface selon la densité et la configuration
+  d'affichage du terminal (https://github.com/PnX-SI/gn_mobile_occtax/issues/217).
+* Le bouton "Envoyer les relevés" présenté sous forme de bouton icône dans la barre de menu en page
+  d'accueil est affiché sous forme de texte simple "Envoyer" et non plus sous forme d'icône pour
+  plus de clarté.
+* Petites améliorations sur la documentation, notamment sur la gestion, la configuration et
+  l'ordonnancement des couches coté module ["maps"](https://github.com/PnX-SI/gn_mobile_maps/tree/develop/maps)
+  (https://github.com/PnX-SI/gn_mobile_occtax/issues/192).
+
+### ⚠️ Notes de version
+
+* Code de version : 3191
+
+## [2.6.0-rc1](https://github.com/PnX-SI/gn_mobile_occtax/releases/tag/2.6.0-rc1) (2023-04-19, pre-release)
+
+### 🚀 Nouveautés
+
+* Support Android 13 (API 33).
+* Support des fonds Geoportail (https://github.com/PnX-SI/gn_mobile_maps/issues/8).
+  Le module ["maps"](https://github.com/PnX-SI/gn_mobile_maps/tree/develop/maps) supporte
+  officiellement les fonds suivants :
+  * [Geoportail WMTS](https://www.geoportail.gouv.fr)
+  * [OpenTopoMap](https://www.opentopomap.org)
+  * [OpenStreetMap](https://www.openstreetmap.org)
+  * [Wikimedia Maps](https://maps.wikimedia.org)
+* Gestion automatique des attributions sur les fonds en ligne (https://github.com/PnX-SI/gn_mobile_occtax/issues/191).
+  L'attribution est définie automatiquement selon la nature de la source si aucune n'a été précisée
+  dans la configuration. L'attribution n'est valable que pour les fonds en ligne.
+* Petites améliorations sur la documentation, notamment sur la gestion des couches coté module
+  ["maps"](https://github.com/PnX-SI/gn_mobile_maps/tree/develop/maps) (https://github.com/PnX-SI/gn_mobile_occtax/issues/192).
+
+### 🐛 Corrections
+
+* Mise à jour de la liste des relevés et de leurs statuts pendant la synchronisation.
+
+### ⚠️ Notes de version
+
+* Code de version : 3187
+
+## [2.6.0-rc0](https://github.com/PnX-SI/gn_mobile_occtax/releases/tag/2.6.0-rc0) (2023-03-25, pre-release)
+
+### 🚀 Nouveautés
+
+* La synchronisation des données est maintenant décoléré de la synchronisation des relevés (https://github.com/PnX-SI/gn_mobile_occtax/issues/133). 
+* La synchronisation des relevés se fait à la demande de l'utilisateur (https://github.com/PnX-SI/gn_mobile_occtax/issues/137).
+* La synchronisation des données s'exécute mantenant dans un contexte transactionnel afin de
+  toujours garantir une cohérence des données présentes localement.
+* Refonte de l'écran d'accueil pour mettre en valeur les relevés en cours ou prêt à être
+  synchronisés. La partie paramétrage et synchronisation des données sont déportées dans le menu
+  latéral.
+
+### ⚠️ Notes de version
+
+* Code de version : 3181
+
 ## [2.5.0](https://github.com/PnX-SI/gn_mobile_occtax/releases/tag/2.5.0) (2023-03-21, release)
 
 ### 🚀 Nouveautés
 
 * Gestion des médias sur la partie dénombrement (https://github.com/PnX-SI/gn_mobile_occtax/issues/84)
-* Refonte de la synchronisation des relevés en consommant les nouvelles APIs du module "Occtax".
+* Refonte de la synchronisation des relevés en consommant les APIs v2 du module "Occtax".
 * Refonte de la gestion des relevés.
 * Accélérer la saisie en permettant de mémoriser les dernières nomenclatures saisies sur la partie
   dénombrement (https://github.com/PnX-SI/gn_mobile_occtax/issues/169).
 * Possibilité de reprendre en édition un relevé terminé prêt à être synchronisé (https://github.com/PnX-SI/gn_mobile_occtax/issues/78).
 
-### 🚀 Corrections
+### 🐛 Corrections
 
 * Valeur par défaut des champs "Min"et "Max" dans la partie dénombrement (https://github.com/PnX-SI/gn_mobile_occtax/issues/209, https://github.com/PnX-SI/gn_mobile_occtax/issues/210)
 * Quelques petits ajustements sur la documentation de l'installation, notamment sur la récupération
@@ -20,13 +130,14 @@
 ### ⚠️ Notes de version
 
 * Code de version : 3170
+* Nécessite la version 2.10 (ou plus) de GeoNature.
 * Suite à la refonte sur la partie gestion des relevés, le paramétrage de la nomenclature en
   configuration avancée a évolué aussi (cf. [README.md](https://github.com/PnX-SI/gn_mobile_occtax#nomenclature-settings)),
   notamment sur le nommage des attributs et du respect de la casse (Par exemple `MIN` devient `count_min`).
 
 ## [2.4.1-rc4](https://github.com/PnX-SI/gn_mobile_occtax/releases/tag/2.4.1-rc4) (2023-02-21, pre-release)
 
-### 🚀 Corrections
+### 🐛 Corrections
 
 * Gestion des médias sur la partie dénombrement (https://github.com/PnX-SI/gn_mobile_occtax/issues/84)
 * Accélérer la saisie en permettant de mémoriser les dernières nomenclatures saisies sur la partie

README.md

@@ -50,19 +50,36 @@ Example:
     "base_path": "Offline_maps",
     "layers": [
       {
-        "source": "plan.mbtiles",
-        "label": "IGN plan"
+        "label": "IGN: plan v2",
+        "source": "https://wxs.ign.fr/essentiels/geoportail/wmts?REQUEST=GetTile&SERVICE=WMTS&VERSION=1.0.0&STYLE=normal&TILEMATRIXSET=PM&FORMAT=image/png&LAYER=GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2"
       },
       {
-        "source": "ortho.mbtiles",
-        "label": "IGN ortho"
+        "label": "IGN: ortho",
+        "source": "https://wxs.ign.fr/ortho/geoportail/wmts?REQUEST=GetTile&SERVICE=WMTS&VERSION=1.0.0&STYLE=normal&TILEMATRIXSET=PM&FORMAT=image/jpeg&LAYER=ORTHOIMAGERY.ORTHOPHOTOS"
       },
       {
         "label": "OpenStreetMap",
-        "source": "https://a.tile.openstreetmap.org/",
-        "properties": {
-          "attribution": "© OSM contributors"
-        }
+        "source": [
+          "https://a.tile.openstreetmap.org",
+          "https://b.tile.openstreetmap.org",
+          "https://c.tile.openstreetmap.org"
+        ]
+      },
+      {
+        "label": "OpenTopoMap",
+        "source": [
+          "https://a.tile.opentopomap.org",
+          "https://b.tile.opentopomap.org",
+          "https://c.tile.opentopomap.org"
+        ]
+      },
+      {
+        "label": "IGN plan",
+        "source": "plan.mbtiles"
+      },
+      {
+        "label": "IGN ortho",
+        "source": "ortho.mbtiles"
       },
       {
         "label": "Mailles 5x5",
@@ -252,10 +269,11 @@ Each property may be a simple string representing the nomenclature attribute to
 
 ## Upgrade git sub modules
 
-Do **NOT** modify directly any git sub modules (e.g. `commons`, `mountpoint`, `viewpager` and `maps`).
-Any changes should be made from each underlying git repository:
+Do **NOT** modify directly any git sub modules (e.g. `commons`, `compat`, `mountpoint`, `viewpager`
+and `maps`). Any changes should be made from each underlying git repository:
 
 - `commons`: [gn_mobile_core](https://github.com/PnX-SI/gn_mobile_core) git repository
+- `compat`: [gn_mobile_core](https://github.com/PnX-SI/gn_mobile_core) git repository
 - `datasync`: [gn_mobile_core](https://github.com/PnX-SI/gn_mobile_core) git repository
 - `mountpoint`: [gn_mobile_core](https://github.com/PnX-SI/gn_mobile_core) git repository
 - `viewpager`: [gn_mobile_core](https://github.com/PnX-SI/gn_mobile_core) git repository

build.gradle

@@ -1,10 +1,12 @@
 // Top-level build file where you can add configuration options common to all sub-projects/modules.
 
 buildscript {
-    ext.kotlin_version = '1.6.21'
+    ext.klint_version = '11.3.1'
+    ext.kotlin_version = '1.8.0'
     ext.androidx_hilt_version = '1.0.0'
-    ext.hilt_version = '2.41'
+    ext.hilt_version = '2.44'
     ext.retrofit_version = '2.9.0'
+    ext.room_version = '2.5.1'
     ext.tinylog_version = '2.4.1'
 
     repositories {
@@ -16,13 +18,17 @@ buildscript {
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:7.1.3'
+        classpath 'com.android.tools.build:gradle:7.4.2'
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
-        classpath "com.google.dagger:hilt-android-gradle-plugin:$hilt_version"
-        classpath "org.jlleitschuh.gradle:ktlint-gradle:9.4.1"
     }
 }
 
+plugins {
+    id 'com.google.dagger.hilt.android' version "$hilt_version" apply false
+    id 'org.jlleitschuh.gradle.ktlint' version "$klint_version"
+    id 'org.jlleitschuh.gradle.ktlint-idea' version "$klint_version"
+}
+
 allprojects {
     repositories {
         google()

compat

@@ -0,0 +1 @@
+gn_mobile_core/compat

docs/installation-fr.adoc

@@ -44,17 +44,17 @@ Il est nécessaire de gérer les fichiers de configuration, l'installation et la
 
 L'application *_Occtax-mobile_* se chargera alors de récupérer automatiquement sur le serveur GeoNature la dernière version du fichier de configuration des applications et détectera les éventuelles mises à jour disponibles pour l'application.
 
-Pour cela, chargez l'APK de l'application *_Occtax-mobile_* ainsi que son fichier de configuration `settings.json` dans le dossier `$HOME/geonature/backend/static/mobile/occtax` du serveur GeoNature.
+Pour cela, chargez l'APK de l'application *_Occtax-mobile_* ainsi que son fichier de configuration `settings.json` dans le dossier `$HOME/geonature/backend/media/mobile/occtax` du serveur GeoNature.
 
 Dans les commandes ci-dessous, remplacez `x.y.y` par le numéro (tag) de la version (release) utilisée.
 
 * *_Occtax-mobile_* : https://github.com/PnX-SI/gn_mobile_occtax/releases
 
-Sur votre serveur GeoNature, créer le sous-répertoire de l'application mobile *_Occtax-mobile_*.
+Sur votre serveur GeoNature, créez le sous-répertoire de l'application mobile *_Occtax-mobile_*.
 
 [source,shell]
 ----
-cd $HOME/geonature/backend/static/mobile
+cd ~/geonature/backend/media/mobile
 mkdir occtax
 ----
 
@@ -68,7 +68,7 @@ wget https://github.com/PnX-SI/gn_mobile_occtax/releases/download/x.y.z/occtax-y
 
 Créer le fichier de settings `settings.json` en suivant https://github.com/PnX-SI/gn_mobile_occtax#settings[la documentation] en fonction de la configuration de votre serveur GeoNature.
 
-Renseigner ensuite la table `gn_commons.t_mobile_apps` de la base de données.
+Renseigner ensuite la table `gn_commons.t_mobile_apps` directement dans la base de données ou depuis le backoffice du module "Admin" de GeoNature.
 
 Pour trouver la valeur à renseigner dans le champs `version_code`, celui-ci est mentionné dans les releases, ou reportez-vous au fichier suivant en sélectionnant le tag de version où la branche que vous utilisez :
 
@@ -80,14 +80,14 @@ Exemple de contenu de la table `gn_commons.t_mobile_apps` :
 
 [source,csv]
 ----
-1;"OCCTAX";"static/mobile/occtax/occtax-2.0.0-pne-debug.apk";"";"fr.geonature.occtax2";"2555"
+1;"OCCTAX";"occtax/occtax-2.0.0-pne-debug.apk";"";"fr.geonature.occtax2";"2555"
 ----
 
 Le résultat peut être testé en interrogeant directement la route `<URL_GEONATURE>/api/gn_commons/t_mobile_apps` qui est celle utilisée par l'application *_Occtax-mobile_* pour faire les mises à jour.
 
 Installez ensuite l'application *_Occtax-mobile_* sur le terminal mobile.
 
-Récupérer le fichier APK de la version souhaitée dans la fichiers de la release (assets)
+Récupérer le fichier APK de la version souhaitée dans les fichiers de la release (assets)
 
 Lancez l'application *_Occtax-mobile_* et déclarez l'URL de GeoNature et de TaxHub dans sa configuration (paramètres).
 

gradle/wrapper/gradle-wrapper.properties

@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip

occtax/build.gradle

@@ -7,7 +7,7 @@ plugins {
 }
 
 android {
-    compileSdkVersion 31
+    compileSdkVersion 33
 
     compileOptions {
         sourceCompatibility JavaVersion.VERSION_11
@@ -21,9 +21,9 @@ android {
     defaultConfig {
         applicationId "fr.geonature.occtax2"
         minSdkVersion 26
-        targetSdkVersion 31
-        versionCode 3170
-        versionName "2.5.0"
+        targetSdkVersion 33
+        versionCode 3200
+        versionName "2.6.0"
         buildConfigField "String", "BUILD_DATE", "\"" + new Date().getTime() + "\""
         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
         archivesBaseName = project.name + "-" + versionName
@@ -76,23 +76,27 @@ dependencies {
     kapt "com.google.dagger:hilt-android-compiler:$hilt_version"
 
     implementation 'androidx.cardview:cardview:1.0.0'
-    implementation 'androidx.constraintlayout:constraintlayout:2.1.3'
+    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
+    implementation 'androidx.lifecycle:lifecycle-livedata-ktx:2.6.1'
     implementation 'androidx.preference:preference-ktx:1.2.0'
-    implementation 'androidx.recyclerview:recyclerview:1.2.1'
-    implementation 'com.google.android.material:material:1.5.0'
+    implementation 'androidx.recyclerview:recyclerview:1.3.0'
+    implementation 'com.google.android.material:material:1.8.0'
+    implementation 'androidx.work:work-runtime-ktx:2.8.1'
     implementation "io.github.l4digital:fastscroll:2.0.1"
 
     // Logging
     implementation "org.tinylog:tinylog-api-kotlin:$tinylog_version"
     runtimeOnly "org.tinylog:tinylog-impl:$tinylog_version"
 
     // Testing dependencies
-    testImplementation 'androidx.arch.core:core-testing:2.1.0'
-    testImplementation 'androidx.test.ext:junit-ktx:1.1.3'
+    testImplementation 'androidx.arch.core:core-testing:2.2.0'
+    testImplementation 'androidx.test.ext:junit-ktx:1.1.5'
+    testImplementation 'androidx.work:work-testing:2.8.1'
     testImplementation("com.squareup.okhttp3:mockwebserver:4.10.0")
-    testImplementation 'io.mockk:mockk:1.12.3'
-    testImplementation 'io.mockk:mockk-agent-jvm:1.12.3'
+    testImplementation 'io.mockk:mockk:1.13.4'
+    testImplementation 'io.mockk:mockk-agent-jvm:1.13.4'
     testImplementation 'junit:junit:4.13.2'
-    testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-test:1.6.1'
-    testImplementation 'org.robolectric:robolectric:4.8.1'
+    testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-test:1.6.4'
+    testImplementation 'org.robolectric:robolectric:4.9.2'
+    testImplementation "org.tinylog:slf4j-tinylog:$tinylog_version"
 }