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

Introduction

Shinylive vous permet d’exécuter des applications Shiny entièrement dans le navigateur en utilisant WebAssembly. Dans ce tutoriel avancé, nous explorons les techniques pour affiner votre déploiement de Shinylive en gérant les actifs, en gérant plusieurs applications et en résolvant les problèmes courants. Ces méthodes avancées vous aideront à créer des apps Shiny robustes, sans serveur, faciles à maintenir et à déployer.

1. Gestion des actifs

La gestion efficace des actifs garantit le bon fonctionnement de votre application Shinylive. Le package {shinylive} gère les actifs web (HTML, JavaScript, CSS et fichiers WASM) requis pour Shiny sans serveur.

Vérifier les informations sur les actifs

Utiliser la commande suivante pour vérifier les versions des actifs installés et les chemins de cache:

shinylive::assets_info()

Cette commande renvoie des détails tels que la version du package R de Shinylive, la version de l’actif et le répertoire de cache local.

Téléchargement et mise à jour des ressources

Pour télécharger manuellement une version spécifique des actifs (si nécessaire), exécutez:

shinylive::assets_download("0.1.5")

Remplacer « 0.1.5 » par la version désirée.

Nettoyer les anciens actifs

Au fil du temps, votre cache peut accumuler des ressources obsolètes. Les nettoyer en utilisant:

shinylive::assets_cleanup()

Ou supprimez une version spécifique:

shinylive::assets_remove("0.1.5")

Astuce

Nettoyer régulièrement les actifs peut aider à éviter les conflits et à économiser de l’espace disque.

2. Gérer des applications multiples

Si vous avez plusieurs applications Shiny, vous pouvez les exporter dans des sous-répertoires afin qu’elles partagent les mêmes actifs Shinylive. Ceci est utile pour créer un site statique centralisé pour plusieurs apps.

Exemple : Exporter plusieurs applications

Supposons que vous ayez deux applications Shiny situées dans myapp1 et myapp2. Vous pouvez les exporter comme suit:

shinylive::export("myapp1", "site", subdir = "app1")
shinylive::export("myapp2", "site", subdir = "app2")

Cette commande crée des dossiers distincts (par exemple, site/app1 et site/app2) au sein de votre site exporté, partageant les actifs Shinylive communs.

Astuce

L’organisation de plusieurs applications dans des sous-répertoires simplifie la maintenance et vous permet de gérer efficacement les actifs partagés.

3. Résolution des problèmes courants

Même avec une configuration robuste, vous pouvez rencontrer des problèmes lors du déploiement des applications Shinylive. Voici quelques étapes de dépannage courantes:

Actifs manquants ou obsolètes

• Symptôme: Votre application ne parvient pas à se charger ou affiche des erreurs apparentées à des fichiers JavaScript ou WASM manquants.
• Solution:
  • Exécuter shinylive::assets_info() pour vérifier les versions installées.
    
  • Si des ressources sont manquantes ou obsolètes, utilisez shinylive::assets_download() pour les mettre à jour.

Problèmes d’exportation

• Symptôme: Le processus d’exportation échoue ou le répertoire de sortie ne contient pas les fichiers attendus.
• Solution:
  • Assurez-vous que votre application Shiny fonctionne localement avant de l’exporter.
    
  • Vérifiez que les chemins d’accès aux répertoires dans votre commande export sont corrects.
    
  • Effectuer une reconstruction propre en utilisant quarto clean si intégré dans Quarto.

Problèmes de déploiement

• Symptôme: L’application exportée fonctionne localement mais échoue lorsqu’elle est déployée sur un service d’hébergement statique.
• Solution:
  • Vérifiez que votre service d’hébergement est correctement configuré pour servir des fichiers statiques.
    
  • Veillez à ce que tous les chemins d’accès aux actifs soient apparents et que la structure des répertoires soit maintenue pendant le déploiement.

Débogage général

• Surveiller les logs de la console:
  Ouvrez la console de développement de votre navigateur pour vérifier les messages d’erreur.
• Tester de manière incrémentale:
  Exportez et testez votre application en petites parties afin d’isoler l’origine des problèmes.
• Consulter la documentation:
  Référez-vous à la documentation officielle de Shinylive et aux forums de la communauté pour de l’aide supplémentaire.

Plus d’informations

• Introduction à Shinylive pour R
  Obtenir une vue d’ensemble de Shinylive, de ses composants et de ses avantages.
• Installer et configurer Shinylive (R)
  Apprenez à installer le package {shinylive} et à configurer la gestion des actifs.
• Créer une application Shinylive de base (R)
  Construisez et exportez votre première application Shinylive.
• Intégrer des applications Shinylive dans des documents Quarto (R)
  Apprenez à intégrer des applications Shinylive directement dans vos documents Quarto.

Conclusion

La personnalisation avancée et le dépannage sont essentiels pour maintenir des applications Shinylive robustes. En gérant soigneusement les actifs, en organisant efficacement plusieurs apps et en suivant les meilleures pratiques, vous pouvez vous assurer que vos apps Shiny sans serveur fonctionnent de manière fiable sur les services d’hébergement statique. Utilisez les conseils de dépannage pour résoudre rapidement les problèmes et consultez les ressources de lecture complémentaire pour approfondir les configurations avancées.

Explorer d’autres articles

Note

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