Personalização avançada e solução de problemas para Shinylive (R)

Introdução

Shinylive permite que você execute aplicativos Shiny inteiramente no navegador usando WebAssembly. Neste tutorial avançado, exploramos técnicas para ajustar sua implantação do Shinylive gerenciando ativos, lidando com vários aplicativos e solucionando problemas comuns. Esses métodos avançados ajudarão você a criar aplicativos Shiny robustos e sem servidor, fáceis de manter e implantar.

1. Gerenciamento de ativos

O gerenciamento eficiente de ativos garante que seu aplicativo Shinylive funcione perfeitamente. O pacote {shinylive} lida com os ativos da web (arquivos HTML, JavaScript, CSS e WASM) necessários para o Shiny sem servidor.

Verificar informações sobre ativos

Use o comando a seguir para verificar as versões dos recursos instalados e os caminhos do cache:

shinylive::assets_info()

Este comando retorna detalhes como a versão do pacote R Shinylive, a versão do recurso e o diretório de cache local.

Baixando e atualizando recursos

Para baixar manualmente uma versão específica dos ativos (se necessário), execute:

shinylive::assets_download("0.1.5")

Substitua '0.1.5' pela versão desejada.

Limpar ativos antigos

Com o tempo, seu cache pode acumular ativos desatualizados. Limpe-os usando:

shinylive::assets_cleanup()

Ou remova uma versão específica:

shinylive::assets_remove("0.1.5")

Dica

Limpar regularmente os ativos pode ajudar a evitar conflitos e economizar espaço em disco.

2. Lidando com vários aplicativos

Se você tiver vários aplicativos Shiny, poderá exportá-los para subdiretórios para que compartilhem os mesmos recursos Shinylive. Isso é útil para criar um site estático centralizado para vários aplicativos.

Exemplo: exportando vários aplicativos

Suponha que você tenha dois aplicativos Shiny localizados em myapp1 e myapp2. Você pode exportá-los da seguinte maneira:

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

Este comando cria pastas separadas (por exemplo, site/app1 e site/app2) dentro do site exportado, compartilhando os recursos comuns Shinylive.

Dica

Organizar vários aplicativos em subdiretórios simplifica a manutenção e permite gerenciar ativos compartilhados com eficiência.

3. Solução de problemas comuns

Mesmo com uma configuração robusta, você pode encontrar problemas ao implantar aplicativos Shinylive. Aqui estão algumas etapas comuns de solução de problemas:

Ativos ausentes ou desatualizados

• Sintoma: Seu aplicativo não carrega ou exibe erros relacionados a arquivos JavaScript ou WASM ausentes.
• Solução:
  • Execute shinylive::assets_info() para verificar as versões instaladas.
    
  • Se houver ativos ausentes ou desatualizados, use shinylive::assets_download() para atualizá-los.

Problemas de exportação

• Sintoma: O processo de exportação falha ou o diretório de saída não contém os arquivos esperados.
• Solução:
  • Certifique-se de que seu aplicativo Shiny está funcionando localmente antes de exportar.
    
  • Verifique se os caminhos do diretório no seu comando de exportação estão corretos.
    
  • Execute uma reconstrução limpa usando quarto clean se integrado ao Quarto.

Problemas de implantação

• Sintoma: O aplicativo exportado funciona localmente, mas falha quando implantado em um serviço de hospedagem estática.
• Solução:
  • Verifique se o seu serviço de hospedagem está configurado corretamente para servir arquivos estáticos.
    
  • Certifique-se de que todos os caminhos dos ativos sejam relativos e que a estrutura do diretório seja mantida durante a implantação.

Depuração geral

• Monitorar os registros do console:
  Abra o console do desenvolvedor do seu navegador para verificar se há mensagens de erro.
• Teste incrementalmente:
  Exporte e teste seu aplicativo em pequenas partes para isolar onde ocorrem os problemas.
• Consulte a documentação:
  Consulte a documentação oficial do Shinylive e os fóruns da comunidade para obter ajuda adicional.

Leitura adicional

• Introdução ao Shinylive para R
  Obtenha uma visão geral do Shinylive, seus componentes e seus benefícios.
• Instalando e configurando Shinylive (R)
  Aprenda a instalar o pacote {shinylive} e configurar o gerenciamento de recursos.
• Criando um aplicativo Shinylive básico (R)
  Crie e exporte seu primeiro aplicativo Shinylive.
• Incorporando aplicativos Shinylive em documentos Quarto (R)
  Aprenda a integrar aplicativos Shinylive diretamente em seus documentos Quarto.

Conclusão

A personalização avançada e o troubleshooting são essenciais para manter aplicativos Shinylive robustos. Ao gerenciar ativos com cuidado, organizar vários aplicativos de maneira eficaz e seguir as práticas recomendadas, você pode garantir que seus aplicativos Shiny sem servidor tenham um desempenho confiável em serviços de hospedagem estática. Use as dicas de solução de problemas para resolver questões rapidamente e consulte os recursos de leitura adicional para obter insights mais aprofundados sobre configurações avançadas.

Explore mais artigos

Nota

Aqui estão mais artigos da mesma categoria para ajudá-lo a se aprofundar no tópico.