Notificações Push
OBJETIVOS
Integrate push notifications to your 4d for iOS apps
PRÉ-REQUISITOS
O componente4D Mobile App Server, que permite empurrar notificações (push), está integrado no 4D monousuário e no 4D Server.
O que é uma notificação push?
On a mobile phone, a push notification is an alert message received via an application, that you can open, delete, allow or block. It can be very useful to notify your app users that a new version is available, for example.
But what about the architecture that needs to be implemented, in order to integrate this functionality into a mobile application? And what is the process of a push notification, from creation to display, on the user's mobile?
Arquitetura técnica
Esses são os elementos diferentes necessários para criar, enviar e receber uma notificação push móvel:
Pré-requisitos
To send push notifications, an AuthKey_XXXYYY.p8 authentication file from Apple is required.
Primeiro vá para a página da conta de desenvolvedor Apple, inicie a sessão, e selecione Certificates, IDs & Profiles.
Então poderá gerar seus certificados push e baixá-los
Finally, activate the Push notification feature to integrate your certificate in your 4D for iOS project from the Publishing section.
Puede encontrar mais informação sobre este processo aqui na documentação de componente.
Exemplo básico para gerenciar suas notificações push
Este é um exemplo para enviar uma notificação push a test@4d.com:
$pushNotification:=MobileAppServer.PushNotification.new()
$notification:=New object
$notification.title:="This is title"
$notification.body:="Here is the content of this notification"
$response:=$pushNotification.send($notification;"test@4d.com")
It couldn't be any easier!
Empurrar notificações co sincronização de dados
Com uma notificação push, pode lançar uma sincronização para atualizar seus dados.
Por exemplo se sua aplicação tiver uma opção de acompanhamento de entrega, a informação de entrega será atualizada no banco de dados graças à notificação enviada ao cliente. Esta notificação, contendo uma petição para sincronizar os dados, vai permitir ao cliente modificar os dados no seu smartphone.
Para fazer isso no componente 4D Mobile App Server, precisa especificar se vai ou não forçar a sincronização de dados em suas notificações push/empurrar. Para isso, simplesmente forneça o valor booleano dataSynchro no objeto userInfo.
Sincronização de dados com uma notificação e abertura de registro
Como padrão normal, uma notificação de abertura de registro automaticamente ativa a sincronização de dados.
Por exemplo, em um app Contact, se uma informação específica de contato (ou seja. um registro do contato, tal como endereço ou número de telefone) for modificado, o usuário recebe uma notificação que automaticamente abre o registro relevante e sincroniza os dados contidos no registro. Quando o usuário abrir a notificação, a informação de contato é totalmente atualizada.
Aqui um exemplo do comportamento normal, uma petição dataSynchro com o método open():
Note que exclusivamente para o método open(), esse é o comportamento padrão. Como resultado, se não especificar o valor booleano dataSynchro seu valor por padrão será true.
$pushNotification:=MobileAppServer.PushNotification.new()
$notification:=New object
$notification.title:="Este é o título"
$notification.body:="Aqui está o conteúdo da notificação"
$entity:=ds.Employees.get("456456")
$response:=$pushNotification.open($entity; $notification; $recipients)
Entretanto pode escolher não forçar uma sincronização de dados, para prevenir dataSynchro:
$pushNotification:=MobileAppServer.PushNotification.new()
$notification:=New object
$notification.title:="Este é o título"
$notification.body:="Este é o conteúdo desta notificação"
$notification.userInfo:=New object("dataSynchro"; False)
$entity:=ds.Employees.get("456456")
$response:=$pushNotification.open($entity; $notification; $recipients)
Sincronização de dados com uma notificação simples
Também pode se pedir uma sincronização para uma notificação simples, sem abrir um registro específico. Por exemplo, algumas novas entradas foram adicionadas. Pode informar então a seu usuário e atualizar os dados sem manipulação do seu lado.
Aqui está um exemplo de código que pode usar com outros métodos, desde que preencha o objeto userInfo com o valor dataSynchro.
$pushNotification:=MobileAppServer.PushNotification.new()
$notification:=New object
$notification.title:="Este é o título"
$notification.body:="Aqui está o conteúdo da notificação"
$notification.userInfo:=New object("dataSynchro"; True)
$response:=$pushNotification.send($notification; $recipients)
Windows Configuration
Windows users need to download the last CURL version to work on the variables of the environment of their machine. Ou podem inserir curl.exe na pasta Resources do banco de dados produção.
MobileApps folder
Whether you're working on Windows or on macOS, you need to copy the 4DBASE/MobileApps/ID.BundleID/AuthKey_XXXX.P8 and 4DBASE/MobileApps/ID.BundleID/manifest.json files from your Design database to your production database.
Que fazer agora?
O componente que maneja e facilita o processo também está disponível aqui para que possa adaptar as notificações push a suas próprias necessidades. Pode usar e escolher quais os aspectos mais relevantes para sua aplicação. Todas as contribuições são bem vindas a este projeto, seja através de comentários, relatórios de erros ou ainda melhor: "pull requests".