MO-07 · Publier une version

Livrer une nouvelle version de Docora à tous les postes, par les mises à jour en ligne, et l'annoncer sur ce site.

Les règles de numérotation et le rôle du manifeste sont expliqués dans Versionnage et publication.

Étapes

1. Choisir le numéro

   Correctif, mineure ou majeure ? Incrémentez la ligne version: du fichier pubspec.yaml de l'application, par exemple version: 1.4.3.

2. Vérifier le fichier .env

   Le .env est embarqué dans l'installateur. Il doit contenir la bonne adresse de serveur et DOCORA_UPDATE_URL — voir Configuration.

3. Fabriquer l'installateur Windows

   Sur le poste Windows, depuis le dossier de l'application :

   powershell -ExecutionPolicy Bypass -File installer/windows/build.ps1
   

   Résultat : installer/dist/Docora-1.4.3-windows-x64.exe.

4. Fabriquer la version macOS (si publiée)

   Sur un Mac, depuis le même dossier :

   ./installer/macos/build.sh
   

   Résultat : Docora-1.4.3-macos.dmg (première installation) et Docora-1.4.3-macos.zip (mise à jour). Copiez-les dans installer/dist/ du poste Windows.

5. Essayer la version

   Installez-la sur un poste de test par-dessus la version précédente et vérifiez qu'elle démarre, se connecte et exporte un PDF.

6. Générer le manifeste et l'historique

   Rédigez les notes de la version : elles s'affichent dans l'application et sur ce site.

   dart run tool/generer_manifeste_maj.dart --base https://<projet>.supabase.co/storage/v1/object/public/mises-a-jour --titre "Titre de la version" --resume "Ce que la version change, en une phrase." --nouveaute "Une nouveauté" --amelioration "Une amélioration" --correction "Une correction"
   

   Chaque option --nouveaute, --amelioration et --correction se répète autant que nécessaire. Ajoutez --obligatoire si la version doit s'imposer, ou --minimale 1.2.0 pour ne l'imposer qu'aux versions plus anciennes. Le script refuse le texte d'exemple « Ce qui change ».

   Il écrit dans installer/dist/ :

   • maj.json, le manifeste lu par les postes ;
   • historique.json, l'historique en ligne complété de cette version.
7. Publier

   Dans l'hébergement (Supabase → Storage → mises-a-jour), déposez dans cet ordre :

   1. le ou les paquets (.exe, .zip) ;
   2. historique.json ;
   3. maj.json, en dernier.

   Ouvrez l'adresse du manifeste dans un navigateur pour vérifier qu'il annonce la nouvelle version.

8. Le site se met à jour seul

   Rien à faire : les pages Accueil, Télécharger et Nouveautés, le flux RSS et le plan du site relisent les fichiers publiés et affichent la nouvelle version dans les cinq minutes. La page de la version renvoie d'elle-même vers la documentation concernée par ses notes.

   Pour un affichage immédiat :

   curl -X POST "https://<site>/api/revalider?cle=<REVALIDATION_SECRET>"
   

9. Archiver

   Copiez les paquets, maj.json et historique.json dans un dossier daté (livraisons/2026-11-02_1.4.3/).

Points de contrôle

• Le numéro du manifeste est celui de pubspec.yaml.
• L'empreinte SHA-256 affichée sur la page Télécharger correspond au fichier publié.
• Un poste de test resté sur la version précédente affiche le bandeau de mise à jour au redémarrage, et l'installation aboutit.
• La version figure dans Nouveautés.

Résultat attendu

Les postes se voient proposer la nouvelle version au démarrage suivant ; la page de téléchargement et l'historique du site l'annoncent.