Pular para o conteúdo

O Panel Studio é o editor de aplicativos Panel dentro do PlaidCloud. Ele mostra os arquivos do aplicativo ao lado de um editor, cria uma pré-visualização privada que você pode abrir e publica o aplicativo quando você estiver pronto. Você não precisa de um repositório git para começar.

  • No quadro Início de um projeto, escolha Abrir no Studio em um aplicativo Panel.
  • Em Aplicativos, escolha Studio na linha de um aplicativo.

Para começar um novo aplicativo, escolha Novo app > Studio. Ele também fica na linha Aplicativos Studio do cartão Aplicativos e identidade visual na guia Início de um projeto. Para criar a partir de uma tabela, selecione-a na guia Tabelas do projeto e escolha Criar aplicativo Panel.

A caixa de diálogo Novo aplicativo Studio permite começar de um destes cinco pontos:

Começar de O que você recebe
Aplicativo em branco Um aplicativo mínimo com um app.py e um requirements.txt.
A partir de uma tabela Um aplicativo criado a partir da tabela que você escolher.
A partir de uma visualização O mesmo, criado a partir de uma visão do projeto.
A partir de outro aplicativo Studio Uma cópia de um dos seus aplicativos Studio.
A partir da galeria Uma cópia de um aplicativo que seu espaço de trabalho listou na galeria de aplicativos.

Dê um nome ao aplicativo, escolha o Projeto e selecione Criar. O Studio abre o novo aplicativo com os arquivos listados à esquerda. No caso de uma tabela ou de uma visão, o prompt do Weave para criar a primeira página do aplicativo já está pronto para envio. Consulte Criar um aplicativo Panel.

Um aplicativo Studio é uma pasta com o nome do aplicativo (<app-slug>/) dentro do repositório apps do seu espaço de trabalho no PlaidCloud Git, o mesmo repositório onde ficam seus outros aplicativos Panel. O Studio não cria um repositório próprio para o aplicativo, então você pode encontrar e editar o código-fonte em apps, junto com seus outros aplicativos.

  • Branch de rascunho. O trabalho que ainda não está no ar fica em um branch chamado studio-<app-slug>. Publicar copia a pasta do aplicativo desse branch para o branch principal.
  • Recompilações. Um push para apps recompila um aplicativo somente quando a pasta desse aplicativo ou o requirements.txt da raiz do repositório mudou.
  • Aplicativos existentes. Um aplicativo Studio que estava em um repositório próprio é movido para a sua pasta automaticamente. O repositório antigo é arquivado: ele permanece, somente leitura, e nunca é excluído.

Escolha um arquivo na lista para editá-lo no editor. Liste suas dependências Python em requirements.txt, um pacote por linha. Elas são instaladas quando o aplicativo é compilado.

Escolha Perguntar ao Weave para que o Weave escreva ou altere o aplicativo para você. Consulte Criar aplicativos Panel com o Weave.

Salvar somente rascunho Pré-visualização somente editor Publicar o aplicativo no ar
Suas edições só chegam aos visualizadores quando você publica.

Salvar armazena suas alterações como rascunho. O aplicativo no ar não muda, e ninguém mais vê o rascunho.

Pré-visualização cria seu rascunho salvo como uma cópia privada e a abre. Somente os editores do aplicativo podem abrir uma pré-visualização.

  • Uma pré-visualização é removida após 24 horas sem um salvamento.
  • Um espaço de trabalho pode ter até 10 pré-visualizações ao mesmo tempo.
  • Salve novamente e escolha Pré-visualização para ver suas edições mais recentes.

Publicar substitui o aplicativo no ar pelo seu rascunho salvo. Isso exige permissão de edição no projeto do aplicativo, e o Studio pede que você confirme antes.

Se outra pessoa publicou uma alteração depois que você abriu o aplicativo, o Studio informa um conflito em vez de sobrescrever o trabalho dela. Recarregue o aplicativo, traga suas edições e publique novamente.

A guia Criar mostra o status da compilação mais recente e é atualizada enquanto ela é executada. Quando uma compilação falha, a guia lista cada erro com seu arquivo e número de linha, para que você vá direto à linha. Problemas de dependência em requirements.txt vêm com uma dica sobre a correção.

Erros e avisos também são marcados nas respectivas linhas no editor, então você vê o problema onde ele está.

Para saber o que cada status significa depois que o aplicativo é publicado, consulte Usar um aplicativo Panel.

A guia Histórico lista todas as versões publicadas do aplicativo, da mais recente para a mais antiga, com o status de compilação de cada uma. Escolha Carregar mais para ver as mais antigas.

Para voltar a uma versão anterior, escolha Restaurar nela e confirme. A versão restaurada passa a ser o aplicativo no ar e é recompilada. Seu rascunho não salvo não se perde: ele continua no rascunho e entra no ar sobre a versão restaurada na próxima vez que você publicar. Se o aplicativo já corresponde a essa versão, o Studio avisa e não altera nada. Se alguém publicou enquanto você restaurava, o Studio não restaura nada e pede que você tente novamente.

A guia Insights mostra como as pessoas usam o aplicativo e a rapidez com que ele responde. Escolha os últimos 7, 14 ou 30 dias.

Seção Mostra
Visualizações por dia Quantas vezes o aplicativo foi aberto em cada dia.
Carregamento de página O tempo mediano de carregamento e o tempo que 95 por cento dos carregamentos superam, com base nos carregamentos de página do período.
Consultas mais lentas As consultas que levaram mais tempo, com a frequência com que foram executadas e seus tempos mediano, do extremo lento e mais lento.
Erros O que deu errado no período, por tipo de erro e pelo local do aplicativo em que ocorreu.

Quando um período contém mais atividade do que o Insights consegue ler, ele informa que os números são parciais. Quando os carregamentos de página ultrapassam o orçamento de desempenho do aplicativo, o Insights avisa quantos ultrapassaram e quais consultas estavam lentas. O Insights nunca mostra os dados que uma consulta retornou nem os nomes das pessoas que abriram o aplicativo.

As guias Histórico e Insights exigem que o aplicativo esteja atribuído a um projeto; um aplicativo não atribuído mostra uma solicitação para atribuí-lo.

Escolha Alertas e resumos para configurar notificações que acompanham um número nos dados do aplicativo e avisam você quando ele ultrapassa um limite, ou que enviam um resumo em um agendamento. Consulte Alertas e resumos.

Escolha Galeria… no Studio. Escolha Listar na galeria para listar o aplicativo como um modelo a partir do qual qualquer pessoa que possa ver o projeto dele pode criar seu próprio aplicativo, ou Remover da galeria para removê-lo. O botão está disponível para aplicativos que pertencem a um projeto. Você precisa de acesso de edição ao projeto. Consulte A galeria de aplicativos.

Escolha Fixar no Início para adicionar o aplicativo ao quadro Início do projeto e Desafixar do Início para removê-lo.

Excluir um aplicativo Panel pede que você confirme antes. Em Aplicativos, use o ícone de menos na linha do aplicativo. Cancelar a publicação também pede confirmação.