先到github 上下載一個插件:https://github.com/DeskConnect/SBShortcutMenuSimulator
然后打開電腦終端;執行以下命令
git clone https://github.com/DeskConnect/SBShortcutMenuSimulator.git 回車
cd SBShortcutMenuSimulator 回車
make 回車
xcrun simctl spawn booted launchctl debug system/com.apple.SpringBoard --environment DYLD_INSERT_LIBRARIES=$PWD/SBShortcutMenuSimulator.dylib xcrun simctl spawn booted launchctl stop com.apple.SpringBoard 回車
然后將你加好了3dtouch的工程運行,並將模擬器返回到主界面(command+shift+h)。
然后在終端運行命令:
echo 'com.apple.mobilecal' | nc 127.0.0.1 8000 回車,其中,com.apple.mobilecal是應用的Bundle ID ,如果要測試我們的應用,將其改為我們應用的BundleID即可
1、靜態標簽
靜態標簽是我們在項目的配置plist文件中配置的標簽,在用戶安裝程序后就可以使用,並且排序會在動態標簽的前面。
我們先來看靜態標簽的配置:
首先,在info.plist文件中添加如下鍵值(我在測試的時候,系統並沒有提示,只能手打上去):
先添加了一個UIApplicationShortcutItems的數組,這個數組中添加的元素就是對應的靜態標簽,在每個標簽中我們需要添加一些設置的鍵值:
必填項(下面兩個鍵值是必須設置的):
UIApplicationShortcutItemType 這個鍵值設置一個快捷通道類型的字符串
UIApplicationShortcutItemTitle 這個鍵值設置標簽的標題
選填項(下面這些鍵值不是必須設置的) :
UIApplicationShortcutItemSubtitle 設置標簽的副標題
UIApplicationShortcutItemIconType 設置標簽Icon類型
UIApplicationShortcutItemIconFile 設置標簽的Icon文件
UIApplicationShortcutItemUserInfo 設置信息字典(用於傳值)
我們如上截圖設置后,運行程序,用我們前面的方法進行測試,效果如下:
2、動態標簽
動態標簽是我們在程序中,通過代碼添加的,與之相關的類,主要有三個:
UIApplicationShortcutItem 創建3DTouch標簽的類
UIMutableApplicationShortcutItem 創建可變的3DTouch標簽的類
UIApplicationShortcutIcon 創建標簽中圖片Icon的類
因為這些類是iOS9中新增加的類,所以其api的復雜程度並不大,下面我們來對其中方法與屬性進行簡要講解:
@interface UIApplicationShortcutItem : NSObject <NSCopying, NSMutableCopying>//下面是兩個初始化方法 通過設置type,title等屬性來創建一個標簽,這里的icon是UIApplicationShortcutIcon對象,我們后面再說 - (instancetype)initWithType:(NSString *)type localizedTitle:(NSString *)localizedTitle localizedSubtitle:(nullable NSString *)localizedSubtitle icon:(nullable UIApplicationShortcutIcon *)icon userInfo:(nullable NSDictionary *)userInfo NS_DESIGNATED_INITIALIZER; - (instancetype)initWithType:(NSString *)type localizedTitle:(NSString *)localizedTitle;//下面這是一些只讀的屬性,獲取相應的屬性值@property (nonatomic, copy, readonly) NSString *type;@property (nonatomic, copy, readonly) NSString *localizedTitle;@property (nullable, nonatomic, copy, readonly) NSString *localizedSubtitle;@property (nullable, nonatomic, copy, readonly) UIApplicationShortcutIcon *icon;@property (nullable, nonatomic, copy, readonly) NSDictionary<NSString *, id <NSSecureCoding>> *userInfo;
//這個類繼承於 UIApplicationShortcutItem,創建的標簽可變@interface UIMutableApplicationShortcutItem : UIApplicationShortcutItem@property (nonatomic, copy) NSString *type;@property (nonatomic, copy) NSString *localizedTitle;@property (nullable, nonatomic, copy) NSString *localizedSubtitle;@property (nullable, nonatomic, copy) UIApplicationShortcutIcon *icon;@property (nullable, nonatomic, copy) NSDictionary<NSString *, id <NSSecureCoding>> *userInfo;@end
//這個類創建標簽中的icon@interface UIApplicationShortcutIcon : NSObject <NSCopying>//創建系統風格的icon+ (instancetype)iconWithType:(UIApplicationShortcutIconType)type;//創建自定義的圖片icon+ (instancetype)iconWithTemplateImageName:(NSString *)templateImageName;@end
創建好標簽后,將其添加如application的hortcutItems數組中即可,示例如下:
- (void)viewDidLoad { [super viewDidLoad]; // Do any additional setup after loading the view, typically from a nib. //創建 UIApplicationShortcutItem * item = [[UIApplicationShortcutItem alloc]initWithType:@"two" localizedTitle:@"第二個標簽" localizedSubtitle:@"看我哦" icon:[UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypePlay] userInfo:nil]; 添加 [UIApplication sharedApplication].shortcutItems = @[item]; }
效果如下:
這里,將系統風格icon的枚舉列舉如下:
typedef NS_ENUM(NSInteger, UIApplicationShortcutIconType) { UIApplicationShortcutIconTypeCompose,//編輯的圖標 UIApplicationShortcutIconTypePlay,//播放圖標 UIApplicationShortcutIconTypePause,//暫停圖標 UIApplicationShortcutIconTypeAdd,//添加圖標 UIApplicationShortcutIconTypeLocation,//定位圖標 UIApplicationShortcutIconTypeSearch,//搜索圖標 UIApplicationShortcutIconTypeShare//分享圖標} NS_ENUM_AVAILABLE_IOS(9_0);
3、響應標簽的行為
類似推送,當我們點擊標簽進入應用程序時,也可以進行一些操作,我們可以看到,在applocation中增加了這樣一個方法:
- ( void )application:( UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:( void (^)( BOOLsucceeded))completionHandler NS_AVAILABLE_IOS ( 9 _0);
當我們通過標簽進入app時,就會在appdelegate中調用這樣一個回調,我們可以獲取shortcutItem的信息進行相關邏輯操作。
這里有一點需要注意:我們在app的入口函數:
- ( BOOL )application:( UIApplication *)application didFinishLaunchingWithOptions:( NSDictionary *)launchOptions;
也需要進行一下判斷,在launchOptions中有UIApplicationLaunchOptionsShortcutItemKey這樣一個鍵,通過它,我們可以區別是否是從標簽進入的app,如果是則處理結束邏輯后,返回NO,防止處理邏輯被反復回調。
幾點注意:
1、快捷標簽最多可以創建四個,包括靜態的和動態的。
2、每個標簽的題目和icon最多兩行,多出的會用...省略