Personnalisation avancée et dépannage pour Shinylive (Python)

Introduction

Au fur et à mesure que vous gagnez de l’expérience avec Shinylive pour Python, vous voudrez peut-être personnaliser davantage vos applications et vous assurer qu’elles fonctionnent de manière fiable en production. Ce tutoriel aborde des sujets avancés tels que la gestion des actifs Web, la gestion de plusieurs applications Shiny au sein d’un même déploiement et le dépannage des problèmes courants rencontrés lors de l’exécution d’applications Shinylive.

1. Gestion des actifs

Une gestion efficace des actifs est cruciale pour une bonne performance. Le package Python shinylive télécharge et met en cache les actifs web nécessaires (HTML, JavaScript, CSS et WASM) pour votre application.

Vérifier les informations sur les actifs

Exécutez la commande suivante dans votre terminal pour afficher les détails de l’actif:

shinylive extension info

Ceci affiche la version du package shinylive, la version de l’actif et le répertoire de cache.

Mise à jour et nettoyage des actifs

• Télécharger/mettre à jour les actifs:
  Si vous avez besoin des dernières ressources web, mettez-les à jour avec:

  shinylive extension language-resources

• Nettoyer les anciens actifs:
  Pour libérer de l’espace et éviter les conflits de version, nettoyer les actifs obsolètes:

  shinylive extension clean

Astuce

Vérifiez et mettez à jour régulièrement vos ressources pour maintenir la compatibilité avec votre application.

2. Gérer des applications multiples

Lorsque vous gérez plus d’une application Shiny, vous pouvez exporter chacune d’entre elles dans des sous-répertoires distincts afin de partager des ressources web communes. Cette approche permet de rationaliser la maintenance et le déploiement.

Exemple : Exporter plusieurs applications

Supposons que vous ayez deux applications Python Shiny dans les répertoires myapp1 et myapp2. Les exporter en utilisant:

shinylive export myapp1 site --subdir app1
shinylive export myapp2 site --subdir app2

Cette commande crée un dossier site/ avec les sous-répertoires app1 et app2, chacun contenant ses fichiers statiques respectifs tout en partageant des actifs communs.

3. Résolution des problèmes courants

Même avec une configuration minutieuse, des problèmes peuvent survenir. Voici quelques étapes de dépannage courantes:

Problèmes liés aux actifs

• Symptôme: L’application ne parvient pas à se charger ou signale des actifs manquants.
• Solution:
  • Vérifier les versions des actifs en utilisant shinylive extension info.
  • Mettez à jour les actifs si nécessaire en utilisant les commandes de mise à jour.
  • S’assurer que les autorisations de votre réseau ou de vos fichiers permettent le téléchargement des ressources.

Erreurs d’exportation

• **Symptôme : Le processus d’exportation échoue ou produit un résultat incomplet.
• Solution:
  • Confirmer que votre application Shiny pour Python fonctionne correctement dans votre environnement de développement.
  • Vérifier deux fois les chemins d’accès aux fichiers et les autorisations d’accès aux répertoires.
  • Exécuter une exportation propre en supprimant les répertoires de résultats précédents avant d’exporter à nouveau.

Problèmes de déploiement

• Symptôme: L’application fonctionne localement mais pas lorsqu’elle est déployée sur un hébergement statique (par exemple, GitHub Pages).
• Solution:
  • Assurez-vous que votre service d’hébergement est correctement configuré pour servir des fichiers statiques à partir de votre répertoire site/.
  • Vérifiez que les chemins d’accès aux ressources restent apparents après le déploiement.
  • Tester le site déployé en utilisant un serveur statique local (par exemple, python3 -m http.server --directory site --bind localhost 8008).

Plus d’informations

• Introduction à Shinylive pour Python
  Un aperçu de Shinylive pour Python et de ses avantages.
• Installer et configurer Shinylive pour Python
  Apprenez à installer le package Python shinylive et à configurer la gestion des ressources.
• Créer une application Shinylive Python de base
  Instructions étape par étape pour construire et exporter votre première application Shinylive Python.
• Embedding Shinylive Python Apps in Quarto Documents
  Découvrez comment intégrer vos applications Shinylive directement dans les documents Quarto.

Conclusion

La personnalisation avancée et le dépannage sont essentiels pour garantir que vos applications Shinylive Python fonctionnent de manière fiable dans un environnement sans serveur. En gérant efficacement les actifs, en organisant correctement plusieurs applications et en suivant les meilleures pratiques, vous pouvez optimiser vos apps Shiny interactives pour un fonctionnement fluide sur les plateformes d’hébergement statique.

Explorer d’autres articles

Note

Voici d’autres articles de la même catégorie pour vous aider à approfondir le sujet.