Criando um aplicativo básico Shinylive (R)

Introdução

Shinylive permite que você execute aplicativos Shiny inteiramente no navegador usando WebAssembly. Neste tutorial, você criará um aplicativo Shiny simples e, em seguida, exportá-lo-á como um aplicativo Shinylive. Essa abordagem sem servidor permite que você compartilhe aplicativos Shiny interativos em plataformas de hospedagem estática, como GitHub Pages.

1. Criando seu aplicativo Shiny

Copie e cole o código a seguir no arquivo app.r para criar um aplicativo Shiny básico. O código cria um aplicativo Shiny simples com um controle deslizante e um histograma:

library(shiny)
library(bslib)

# Defina a interface do usuário usando um layout de barra lateral.
ui <- page_sidebar(
  title = "Hello Shiny!",
  sidebar = sidebar(
    sliderInput("bins", "Number of bins:", min = 5, max = 30, value = 10)
  ),
  plotOutput("distPlot")
)

# Defina a lógica do servidor para gerar um histograma.
server <- function(input, output) {
  output$distPlot <- renderPlot({
    x <- mtcars$mpg
    bins <- seq(min(x), max(x), length.out = input$bins + 1)
    hist(x, breaks = bins, col = "#75AADB", border = "white",
         main = "Histogram of MPG", xlab = "Miles Per Gallon")
  })
}

# Crie e execute o aplicativo Shiny.
shinyApp(ui = ui, server = server)

Nota

Você pode testar este aplicativo localmente no RStudio executando o código.

2. Exportando seu aplicativo Shiny com Shinylive

Quando seu aplicativo Shiny estiver funcionando, use o pacote {shinylive} para exportá-lo como um aplicativo estático e sem servidor.

Processo de exportação passo a passo

1. Prepare o diretório do seu aplicativo:
   Salve os arquivos do seu aplicativo Shiny (por exemplo, app.R) em um diretório. Por exemplo, crie uma pasta chamada myapp.

2. Exportar o aplicativo:
   Use a função shinylive::export() para converter seu aplicativo Shiny em arquivos estáticos que são executados no navegador. Por exemplo:

   # Substitua `myapp` pelo caminho para o diretório do seu aplicativo.
   # Substitua `site` pelo diretório de destino dos arquivos exportados.
   shinylive::export("myapp", "site")

   Este comando cria uma nova pasta (site/) contendo os arquivos HTML, JavaScript, CSS e WASM necessários para executar seu aplicativo como um site estático.

3. Visualize seu aplicativo exportado:
   Você pode usar httpuv::runStaticServer() para servir o aplicativo exportado localmente:

   library(httpuv)
   httpuv::runStaticServer("site/")

   Abra o navegador e navegue até a URL fornecida pelo comando para ver seu aplicativo Shinylive em execução.

3. Implantação em serviços de hospedagem estática

Depois de verificar se o aplicativo exportado funciona localmente, implante o conteúdo da pasta site/ em um serviço de hospedagem estática.

Aqui estão as etapas gerais para implantar seu aplicativo Shinylive no GitHub Pages:

1. Criar um repositório:
   Inicialize um repositório GitHub e adicione a pasta site/ a ele.

2. Configurar páginas do GitHub:
   Nas configurações do seu repositório, habilite o GitHub Pages e selecione o branch/pasta que contém seu aplicativo exportado (por exemplo, a raiz do repositório ou uma pasta docs/).

3. Enviar e publicar:
   Confirmar e enviar suas alterações. Seu aplicativo deve estar acessível através da URL do GitHub Pages fornecida nas configurações do repositório.

4. Acessar seu aplicativo:
   Depois que o GitHub Pages estiver habilitado, seu aplicativo estará acessível por meio de uma URL como https://yourusername.github.io/your-repo/.

Nota

Outras opções de hospedagem estática, como Netlify, seguem etapas semelhantes: basta fazer upload do conteúdo da pasta site/ e configurar as definições de implantação.

4. Dicas para uma exportação bem-sucedida

• Verificar versões de ativos:
  Use shinylive::assets_info() para verificar se os recursos da web corretos estão instalados e armazenados em cache.

• Atualize os pacotes, se necessário:
  Se você encontrar problemas com as versões dos ativos, tente executar shinylive::assets_download() para atualizar seus ativos.

• Limpar ativos antigos:
  Periodicamente, execute shinylive::assets_cleanup() para remover versões desatualizadas de ativos do seu cache.

4. 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

Seguindo este tutorial, você aprendeu a criar um aplicativo Shiny simples e exportá-lo como um aplicativo Shinylive, transformando seu código Shiny em uma experiência interativa sem servidor e baseada em navegador. Com essas ferramentas, você pode compartilhar facilmente seus aplicativos Shiny em plataformas de hospedagem estática, expandindo o alcance do seu conteúdo R interativo.

Explore mais artigos

Nota

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