Swiftpack.co - swift-server-community/APNSwift as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by swift-server-community.
swift-server-community/APNSwift 5.0.1
📱HTTP/2 Apple Push Notification Service built with swift - send push notifications to iOS, iPadOS, tvOS, macOS, watchOS, visionOS, and Safari!
⭐️ 578
🕓 6 days ago
iOS macOS watchOS tvOS
.package(url: "https://github.com/swift-server-community/APNSwift.git", from: "5.0.1")

sswg:graduated|94x20 Build Documentation


A non-blocking Swift module for sending remote Apple Push Notification requests to APNS built on AsyncHttpClient.


To install APNSwift, just add the package as a dependency in your Package.swift.

dependencies: [
    .package(url: "https://github.com/swift-server-community/APNSwift.git", from: "5.0.0"),

Getting Started

APNSwift aims to provide semantically correct structures to sending push notifications. You first need to setup a APNSClient. To do that youll need to know your authentication method

let client = APNSClient(
    configuration: .init(
        authenticationMethod: .jwt(
            privateKey: try .init(pemRepresentation: privateKey),
            keyIdentifier: keyIdentifier,
            teamIdentifier: teamIdentifier
        environment: .sandbox
    eventLoopGroupProvider: .createNew,
    responseDecoder: JSONDecoder(),
    requestEncoder: JSONEncoder(),
    byteBufferAllocator: .init(),
    backgroundActivityLogger: logger
defer {
    client.shutdown { _ in
        logger.error("Failed to shutdown APNSClient")

Sending a simple notification

All notifications require a payload, but that payload can be empty. Payload just needs to conform to Encodable

struct Payload: Codable {}

try await client.sendAlertNotification(
        alert: .init(
            title: .raw("Simple Alert"),
            subtitle: .raw("Subtitle"),
            body: .raw("Body"),
            launchImage: nil
        expiration: .immediately,
        priority: .immediately,
        topic: "com.app.bundle",
        payload: Payload()
    deviceToken: "device-token",
    deadline: .nanoseconds(Int64.max),
    logger: myLogger

Sending Live Activity Update / End

It requires sending ContentState matching with the live activity configuration to successfully update activity state. ContentState needs to conform to Encodable

        try await client.sendLiveActivityNotification(
                  expiration: .immediately,
                  priority: .immediately,
                  appID: "com.app.bundle",
                  contentState: ContentState,
                  event: .update,
                  timestamp: Int(Date().timeIntervalSince1970)
            activityPushToken: activityPushToken,
            deadline: .distantFuture
        try await client.sendLiveActivityNotification(
                  expiration: .immediately,
                  priority: .immediately,
                  appID: "com.app.bundle",
                  contentState: ContentState,
                  event: .end,
                  timestamp: Int(Date().timeIntervalSince1970),
                  dismissalDate: .dismissImmediately // Optional to alter default behaviour
            activityPushToken: activityPushToken,
            deadline: .distantFuture


APNSwift provides two authentication methods. jwt, and TLS.

jwt is preferred and recommend by Apple These can be configured when created your APNSClientConfiguration

Notes: jwt requires an encrypted version of your .p8 file from Apple which comes in a pem format. If you're having trouble with your key being invalid please confirm it is a PEM file

 openssl pkcs8 -nocrypt -in /path/to/my/key.p8 -out ~/Downloads/key.pem


By default APNSwift has a no-op logger which will not log anything. However if you pass a logger in, you will see logs.

There are currently two kinds of loggers.

Background Activity Logger

This logger can be passed into the APNSClient and will log background things like connection pooling, auth token refreshes, etc.

Notification Send Logger

This logger can be passed into any of the send: methods and will log everything related to a single send request.

Server Example

Take a look at Program.swift

iOS Examples

For an iOS example, open the example project within this repo.

Once inside configure your App Bundle ID and assign your development team. Build and run the ExampleApp to iOS Simulator, grab your device token, and plug it in to server example above. Background the app and run Program.swift

Original pitch and discussion on API


Stars: 578
Last commit: 6 days ago
Advertisement: IndiePitcher.com - Cold Email Software for Startups

Related Packages

Release Notes

6 days ago

What's Changed

New Contributors

Full Changelog: https://github.com/swift-server-community/APNSwift/compare/5.0.0...5.0.1

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics