iOS 8 分享扩展

今天研究了下，iOS 8 的分享扩展，iOS 8 有好几个扩展，如下：

0.通知界面 Widget
1.分享扩展
2.Action
3.照片编辑扩展
4.资源存储扩展
5.自定义键盘

本文主要整理下分享扩展。

创建项目并添加分享扩展

0.新建一个项目，命名为YMShareDemo：

1.添加分享扩展

选择 Share Extentsion(分享扩展)

命名为 YMShareExtension：

选择 Finish，下图选择 Active：

OK，到这里，项目创建成功！

分享扩展 plist 文件

如下图所示，查看分享扩展的 plist 文件：

NSExtensionActivationSupportsAttachmentsWithMaxCount

向系统和其他应用程序指示自己的应用程序支持最多附件数量

NSExtensionActivationSupportsAttachmentsWithMinCount

向系统和其他应用程序指示自己的应用程序支持的最小附件数量

NSExtensionActivationSupportsFileWithMaxCount

向系统和其他应用程序指示自己的应用程序支持文件分享，数值是一个 Number 类型的，表示能分享的最多文件数量

NSExtensionActivationSupportsImageWithMaxCount

向系统和其他应用程序指示自己的应用程序支持图片分享，数值是一个 Number 类型的，表示能分享的最多图片数量

NSExtensionActivationSupportsMovieWithMaxCount

向系统和其他应用程序指示自己的应用程序支持视频分享，数值是一个 Number 类型的，表示能分享的最多视频数量

NSExtensionActivationSupportsText

向系统和其他应用程序指示自己的应用程序支持文本分享，数值是一个 Boolean 类型的，表示是否能分享文本

NSExtensionActivationSupportsWebURLWithMaxCount

向系统和其他应用程序指示自己的应用程序支持链接分享，数值是一个 Number 类型的，表示能分享的最多链接数量

NSExtensionActivationSupportsWebPageWithMaxCount

向系统和其他应用程序指示自己的应用程序支持网页分享，数值是一个 Number 类型的，表示能分享的最多网页数量

示例（支持 2 个图片、1 个视频、1 个链接并支持文本分享）：

分享扩展中的方法和属性

分享扩展控制器 ShareViewController，继承自SLComposeServiceViewController（UIViewController 的子类）。

除了 UIViewController 的标准方法外，SLComposeServiceViewController 还提供了一些与分享功能生命周期相关的属性和方法：

0. -(void) presentationAnimationDidFinish

在这个方法里，我们可以获得，要分享的图片、视频、链接等内容

示例(获取图片、视频、链接)：

- (void) presentationAnimationDidFinish
{
    for (NSExtensionItem *item in self.extensionContext.inputItems) {
        for (NSItemProvider *itemProvider in item.attachments) {
            dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT,0), ^{
                if ([itemProvider hasItemConformingToTypeIdentifier:(NSString *) kUTTypeURL]) {//URL地址
                    [itemProvider loadItemForTypeIdentifier:(NSString *)kUTTypeURL options:nil completionHandler:^(NSURL *URL, NSError *error) {
                            dispatch_async(dispatch_get_main_queue(), ^{
                                NSLog(@"URL:%@",URL);
                            });
                    }];
                }else if([itemProvider hasItemConformingToTypeIdentifier:(NSString *)kUTTypeImage]){//图片
                    [itemProvider loadItemForTypeIdentifier:(NSString *)kUTTypeImage options:nil completionHandler:^(UIImage *image, NSError *error) {
                            dispatch_async(dispatch_get_main_queue(), ^{
                                NSLog(@"图片:%@",image);
                            });
                    }];
                }else if([itemProvider hasItemConformingToTypeIdentifier:(NSString *)kUTTypeMovie]){//视频
                    [itemProvider loadItemForTypeIdentifier:(NSString *)kUTTypeMovie options:nil completionHandler:^(NSURL *path,NSError *error){
                        if (path){
                            dispatch_async(dispatch_get_main_queue(), ^{
                                NSLog(@"视频地址:%@",path);
                            });
                        }
                    }];
                }
            });
        }
    }
}

1.contentText

NSString 类型属性，是分享文本框内的文字

示例（获取分享文本框内文字）：

self.contentText

2. -(void) didSelectPost

点击Post按钮时触发

3. -(void) didSelectCancel

点击Cancel按钮时触发。

4. -(BOOL) isContentValid

编辑框文字变化时触发。

示例（只能在分享文本框内输入140字）：

- (BOOL)isContentValid {
    NSInteger messageLength = [[self.contentText stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceCharacterSet]] length];
    NSInteger charactersRemaining = 140 - messageLength;
    self.charactersRemaining = @(charactersRemaining);

    if (charactersRemaining >= 0) {
        return YES;
    }

    // Do validation of contentText and/or NSExtensionContext attachments here
    return YES;
}

5. charactersRemaining

Int类型属性，表示分享文本框还能填写的字数，如果超出字数，该属性展示的字数会变红，并用负数表示已经超出了多少字数。

具体用法可以参照上方-(BOOL) isContentValid

实战

未完成

注意及遇到的问题

0.如果想要调试的话，需要选择第三方应用 如 Safari 、照片应用测试，如下图：

1.本来想使用 AFNetworking 作为网络库来上传图片数据，但是不知道什么原因，不能在扩展中使用，至今不知道啥原因，还需研究下。
2.如果想要自定义分享视图，如Tumblr、微信：

官方文档上说：

不过貌似已经取消了，需要将ShareViewController : SLComposeServiceViewController转变为ShareViewController : UIViewController，详见stackoverflow上的回复

参考文章

苹果官方文档 1
苹果官方文档 2