iOS小组件widget基本功能

创建

在当前工程里新建target

选择Today Extension

独立应用

widget虽做为应用的扩展, 但却是两个完全独立的应用

widget上线需要单独申请 AppID 和 Bundle Identifier , 需要配置 证书 和 Provisioning Profiles(配置文件)

第三方pod导入, 也的重新导入一份

target 'MMWidget' do
  pod 'Masonry'
end

target 'widgetDemo' do
  pod 'Masonry'
end

使用到的文件需要导入:

或者这样:

页面实现

默认是storyboard实现页面, 若想使用代码实现需对widget的配置文件进行修改:

	<key>NSExtension</key>
	<dict>
<!--  storyboard 实现  -->
    <key>NSExtensionMainStoryboard</key>
    <string>MainInterface</string>
    
<!--  纯代码 实现  -->
    <key>NSExtensionPrincipalClass</key>
    <string>TodayViewController</string>

		<key>NSExtensionPointIdentifier</key>
		<string>com.apple.widget-extension</string>

	</dict>

以上俩key保留一个就好.

打开应用

创建URL Schemes:

- (void)openApp {
  [self.extensionContext openURL:[NSURL URLWithString:@"wenwen://"] completionHandler:^(BOOL success) {
    NSLog(@"open url result: %d",success);
  }];
}

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary *)options {
  if ([url.scheme isEqualToString:@"wenwen"]) {
    return YES;
  }
}

展开/折叠

- (void)viewDidLoad {
  [super viewDidLoad];
  // iOS10 later support
  if (@available(iOS 10.0, *)) {
    self.extensionContext.widgetLargestAvailableDisplayMode = NCWidgetDisplayModeExpanded;
    self.preferredContentSize = CGSizeMake(0, 110);
  }
}

#pragma mark - 点击 展开/折叠
- (void)widgetActiveDisplayModeDidChange:(NCWidgetDisplayMode)activeDisplayMode withMaximumSize:(CGSize)maxSize {
  if (activeDisplayMode == NCWidgetDisplayModeCompact) {
    self.preferredContentSize = CGSizeMake(0, 110);
  } else {
    // 最多显示屏高
    self.preferredContentSize = CGSizeMake(0, 1000);
  }
}

数据共享

1.在开发者网站注册App Groups

2. 在主应用和拓展应用中将App Groups打开, 选中需要共享数据的group

3. 共享数据的两种方式

(1)NSUserDefaults 因拓展App无法访问主App的沙盒文件, 所以需要搭配App groups实例化UserDefaults

NSUserDefaults *userDefault = [[NSUserDefaults alloc] initWithSuiteName:@"group.momo.widget"];

// 存
[userDefault setValue:@"momo" forKey:@"key"];

// 取
label.text = [NSString stringWithFormat:@"%@", [userDefauct valueForKey:@"key"]];

(2)FileManager

  NSURL *containerURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"group.momo.widget"];
  containerURL = [containerURL URLByAppendingPathComponent:@"Library/Caches/widget"];
  
  NSError *error = nil;
  // 写入
  BOOL result = [string writeToURL:containerURL atomically:YES encoding:NSUTF8StringEncoding error:&error];
  if (result) {
    NSLog(@"写入成功");
  } else {
    NSLog(@"写入失败 %@", error.description);
  }

    
  // 读取
  NSString *string = [NSString stringWithContentsOfURL:containerURL encoding:NSUTF8StringEncoding error:&error];
  if (error) {
    NSLog(@"读取失败 %@", error.description);
  } else {
    NSLog(@"读取成功");
  }

Demo下载地址

我们的项目widget数据分析失败, 最后找到原因, 是因为项目里有俩entitlements文件, 需要配置