Abre uma pop-up para a confirmação de instalação do PWA (Progressive Web App) da aplicação. 

Figura 1 - Bloco Instalar PWA

Compatibilidade

• Bloco cliente (web / mobile): cronapi.PWA.install()

Retorno

Retorna um objeto que indica se o usuário instalou ou não o PWA. Esse objeto é atribuído a variável definida no retorno dos parâmetros de entradas de comando Retorno quando Sucesso, se o usuário instalar o PWA, e Retorno quando Cancelar, em caso contrário. 

Parâmetros

Retorno quando Sucesso

Executa uma ação caso o usuário instale o PWA.

• Posição: 1
• Inglês: Callback Success
• Tipo: Comando com retorno ("item") / Command with return ("item")
• Exemplo: uso do bloco Exibir Notificação

Retorno quando Cancelar

Executa uma ação caso o usuário escolha não instalar o PWA ou ocorra um erro.

• Posição: 2
• Inglês: Callback Cancel
• Tipo: Comando com retorno ("item") / Command with return ("item")
• Exemplo: uso do bloco Exibir Notificação 

Exemplo

Na função abaixo, o bloco Instalar PWA abre uma pop-up para instalar um PWA. Por meio do bloco imprime, será impresso no console do navegador um objeto que indica se o usuário instalou ou não o PWA. Em seguida o bloco Exibir Notificação retornará uma mensagem a depender da ação do usuário. Caso o usuário faça a instalação, o fluxo de execução é direcionado para os comandos contidos no parâmetro Retorno quando Sucesso, caso contrário, os comandos em Retorno quando Cancelar são executados.

Figura 2 - Exemplo de uso do bloco Instalar PWA

A imagem a seguir mostra o resultado de execução da função da Figura 2. Ao clicar no botão "Instalar PWA" é exibida na tela uma pop-up para instalação. Ao clicar em "Instalar" o PWA será instalado e aberto no desktop do usuário.

Figura 2.1 - Exibição da pop-up de instalação do aplicativo PWA

Após a instalação, é exibida no console do navegador as informações abaixo.

Figura 2.2 - Informações exibidas no console do navegador após instalação do aplicativo PWA