1.證書(shū)配置: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.國(guó)外有篇比較好的文檔:https://www.appcoda.com/app-extension-programming-today/
5.widget幾個(gè)常用功能的實(shí)現(xiàn):http://www.itdecent.cn/p/9b3d06236d19
術(shù)語(yǔ):
主項(xiàng)目:往已有的A項(xiàng)目里添加widget,那么A是主項(xiàng)目
Start~
環(huán)境搭建
1.蘋果后臺(tái)配置證書(shū),下載Provisioning Profiles文件,得到4個(gè)Provisioning Profiles文件(主項(xiàng)目和widget分別有兩個(gè):dev的和release的)。

注意widget項(xiàng)目和主項(xiàng)目其實(shí)是兩個(gè)獨(dú)立的appID,而通過(guò)app group來(lái)相互交互。
2.對(duì)于主項(xiàng)目的配置:
(1)選擇新的pro證書(shū)
(2)打開(kāi)targets-->Capabilities-->App Groups 選項(xiàng),然后選擇后臺(tái)配置的group:

3.添加widget項(xiàng)目。



將Bundle
Identifier改為和蘋果后臺(tái)配置的appid一樣。并且注意當(dāng)時(shí)命名的時(shí)候,必須遵循如下規(guī)則:前綴要包括主項(xiàng)目的Bundle
Identifier。后綴不能是widget關(guān)鍵字(。。。這里很坑,試了很多次)。然后因?yàn)槲业腦Code并沒(méi)有配置開(kāi)發(fā)者賬號(hào),所以將Automatically
manage singing的對(duì)勾去掉(反正證書(shū)文件都下載給你了)。
然后選擇好Provisioning Profile文件,dev和release的。當(dāng)前頁(yè)的error就都應(yīng)該消失了。

將Build Setting里的簽名設(shè)置好:

如果當(dāng)時(shí)在蘋果后臺(tái)配置證書(shū)的時(shí)候,deviceid都加上了你的手機(jī),那么直接真機(jī)運(yùn)行,就可以在手機(jī)上看到一個(gè)“Hello World”的widget。

第一次運(yùn)行,可能看到左上角名字是WIDGET,這個(gè)有點(diǎn)延遲,第二次就可以看到是“寶寶樹(shù)小時(shí)光”。
業(yè)務(wù)邏輯實(shí)現(xiàn)
1.純代碼實(shí)現(xiàn)布局:
通過(guò)以上步驟,添加的widget項(xiàng)目,使用的是Storyboard作為布局。使用純代碼需要:
(1)刪除Storyboard文件,widget項(xiàng)目的plist,刪除NSExtensionMainStoryboard
(2)添加NSExtensionPrincipalClass字段 并設(shè)為TodayViewController

2.TodayViewController生命周期:
經(jīng)過(guò)測(cè)試:基本上超過(guò)2秒,widget元素在屏幕上消失(手機(jī)沒(méi)有停留在widget頁(yè)面或者停留在widget頁(yè)面,沒(méi)有滑動(dòng)到自己項(xiàng)目的widget),widget再次出現(xiàn)的時(shí)候,都會(huì)重新調(diào)用ViewDidLoad。而短時(shí)間的消失再出現(xiàn),不會(huì)執(zhí)行ViewDidLoad而是執(zhí)行ViewWillAppear。所以如果不進(jìn)行處理,每次widget出現(xiàn),就請(qǐng)求數(shù)據(jù)的話,即時(shí)兩次數(shù)據(jù)相同也會(huì)閃一下(知乎),想不閃可以把數(shù)據(jù)緩存,每次widget出現(xiàn)都加在緩存數(shù)據(jù),并且發(fā)送請(qǐng)求,請(qǐng)求回的數(shù)據(jù)和當(dāng)前展示數(shù)據(jù)做對(duì)比,如果一樣,則不用刷新列表,如果不一樣則刷新列表。然后緩存的機(jī)制,因?yàn)橐话阏?qǐng)求的數(shù)據(jù)都是json,可以解析成dic對(duì)象,使用plist進(jìn)行緩存,比較方便。
3.展開(kāi)/折疊,在這個(gè)系統(tǒng)方法中設(shè)置展開(kāi)、折疊的高度即可,但是好像不能主動(dòng)設(shè)置在什么情況下是展開(kāi)的,在什么情況下的折疊的,也就是說(shuō)不能代碼控制展開(kāi)還是折疊,只能是用戶點(diǎn)擊按鈕來(lái)展開(kāi)和折疊,蘋果沒(méi)有給出那么多的自由。
- (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.使用主項(xiàng)目的自定義類,以及第三方庫(kù):
widget開(kāi)發(fā)時(shí),肯定會(huì)遇到想使用主項(xiàng)目的類的情況,只需要將要使用的類的.m文件,多加上一個(gè)target,選擇widget項(xiàng)目即可。

使用第三方庫(kù),我的項(xiàng)目里暫時(shí)沒(méi)有遇到這種需求,但是通過(guò)pods維護(hù)第三方庫(kù)的時(shí)候,Podfile文件會(huì)指定每個(gè)第三方庫(kù)要加入的target,那么在widget的target中,加上要使用的第三方庫(kù),應(yīng)該就可以,可以自己試試。

5.數(shù)據(jù)共享
widget項(xiàng)目必然經(jīng)常要和主項(xiàng)目共享數(shù)據(jù),可以通過(guò)NSUserDefault,注意和平時(shí)用有些不同,創(chuàng)建UserDefault的時(shí)候,要指定groupid。上代碼:
// widget項(xiàng)目里取數(shù)據(jù)
+ (NSString*)widgetStringForKey:(NSString*)defaultName {
NSUserDefaults*shared = [[NSUserDefaultsalloc] initWithSuiteName:@"group.com.appname"];
return[shared stringForKey:defaultName];
}
// 主項(xiàng)目里存數(shù)據(jù)
+ (void)widgetSetObject:(id)value forKey:(NSString*)defaultName {
NSUserDefaults*shared = [[NSUserDefaultsalloc] initWithSuiteName:@"group.com.appname"];
[shared setObject:value forKey:defaultName];
[shared synchronize];
}
還有通過(guò)NSFileManager數(shù)據(jù)共享的方式,項(xiàng)目里沒(méi)有用到,可以自己查閱資料試一試。
6.喚起主項(xiàng)目
通過(guò)URL Schemes的方式:
(1)在主項(xiàng)目里配置一個(gè)對(duì)應(yīng)widget的URL。

(2)在需要喚起主項(xiàng)目的地方:
NSString*schemeString = [NSStringstringWithFormat:@"HMWidget://jumptab?number=%@",[NSStringencodeBase64String:@"3"]];
[self.extensionContext openURL:[NSURLURLWithString:schemeString] completionHandler:^(BOOLsuccess) {
}];
(3)在主項(xiàng)目appdelegate的代理方法中,截取URL,做處理:
- (BOOL)application:(UIApplication *)application openURL:(NSURL*)url sourceApplication:(NSString*)sourceApplication annotation:(id)annotation
{
if([url.description hasPrefix:@"HMWidget://"]) {
if(![HMUser isLogin]) {
returnYES;
}
return[HMSchemeUrlRouter handleScheme:url.description withAppDelegate:self];
}
}