前言
我在通過UIDocumentInteractionController預覽和分享"史蒂夫?喬布斯傳"這篇文章中鼓择,詳細講了UIDocumentInteractionController
的用途和使用方法。而在iOS 6 SDK
中,蘋果提供了UIActivityViewController
來讓我們可以使用更多地服務碍侦。這篇文章,我就來介紹一下怎么通過UIActivityViewController
實現更多地服務隶糕。
簡介
打開UIActivityViewController
的API文檔瓷产,我們可以看到UIActivityViewController
的聲明。
NS_CLASS_AVAILABLE_IOS(6_0) __TVOS_PROHIBITED @interface UIActivityViewController : UIViewController
我們可以看出UIActivityViewController
是在iOS 6
開始支持的枚驻,同樣是不能在Apple TV的開發(fā)中使用濒旦。而且UIActivityViewController
是直接繼承UIViewController
的,這意味著我們需要自己來展示和解散視圖再登。
準備
我使用在UIDocumentInteractionController
測試中使用的Demo,GitHub地址是:ZSDocumentInteractionTest尔邓。然后添加一個新的Button作為UIActivityViewController
的觸發(fā)事件,運行程序霎冯,就可以看到下面的界面啦(過程自行想象铃拇,哈哈)
初始化
接著我們在Button的觸發(fā)方法里面開始操作UIActivityViewController
來提供服務。首先沈撞,我們需要初始化一個UIActivityViewController
的實例慷荔,UIActivityViewController
提供了一個初始化方法:
- (instancetype)initWithActivityItems:(NSArray *)activityItems applicationActivities:(nullable NSArray<__kindof UIActivity *> *)applicationActivities NS_DESIGNATED_INITIALIZER;
官方文檔對這倆個參數有詳細的解釋:
參數 | 描述 |
---|---|
activityItems | The array of data objects on which to perform the activity. The type of objects in the array is variable and dependent on the data your application manages. For example, the data might consist of one or more string or image objects representing the currently selected content. Instead of actual data objects, the objects in this array can be objects that adopt the UIActivityItemSource protocol, such as UIActivityItemProvider objects. Source and provider objects act as proxies for the corresponding data in situations where you do not want to provide that data until it is needed. Note that you should not resuse an activity view controller object that includes a UIActivityItemProvider object in its activityItems array.This array must not be nil and must contain at least one object. |
applicationActivities | An array of UIActivity objects representing the custom services that your application supports. This parameter may be nil. |
大概意思是這個方法接收倆個數組類型的參數,第一個數組內的對象代表的是我們想要操作的數據的一些表征,而且這個數組至少需要一個值显晶,比如我們PDF文檔的名稱贷岸,URL;第二個數組指定了泛型
磷雇,數組內的對象必須是UIActivity
類型的對象偿警,代表的是iOS系統(tǒng)支持的我們自定義的服務,關于這點我在后面自定義UIActivity服務
的內容中會講解唯笙,現在我們暫時置為nil
螟蒸。代碼如下:
- (IBAction)presentPDFActivityView:(id)sender {
UIActivityViewController *activity = [[UIActivityViewController alloc] initWithActivityItems:@[@"Steve Jobs by waiter lsaacson", [[NSBundle mainBundle] URLForResource:@"Steve" withExtension:@"pdf"]] applicationActivities:nil];
視圖展示
UIActivityViewController
是直接繼承UIViewController
的,看到這崩掘,你想象可以通過自己的需求來使用不同的方式展示UIActivityViewController
啦七嫌,然而事與愿違。
官方文檔中是這么說的: “When presenting the view controller, you must do so using the appropriate means for the current device. On iPad, you must present the view controller in a popover. On iPhone and iPod touch, you must present it modally”苞慢。 大概意思是說诵原,展示
UIActivityViewController
的時候需要根據當前的設備類型選擇合適的展示方式,在iPad設備上就必須在'popover'視圖里面展示挽放,在其他設備上绍赛,必須以模態(tài)視圖展示。
個人認為開發(fā)必須持懷疑和驗證的態(tài)度辑畦,所以我嘗試在一個UINavigationController
中push一個UIActivityController
,代碼如下:
- (IBAction)presentPDFActivityView:(id)sender {
UIActivityViewController *activity = [[UIActivityViewController alloc] initWithActivityItems:@[@"Steve Jobs by waiter lsaacson", [[NSBundle mainBundle] URLForResource:@"Steve" withExtension:@"pdf"]] applicationActivities:nil];
[self.navigationController pushViewController:activity animated:YES];
}
然后運行程序吗蚌,點擊Button,意料之中程序崩潰掉了纯出,給出我們的錯誤反饋是:
2015-12-31 15:03:03.733 ZSDocumentInteractionTest[9307:971136] *** Terminating app due to uncaught exception 'NSGenericException', reason: 'UIActivityViewController can only be used modally or as contentViewController in popover on iPad.'
*** First throw call stack:
(
0 CoreFoundation 0x0000000103197e65 __exceptionPreprocess + 165
1 libobjc.A.dylib 0x0000000102c10deb objc_exception_throw + 48
2 CoreFoundation 0x0000000103197d9d +[NSException raise:format:] + 205
3 UIKit 0x0000000103e68e55 -[UIActivityViewController viewDidAppear:] + 533
4 UIKit 0x00000001036e0949 -[UIViewController _setViewAppearState:isAnimating:] + 830
5 UIKit 0x00000001036e12cc -[UIViewController _endAppearanceTransition:] + 262
6 UIKit 0x000000010371bf63 -[UINavigationController navigationTransitionView:didEndTransition:fromView:toView:] + 1290
7 UIKit 0x0000000103711d24 __49-[UINavigationController _startCustomTransition:]_block_invoke + 233
8 UIKit 0x0000000103f4ad20 -[_UIViewControllerTransitionContext completeTransition:] + 101
9 UIKit 0x000000010352cfff __53-[_UINavigationParallaxTransition animateTransition:]_block_invoke95 + 834
10 UIKit 0x00000001035f1076 -[UIViewAnimationBlockDelegate _didEndBlockAnimation:finished:context:] + 644
11 UIKit 0x00000001035ce2af -[UIViewAnimationState sendDelegateAnimationDidStop:finished:] + 241
12 UIKit 0x00000001035ce65e -[UIViewAnimationState animationDidStop:finished:] + 80
13 QuartzCore 0x00000001070c2fa0 _ZN2CA5Layer23run_animation_callbacksEPv + 308
14 libdispatch.dylib 0x000000010589f49b _dispatch_client_callout + 8
15 libdispatch.dylib 0x00000001058872af _dispatch_main_queue_callback_4CF + 1738
16 CoreFoundation 0x00000001030f7d09 __CFRUNLOOP_IS_SERVICING_THE_MAIN_DISPATCH_QUEUE__ + 9
17 CoreFoundation 0x00000001030b92c9 __CFRunLoopRun + 2073
18 CoreFoundation 0x00000001030b8828 CFRunLoopRunSpecific + 488
19 GraphicsServices 0x0000000106954ad2 GSEventRunModal + 161
20 UIKit 0x0000000103544610 UIApplicationMain + 171
21 ZSDocumentInteractionTest 0x000000010270b6af main + 111
22 libdyld.dylib 0x00000001058d392d start + 1
)
libc++abi.dylib: terminating with uncaught exception of type NSException
(lldb)
我們看出錯誤說明是"UIActivityViewController can only be used modally or as contentViewController in popover on iPad."
因此我們需要更換一下展示方法褪测,在手機上已一個模態(tài)視圖的方式展示,而在iPad上則作為popover
的內容視圖展示潦刃。代碼如下:
- (IBAction)presentPDFActivityView:(id)sender {
UIActivityViewController *activity = [[UIActivityViewController alloc] initWithActivityItems:@[[[NSBundle mainBundle] URLForResource:@"Steve" withExtension:@"pdf"]] applicationActivities:@[[[ZSCustomActivity alloc] init]]];
activity.excludedActivityTypes = @[UIActivityTypeAirDrop];
// incorrect usage
// [self.navigationController pushViewController:activity animated:YES];
UIPopoverPresentationController *popover = activity.popoverPresentationController;
if (popover) {
popover.sourceView = self.activityButton;
popover.permittedArrowDirections = UIPopoverArrowDirectionUp;
}
[self presentViewController:activity animated:YES completion:NULL];
}
再次運行代碼,點擊Button懈叹,就可以看到下面的界面啦(完美展示)
然后我們就可以選擇服務來操作和分享史蒂夫?喬布斯傳
啦乖杠。
excludedActivityTypes
UIActivityViewController
相比于UIDocumentInteractionController
優(yōu)勢除了可以添加額外的自定義服務,它還提供了非常好的原生服務的定制化功能澄成。我們可以完全根據自己的需求胧洒,控制UIActivityViewController
提供的系統(tǒng)服務的顯示,比如我不想展示AirDrop
這個功能墨状,而這點在UIDocumentInteractionController
是做不到的城舞。想做到這一點靶端,就需要使用到UIActivityViewController
提供的一個屬性:
@property(nullable, nonatomic, copy) NSArray<NSString *> *excludedActivityTypes; // default is nil. activity types listed will not be displayed
正如注釋中提到的,excludedActivityTypes
這個屬性包含了所有不想在UIActivityViewController
中展示的Item服務。excludedActivityTypes
是一個字符串數組随闺,所包含的內容必須是系統(tǒng)提供的UIActivity
的activityType
字符串,而系統(tǒng)提供的字符串如下:
NSString *const UIActivityTypePostToFacebook;
NSString *const UIActivityTypePostToTwitter;
NSString *const UIActivityTypePostToWeibo;
NSString *const UIActivityTypeMessage;
NSString *const UIActivityTypeMail;
NSString *const UIActivityTypePrint;
NSString *const UIActivityTypeCopyToPasteboard;
NSString *const UIActivityTypeAssignToContact;
NSString *const UIActivityTypeSaveToCameraRoll;
NSString *const UIActivityTypeAddToReadingList;
NSString *const UIActivityTypePostToFlickr;
NSString *const UIActivityTypePostToVimeo;
NSString *const UIActivityTypePostToTencentWeibo;
NSString *const UIActivityTypeAirDrop;
如果我們不想展示AirDrop
功能,我們把UIActivityTypeAirDrop
添加到excludedActivityTypes
里面:
activity.excludedActivityTypes = @[UIActivityTypeAirDrop];
運行程序,點擊Button饼煞,我們可以看到下面的界面發(fā)生的變化。
自定義UIActivity服務
UIActivityViewController
相比于UIDocumentInteractionController
的最大優(yōu)勢就是UIActivityViewController
所提供的自定義服務诗越,我們可以通過UIActivity
在UIActivityViewController
上添加我們自定義的服務砖瞧。
官方文檔上對UIActivity有一段解釋,"This class must be subclassed before it can be used. The job of an activity object is to act on the data provided to it and to provide some meta information that iOS can display to the user. For more complex services, an activity object can also display a custom user interface and use it to gather additional information from the user."嚷狞。其大概意思是块促,UIActivity必須通過繼承來使用,它主要是操作給用戶展示的信息床未,而且還可以操作展示定制化的界面來獲取更多地數據信息竭翠。
現在我們打算自定義一個叫ZS Custom
的服務,所以我們創(chuàng)建一個ZSCustomActivity
得類來繼承UIActivity
即硼,除此之外逃片,我們必須重寫下面的幾個方法:
-
activityType
- (nullable NSString *)activityType; // default returns nil. subclass may override to return custom activity type that is reported to completion handler
這是用來標識自定義服務的一個字符串,而系統(tǒng)提供的服務的標識在上面我們已經提到了;為了迎合iOS SDK中的規(guī)范只酥,我給它返回一個
UIActivityTypeZSCustomMine
褥实,定義如下:NSString *const UIActivityTypeZSCustomMine = @"ZSCustomActivityMine"; - (NSString *)activityType { return UIActivityTypeZSCustomMine; }
-
activityTitle
- (nullable NSString *)activityTitle; // default returns nil. subclass must override and must return non-nil value
在
UIActivityViewController
中給用戶展示的服務的名稱,比如上面圖片中的"Copy"
,"Print"
,我們自定義的服務名稱為ZS Custom
:- (NSString *)activityTitle { //國際化 return NSLocalizedString(@"ZS Custom", @""); }
-
activityImage
- (nullable UIImage *)activityImage; // default returns nil. subclass must override and must return non-nil value
在
UIActivityViewController
中給用戶展示的服務的圖標裂允。關于這里的圖標损离,有非常嚴格的限制:- 首先是圖標的背景色,這里推薦最好的完全透明的背景色绝编。
官方文檔中是這么解釋的僻澎,"The alpha channel of the image is used as a mask to generate the final image that is presented to the user. Any color data in the image itself is ignored. Opaque pixels have a gradient applied to them and this gradient is then laid on top of a standard background. Thus, a completely opaque image would yield a gradient filled rectangle",意思大概是,在這里顏色數據會被忽略十饥,而透明圖層會被當做mask(蒙版圖層)窟勃,不透明的圖片會顯示成漸進色填充。
- 其次是圖標的尺寸逗堵,在不同的設備需要不同的尺寸秉氧,因此需要準備一套圖標。
Device | iOS Version | Icon Size(pt) |
---|---|---|
iPhone蜒秤、iPod Touch | iOS 6 | < 43x43 |
iPhone汁咏、iPod Touch | iOS 7+ | 60x60 |
iPad | iOS 6 | < 60x60 |
iPad | iOS 7+ | 76x76 |
Retina | All | @2x |
-
canPerformWithActivityItems:
- (BOOL)canPerformWithActivityItems:(NSArray *)activityItems; // override this to return availability of activity based on items. default returns NO
指定可以處理的數據類型,如果可以處理則返回
YES
-
prepareWithActivityItems:
- (void)prepareWithActivityItems:(NSArray *)activityItems; // override to extract items and set up your HI. default does nothing
在用戶選擇展示在
UIActivityViewController
中的自定義服務的圖標之后作媚,調用自定義服務處理方法之前的準備工作攘滩,都需要在這個方法中指定,比如可以根據數據展示一個界面來獲取用戶指定的額外數據信息 -
activityCategory
+ (UIActivityCategory)activityCategory NS_AVAILABLE_IOS(7_0); // default is UIActivityCategoryAction.
UIActivityViewController
中的服務分為了倆種纸泡,UIActivityCategoryAction
和UIActivityCategoryShare,``UIActivityCategoryAction
表示在最下面一欄的操作型服務,比如Copy
漂问、Print
;UIActivityCategoryShare
表示在中間一欄的分享型服務冒黑,比如一些社交軟件。 -
performActivity
- (void)performActivity; // if no view controller, this method is called. call activityDidFinish when done. default calls [self activityDidFinish:NO]
在用戶選擇展示在
UIActivityViewController
中的自定義服務的圖標之后勤哗,而且也調用了prepareWithActivityItems:
,就會調用這個方法執(zhí)行具體的服務操作
需要的方法都重寫好之后抡爹,運行程序,點擊Button芒划,就可以看到我們自定義的服務圖標顯示在了UIActivityViewController
中冬竟。
補充之AirDrop
前面一直提到AirDrop
,我們在這里額外補充一下AirDrop
的相關知識點。AirDrop
是在iOS 7
中提供的民逼,實現跨設備傳輸文檔的功能拼苍。AirDrop
的實現基于藍牙創(chuàng)建一種類似WIFI的”點對點網絡“笑诅,然后實現跨設備傳輸功能。
只是AirDrop
的傳輸是有限制的疮鲫,我們可以在我們的App中通過AirDrop
傳送內容吆你,卻不能實現通過AirDrop
接收內容,因為燕侠,蘋果把設備上通過AirDrop
接收到的內容都放到了自家App上者祖,比如僅僅傳送文字時,在接收設備上就會通過Notes
打開绢彤;如果傳送圖片七问,在接收設備上就會保存到Photos
應用中;通過URL傳送文件茫舶,在接收設備上就會通過Safari
打開烂瘫。
只要是有UIDocumentInteractionController
和UIActivityViewController
展示的地方,都可以展示AirDrop
功能奇适。關于AirDrop
如何連接設備,如何傳送芦鳍,可以到百度經驗找完美得教程嚷往。