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

Introdução

À medida que você ganha experiência com o Shinylive para Python, você pode querer personalizar ainda mais seus aplicativos e garantir que eles sejam executados de maneira confiável em produção. Este tutorial aborda tópicos avançados, como gerenciamento de ativos da web, tratamento de vários aplicativos Shiny em uma única implantação e solução de problemas comuns encontrados ao executar aplicativos Shinylive.

1. Gerenciamento de ativos

O gerenciamento eficiente de ativos é crucial para um desempenho tranquilo. O pacote Python shinylive baixa e armazena em cache os recursos da web necessários (HTML, JavaScript, CSS e WASM) para seu aplicativo.

Verificar informações sobre ativos

Execute o seguinte comando no seu terminal para ver os detalhes do recurso:

shinylive extension info

Isso exibe a versão do pacote shinylive, a versão do recurso e o diretório de cache.

Atualizar e limpar ativos

• Baixar/atualizar ativos:
  Se você precisar dos ativos da web mais recentes, atualize-os com:

  shinylive extension language-resources

• Limpar ativos antigos:
  Para liberar espaço e evitar conflitos de versão, limpe os ativos desatualizados:

  shinylive extension clean

Dica

Verifique e atualize regularmente seus ativos para manter a compatibilidade com seu aplicativo.

2. Lidando com vários aplicativos

Ao gerenciar mais de um aplicativo Shiny, você pode exportar cada um para subdiretórios separados para compartilhar recursos da web comuns. Essa abordagem simplifica a manutenção e a implantação.

Exemplo: exportando vários aplicativos

Suponha que você tenha dois aplicativos Python Shiny nos diretórios myapp1 e myapp2. Exportá-los usando:

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

Este comando cria uma pasta site/ com os subdiretórios app1 e app2, cada um contendo seus respectivos arquivos estáticos, enquanto compartilha ativos comuns.

3. Solução de problemas comuns

Mesmo com uma configuração cuidadosa, podem surgir problemas. Aqui estão algumas etapas comuns de solução de problemas:

Problemas com ativos

• Sintoma: O aplicativo não carrega ou relata ativos ausentes.
• Solução:
  • Verifique as versões dos ativos usando shinylive extension info.
  • Atualize os ativos, se necessário, usando os comandos de atualização.
  • Certifique-se de que sua rede ou permissões de arquivo permitem downloads de ativos.

Erros de exportação

• Sintoma: O processo de exportação falha ou produz uma saída incompleta.
• Solução:
  • Confirme se o seu aplicativo Shiny para Python funciona corretamente no seu ambiente de desenvolvimento.
  • Verifique novamente os caminhos dos arquivos e as permissões do diretório.
  • Execute uma exportação limpa removendo os diretórios de saída anteriores antes de exportar novamente.

Problemas de implantação

• Sintoma: O aplicativo funciona localmente, mas não quando implantado em hospedagem estática (por exemplo, GitHub Pages).
• Solução:
  • Certifique-se de que seu serviço de hospedagem esteja configurado corretamente para servir arquivos estáticos do seu diretório site/.
  • Verifique se os caminhos dos ativos permanecem relativos após a implantação.
  • Teste o site implantado usando um servidor estático local (por exemplo, python3 -m http.server --directory site --bind localhost 8008).

Leitura adicional

• Introdução ao Shinylive para Python
  Uma visão geral do Shinylive para Python e seus benefícios.
• Instalando e configurando Shinylive para Python
  Aprenda a instalar o pacote Python shinylive e configurar o gerenciamento de ativos.
• Criando um aplicativo Python Shinylive básico
  Instruções passo a passo para criar e exportar seu primeiro aplicativo Python Shinylive.
• Incorporando aplicativos Python Shinylive em documentos Quarto
  Descubra como incorporar seus aplicativos Shinylive diretamente em documentos Quarto.

Conclusão

A personalização avançada e o troubleshooting são essenciais para garantir que seus aplicativos Python Shinylive tenham um desempenho confiável em um ambiente sem servidor. Ao gerenciar ativos de maneira eficaz, organizar vários aplicativos corretamente e seguir as práticas recomendadas, você pode otimizar seus aplicativos Shiny interativos para uma operação tranquila em plataformas de hospedagem estáticas.

Explore mais artigos

Nota

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