
UIImagePickerController 是 iOS 自帶的系統相冊選擇器,接入起來非常簡便。
UIImagePickerController *imagePickerController = [[UIImagePickerController alloc] init]; // 設定 sourceType 為系統相冊,若使用相機請對應修改該屬性 imagePickerController.sourceType = UIImagePickerControllerSourceTypePhotoLibrary; imagePickerController.allowsEditing = YES; imagePickerController.delegate = self; [self presentViewController:imagePickerController animated:YES completion:nil];
要注意的是,UIImagePickerController 本身繼承自 UINavigationController,因此不能簡單地把它當成一個 UIViewController 看待。它實作了 UINavigationControllerDelegate 與 UIImagePickerControllerDelegate 協議,內部包含三個由 ViewController 組成的導航堆疊。列印它的 viewControllers 就能看出來:
(lldb) po [picker viewControllers] // 輸出(因識別問題,此處以方括號代替尖括號) // ( // [PUUIAlbumListViewController: 0x14609a200], // [PUUIPhotosAlbumViewController: 0x1458e5a00], // [PUUIImageViewController: 0x1468f1ad0] // )
該協議有三個代理方法:
__TVOS_PROHIBITED @protocol UIImagePickerControllerDelegate [NSObject] @optional // The picker does not dismiss itself; the client dismisses it in these callbacks. // The delegate will receive one or the other, but not both, depending on whether the user // confirms or cancels. - (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingImage:(UIImage *)image editingInfo:(nullable NSDictionary *)editingInfo NS_DEPRECATED_IOS(2_0, 3_0); - (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info; - (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker;
其中 info 字典包含所選照片的基本資訊,鍵值如下:
// info dictionary keys UIKIT_EXTERN NSString *const UIImagePickerControllerMediaType __TVOS_PROHIBITED; // an NSString (UTI, i.e. kUTTypeImage) UIKIT_EXTERN NSString *const UIImagePickerControllerOriginalImage __TVOS_PROHIBITED; // a UIImage UIKIT_EXTERN NSString *const UIImagePickerControllerEditedImage __TVOS_PROHIBITED; // a UIImage UIKIT_EXTERN NSString *const UIImagePickerControllerCropRect __TVOS_PROHIBITED; // an NSValue (CGRect) UIKIT_EXTERN NSString *const UIImagePickerControllerMediaURL __TVOS_PROHIBITED; // an NSURL UIKIT_EXTERN NSString *const UIImagePickerControllerReferenceURL NS_AVAILABLE_IOS(4_1) __TVOS_PROHIBITED; // an NSURL that references an asset in the AssetsLibrary framework UIKIT_EXTERN NSString *const UIImagePickerControllerMediaMetadata NS_AVAILABLE_IOS(4_1) __TVOS_PROHIBITED; // an NSDictionary containing metadata from a captured photo UIKIT_EXTERN NSString *const UIImagePickerControllerLivePhoto NS_AVAILABLE_IOS(9_1) __TVOS_PROHIBITED; // a PHLivePhoto
使用者在系統相冊中選好照片後,會觸發 imagePickerController:didFinishPickingMediaWithInfo:,我們可以在其中對照片做進一步處理,例如寫入相冊:
- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info {
UIImage *originalImage = info[UIImagePickerControllerOriginalImage];
UIImage *editedImage = info[UIImagePickerControllerEditedImage];
UIImage *savedImage = editedImage ?: originalImage;
if (picker.sourceType == UIImagePickerControllerSourceTypeCamera) {
UIImageWriteToSavedPhotosAlbum(savedImage, nil, nil, nil);
}
__weak ViewController *weakSelf = self;
[picker dismissViewControllerAnimated:YES completion:^{
weakSelf.imageView.image = savedImage;
}];
}請注意:UIImagePickerController 自身不會 dismiss,必須由我們主動呼叫,並透過回調把照片做相應處理。上面的程式碼就是在 picker dismiss 之後,把照片放進 UIImageView。
建立一個 UIViewController,繼承自 UIImagePickerController 並實作相關協議方法,就能得到一個自定義相冊選擇器——不過本質上仍然只是對 UIImagePickerController 做了一次包裝。
Demo 參考:https://github.com/icetime17/Playground/tree/master/DemoUIImagePicker
另外,也可以使用 PhotoKit 框架搭配 UICollectionView,實作真正意義上的自定義相冊。
參考部落格:iOS--使用 PhotoKit 代替 ALAssetsLibrary 來管理相冊資源
3D Touch 是 iPhone 6s / 6s Plus 才具備的能力。在系統相冊中長按某張照片,會觸發 3D Touch 相關操作。而在不支援 3D Touch 的裝置上執行同樣的長按手勢,卻會直接 crash——這看起來像是 iOS 系統的一個 bug。
原因在於:觸發 3D Touch 操作後,PUPhotosGridViewController 的 previewingContext:viewControllerForLocation: 未實作,於是崩潰。
解決方法:使用 runtime 做 method swizzling,在執行期把該方法替換掉。
利用 runtime 實作 method swizzling;
核心 API 是 method_exchangeImplementations(originalMethod, replacementMethod);
先封裝一個通用的 swizzling 方法:
- (void)replaceSelectorForClass:(Class)cls
SelectorOriginal:(SEL)original
SelectorReplace:(SEL)replacement
withBlock:(id)block {
IMP implementation = imp_implementationWithBlock(block);
Method originalMethod = class_getInstanceMethod(cls, original);
class_addMethod(cls, replacement, implementation, method_getTypeEncoding(originalMethod));
Method replacementMethod = class_getInstanceMethod(cls, replacement);
if (class_addMethod(cls, original, method_getImplementation(replacementMethod), method_getTypeEncoding(replacementMethod))) {
class_replaceMethod(cls, replacement, method_getImplementation(originalMethod), method_getTypeEncoding(originalMethod));
} else {
method_exchangeImplementations(originalMethod, replacementMethod);
}
}接著在 AppDelegate 的 application:didFinishLaunchingWithOptions: 中進行 swizzling:
- (void)preventImagePickerCrashOn3DTouch {
// Load PhotosUI and bail if 3D Touch is unavailable.
// (UIViewControllerPreviewing may be redundant, as PUPhotosGridViewController only seems to exist on iOS 9,
// but I'm being cautious.)
NSString *photosUIPath = @"/System/Library/Frameworks/PhotosUI.framework";
NSBundle *photosUI = [NSBundle bundleWithPath:photosUIPath];
Class photosClass = [photosUI classNamed:@"PUPhotosGridViewController"];
if (!(photosClass && objc_getProtocol("UIViewControllerPreviewing"))) {
return;
}
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wundeclared-selector"
SEL selector = @selector(ab_previewingContext:viewControllerForLocation:);
[self replaceSelectorForClass:photosClass
SelectorOriginal:@selector(previewingContext:viewControllerForLocation:)
SelectorReplace:selector
withBlock:^UIViewController *(id self, id previewingContext, CGPoint location) {
// Default implementation throws on iOS 9.0 and 9.1.
@try {
MTLog(@"Replace method at runtime to prevent UIImagePicker crash on 3D Touch.");
return ((UIViewController *(*)(id, SEL, id, CGPoint))objc_msgSend)(self, selector, previewingContext, location);
} @catch (NSException *e) {
return nil;
}
}];
#pragma clang diagnostic pop
}這樣一來,3D Touch 導致系統 UIImagePickerController 崩潰的問題就成功解決了。