iOS widget扩展功能最主要的目的是可快捷查看该App里面的某些功能,无需每次进入app才能查看。为app提供一个“小应用”。iOS widget扩展已经不是一个新鲜的技能了,最近公司对widget 有一个新的需求,为此也做了一下总结以便回顾。
widget扩展顾名思义就是在原有的项目上做一个扩展,所以首先需要有一个项目,创建项目对大家来说已经是一件非常简单的事情,在这里我就不演示。打开项目后
在项目的设置页面创建一个target扩展
创建成功后该项目多了一个文件夹文件夹中多了三个文件
值得注意的是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
在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 协议。只要进去协议中浏览一遍,相信每个人都很快就能完成这个扩展功能。