分享扩展
注:此教程来源于http://www.raywenderlich.com的《iOS8 by Tutorials》
1.准备
这次例子来源于国外的图片分享网站Imgur.com
首先现在Imgur上注册你的帐号,之后按下面的步骤来,点击settings
选择applications中新建app,即下面的create your own,这里上面的App是我得Demo
之后点击register注册你的应用
输入你App的名字后选择第二项,后面输入你的邮箱与面述,点击submit
这里请记好App的Client ID和Client secret
到此,即注册App成功,可以在你的App中调用Imgur的API
2.设置分享扩展前
首先打开源码JMImgure_original,这是我还未设置分享扩展的源码,你可以自己将下面过程全部演练一遍,但前提是你需要将警告处的Group ID与Client ID更改为你自己的,
否则会报错!!!
你需要新建你自己的Group ID需要注意的地方如下:
以及下面的源码部分:
1 //AppDelegate.m
2 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
3 // Override point for customization after application launch.
4 #warning 在这里设置成你的CLIENT ID
5 [RWTImgurService setClientId:@"CLIENT ID"];
6
7 [[UITabBar appearance] setTintColor:[UIColor imgvueGreen]];
8 [[UINavigationBar appearance] setTintColor:[UIColor imgvueGreen]];
9 [[UIProgressView appearance] setTintColor:[UIColor imgvueGreen]];
10
11 return YES;
12 }
13
14 //RWTSavedImageService.m
15 - (NSURL *)URLForDirectoryWithName:(NSString *)name {
16 #warning 在这里设置你的APP GROUP ID
17 NSURL *containerURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:@"group.qq100858433.JMImgvue"];
18 containerURL = [containerURL URLByAppendingPathComponent:name];
19
20 if (![[NSFileManager defaultManager] fileExistsAtPath:containerURL.path]) {
21 [[NSFileManager defaultManager] createDirectoryAtURL:containerURL withIntermediateDirectories:NO attributes:nil error:nil];
22 }
23
24 return containerURL;
25 }
3.正文
如果已经可以正常运行,那么就可以进行分享扩展的设置
首先依然是添加Share Extension
接下来输入App分享的名字后点击Finish,点击Activate,之后为分享扩展也设置App Groups
下面我们来看share文件夹下面的Info文件中的NSExtension项,系统默认如下
需要关心的是NSExtensionActivationRule,Apple默认设置为TRUEPREDICATE,意思就是这个扩展将一直有效,这方便与开发,但是实际中Apple不允许这个值默认如此,App扩展最基本的要求就是轻量,因此如果你直接默认的话,提交到App Store是不会过审的,在这里我们做这样的修改
意思是每次选择的附件只能选一个,这里就设置一处即可,更多关于NSExtension请点击此处:
App Extension Keys
接下来进行扩展的实现,Apple默认提供的类为SLComposeServiceViewController,它做出来与Sina微博类似
直接使用即可,在对SharViewController编程前,由于我们要使用原有的头文件和第三方库,所以将cocoapods的Podfile文件做如下更改,增加你建的扩展项目
1 # Uncomment this line to define a global platform for your project
2 # platform :ios, '6.0'
3 inhibit_all_warnings!
4
5 target 'JMImgure' do
6
7 pod 'SDWebImage'
8 pod 'AFNetworking'
9
10 end
11
12 target 'JMImgure Share' do
13
14 pod 'SDWebImage'
15 pod 'AFNetworking'
16
17 end
之后在命令行重新运行pod install即可,下面是更改后的ShareViewController.m,有注释说明
1 //
2 // ShareViewController.m
3 // JMImgure Share
4 //
5 // Created by JackMa on 15/11/29.
6 // Copyright © 2015年 JackMa. All rights reserved.
7 //
8
9 #import <MobileCoreServices/MobileCoreServices.h>
10 #import "ShareViewController.h"
11
12 @interface ShareViewController ()
13
14 @property (nonatomic, strong) UIImage *image;
15
16 @end
17
18 @implementation ShareViewController
19
20 - (void)viewDidLoad {
21 //获取inputItems,在这里itemProvider是你要分享的图片
22 NSExtensionItem *firstItem = self.extensionContext.inputItems.firstObject;
23 NSItemProvider *itemProvider;
24 if (firstItem) {
25 itemProvider = firstItem.attachments.firstObject;
26 }
27
28 //这里的kUTTypeImage代指@"public.image",也就是从相册获取的图片类型
29 //这里的kUTTypeURL代指网站链接,如在Safari中打开,则应该拷贝保存当前网页的链接
30 if ([itemProvider hasItemConformingToTypeIdentifier:(NSString *)kUTTypeURL]) {
31 [itemProvider loadItemForTypeIdentifier:(NSString *)kUTTypeURL options:nil completionHandler:^(id<NSSecureCoding> _Nullable item, NSError * _Null_unspecified error) {
32 if (!error) {
33 //对itemProvider夹带着的URL进行解析
34 NSURL *url = (NSURL *)item;
35 [UIPasteboard generalPasteboard].URL = url;
36 }
37 }];
38 }
39 if ([itemProvider hasItemConformingToTypeIdentifier:(NSString *)kUTTypeImage]) {
40 [itemProvider loadItemForTypeIdentifier:(NSString *)kUTTypeImage options:nil completionHandler:^(id<NSSecureCoding> _Nullable item, NSError * _Null_unspecified error) {
41 if (!error) {
42 //对itemProvider夹带着的图片进行解析
43 NSURL *url = (NSURL *)item;
44 NSData *imageData = [NSData dataWithContentsOfURL:url];
45 self.image = [UIImage imageWithData:imageData];
46 }
47 }];
48 }
49 }
50
51 //设置Post是否有效,当你每次输入内容的时候,都会调用此方法
52 - (BOOL)isContentValid {
53 if (self.image) {
54 return YES;
55 } else {
56 return NO;
57 }
58 }
59
60 //设置点击Post后的动作
61 - (void)didSelectPost {
62 [self shareImage];
63 }
64
65 //在这里设置弹出sheet的底部,要求用SLComposeSheetConfigurationItem的对象
66 - (NSArray *)configurationItems {
67 SLComposeSheetConfigurationItem *configItem = [[SLComposeSheetConfigurationItem alloc] init];
68 configItem.title = @"链接将被拷贝到剪贴板";
69 return @[configItem];
70 }
71
72 - (void)shareImage {
73 //在这里写图片上传的代码
74 }
在运行时选择Photos后Run
至此,完成了分享扩展最基本的设置。
源码有原始版本(original)和设置好的share版本供参考