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. Diğer her şey dört şeyin doğru olmasına bağlıdır: SDK kuruludur, uygulama başladığında SDK da başlar, her cihaz bir kullanıcıya bağlıdır ve kişiler ne alacaklarını kontrol edebilir.

Expo eklentisiyle kurulum \

onesignal-expo-plugin, yerel iOS ve Android projelerini derleme sırasında yapılandırır. OneSignal’ın görseller, rozetler ve teslimat onayı için ihtiyaç duyduğu push capability’sini, App Group’u ve Notification Service Extension’ı ekler.
app.json

Kökte bir kez başlatın \

Clean Beans, OneSignal’ı kök düzeninde başlatır. Böylece her açılışta, herhangi bir ekran görünmeden önce bir kez çalışır.
app/_layout.tsx
İlk açılışta izin istemek en basit yaklaşımdır. Önce faydayı açıklamak için sistem isteminden önce bir uygulama içi mesaj gösterin. Clean Beans’te hazır bir tane var: Push izni ön istemi bölümüne bakın.

Her cihazı bir kullanıcıya bağlayın \

Biri oturum açtığında uygulama, Supabase kullanıcı kimliğini OneSignal.login() fonksiyonuna iletir. Bu kimlik External ID olur. Kullanıcı oturumu kapattığında logout() cihazın bağlantısını keser. Böylece oturum açan bir sonraki kişi önceki kullanıcının mesajlarını devralmaz.
app/_layout.tsx
İki yöntemden herhangi birini çağırmadan önce kayıtlı oturumun yüklenmesini bekleyin. Soğuk başlatmada oturum açmış kullanıcı kısa bir süre bilinmez. Uygulama o anda logout() ve hemen ardından login() çağırırsa, cihazın push aboneliği anonim bir kullanıcıda kalabilir ve External ID’ye gönderilen push’lar telefona ulaşmaz. logout() yöntemini yalnızca biri gerçekten oturumu kapattığında çağırın.
Bu kılavuzdaki her backend gönderimini mümkün kılan bu tek çağrıdır. Bir kullanıcının veritabanı kimliğini bilen bir fonksiyon, cihazları hakkında hiçbir şey bilmeden ona mesaj gönderebilir.

E-posta kanalını ekleyin \

Uygulama, her kullanıcının e-posta adresini kayıttan beri bilir. Bu yüzden oturum açıldığında adresi bir e-posta aboneliği olarak kaydeder. OneSignal aynı adresle yapılan tekrar çağrılarını yok sayar.
src/lib/onesignalSync.ts
SMS de aynı şekilde addSms() ile eklenir, ancak yalnızca numara doğrulandıktan sonra. SMS: doğrulama kodları ve davetler sayfasına bakın.

Kişilerin ne alacaklarını kontrol etmesine izin verin \

Bildirim ayarları ekranında bir ana anahtar ve her mesaj türü için bir anahtar bulunur.
Ana anahtarı ve türe göre anahtarları olan bildirim ayarları ekranı

Bildirim ayarları: ana anahtar, türe göre anahtarlar ve günlük hatırlatıcı saati.

Ana anahtar, push aboneliğinde optOut() ve optIn() çağırır. Böylece OneSignal o cihaza teslimatı durdurur ve yeniden başlatır.
app/notification-settings.tsx
Her anahtar, kullanıcının profil satırına da kaydedilir. Backend bir şey göndermeden önce bu sütunları okur. Türe göre tercihler bu şekilde uygulanır.
src/lib/database.ts
Tercihleri kendi veritabanınızda saklamak ve her gönderimden önce kontrol etmek, mantığı tek bir yerde tutar. Alternatif, tercihleri etiket olarak saklamak ve OneSignal’da etikete göre filtrelemektir. Bu yöntem segmentlere gönderim yaptığınızda iyi çalışır. Clean Beans belirli kullanıcılara gönderim yaptığı için veritabanını kontrol etmek daha basittir.

Mobil SDK referansı

Bu kılavuzda kullanılan tüm istemci yöntemleri.

Kullanıcılar ve External ID'ler

Kimliğin abonelikleri kanallar ve cihazlar arasında nasıl bağladığı.