mirror
/
vapor-docs
mirror of https://github.com/vapor/docs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Updated apns(Chinese) doc. (#875)

This commit is contained in:
晋先森 2023-08-02 01:46:04 +08:00 committed by GitHub
parent 80edddff98
commit b63d6c3e36
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 63 additions and 60 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

123
docs/advanced/apns.zh.md
View File

@ -1,6 +1,6 @@
# APNS # APNS
在 Vapor 中使用基于 [APNSwift](https://github.com/kylebrowning/APNSwift) 构建的 API，可以轻松实现 Apple 推送通知服务(APNS) 的身份验证并将推送通知发送到 Apple 设备。 在 Vapor 中使用基于 [APNSwift](https://github.com/swift-server-community/APNSwift) 构建的 API，可以轻松实现 Apple 推送通知服务(APNS) 的身份验证并将推送通知发送到 Apple 设备。
## 入门 ## 入门
@ -11,14 +11,14 @@
使用 APNS 的第一步是将此依赖项添加到你的 Package.swift 文件中。 使用 APNS 的第一步是将此依赖项添加到你的 Package.swift 文件中。
```swift ```swift
// swift-tools-version:5.2 // swift-tools-version:5.8
import PackageDescription import PackageDescription
let package = Package( let package = Package(
name: "my-app", name: "my-app",
dependencies: [ dependencies: [
// Other dependencies... // Other dependencies...
.package(url: "https://github.com/vapor/apns.git", from: "3.0.0"), .package(url: "https://github.com/vapor/apns.git", from: "5.0.0"),
], ],
targets: [ targets: [
.target(name: "App", dependencies: [ .target(name: "App", dependencies: [
@ -40,18 +40,29 @@ APNS 模块为 `Application` 添加了一个 `apns` 新属性。要发送推送
import APNS import APNS
// 使用 JWT 认证 配置 APNS。 // 使用 JWT 认证 配置 APNS。
app.apns.configuration = try .init( let apnsConfig = APNSClientConfiguration(
authenticationMethod: .jwt( authenticationMethod: .jwt(
key: .private(filePath: <#path to .p8#>), privateKey: try .loadFrom(filePath: "<#path to .p8#>")!,
keyIdentifier: "<#key identifier#>", keyIdentifier: "<#key identifier#>",
teamIdentifier: "<#team identifier#>" teamIdentifier: "<#team identifier#>"
), ),
topic: "<#topic#>",
environment: .sandbox environment: .sandbox
) )
app.apns.containers.use(
apnsConfig,
eventLoopGroupProvider: .shared(app.eventLoopGroup),
responseDecoder: JSONDecoder(),
requestEncoder: JSONEncoder(),
backgroundActivityLogger: app.logger,
as: .default
)
``` ```
在占位符中填写你的凭据。上面的示例显示了[基于 JWT 的认证](https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/establishing_a_token-based_connection_to_apns)方式，使用从 Apple 开发者官网获得的 `.p8` 密钥。对于[基于 TLS 的认证](https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/establishing_a_certificate-based_connection_to_apns)，请使用 `.tls` 身份验证方法： 在占位符中填写你的凭证。
上面的示例显示了[基于 JWT 的认证](https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/establishing_a_token-based_connection_to_apns)方式，使用从 Apple 开发者官网获得的 `.p8` 密钥。
对于[基于 TLS 的认证](https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/establishing_a_certificate-based_connection_to_apns)，请使用 `.tls` 身份验证方法：
```swift ```swift
authenticationMethod: .tls( authenticationMethod: .tls(
@ -61,88 +72,80 @@ authenticationMethod: .tls(
) )
``` ```
### 发送 ### 发送通知
配置 APNS 后，你可以使用 `apns.send` 方法在 `Application` 或 `Request` 中发送推送通知。 配置 APNS 后，你可以使用 `apns.client.sendAlertNotification` 方法在 `Application` 或 `Request` 中发送通知。
```swift ```swift
// 发送一条推送。 // 自定义遵循 `Codable` 协议的 Payload
try app.apns.send( struct Payload: Codable {
.init(title: "Hello", subtitle: "This is a test from vapor/apns"), let acme1: String
to: "98AAD4A2398DDC58595F02FA307DF9A15C18B6111D1B806949549085A8E6A55D" let acme2: Int
).wait() }
// 创建推送
// 或者 let dt = "70075697aa918ebddd64efb165f5b9cb92ce095f1c4c76d995b384c623a258bb"
try await app.apns.send( let payload = Payload(acme1: "hey", acme2: 2)
.init(title: "Hello", subtitle: "This is a test from vapor/apns"), let alert = APNSAlertNotification(
to: "98AAD4A2398DDC58595F02FA307DF9A15C18B6111D1B806949549085A8E6A55D" alert: .init(
title: .raw("Hello"),
subtitle: .raw("This is a test from vapor/apns")
),
expiration: .immediately,
priority: .immediately,
topic: "<#my topic#>",
payload: payload
)
// 发送通知
try! await req.apns.client.sendAlertNotification(
alert,
deviceToken: dt,
deadline: .distantFuture
) )
``` ```
每当你在路由内部处理时，使用 `req.apns` 发送推送通知。 当你在路由内部处理时，使用 `req.apns` 发送推送通知。
```swift ```swift
// 发送推送通知 // 发送通知
app.get("test-push") { req -> EventLoopFuture<HTTPStatus> in
req.apns.send(..., to: ...)
.map { .ok }
}
// 或者
app.get("test-push") { req async throws -> HTTPStatus in app.get("test-push") { req async throws -> HTTPStatus in
try await req.apns.send(..., to: ...) try await req.apns.send(..., to: ...)
return .ok return .ok
} }
``` ```
第一个参数接受推送通知的数据，第二个参数是目标设备令牌。 第一个参数接受推送通知的数据，第二个参数是目标设备的 token。
## Alert ## Alert
`APNSwiftAlert` 是要发送的推送通知的实际元数据。[此处](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/PayloadKeyReference.html)提供了每个属性的详细信息。它们遵循 Apple 文档中列出的一对一命名方案。 `APNSAlertNotification` 是要发送的推送通知的实际元数据。[此处](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/PayloadKeyReference.html)提供了每个属性的详细信息。它们遵循 Apple 文档中列出的一对一命名方案。
```swift ```swift
let alert = APNSwiftAlert( let alert = APNSAlertNotification(
title: "Hey There", alert: .init(
subtitle: "Full moon sighting", title: .raw("Hello"),
body: "There was a full moon last night did you see it" subtitle: .raw("This is a test from vapor/apns")
),
expiration: .immediately,
priority: .immediately,
topic: "<#my topic#>",
payload: payload
) )
``` ```
此类型可以直接传递给 `send` 方法，它将自动包装在 `APNSwiftPayload` 中。 此类型可以直接传递给 `send` 方法。
### Payload
`APNSwiftPayload` 是推送通知的元数据。诸如推送弹窗，徽章数之类的东西。[此处](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/PayloadKeyReference.html)提供了每个属性的详细信息。它们遵循 Apple 文档中列出的一对一命名方案。
```swift
let alert = ...
let aps = APNSwiftPayload(alert: alert, badge: 1, sound: .normal("cow.wav"))
```
这可以传递给 `send` 方法。
### 自定义通知数据 ### 自定义通知数据
Apple 为工程师提供了为每个通知添加定制有效载荷数据的能力。为了方便操作，我们有了 `APNSwiftNotification`。 Apple 为工程师提供了为每个通知添加定制有效载荷数据的能力。为了方便操作，我们有了 `APNSwiftNotification`。
Apple 为工程师提供了向每个通知添加自定义 Payload 的能力，为了方便使用，对于 `send` api，我们接受所有遵循 `Codable` 协议的 Payload。
```swift ```swift
struct AcmeNotification: APNSwiftNotification { // 自定义遵循 `Codable` 协议的 Payload
let acme2: [String] struct Payload: Codable {
let aps: APNSwiftPayload let acme1: String
let acme2: Int
init(acme2: [String], aps: APNSwiftPayload) {
self.acme2 = acme2
self.aps = aps
}
}
let aps: APNSwiftPayload = ...
let notification = AcmeNotification(acme2: ["bang", "whiz"], aps: aps)
``` ```
可将此自定义通知类型传递给该 `send` 方法。
## 更多信息 ## 更多信息
了解更多可用方法的信息，请参阅 [APNSwift](https://github.com/kylebrowning/APNSwift)。 了解更多可用方法的信息，请参阅 [APNSwift](https://github.com/swift-server-community/APNSwift)。