Início rápido do módulo Mendix

Comece a usar o módulo Pushwoosh para Mendix executando o aplicativo de demonstração que acompanha o módulo e enviando uma notificação push para ele.

Pré-requisitos

Para executar o aplicativo de demonstração, você precisará do seguinte:

Requisitos

• Uma conta Pushwoosh.
• Um projeto Pushwoosh configurado na sua conta.
• Para integração com iOS:
  • Uma plataforma iOS configurada para enviar notificações push. Recomendamos usar a configuração de Autenticação Baseada em Token como a abordagem mais simples.
  • Durante a configuração, defina o Gateway como Sandbox para enviar pushes para um simulador.
• Para integração com Android:
  • Uma plataforma Android configurada
  • O arquivo google-services.json e o package name do seu projeto Firebase.
  • Um projeto Firebase conectado ao seu aplicativo Android. Siga o guia de configuração do Firebase se necessário.
• O seu Pushwoosh Application Code e o Token da API de Dispositivo Pushwoosh do Painel de Controle da Pushwoosh para o seu aplicativo.

Você também precisará do Mendix Studio Pro 11.12.3 ou mais recente com um perfil de navegação móvel nativo, e do Xcode ou Android Studio para produzir a compilação nativa.

O Token de API do Dispositivo na lista acima não é necessário para este módulo. O widget utiliza apenas o Código da Aplicação.

Baixe o aplicativo de demonstração

Clone o repositório do módulo:

git clone https://github.com/Pushwoosh/pushwoosh-mendix.git

O aplicativo de demonstração está na pasta demo. É o mesmo aplicativo contra o qual o módulo é desenvolvido: uma tela com botões para registrar e cancelar o registro do dispositivo, ler o token push, definir e ler tags e postar um evento, além de campos de entrada para a chave e o valor da tag e para o nome do evento.

Abra o aplicativo no Studio Pro

Abra demo/PushwooshDemo.mpr no Studio Pro. O aplicativo já contém o módulo Pushwoosh, o widget Pushwoosh events na página inicial e um nanoflow por trás de cada botão.

Defina seu Código da Aplicação

Abra a página inicial do perfil de navegação móvel nativo, selecione o widget Pushwoosh events e substitua o placeholder XXXXX-XXXXX na propriedade Application Code pelo Código da Aplicação do seu aplicativo no Painel de Controle do Pushwoosh.

Compile o aplicativo nativo

A demonstração não pode ser executada no aplicativo Make It Native, porque esse aplicativo não contém código nativo de terceiros. Em vez disso, produza um aplicativo de desenvolvedor personalizado ou uma compilação nativa real.

No Windows, use App > Build Native App para abrir o Native Mobile Builder e defina as capacidades da seguinte forma:

• Push notifications: desativado.
• Firebase Android: ativado.

O Pushwoosh substitui o push integrado de um aplicativo Mendix em vez de funcionar ao lado dele. Dois serviços de notificação registrados para o mesmo evento do Firebase se sobrepõem e as notificações param de chegar.

No macOS, o Studio Pro não possui o Native Mobile Builder. Em vez disso, configure o template nativo com a ferramenta de linha de comando @mendix/native-mobile-toolkit e, em seguida, compile localmente os projetos iOS e Android gerados.

Para iOS, abra o projeto Xcode gerado e adicione a capacidade Push Notifications em Signing & Capabilities. Para Android, coloque o arquivo google-services.json do seu projeto Firebase no projeto Android gerado.

Execute o aplicativo e registre o dispositivo

Inicie o tempo de execução do Mendix para o aplicativo, em seguida, inicie a compilação nativa em um dispositivo ou simulador e toque em Register For Push Notifications. O dispositivo solicitará permissão para notificações, se registrará no Pushwoosh e exibirá o token push em uma mensagem.

Envie uma notificação push de teste

Registre o dispositivo como um dispositivo de teste e envie uma mensagem para ele a partir do Painel de Controle do Pushwoosh. Consulte Teste sua integração para ver os passos.

Próximos passos

• Guia de integração básica - adicione o módulo ao seu próprio aplicativo
• Referência de ações do módulo - as propriedades do widget e as ações JavaScript