【转】iOS Widget开发

在说widget开发前,先来了解下APP Extensions和App Groups:

一、关于App Extensions

extension是iOS8新开放的一种对几个固定系统区域的扩展机制,它可以在一定程度上弥补iOS的沙盒机制对应用间通信的限制。

extension的出现,为用户提供了在其它应用中使用我们应用提供的服务的便捷方式,比如用户可以在Today的widgets中查看应用展示的简略信息,而不用再进到我们的应用中,这将是一种全新的用户体验;但是extension的出现可能会减少用户启动应用的次数。

了解几个关键词

extension point:

系统中支持extension的区域,extension的类别也是据此区分的,iOS上共有Today、Share、Action、Photo Editing、Storage Provider等多种,其中Today中的extension又被称为widget。

每种extension point的使用方式和适合干的活都不一样,因此不存在通用的extension。

app extension:

extension并不是一个独立的app,它有一个包含在app bundle中的独立bundle,extension的bundle后缀名是.appex。其生命周期也和普通app不同(后文将会描述)。

extension不能单独存在,必须有一个包含它的containing app。

extension需要用户手动激活,不同的extension激活方式也不同,比如: 比如Today中的widget需要在Today中激活和关闭;

containing app:

尽管苹果开放了extension,但是在iOS中extension并不能单独存在,要想提交到AppStore,必须将extension包含在一个app中提交,并且app的实现部分不能为空,这个包含extension的app就叫containing app。

extension会随着containing app的安装而安装,同时随着containing app的卸载而卸载。

host app

能够调起extension的app被称为host app,比如widget的host app就是Today。

extension和containing app之间的关系:

1、不能直接通信:尽管extension的bundle是放在containing app的bundle中,但是他们是两个完全独立的进程,之间不能直接通信。不过extension可以通过openURL的方式启动containing app(当然也能启动其它app),不过必须通过extensionContext借助host app来实现:

  • (void)jumpToWidgetAPP:(UIButton *)sender {

[self.extensionContext openURL:[NSURL URLWithString:@"WidgetDemo://xxx"] completionHandler:^(BOOL success) {

NSLog(@"open url result: %d",success);

}];

}

2、可以共享资源数据:extension和containing app可以共同读写一个被称为Shared resources的存储区域,这是通过App Groups实现的,后文将会详述。

3、containing app能够控制extension的出现和隐藏:

让隐藏的插件重新显示YES/隐藏NO

[[NCWidgetController widgetController] setHasContent:YES forWidgetWithBundleIdentifier:@"com.w.app.extension"];

extension和containing app以及host app三者之间的关系:

image.png

三者之间的关系可以用官网的两张图片形象说明;

image.png

二、关于App Groups

App Groups是iOS8新开放的功能,在OS X上早就可用了,它主要用于同一group下的app共享同一份读写空间,以实现数据共享。extension和containing app共同读写一份数据是很合理的需求,比如系统的股市应用,widget和app中都需要展示几个公司的股票数据,这就可以通过App Groups实现。(如何开启以及使用App Groups下文会说明 )

三、widget开发过程:

接下来我们从环境搭建和业务逻辑实现两大方面来说一下widget开发的过程:(接下来的提到的主项目即为上面说到的containing app)

环境搭建:

1、添加widget项目

在APP中选择target-》 添加一个类型为Today Extension的工程,就是我们想要的widget;含有widget的app目录结构如下:

image.png

2、配置证书

由于widget项目和主项目其实是两个独立的appID,因为需要单独给widget配置证书,配置证书的过程参考APP证书配置;

3、开启APP Groups

开启APP Groups是为了widget和app之间实现数据共享;为了便于后续操作,请先确保你的开发者账号在Xcode上处于登录状态。

在app中开启

TARGETS-->AppExtensionDemo-->Capabilities-->App Groups

找到以后,将App Groups右上角的开关打开,然后选择添加groups,注意命名要规范,比如:group.com.company.app;

在extension中开启:假设创建widget target的名称为TodayExtension,对应的App Group位于

TARGETS-->TodayExtension-->Capabilities-->App Groups

开启的方式和APP中一样,注意必须要保证这里的App Groups名称和APP中相同。

业务逻辑实现:

搭建好开发环境后接下来主要从几个功能实现的角度来谈谈如何进行widget开发。

1、纯代码实现布局

widget项目默认是使用storyboard作为布局的,如果喜欢用纯代码实现布局,则需要做如下处理:

(1)删除Storyboard文件,并在widget项目的plist,删除NSExtensionMainStoryboard;

(2)添加NSExtensionPrincipalClass字段 并设为TodayViewController;

2、设置展开/折叠:

在系统提供的方法中设置widget展开/折叠的高度,即可实现widget的展开/折叠,但是不能主动设置在什么情况下是展开的,在什么情况下的折叠的,也就是说不能代码控制展开还是折叠,只能是用户点击按钮来展开和折叠,苹果没有给出那么多的自由。

image.png

3、共享数据

widget做为主项目的扩展,必然要经常和主项目共享数据,上面我们已经提到可以通过App Groups来进行数据共享,具体实现上主要有NSUserDefault和NSFileManager两种方式进行数据共享。

3.1 通过NSUserDefaults共享数据

image.png

主项目中存数据:通过以下方式向NSUserDefaults中保存数据:需要注意的是:

1、保存数据的时候必须指明group id;

2、而且要注意NSUserDefaults能够处理的数据只能是可plist化的对象,详情见Property List Programming Guide。

3、为了防止出现数据同步问题,不要忘记调用[shared synchronize];

image.png

widget项目中取数据 :对应的读取数据方式:

3.2 通过NSFileManager共享数据

主项目中存数据:

image.png

widget项目中取数据:

image.png

4、使用主项目的自定义类,以及第三方库

widget开发时,肯定会遇到想使用主项目的类的情况,只需要将要使用的类的.m文件,多加上一个target,选择widget项目即可。(如图)

image.png

使用主项目中的第三方库:

我们知道,通过pods维护第三方库的时候Podfile文件会指定每个第三方库要加入的target,因此Widget如果想使用第三方库,只需要在在widget的target中,加上要使用的第三方库即可;

target 'CSMBP-Widget' do

pod 'AFNetworking', '3.1.0'

end

5、唤起主项目

可以通过URL Schemes的方式从widget项目跳转到APP中;

image.png

(1)在主项目里配置一个对应widget的URL:

(2)在需要唤起主项目的地方通过self.extensionContext来实现跳转:

[self.extensionContext openURL:[NSURL URLWithString:@"WidgetDemo://xxx"] completionHandler:^(BOOL success) {

NSLog(@"open url result: %d",success);

}];

(3)在主项目appdelegate的openURL代理方法中,截取URL并做处理:

  • (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {

if ([url.description hasPrefix:@"WidgetDemo://"]) {

// 根据url处理具体跳转页面

}

return YES;

}

[官方链接](https://developer.apple.com/library/content/documentation/General/Conceptual/ExtensibilityPG/Today.html)

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,921评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,635评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,393评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,836评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,833评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,685评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,043评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,694评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,671评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,670评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,779评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,424评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,027评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,984评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,214评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,108评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,517评论 2 343

推荐阅读更多精彩内容