Ana içeriğe atla
Bu sayfa, gerçek bir uygulamayı baştan sona takip eden Örnek uygulama: eksiksiz bir OneSignal entegrasyonu kılavuzunun bir parçasıdır. Uygulama, ortak yaşanan evler için bir temizlik nöbet çizelgesi olan Clean Beans’tir ve Expo (React Native) ile bir Supabase backend’i kullanılarak geliştirilmiştir. Bir bildirim ancak ona dokunmak sizi doğru yere götürüyorsa işe yarar. Clean Beans uygulamaya girmenin dört yolunu işler: dokunulan bir push, bir push üzerinde dokunulan bir düğme, özel şemalı bir bağlantı ve sıradan bir web bağlantısı.

Dokunulan bir push’u yönlendirin \

Her push bir data.type alanı taşır. Uygulama dokunmaları dinler, türü okur ve eşleşen ekranı açar.
app/_layout.tsx
Bu türlerden ikisi, bu kılavuzun ele almadığı Journeys’ten gelir. reengagement, kontrol panelinde oluşturulan bir geri kazanma Journey’sinin push’larında ayarlanır. member_lapsed, hanenin sahiplerine ve yöneticilerine gönderilen bir push’tur ve bu Journey bir üyenin temizlik yapmayı bıraktığını bildirdiğinde backend tarafından gönderilir. Bunlar da diğer push’lar gibi burada yönlendirilir.
Kontrol ettiğiniz bir türe göre yönlendirmek, bir URL’yi ayrıştırmaktan daha sağlamdır. Bir ekran taşınırsa tek bir switch ifadesini değiştirirsiniz ve değişiklikten önce gönderilen her push doğru şekilde açılmaya devam eder.

Eylem düğmeleri: dokunulacak birden fazla şey \

Bir push düğmeler taşıyabilir. Görev push’ları Start cleaning ve Snooze 1h sunar, “ev arkadaşı temizliği bitirdi” push’u ise Send kudos sunar. Kişiler düğmeleri bildirimi genişleterek görür. iOS’ta bu, uzun basmaktır.
Start cleaning ve Snooze 1h düğmeleri olan genişletilmiş bir push bildirimi

İki eylem düğmesiyle genişletilmiş bir hatırlatıcı.

Backend düğmeleri isteğe ekler. Her birinin bir id değeri ve bir etiketi vardır.
supabase/functions/_shared/buttons.ts
Bir düğmeye dokunmak uygulamayı açar ve yukarıda gösterilen tıklama dinleyicisi düğmenin id değerini event.result.actionId olarak alır. Bildirimin kendisine dokunulduğunda actionId olmaz. Uygulama önce bir düğme olup olmadığını kontrol eder ve yoksa normal yönlendirmeye geçer.
src/lib/pushActions.ts
Erteleme backend’e ihtiyaç duyar, çünkü uygulama push gönderemez. Uygulama, send_after ile başka bir hatırlatıcı zamanlayan bir fonksiyonu çağırır. OneSignal mesajı o zamana kadar bekletir, bu yüzden hiçbir şeyin bir saat boyunca çalışmaya devam etmesi gerekmez.
supabase/functions/snooze-reminder/index.ts
Her düğme dokunuşu ayrıca push_action_clicked adlı özel bir olay olarak kaydedilir. Bir Journey doğrudan bir düğmeye göre dallanamaz, ancak bu olayı bekleyebilir ve action_id özelliğine göre dallanabilir.
Bir düğmeye dokunmak varsayılan olarak uygulamayı açar. Bir dokunmayı uygulamayı açmadan işlemek yerel kod gerektirir: iOS’ta bir bildirim kategorisi, Android’de bir notification service extension.
Uygulamanın dışından gelen bağlantılar /clean gibi kısa yollar kullanır. Expo Router’ın native intent kancası, gezinme gerçekleşmeden önce bunları uygulamanın gerçek rotalarına yeniden yazar. Böylece uygulamanın dışındaki hiçbir şeyin ekranların nasıl düzenlendiğini bilmesi gerekmez.
app/+native-intent.tsx
cleaning-rota:// gibi özel bir şema yalnızca uygulama yüklüyse çalışır ve birçok uygulama onu dokunulabilir yapmayı reddeder. iOS’taki Universal Links ve Android’deki App Links bu sorunu çözer. Bunlar, uygulama yüklüyse uygulamayı, değilse web sitesini açan normal https:// bağlantılarıdır. Bu da onları e-postalardaki, SMS’lerdeki ve paylaşılan mesajlardaki bağlantılar için doğru seçim yapar. Bunları kurmak her iki tarafta da bir bildirim gerektirir: uygulama hangi alan adına ait olduğunu söyler, web sitesi de bağlantılarını hangi uygulamanın açabileceğini söyler.
1

Alan adını uygulamada bildirin

app.json
2

Apple ilişkilendirme dosyasını yayınlayın

Dosyayı /.well-known/apple-app-site-association konumunda, HTTPS üzerinden ve JSON olarak sunun. Uygulama kimliği, Apple Team ID’nizin ardından gelen bundle identifier’dır.
website/.well-known/apple-app-site-association
3

Android ilişkilendirme dosyasını yayınlayın

Dosyayı /.well-known/assetlinks.json konumunda barındırın. Parmak izi, uygulamanızın imzalama sertifikasından gelir. EAS ile bulmak için eas credentials -p android komutunu çalıştırın.
website/.well-known/assetlinks.json
4

Bağlantıyı kullanın

Hane ekranı bir davet bağlantısı paylaşır. Bağlantıya dokunmak, kodu önceden doldurulmuş olarak katılma ekranını açar.
app/household.tsx
app/join-household.tsx
Clean Beans yalnızca uygulamanın gösterebileceği yolları sahiplenir. Ana sayfa bunun dışında bırakılır, bu yüzden pazarlama sitesi tarayıcıda açılmaya devam eder. iOS ilişkilendirme dosyasını uygulama yüklendiğinde veya güncellendiğinde okur, bu yüzden derlemeyi yayınlamadan önce dosyayı yayınlayın.

Derin bağlantı

OneSignal’ın her platformda URL’leri nasıl işlediği.

Bildirim yükü

Tıklama dinleyicisinde kullanılabilen her alan.

Eylem düğmeleri

Platform sınırları, simgeler ve dokunmaları işleme.