公司之前在新的版本中添加了3DTouch,今天就總結出來方面大家參考和查閱
一、3D Touch 的Quick Action實現
Quick Action有兩種方式:靜態和動態,靜態是在plist文件中申明,動態則是在代碼中注冊,系統支持兩者同時存在。但是系統限制每個app最多顯示4個快捷圖標,包括靜態和動態。
第一種方式動態添加入口標簽
-(BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
方法中實現添加和分享的入口,代碼如下 :
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 創建標簽的ICON圖標。
UIApplicationShortcutIcon *firstItemIcon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeAdd];
// 創建一個標簽,并配置相關屬性。
UIMutableApplicationShortcutItem *firstItem = [[UIMutableApplicationShortcutItem alloc]initWithType:@"First" localizedTitle:@"添加" localizedSubtitle:nil icon:firstItemIcon userInfo:nil];
UIApplicationShortcutIcon *secondItemIcon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeShare];
UIMutableApplicationShortcutItem *secondItem = [[UIMutableApplicationShortcutItem alloc]initWithType:@"Second" localizedTitle:@"分享" localizedSubtitle:nil icon:secondItemIcon userInfo:nil];
// 自定義創建標簽的ICON圖標。
UIApplicationShortcutIcon *thirdItemIcon = [UIApplicationShortcutIcon iconWithTemplateImageName:@""];
UIMutableApplicationShortcutItem *thirdItem = [[UIMutableApplicationShortcutItem alloc]initWithType:@"Third" localizedTitle:@"自定義" localizedSubtitle:nil icon:thirdItemIcon userInfo:nil];
application.shortcutItems = @[firstItem,secondItem,thirdItem];
return YES;
}
系統提供的圖標樣式
typedef NS_ENUM(NSInteger, UIApplicationShortcutIconType) { UIApplicationShortcutIconTypeCompose,
UIApplicationShortcutIconTypePlay,
UIApplicationShortcutIconTypePause,
UIApplicationShortcutIconTypeAdd,
UIApplicationShortcutIconTypeLocation,
UIApplicationShortcutIconTypeSearch,
UIApplicationShortcutIconTypeShare,
UIApplicationShortcutIconTypeProhibit NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeContact NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeHome NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeMarkLocation NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeFavorite NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeLove NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeCloud NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeInvitation NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeConfirmation NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeMail NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeMessage NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeDate NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeTime NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeCapturePhoto NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeCaptureVideo NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeTask NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeTaskCompleted NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeAlarm NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeBookmark NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeShuffle NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeAudio NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeUpdate NS_ENUM_AVAILABLE_IOS(9_1)
}
NS_ENUM_AVAILABLE_IOS(9_0) __TVOS_PROHIBITED;
2.實現這個方法
-(void)application:(UIApplication *)application performActionForShortcutItem:
(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler
在這個方法中處理添加和分享的事件,代碼如下:
-(void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler
{
if ([shortcutItem.type isEqual:@"add"])
{ NSLog(@"執行添加事件"); }
else if([shortcutItem.type isEqual:@"share"])
{ NSLog(@"執行分享的操作 ");}
}
第二種方式靜態添加入口標簽
靜態添加入口標簽不需要寫代碼,只需要在info.plist文件中添加相關功能設置即可。
靜態的方法加入:
即在plist文件中加入UIApplicationShortcutItems標簽,標簽類型為NSArray,根據需要可以添加四個不同的子標簽。類型為NSDictionary。然后加如所需鍵值對:
必填項(下面兩個鍵值是必須設置的):
UIApplicationShortcutItemType 這個鍵值設置一個快捷通道類型的字符串
UIApplicationShortcutItemTitle 這個鍵值設置標簽的標題
選填項(下面這些鍵值不是必須設置的):
UIApplicationShortcutItemSubtitle 設置標簽的副標題
UIApplicationShortcutItemIconType 設置標簽的圖標樣式,系統提供了29中樣式的圖標
UIApplicationShortcutItemIconFile 設置自定義標簽圖片文件的路徑
UIApplicationShortcutItemUserInfo 設置用戶信息,是一個字典類型,可以用來傳值
<key>UIApplicationShortcutItems</key>
<array>
<dict>
<key>UIApplicationShortcutItemType</key>
<string>First</string>
<key>UIApplicationShortcutItemTitle</key>
<string>添加</string>
<key>UIApplicationShortcutItemIconType</key>
<string>UIApplicationShortcutIconTypeFavorite</string>
<string>UIApplicationShortcutIconTypeShare</string>
</dict>
<dict>
<key>UIApplicationShortcutItemType</key>
<string>Second</string>
<key>UIApplicationShortcutItemTitle</key>
<string>帥哥</string>
<key>UIApplicationShortcutItemIconType</key>
<string>UIApplicationShortcutIconTypeFavorite</string>
</dict>
</array>
二、3D Touch 的Peek和Pop實現
使用步驟:
- 給Cell注冊3DTouch
- 遵守協議<UIViewControllerPreviewingDelegate>
- 實現協議方法
第1步:給Cell注冊3DTouch
-(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
MyTableViewCell *cell=[tableView dequeueReusableCellWithIdentifier:@"zhan" forIndexPath:indexPath];
//判斷是否支持3DTouch
if (self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable) {
//注冊Cell支持3DTouch,并設置代理
[self registerForPreviewingWithDelegate:self sourceView:cell];
}
return cell;
}
第2步:遵守協議<UIViewControllerPreviewingDelegate>
@interface ViewController ()<UITableViewDelegate,UITableViewDataSource,UIViewControllerPreviewingDelegate>
@property (weak, nonatomic) IBOutlet UITableView *myTableView;
第3步:實現協議方法
-(UIViewController *)previewingContext:(id<UIViewControllerPreviewing>)previewingContext viewControllerForLocation:(CGPoint)location
{
//獲取sourceView
MyTableViewCell *cell = (MyTableViewCell *)[previewingContext sourceView];
//設置彈出預覽的位置(peek是從哪個位置彈出)
[previewingContext setSourceRect:cell.bounds];
//設置彈框的View.
UIStoryboard *sb=[UIStoryboard storyboardWithName:@"Main" bundle:nil];
DetailViewController *detailVC = [sb instantiateViewControllerWithIdentifier:@"DetailViewController"];
//設置彈出peek的高度(設置寬度是沒有效果的)
detailVC.preferredContentSize = CGSizeMake(0, self.view.bounds.size.height*0.6);
//取出Cell的模型傳遞給詳情控制器.
return detailVC;
//設置標題
//detailVC.title = @"帥";
//在這里想彈一個帶有導航條的控制器,控制器里面包裝一個導航條.直接返回導航控制器.那么就會peek出一個導航控制器.
//return [[UINavigationController alloc] initWithRootViewController:detailVC];
}
彈框出現后,繼續重按時調用
//彈框出現后,繼續重按時調用 //viewControllerToCommit:就是上面return的控制器.
- (void)previewingContext:(id <UIViewControllerPreviewing>)previewingContext commitViewController:(UINavigationController *)viewControllerToCommit{
//*******如果上面返回的是導航控制器*********
//獲取導航控制器的根控制器.因為當前已經是一個導航控制器了,不能再繼續push一個導航控制器,所以要先獲取peek的導航控制器里面的根控制器.
//然后再拿當前的控制器把獲取的控制器push進去.
//DetailViewController *detailVC = (DetailViewController*)viewControllerToCommit.childViewControllers.lastObject;
//*******如果上面返回的是導航控制器*********
DetailViewController *detailVC = (DetailViewController*)viewControllerToCommit;//.childViewControllers.lastObject;
[self.navigationController pushViewController:detailVC animated:YES];
//使用show和push是一樣的效果
//[self showViewController:viewControllerToCommit sender:self];
彈窗出現后,向上滑動,會出現類似ActionSheet的控件.
實現該效果必須得要是在previewingContext:(id<UIViewControllerPreviewing>)previewingContext viewControllerForLocation:(CGPoint)location return回去那個控制器當中實現以下方法,(我們這里peek出來的是DetailViewController,所以必須得要在DetailViewController中實現該方法)
-(NSArray<id<UIPreviewActionItem>> *)previewActionItems
{
//彈出的第一個按鈕
UIPreviewAction *action0 = [UIPreviewAction actionWithTitle:@"收藏" style:UIPreviewActionStyleDefault handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
NSLog(@"收藏");
}];
UIPreviewAction *action1 = [UIPreviewAction actionWithTitle:@"點贊" style:UIPreviewActionStyleDestructive handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
NSLog(@"點贊");
}];
UIPreviewAction *action2 = [UIPreviewAction actionWithTitle:@"試試" style:UIPreviewActionStyleSelected handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
NSLog(@"試試");
}];
UIPreviewAction *action3 = [UIPreviewAction actionWithTitle:@"星星" style:UIPreviewActionStyleSelected handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
NSLog(@"星星");
}];
//該按鈕可以是一個組,點擊該組時,跳到組里面的按鈕.
UIPreviewActionGroup *actionGroup = [UIPreviewActionGroup actionGroupWithTitle:@"組" style:UIPreviewActionStyleSelected actions:@[action2, action3]];
//直接返回數組.
return @[action0,action1,actionGroup];
}
三、通過模擬器進行調試
使用SBShortcutMenuSimulator來配置模擬器,使模擬器支持3D Touch
在終端中按順序輸入以下命令:
1.git clone https://github.com/DeskConnect/SBShortcutMenuSimulator.git
2.cd SBShortcutMenuSimulator
3.make
然后打開剛才寫好的程序 運行一下打開模擬器,再去終端中按順序輸入一下命令:
1.xcrun simctl spawn booted launchctl debug system/com.apple.SpringBoard --environment DYLD_INSERT_LIBRARIES=$PWD/SBShortcutMenuSimulator.dylib
2.xcrun simctl spawn booted launchctl stop com.apple.SpringBoard
3.echo 'com.apple.mobilecal' | nc 127.0.0.1 8000
注意: 'com.apple.mobilecal' ''里邊寫的是自己項目的Bundle identifier. 這行命令就是要讓模擬器顯示出3D Touch,每次想要顯示快速入口只要重復操作即可
echo 'com.zhanming.text.-DTouch-OC
' | nc 127.0.0.1 8000
具體代碼放在了GitHub上大家可以下載。
如果感覺這篇文章對您有所幫助,順手點個喜歡,謝謝啦