iOS SDK (Swift)
Native Swift Package, iOS 15+, doğrudan APNs — Firebase yok. Yalnızca URLSession ve UserDefaults.
Uygulama tarafı çalışmadan önce APNs anahtarı yüklenmiş olmalı: iOS platform kurulumu.
1 Paketi ekle
Xcode → File → Add Package Dependencies… → depo URL'ini girip OpenNotification ürününü seçin. Monorepo'yu vendor'lıyorsanız yolla ekleyin (packages/sdk-ios).
// Package.swift
dependencies: [
.package(url: "https://github.com/Aproder/opennotification.git", from: "0.1.0")
],
targets: [
.target(name: "App", dependencies: [
.product(name: "OpenNotification", package: "opennotification")
])
]
2 Yetkiler
Hedef → Signing & Capabilities → + Capability: Push Notifications ve Background Modes → Remote notifications.
3 AppDelegate
SDK'ya dört şeyin iletilmesi gerekir. AppDelegate.swift'te:
import UIKit
import UserNotifications
import OpenNotification
@main
class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {
func application(_ app: UIApplication,
didFinishLaunchingWithOptions options: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
OpenNotification.shared.configure(endpoint: "https://push.example.com", appKey: "pk_live_…")
OpenNotification.shared.onOpen = { message in
Router.open(message.url, data: message.data) // derin bağlantı, actionId, data
}
OpenNotification.shared.onReceive = { message in
// uygulama ön plandayken push geldi
}
// Uygulamayı başlatan basış (soğuk başlatma) — onOpen'a yeniden oynatılır.
OpenNotification.shared.handleLaunch(userInfo: options?[.remoteNotification] as? [AnyHashable: Any])
UNUserNotificationCenter.current().delegate = self
return true
}
// APNs token verdi → SDK cihazı kaydeder
func application(_ app: UIApplication,
didRegisterForRemoteNotificationsWithDeviceToken token: Data) {
OpenNotification.shared.didRegister(deviceToken: token)
}
// Kullanıcı bildirime ya da butonlarından birine bastı
func userNotificationCenter(_ c: UNUserNotificationCenter,
didReceive r: UNNotificationResponse,
withCompletionHandler done: @escaping () -> Void) {
OpenNotification.shared.didReceive(response: r)
done()
}
// Uygulama ön plandayken banner göster
func userNotificationCenter(_ c: UNUserNotificationCenter,
willPresent n: UNNotification,
withCompletionHandler done: @escaping (UNNotificationPresentationOptions) -> Void) {
OpenNotification.shared.willPresent(notification: n)
done([.banner, .sound, .badge])
}
}
SwiftUI uygulamaları: @UIApplicationDelegateAdaptor(AppDelegate.self) ile bir AppDelegate tutun.
didRegister olmadanİzin verilir, Apple token çıkarır ve sunucuya hiçbir şey ulaşmaz — cihaz hiç abone olmaz. En sık "çalışmıyor" nedeni budur.
4 İzin iste
Nedenini açıklayan bir ekrandan — ilk açılışta değil:
OpenNotification.shared.requestPermission { granted in
// granted → SDK registerForRemoteNotifications() çağırır;
// token didRegister'a gelir ve cihaz abone olur.
}
Kayıtta SDK şunları gönderir: platform, token, sdkVersion, OS sürümü, cihaz modeli, uygulama sürümü, cihazın dili, saat dilimi ve ülkesi.
5 Kimlik ve tag'ler
OpenNotification.shared.login("user_123") // kendi girişinizden sonra
OpenNotification.shared.setTags(["plan": "platinum", "streak": 42])
OpenNotification.shared.removeTags(["streak"])
OpenNotification.shared.setLanguage("tr")
OpenNotification.shared.setPhone("+905551234567") // E.164, nil siler
OpenNotification.shared.logout() // çıkışta
OpenNotification.shared.unsubscribe() // kullanıcı ayarlar ekranında çıktı
OpenNotification.shared.trackSession() // isteğe bağlı: didBecomeActive'de zaten gider
OpenNotification.shared.trackBackground() // isteğe bağlı: didEnterBackground kullanım süresini zaten biriktirir
Her çağrı isteğe bağlı completion: (Error?) -> Void alır. Token gelmeden login sorun değil — external id kayıtla birlikte gider. Semantik: Kimlik.
Destek için gerekirse OpenNotification.shared.subscriptionId saklanan kimliği verir.
Sessiz (arka plan) push'lar
Sessiz push kampanyası alert'siz content-available olarak gelir. Background Modes › Remote notifications'ı açın ve AppDelegate geri çağrısını iletin:
func application(_ app: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any],
fetchCompletionHandler done: @escaping (UIBackgroundFetchResult) -> Void) {
OpenNotification.shared.didReceiveBackground(userInfo: userInfo) { _ in done(.newData) }
}
OpenNotification.shared.onReceive = { message in
if message.silent { Sync.run(message.data) }
}
didReceiveBackground delivered bildirir (arka plan push'unda service extension çalışmaz) ve message.data'yı onReceive'e verir. iOS yaklaşık 30 saniye tanır.
Oturumlar
configure() didBecomeActive'i gözler ve POST /v1/subscriptions/:id/session'a ping atar; sunucu 30 dakika sessizlikten sonra yeni oturum sayar. sessionCount ve lastSessionAt böylece segment alanı olarak çalışır.
Cihaz bilgileri
Kayıt ve her oturum pingi OneSignal'ın topladıklarını da taşır; içe aktarılan kitleyle SDK'dan gelen kitle segment ve raporlarda aynı görünür: donanım modeli (iPhone16,1, samsung SM-A566E), OS ve uygulama sürümü, dil, saat dilimi, ülke, root / jailbreak (bilinen sezgisel yöntemler — güvenlik kontrolü değil, segment alanı), ön plan süresi (usageDuration; uygulama arka plana geçince biriktirilir, sonraki pingle gider) ve son bilinen konum — yalnızca uygulamanız konum iznine zaten sahipse. SDK konum izni istemez, izin yoksa location anahtarını hiç göndermez; istemci IP'si sunucuda istekten alınır.
setEmail / setPhone iletişim kanallarını tag gibi kullanıcıya yazar. Bu kanallara gönderim yapılmaz; OneSignal importunda veri kaybolmasın ve segment "e-postası var" diyebilsin diye tutulur. Telefon E.164 biçimindedir; null değeri siler.
Notification Service Extension
delivered olayı, görseller ve aksiyon butonları için zorunlu. iOS bunları extension olmadan vermez.
1 Xcode → File → New → Target… → Notification Service Extension. NotificationService adını verin. Deployment target'ı uygulamayla eşleyin.
2 Üretilen NotificationService.swift'i packages/sdk-ios/Templates/NotificationService.swift ile değiştirin.
3 Extension hedefinin Info.plist'ine API taban URL'inizle (https://push.example.com) OpenNotificationApiUrl adlı String anahtar ekleyin. Extension ayrı bir süreçtir ve uygulamanın yapılandırmasını okuyamaz.
4 Extension'a kendi App ID'sini ve provisioning profilini verin (com.acme.shop.NotificationService) — otomatik imzalama bunu yapar.
Şablonun ~30 saniyelik çalışma süresinde yaptıkları:
| Adım | Ayrıntı |
|---|---|
delivered bildir | Bildirim analitik beklemesin diye 5 sn timeout ile POST /v1/e/d/<msgId>. |
| Görseli indir | on.img'den, UNNotificationAttachment olarak ekler. |
| Butonları kaydet | on.a'yı okur, on_<campaignId> adlı UNNotificationCategory kaydeder — iOS yalnızca tanıdığı kategorinin butonlarını gösterir ve sunucu aps.category'yi bu ada ayarlar. |
Sunucu her zaman mutable-content: 1 gönderir; extension'ı uyandıran budur.
Açılmaları ele alma
onOpen bir OpenNotificationMessage alır:
public struct OpenNotificationMessage {
let msgId: String?, campaignId: String?
let title: String, body: String
let image: String?, url: String?
let actions: [NotificationAction] // {id, title, url?}
let actionId: String? // butona basıldıysa dolu
let data: [String: String]
}
opened (gövde) ya da clicked (buton) closure'ınız çalışmadan önce otomatik bildirilir. iOS kapatmaları asla bildirmez.
Test
packages/sdk-iosiçindeswift testmacOS'ta çalışır; UIKit parçaları#if canImportile dışarıda kalır.- Cihazda: zamanlama adımındaki Test gönder ya da
target.externalIdsilePOST /v1/notifications. - Simülatör Apple Silicon'da (Xcode 11.4+)
xcrun simctl pushile APNs alabilir ama ürettiği token gerçek APNs token'ı değildir; tam yolu test etmek için cihaz kullanın.