iOS Widget扩展总结

iOS widget扩展功能最主要的目的是可快捷查看该App里面的某些功能，无需每次进入app才能查看。为app提供一个“小应用”。iOS widget扩展已经不是一个新鲜的技能了，最近公司对widget 有一个新的需求，为此也做了一下总结以便回顾。

widget扩展顾名思义就是在原有的项目上做一个扩展，所以首先需要有一个项目，创建项目对大家来说已经是一件非常简单的事情，在这里我就不演示。打开项目后

在项目的设置页面创建一个target扩展

widget扩展创建.png
创建扩展并指定名称.png

创建成功后该项目多了一个文件夹文件夹中多了三个文件

widget.png

值得注意的是widget扩展在iOS10之前是不能点击右上角的展开/折叠这个功能的。只有一个默认高度为110(220px)，通过3D touch drop app的应用图标时，显示的widget也只能显示高度为110(220px)。

如果需要有展开/折叠个功能的需要在viewDidLoad中指定

 if #available(iOSApplicationExtension 10.0, *) {
      self.extensionContext?.widgetLargestAvailableDisplayMode = .expanded
}

@available(iOS 10.0, *)
public enum NCWidgetDisplayMode : Int {
    case compact       // 固定高
    case expanded      // 可变高
}

widgetLargestAvailableDisplayMode 是一个枚举，有两种样式可以做选择。具体就要看该项目的实际需求，我这边指定的是可展开/折叠 这个模式。

当视图创建时或点击右上角视图高度发生改变时会触发( iOS 9前不可伸缩且固定高度为110 ，此方法只作用在iOS 9 以上的版本)

  @available(iOSApplicationExtension 10.0, *)
    func widgetActiveDisplayModeDidChange(_ activeDisplayMode: NCWidgetDisplayMode, withMaximumSize maxSize: CGSize) {
        if activeDisplayMode == .compact {
            self.preferredContentSize = CGSize(width: 0, height: 110);
            ...
        }else {
            self.preferredContentSize = CGSize(width: 0, height: 150);
            ...
        }
    }

self.preferredContentSize 该属性是设置该扩展的高度。在compact模式下高度为110，无论设置多高都为110.在expanded模式下可以指定你需要的高度，但是也并不是你想多高就多高.经测试最高只能显示一个屏幕完全展示的大小。

在项目中也想使用pod工具来集成第三方库，通过不同target来导入不同的框架

platform :ios, '7.0'
target 'widgetTest' do
pod 'AFNetworking', '~> 3.0.4'
pod 'SDWebImage', '~> 3.7.5'
pod 'MJExtension', '~> 3.0.13'
pod 'MJRefresh', '~> 3.1.12'
pod 'SWTableViewCell', '~>0.3.7'
pod 'JPush'
pod 'SocketRocket', '~> 0.5.1'

pod 'UMengUShare/UI'
pod 'UMengUShare/Social/WeChat'
pod 'UMengUShare/Social/QQ'
pod 'UMengAnalytics-NO-IDFA'
end

target 'TodayWidget' do
pod 'SocketRocket', '~> 0.5.1'
end

到了编辑我们的展示页面的时候了。依然还是可以使用纯代码、storyboard或者混编都可以，控件与我们app中的UIKit 是完全一样的，可根据具体的业务需求搭建你的视图。

在扩展中点击某个按钮打开app并跳到响应的位置。我们可以使用Schemes跳转。在扩展中对应位置加上

 let url = URL(string: "TodayWidget://Buy")
        self.extensionContext?.open(url! , completionHandler: { (bool) in
 })

回到主app中加上对应的TodayWidget

Schemes设置.png

在Appdelegate中实现

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    if ([url.absoluteString containsString:@"Buy"]){
       ....
    }
    return YES;
}

在开发过程中，我做了一件非常愚蠢的事情，在运行扩展的时候把断点加载回调openURL中，发现始终都进不了，调试了一天始终发现找不出原因，正打算通过其他方式来实现回调的时候，突然发觉app其实不在调试状态，调试的是扩展，可以看出，扩展调试的时候跟app是不会同时运行的，请不要在运行扩展的时候去调试app。

widget开发中，如果你很熟练的掌握app中各个控件的开发的话。其实没有任何难度。widget扩展中遵循的是NCWidgetProviding 协议。只要进去协议中浏览一遍，相信每个人都很快就能完成这个扩展功能。