ios widget开发

1.证书配置:http://blog.csdn.net/songchunmin_/article/details/51316806

2.编码阶段:http://blog.csdn.net/songchunmin_/article/details/51291752

3.官方文档:https://developer.apple.com/library/content/documentation/General/Conceptual/ExtensibilityPG/Today.html

4.国外有篇比较好的文档:https://www.appcoda.com/app-extension-programming-today/

5.widget几个常用功能的实现:http://www.jianshu.com/p/9b3d06236d19

术语:

主项目:往已有的A项目里添加widget,那么A是主项目

 

Start~

环境搭建

1.苹果后台配置证书,下载Provisioning Profiles文件,得到4个Provisioning Profiles文件(主项目和widget分别有两个:dev的和release的)。

注意widget项目和主项目其实是两个独立的appID,而通过app group来相互交互。

2.对于主项目的配置:

(1)选择新的pro证书

(2)打开targets-->Capabilities-->App Groups 选项,然后选择后台配置的group:

3.添加widget项目。

 

 

将Bundle Identifier改为和苹果后台配置的appid一样。并且注意当时命名的时候,必须遵循如下规则:前缀要包括主项目的Bundle Identifier。后缀不能是widget关键字(。。。这里很坑,试了很多次)。然后因为我的XCode并没有配置开发者账号,所以将Automatically manage singing的对勾去掉(反正证书文件都下载给你了)。

然后选择好Provisioning Profile文件,dev和release的。当前页的error就都应该消失了。

将Build Setting里的签名设置好:

 

如果当时在苹果后台配置证书的时候,deviceid都加上了你的手机,那么直接真机运行,就可以在手机上看到一个“Hello World”的widget。

第一次运行,可能看到左上角名字是WIDGET,这个有点延迟,第二次就可以看到是“宝宝树小时光”。

业务逻辑实现

1.纯代码实现布局:

通过以上步骤,添加的widget项目,使用的是Storyboard作为布局。使用纯代码需要:

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

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

2.TodayViewController生命周期:

经过测试:基本上超过2秒,widget元素在屏幕上消失(手机没有停留在widget页面或者停留在widget页面,没有滑动到自己项目的widget),widget再次出现的时候,都会重新调用ViewDidLoad。而短时间的消失再出现,不会执行ViewDidLoad而是执行ViewWillAppear。所以如果不进行处理,每次widget出现,就请求数据的话,即时两次数据相同也会闪一下(知乎),想不闪可以把数据缓存,每次widget出现都加在缓存数据,并且发送请求,请求回的数据和当前展示数据做对比,如果一样,则不用刷新列表,如果不一样则刷新列表。然后缓存的机制,因为一般请求的数据都是json,可以解析成dic对象,使用plist进行缓存,比较方便。

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

- (void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize {
    if (activeDisplayMode == NCWidgetDisplayModeCompact) {
        self.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 105);
    } else {
        self.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 495);
    }
}

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

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

使用第三方库,我的项目里暂时没有遇到这种需求,但是通过pods维护第三方库的时候,Podfile文件会指定每个第三方库要加入的target,那么在widget的target中,加上要使用的第三方库,应该就可以,可以自己试试。

5.数据共享

widget项目必然经常要和主项目共享数据,可以通过NSUserDefault,注意和平时用有些不同,创建UserDefault的时候,要指定groupid。上代码:

// widget项目里取数据

+ (NSString *)widgetStringForKey:(NSString *)defaultName {
    NSUserDefaults *shared = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.appname"];
    return [shared stringForKey:defaultName];
}

 

// 主项目里存数据

+ (void)widgetSetObject:(id)value forKey:(NSString *)defaultName {
    NSUserDefaults *shared = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.appname"];
    [shared setObject:value forKey:defaultName];
    [shared synchronize];
}

 还有通过NSFileManager数据共享的方式,项目里没有用到,可以自己查阅资料试一试。

6.唤起主项目

通过URL Schemes的方式:

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

(2)在需要唤起主项目的地方:

NSString *schemeString = [NSString stringWithFormat:@"HMWidget://jumptab?number=%@",[NSString encodeBase64String:@"3"]];
    [self.extensionContext openURL:[NSURL URLWithString:schemeString] completionHandler:^(BOOL success) {
    }];

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

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
    if ([url.description hasPrefix:@"HMWidget://"]) {
        if (![HMUser isLogin]) {
            return YES;
        }
        return [HMSchemeUrlRouter handleScheme:url.description withAppDelegate:self];
    }
}

 

posted @ 2016-11-02 12:11  张驰小方块  阅读(4636)  评论(4编辑  收藏  举报