A non-blocking Swift module for sending remote Apple Push Notification requests to APNS built on http/2, SwiftNIO for use on server side swift platforms.
To install APNSwift
, just add the package as a dependency in your Package.swift.
dependencies: [
.package(url: "https://github.com/kylebrowning/APNSwift.git", .upToNextMinor(from: "1.3.0"))
]
struct BasicNotification: APNSwiftNotification {
let aps: APNSwiftPayload
}
let group = MultiThreadedEventLoopGroup(numberOfThreads: 1)
var logger = Logger(label: "com.apnswift")
logger.logLevel = .debug
let apnsConfig = try APNSwiftConfiguration(
authenticationMethod: .jwt(
key: .private(filePath: "/Users/kylebrowning/Desktop/AuthKey_9UC9ZLQ8YW.p8"),
keyIdentifier: "9UC9ZLQ8YW",
teamIdentifier: "ABBM6U9RM5"
),
topic: "com.grasscove.Fern",
environment: .sandbox,
logger: logger
)
let apns = try APNSwiftConnection.connect(configuration: apnsConfig, on: group.next()).wait()
let aps = APNSwiftPayload(alert: .init(title: "Hey There", subtitle: "Subtitle", body: "Body"), hasContentAvailable: true)
try apns.send(BasicNotification(aps: aps), pushType: .alert, to: "98AAD4A2398DDC58595F02FA307DF9A15C18B6111D1B806949549085A8E6A55D").wait()
try apns.close().wait()
try group.syncShutdownGracefully()
exit(0)
APNSwiftConfiguration
is a structure that provides the system with common configuration.
let apnsConfig = try APNSwiftConfiguration(
authenticationMethod: .jwt(
key: .private(filePath: "/Users/kylebrowning/Desktop/AuthKey_9UC9ZLQ8YW.p8"),
keyIdentifier: "9UC9ZLQ8YW",
teamIdentifier: "ABBM6U9RM5"
),
topic: "com.grasscove.Fern",
environment: .sandbox,
logger: logger
)
let signer = ...
let apnsConfig = try APNSwiftConfiguration(keyIdentifier: "9UC9ZLQ8YW",
teamIdentifier: "ABBM6U9RM5",
signer: signer),
topic: "com.grasscove.Fern",
environment: .sandbox)
APNSwiftConnection
is a class with methods thats provides a wrapper to NIO's ClientBootstrap. The swift-nio-http2
dependency is utilized here. It also provides a function to send a notification to a specific device token string.
let apnsConfig = ...
let apns = try APNSwiftConnection.connect(configuration: apnsConfig, on: group.next()).wait()
APNSwiftAlert
is the actual meta data of the push notification alert someone wishes to send. More details on the specifics of each property are provided here. They follow a 1-1 naming scheme listed in Apple's documentation
let alert = APNSwiftAlert(title: "Hey There", subtitle: "Full moon sighting", body: "There was a full moon last night did you see it")
APNSwiftPayload
is the meta data of the push notification. Things like the alert, badge count. More details on the specifics of each property are provided here. They follow a 1-1 naming scheme listed in Apple's documentation
let alert = ...
let aps = APNSwiftPayload(alert: alert, badge: 1, sound: .normal("cow.wav"))
Apple provides engineers with the ability to add custom payload data to each notification. In order to facilitate this we have the APNSwiftNotification
.
struct AcmeNotification: APNSwiftNotification {
let acme2: [String]
let aps: APNSwiftPayload
init(acme2: [String], aps: APNSwiftPayload) {
self.acme2 = acme2
self.aps = aps
}
}
let apns: APNSwiftConnection: = ...
let aps: APNSwiftPayload = ...
let notification = AcmeNotification(acme2: ["bang", "whiz"], aps: aps)
let res = try apns.send(notification, to: "de1d666223de85db0186f654852cc960551125ee841ca044fdf5ef6a4756a77e").wait()
var apnsConfig = try APNSwiftConfiguration(
authenticationMethod: .tls(
privateKeyPath: "/Users/kylebrowning/Projects/swift/Fern/development_com.grasscove.Fern.pkey",
pemPath: "/Users/kylebrowning/Projects/swift/Fern/development_com.grasscove.Fern.pem"
),
topic: "com.grasscove.Fern",
environment: .sandbox
)
let apns = try APNSwiftConnection.connect(configuration: apnsConfig, on: group.next()).wait()
APNSwift provides the ability to send raw payloads. You can use Data
, ByteBuffer
, DispatchData
, Array
Though this is to be used with caution. APNSwift cannot gurantee delivery if you do not have the correct payload.
For more information see: Creating APN Payload
let notificationJsonPayload = ...
let data: Data = try! encoder.encode(notificationJsonPayload)
try apns.send(raw: data, pushType: .alert, to: "<DEVICETOKEN>")
- Pitch discussion: Swift Server Forums
- Proposal: SSWG-0006