为受限网络创建本地推送连接

为受限网络创建本地推送连接

利用本地推送连接，从你的 app 服务器给处于无网络连接的网络中的设备传送通知。了解如何为在受限的网络环境中运行的 app 创建通知，帮助用户在受限的网络环境中也能拥有跟有网络连接的环境中先攻的可靠性和使用体验。我们一起来探索这个技术的技术细节，这样在你需要用到这项技术时，就可以在自己的 app 中实施了。

资源
下载

（你好 WWDC 2020）
大家好欢迎来到 WWDC
你好我叫 Paresh Sawant 我要讲的是 iOS 14 里的新本地推送连接 API 推送通知非常好能够将相关内容及时传给你的 app 用户然而推送通知的传送依赖 Apple Push Notification Service 这个服务只有在设备连接到互联网时才是可用的有些人给我们发来反馈说能够从他们的 app 服务器接收信息是其 app 功能性的一个极其重要的部分即便在没有互联网连接的情况下也必须要继续工作为了让大家的 app 能够满足这个要求我们在 iOS 14 里添加了一个新 API 让大家能够创建自己的基于 Wi-Fi 网络运作的推送通知服务首先我会扼要说明一下 Apple 推送通知然后我会讲一下如何使用新 API 建立定制推送通知服务之后我会使用示例 app 来演示一下这个新功能然后我会详细介绍使用这个新 API 的细节那我们开始吧你们当中肯定有许多人很熟悉推送通知许多 app 使用推送通知来发送新闻提醒、体育更新即时通讯、接收 VoIP 网络语音电话和许多其他信息我们来回顾下其工作原理你的服务商服务器给 Apple Push Notification Service 也就是人们所知的 APNs 发送一条推送通知请求 APNs 把相关通知载荷传送给每个目标设备一收到通知后系统会把该载荷传送给设备上适当的 app 根据通知类型你的 app 要么使用 PushKit 要么使用 UserNotifications 框架来接收此载荷 APNs 是推送通知功能的核心连接有 APNs 连接或因特网的网络使用 app 时对于 app 来说推送通知才是正确选择它是最佳选择因为它实现了设备与 APNs 之间的连接把通知传送给设备上的所有 app 推送通知为你的 app 提供你所渴望的用户体验最重要的是它非常节能所以开发者应当更喜欢使用 PushKit 或者是 UserNotifications 框架来处理他们服务器发来的通知但是如果你的 app 所使用的网络环境是 APNs 所无法连接的那这个 app 是无法接收这些通知的举例来说有些像是游轮、航班、野营地或医院这类可能限制或没有 APNs 连接的地方 app 的推送通知功能在以上情况下可能会受损在为用户提供即时信息方面推送通知发挥着非常重要的作用它还让用户能够采取适当行动作为回应所以在推送通知对用户尤为重要的情况下即便是在受限的网络环境中保持它的正常运转也是非常重要的本地推送连接就是用来解决这个问题的我们在 iOS 14 里添加了本地推送连接 API 这是 API NetworkExtension 家族的新成员我们来看看它的工作原理在这个新 API 的协助下你可以建立一个 app 扩展它能在一个本地 Wi-Fi 网络上直接与你的服务商服务器通信因为没有 APNs 你需要界定你自己的在服务商服务器和 app 扩展之间的协议来传送通知你的 app 必须指定你希望为你的 app 用户启动本地推送连接的 Wi-Fi 网络在设备加入指定的 Wi-Fi 网络时系统会启动 app 扩展 app 扩展负责和服务商服务器保持网络连接并接收通知只要设备与指定的 Wi-Fi 网络处于关联状态 app 扩展就能继续在后台运行当设备与指定的 Wi-Fi 网络断开连接时系统就会停止 app 扩展现在既然我们知道了这个新本地推送连接 API 也回顾了正常的推送通知我想讲一下为 app 选择正确的 API 的一般性指导方针针对一般的推送通知请求大家应当首选 PushKit 或 UserNotifications 框架本地推送连接 API 是面向一小部分非常特殊的案例的这些案例主要由网络环境的限制和这些环境中用户的要求决定在通知非常重要而网络环境受限的情况下本地推送连接可以是最恰当的解决方案要使用本地推送连接 API 实现特殊案例你需要请求新授权现在我们通过互相对比来看看这两种机制的情况新本地推送连接是在你的服务商服务器和 app 扩展之间建立直接通讯办法是在你指定的网络上使用你的协议这完全由你来控制现在我们来了解下 app 扩展是如何处理不同类型的通知的一收到面向用户的通知你的 app 扩展使用本地通知来引起用户的注意 app 扩展代码会使用 UserNotifications 框架来创建和安排本地通知它可以显示提醒、发出响声或显现出你 app 的图标比如说一收到一条短信的通知就像这里显示的那样屏幕顶端会滚动出一条横幅消息来提醒用户 app 扩展应该一直使用用户本地通知来进行面向用户的通知
现在我们来看看 app 扩展是如何处理 VoIP 网络语音电话通知的这类通知传达的信息是告诉你的 app 用户 VoIP 网络语音电话有来电
一收到 VoIP 通知 app 扩展会使用 NEAppPushProvider 类别来向系统报告来电系统对此做出回应如果容器 app 没有在运行系统会唤醒它并把来电信息传递给它就像这里展示的这样容器 app 会使用 CallKit 框架来显示来电用户界面稍后我会详细讲述如何处理 app 里的 VoIP 通知现在我们通过演示 app 看看这个是怎么工作的游轮的互联网要么连接受限要么根本没网或者有时游轮提供付费数据服务这个演示版本里的游轮公司开发了一个名为 SimplePush 的 app 该 app 在使用新的本地推送连接 API 来提供短信和 VoIP 网络语音电话服务他们希望船上的朋友和家人们使用该 app 来保持联系 Jane 和 John 是该 app 的用户在演示版本里当他们的设备没有联网时他们使用 SimplePush app 来彼此沟通
这是 Jane 的设备这是 John 的设备我们来看一下 Jane 的设备上 SimplePush app 里的设置
设置包括服务商服务器的主机名实现本地推送连接的 Wi-Fi 网络的 SSID 已经启动
就像大家在这里看到的那样 Jane 的设备连接到了游轮的 Wi-Fi
这些是 Jane 的联系人我将用 Jane 的设备给 John 发一条短信 John 的设备上会显示该短信的通知我们就从联系人中选择 John 轻点”信息“按钮（新信息）我输入 ”你好 John“…
然后轻点“发送”按钮然后这条短信的通知出现在了 John 的设备上 John 轻点这条通知在 SimplePush app 里打开这条短信
现在 Jane 语音呼叫 John…
然后 John 的设备上会显示来电用户界面 John 接通来电…
大家可以在这里看到通话正在进行
现在 John 挂断电话
这是 SimplePush app 在 iOS 14 里使用新本地推送连接 API 的一个简单演示新本地推送连接 API 包括两个类别 NEAppPushManager 和 NEAppPushProvider 使用 NEAppPushManager 类别的是容器 app app 扩展代码执行 NEAppPushProvider 类别的子类别
你的 app 扩展和容器 app 都需要由 NEAppPushProvider 授权来使用该 API 容器 app 使用 NEAppPushManager 类别的一个实例来创建一个配置这个配置主要由应该运行本地推送连接的 Wi-Fi 网络组成你可以使用此类别载入、保存和删除一个配置如果你在执行 VoIP app NEAppPushManager 也会被用来设置一个委托来处理 VoIP 来电你的 app 扩展执行 NEAppPushProvider 类别的一个子类别这个类别决定了你在你的子类别里必须覆盖的生命周期管理方法当 app 扩展被开启和停止时系统会调用这些方法当设备加入指定 Wi-Fi 网络时 app 扩展就被启动了当设备和指定 Wi-Fi 网络断开连接系统会停止 app 扩展 app 扩展开启时会和其服务商服务器建立网络连接并在停止时断开连接一收到 VoIP 通知 app 扩展使用该类别向系统报告此来电系统对此做出回应唤醒容器 app 并把来电信息传递给它现在我们来看看 app 如何使用 NEAppPushManager 类别来创建配置你需要导入 NetworkExtension 模块来使用本地推送连接 API
为你的 app 推送服务商创建配置非常简单
你需要创建 NEAppPushManager 类别的一个实例并用它来设置属性 matchSSIDs 明确指定了你希望开启本地推送连接的 Wi-Fi 网络的 SSID 的一个区域
providerBundleIdentifier 是 app 扩展的包标示符此设置让系统在需要时运行恰当的 app 扩展
providerConfiguration 是为 app 扩展指定配置数据的代码字典
最后你需要设置 isEnabled 为”真“ 来使用该配置启动本地推送连接
在你把所有设置配置好后调用 saveToPreferences 办法来处理该配置如果该配置成功保存并启动了系统会使用该配置启动本地推送连接 app 扩展执行 NEAppPushProvider 类别的子类别并覆盖所需方法
系统调用 startwithcompletionHandler 来启动 app 扩展在这个方法中 app 扩展和其服务器建立一个网络连接当停止使用 app 扩展时系统调用 stopwithreason 在这个方法中 app 扩展断开与服务器的连接收到 VoIP 通知时 app 扩展调用 reportIncomingCall 来向系统报告这个 VoIP 来电系统对此做出回应如果容器 app 没有在运行系统会唤醒它并把来电信息传递给它正如上一页幻灯片所展示的那样 app 扩展负责向系统报告 VoIP 来电系统做出回应启动该 app 容器 app 必须执行 app 委托对象遵循 UIApplicationDelegate 协议以确保知道 app 进程何时启动的 app 启动时你必须调用 loadAllFromPreferences 来载入所有已保存的配置并为每个 NEAppPushManager 实例设置 NEAppPushDelegate 对象就像这里展示的那样
系统把用户信息代码字典传递给容器 app 办法就是为 app 主队列上适当的 NEAppPushManager 实例调用 didReceiveIncomingCallWithUser Info 委托方法一收到用户信息 app 必须使用适当的 CallKit API 把来电报告给 CallKit 并让它显示来电用户界面请大家查看 CallKit API 说明文档来获取报告来电的细节还请大家查阅 SimplePush 示例 app 来获取更多细节请注意为了接收来电信息你的容器 app 必须在 Xcode 项目功能面板里启动 VoIP 后台模式就像这里展示的那样现在大家了解了关于 iOS 14 里引入的新本地推送连接 API 的详细内容我们来讲一下要在你的 app 使用推送接下来该采取的几个步骤
对于 app 里绝大部分一般性的推送通知要求你该首选 PushKit 或 UserNotifications 框架
只有在 APNs 连接不可用并且通知对你的用户非常必要的网络条件下你才应该使用本地推送连接
如果你认定本地推送连接对于你的 app 用户是最佳解决方法记住你必须请求 NEAppPushProvider 授权来使用本地推送连接 API 欢迎大家的观看

