Edição de notebooks em aplicativos nativos compartilhados declarativos

O Declarative Native Apps pode incluir notebooks para consultar, visualizar e explorar os dados. Este tópico descreve como usar Notebook Live Editing para simplificar o desenvolvimento e os testes de notebooks em um aplicativo.

Usando o recurso Notebook Live Editing, é possível acelerar o processo de desenvolvimento editando e testando notebooks diretamente em um aplicativo. Assim, você não precisa desenvolver notebooks externamente nem recriar o pacote de aplicativo a cada alteração.

O Notebook Live Editing usa um Develoment Mode que permite alterar os notebooks «em tempo real», dentro de uma instância de aplicativo. As edições são salvas em uma versão ativa dedicada do pacote de aplicativo, permitindo testes e iterações de forma rápida e dinâmica.

Como funciona

O fluxo de trabalho usa uma versão ativa do pacote de aplicativo, que funciona como uma área restrita de desenvolvimento. Este tutorial descreve como configurar e usar o recurso Notebook Live Editing.

Etapa 1: Configuração do ambiente de desenvolvimento

Para começar, você precisa de um pacote com o seguinte:

  • Um arquivo de manifesto que define o aplicativo e seus componentes.

  • Um notebook que você pode editar e testar.

Em seguida, você cria uma instância de aplicativo a partir da versão ativa do seu pacote. A versão ativa é criada automaticamente no momento em que você cria o aplicativo.

  1. Crie o pacote.

    ALTER APPLICATION PACKAGE pkg_name BUILD;
    Copy

  2. Crie uma instância de aplicativo a partir da versão ativa. Os Notebooks neste novo aplicativo ficarão automaticamente no Development Mode, permitindo a edição em tempo real. Antes desta etapa, os notebooks no aplicativo ficam no Read-only mode.

    CREATE APPLICATION live_app_name
  FROM APPLICATION PACKAGE pkg_name
  USING VERSION LIVE;
    Copy

Etapa 2: Editação e testagem de notebooks em tempo real

Com o aplicativo live_app_name em execução, em SnowSight, abra o aplicativo na lista da sua conta e selecione um de seus notebooks. Depois de criar o aplicativo a partir do pacote de aplicativo na etapa anterior, os notebooks dos aplicativos estarão no Developer mode. Agora você pode fazer o seguinte:

  • Editar as células do notebook diretamente no navegador.

  • Executar e testar seu código imediatamente no contexto do aplicativo.

Todas as alterações feitas são salvas de forma instantânea na versão ativa do pacote de aplicativo pkg_name. Isso permite iterar as alterações no seu aplicativo rapidamente, sem precisar executar uma compilação de pacote completa a cada pequeno ajuste.

Etapa 3: Finalização e lançamento de alterações

Quando estiver satisfeito com os notebooks, você poderá promover a versão ativa para uma versão estável. Isso congela o estado atual dos notebooks e os torna parte de uma versão permanente do aplicativo. O framework do aplicativo cria automaticamente um número de versão para lançamento.

  • Lance a versão ativa para finalizar o trabalho.

ALTER APPLICATION PACKAGE pkg_name RELEASE LIVE VERSION;
Copy

Esse comando cria uma nova versão imutável do pacote de aplicativo com todas as alterações feitas no notebook. Para mais informações sobre o pacote do aplicativo e a versão ativa, consulte Pacotes de aplicativo no compartilhamento declarativo do Native Application Framework.

Linguagem: Português