mymuseum-visitapp/lib/Components/loading_common.dart
Thomas Fransolet 6709726208 Splash, loader et mode hors ligne : ce qui etait invisible le reste
Le fil rouge de ces corrections : des replis silencieux. Une exception
rattrapee, une image absente, un fichier local jamais rattache — rien ne
plantait, mais rien ne marchait non plus, et aucun message ne le disait.

Splash et loader
- assets/splash et assets/loader ne contenaient que des PNG 1x1
  transparents. errorBuilder ne se declenche pas : le fichier est valide,
  juste vide. Logo et loader etaient donc invisibles PARTOUT, splash comme
  ecrans de chargement. assets/loader est supprime, kLoaderAsset avec.
- Le splash natif etait blanc (launch_background en @android:color/white,
  theme Light) puis l'app basculait en sombre. Fond unifie sur #111111,
  cote natif comme Dart, avec values-v31 : Android 12+ ignore
  windowBackground et repart sur le theme sans ces attributs.
- Le loader et l'image principale viennent maintenant du manager
  (Applications -> Mobile). InstanceImages les garde sur le device : le
  splash s'affiche avant tout appel API, il ne peut lire qu'un cache.
  Alimente au boot depuis instanceGetDetail, qui porte deja les
  ApplicationInstances — aucun appel supplementaire.
- Ouvrir une section montrait une page blanche avec un loader au milieu.
  SlideFromRightRoute devient non opaque et SectionPage garde un fond
  transparent tant que la section n'est pas prete : le visiteur garde sous
  les yeux l'ecran d'ou il vient.

Hors ligne
- L'audio d'un article ne repartait jamais du MP3 local : audioFile
  n'etait jamais renseigne, le lecteur retombait toujours sur l'URL.
- L'image de titre d'un article passait par NetworkImage, donc une croix
  rouge des que le reseau manque, alors que le fichier est sur le device.
- L'accueil ne gardait en base que order/gridSpan : une visite jamais
  telechargee disparaissait de la grille hors ligne. La visite entiere est
  desormais mise en cache, et une visite injoignable reste affichee,
  ternie et non ouvrable, plutot qu'absente.
- L'etat reseau datait du premier chargement et n'etait jamais remesure.
  WidgetsBindingObserver etait declare mais jamais enregistre : aucun
  rappel n'arrivait. L'accueil se recharge au retour dans l'app et
  remesure avant de refuser l'ouverture d'une visite.

Divers
- Le futur de getSectionDetail etait construit dans future:, donc relance
  a chaque rebuild — chaque rotation d'ecran refaisait l'appel reseau.
- ImageCustomProvider listait le repertoire d'une visite non telechargee :
  exception a chaque construction de chaque image, pour finir de toute
  facon sur le reseau.
- Scanner un QR d'une autre visite empilait les ConfigurationPage.
  pushAndRemoveUntil : une visite est une destination de premier niveau.
- Le scanner arrive sur l'accueil, en pastille de verre comme les autres
  actions de cet ecran. ScannerBouton prend size et transparent, et garde
  son apparence d'origine ailleurs.
- Le titre d'un article n'etait pas centre : customStylesBuilder ne
  s'applique qu'aux elements, et un titre sans balise n'en a aucun.
- Le lecteur audio replie ne lancait pas la lecture au premier appui, il
  ouvrait le panneau. Il lit, puis ouvre. En lecture auto il reste replie.
- Le dialogue de telechargement faisait la hauteur de l'ecran : un Center
  prend toute la hauteur maximale que lui donne un AlertDialog.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-09 16:47:27 +02:00

137 lines
4.6 KiB
Dart