import NetworkExtension

let manager = NEAppPushManager()
manager.matchSSIDs = [ "Cruise Ship Wi-Fi", "Cruise Ship Staff Wi-Fi" ]
manager.providerBundleIdentifier = "com.myexample.SimplePush.Provider"
manager.providerConfiguration = [ "host": "cruiseship.example.com" ]
manager.isEnabled = true

manager.saveToPreferences { (error) in
    if let error = error {
        // Handle error
        return
    }
    // Report success
}

11:11 - App Extension life cycle management and reporting VoIP call

// Manage App Extension life cycle and report VoIP call 

class SimplePushProvider: NEAppPushProvider {

    override func start(completionHandler: @escaping (Error?) -> Void) {
        // Connect to your provider server       
        completionHandler(nil)
    }

    override func stop(with reason: NEProviderStopReason,
                                   completionHandler: @escaping () -> Void) {
        // Disconnect your provider server
        completionHandler()
    }
    
    func handleIncomingVoIPCall(callInfo: [AnyHashable : Any]) {
        reportIncomingCall(userInfo: callInfo)
    }
}

11:57 - Handling incoming VoIP call in the containing app

class AppDelegate: UIResponder, UIApplicationDelegate, NEAppPushDelegate {
    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions:       
                     [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        NEAppPushManager.loadAllFromPreferences { (managers, error) in
            // Handle non-nil error
            for manager in managers {
                manager.delegate = self
            }
        }
        return true
    }
    
    func appPushManager(_ manager: NEAppPushManager,
                didReceiveIncomingCallWithUserInfo userInfo: [AnyHashable: Any] = [:]) {
        // Report incoming call to CallKit and let it display call UI
    }
}

正在查找特定内容？在上方输入一个主题，就能直接跳转到相应的精彩内容。

提交你查询的内容时出现错误。请检查互联网连接，然后再试一次。

为受限网络 创建本地推送连接

资源