Rotear um push tocado \
Todo push carrega um campodata.type. O aplicativo escuta os toques, lê o tipo e abre a tela correspondente.
app/_layout.tsx
Dois desses tipos vêm de Journeys, que este guia não aborda.
reengagement é definido nos pushes de uma Journey de reconquista criada no painel. member_lapsed é um push para os donos e administradores de uma casa, enviado pelo backend quando essa Journey informa que um membro parou de limpar. Eles são roteados aqui como qualquer outro push.
Botões de ação: mais de uma coisa para tocar \
Um push pode ter botões. Os pushes de tarefas oferecem Start cleaning e Snooze 1h, e o push “um colega de casa terminou a limpeza” oferece Send kudos. As pessoas revelam os botões expandindo a notificação, o que no iOS é um toque longo.
Um lembrete expandido com seus dois botões de ação.
id e um rótulo.
supabase/functions/_shared/buttons.ts
id do botão como event.result.actionId. Um toque na própria notificação não tem actionId. O aplicativo verifica primeiro se há um botão e, se não houver, volta ao roteamento normal.
src/lib/pushActions.ts
send_after. O OneSignal guarda a mensagem até lá, então nada precisa ficar rodando por uma hora.
supabase/functions/snooze-reminder/index.ts
Todo toque em botão também é registrado como evento personalizado,
push_action_clicked. Uma Journey não pode ramificar diretamente com base em um botão, mas pode aguardar esse evento e ramificar pela propriedade action_id.Tocar em um botão abre o aplicativo por padrão. Tratar um toque sem abrir o aplicativo exige código nativo: uma categoria de notificação no iOS e uma notification service extension no Android.
Reescrever links recebidos \
Links de fora do aplicativo usam caminhos curtos como/clean. O hook de native intent do Expo Router os reescreve para as rotas reais do aplicativo antes da navegação, então nada fora do aplicativo precisa saber como as telas estão organizadas.
app/+native-intent.tsx
Abrir o aplicativo a partir de links web comuns \
Um esquema personalizado comocleaning-rota:// só funciona se o aplicativo estiver instalado, e muitos aplicativos se recusam a torná-lo clicável. Os Universal Links no iOS e os App Links no Android resolvem isso. São links https:// comuns que abrem o aplicativo quando ele está instalado e o site quando não está. Isso os torna a escolha certa para links em emails, SMS e mensagens compartilhadas.
Configurá-los exige uma declaração de cada lado: o aplicativo diz a qual domínio pertence, e o site diz qual aplicativo pode abrir seus links.
1
Declarar o domínio no aplicativo
app.json
2
Publicar o arquivo de associação da Apple
Hospede-o em
/.well-known/apple-app-site-association, via HTTPS, servido como JSON. O ID do aplicativo é seu Apple Team ID seguido do bundle identifier.website/.well-known/apple-app-site-association
3
Publicar o arquivo de associação do Android
Hospede-o em
/.well-known/assetlinks.json. A impressão digital vem do certificado de assinatura do seu aplicativo. Com o EAS, execute eas credentials -p android para encontrá-la.website/.well-known/assetlinks.json
4
Usar o link
A tela da casa compartilha um link de convite. Tocar nele abre a tela de entrada com o código já preenchido.
app/household.tsx
app/join-household.tsx
O Clean Beans reivindica apenas os caminhos que o aplicativo consegue mostrar. A página inicial fica de fora, então o site de marketing continua abrindo no navegador. O iOS lê o arquivo de associação quando o aplicativo é instalado ou atualizado, então publique o arquivo antes de lançar a compilação.
Deep linking
Como o OneSignal trata URLs em cada plataforma.
Payload da notificação
Todos os campos disponíveis no listener de clique.
Botões de ação
Limites de cada plataforma, ícones e tratamento de toques.