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