import 'dart:io';
import 'package:cached_network_image/cached_network_image.dart';
import 'package:flutter/material.dart';
import 'package:mymuseum_visitapp/Helpers/instanceImages.dart';
import 'package:mymuseum_visitapp/Models/visitContext.dart';
import 'package:mymuseum_visitapp/app_context.dart';
import 'package:mymuseum_visitapp/constants.dart';
import 'package:provider/provider.dart';
/// Le loader lui-même, sans rien savoir du contexte : le splash s'affiche avant
/// que le `Provider` n'existe et ne peut donc pas passer par `LoadingCommon`.
///
/// L'image vient du manager (Applications → Mobile). Tant qu'elle n'est pas
/// connue, on tourne sur l'indicateur natif plutôt que sur `assets/loader/`, qui
/// ne contient que des PNG 1x1 transparents — invisibles, et `errorBuilder` ne
/// se déclenche pas puisque le fichier est valide.
class RotatingLoader extends StatefulWidget {
const RotatingLoader({Key? key, this.file, this.imageUrl, this.size, this.color})
: super(key: key);
final File? file;
final String? imageUrl;
final double? size;
final Color? color;
@override
State<RotatingLoader> createState() => _RotatingLoaderState();
}
class _RotatingLoaderState extends State<RotatingLoader>
with SingleTickerProviderStateMixin {
late final AnimationController _controller = AnimationController(
duration: const Duration(seconds: 3),
vsync: this,
)..repeat();
@override
void dispose() {
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
final size = widget.size ?? MediaQuery.of(context).size.height * 0.1;
final color = widget.color ?? kMainColor1;
Widget? image;
if (widget.file != null) {
image = Image.file(widget.file!, width: size, height: size, fit: BoxFit.contain);
} else if (widget.imageUrl != null) {
image = CachedNetworkImage(
imageUrl: widget.imageUrl!,
width: size,
height: size,
fit: BoxFit.contain,
progressIndicatorBuilder: (context, url, progress) =>
CircularProgressIndicator(value: progress.progress, color: color),
errorWidget: (context, url, error) => CircularProgressIndicator(color: color),
);
}
if (image == null) {
return SizedBox(
width: size,
height: size,
child: Center(child: CircularProgressIndicator(color: color)),
);
}
return SizedBox(
width: size,
height: size,
child: RotationTransition(turns: _controller, child: image),
);
}
}
/// Loader des écrans de l'app. Ordre de préférence, celui de `visitapp-web` :
/// l'image de la visite si elle en définit une, sinon celle de l'instance mise
/// en cache au démarrage.
class LoadingCommon extends StatelessWidget {
const LoadingCommon({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
final appContext = Provider.of<AppContext>(context);
final VisitAppContext visitAppContext = appContext.getContext();
final configuration = visitAppContext.configuration;
final primaryColor = configuration?.primaryColor != null
? Color(int.parse(
configuration!.primaryColor!.split('(0x')[1].split(')')[0],
radix: 16))
: kMainColor1;
return Center(
child: FutureBuilder<void>(
future: InstanceImages.restore(),
builder: (context, _) {
final localConfigLoader = configuration?.loaderImageId != null
? _localResource(visitAppContext, configuration!.loaderImageId!)
: null;
return RotatingLoader(
file: localConfigLoader ?? InstanceImages.loader,
imageUrl: localConfigLoader == null ? configuration?.loaderImageUrl : null,
color: primaryColor,
);
},
),
);
}
}
/// Fichier déjà téléchargé pour la visite en cours, s'il existe. Lecture
/// synchrone : le répertoire est local et l'écran de chargement ne peut pas se
/// permettre une frame vide pour aller le vérifier.
File? _localResource(VisitAppContext visitAppContext, String resourceId) {
try {
if (visitAppContext.localPath == null || visitAppContext.configuration?.id == null) {
return null;
}
final directory =
Directory('${visitAppContext.localPath}/${visitAppContext.configuration!.id}');
if (!directory.existsSync()) return null;
for (final entity in directory.listSync()) {
if (entity.uri.pathSegments.last.contains(resourceId)) return File(entity.path);
}
} catch (e) {
debugPrint('[loader] ressource locale illisible : $e');
}
return null;
}