39 lines
1.5 KiB
Objective-C
39 lines
1.5 KiB
Objective-C
//
|
||
// KBExtensionAppLauncher.h
|
||
// CustomKeyboard
|
||
//
|
||
// 封装：在键盘扩展中拉起主 App（Scheme / Universal Link）。
|
||
//
|
||
|
||
#import <UIKit/UIKit.h>
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
@interface KBExtensionAppLauncher : NSObject
|
||
|
||
/// 通用入口：优先尝试 primaryURL，失败后尝试 fallbackURL，
|
||
/// 均通过 `extensionContext openURL` 发起跳转（避免使用扩展禁用 API/响应链绕行）。
|
||
/// 若开启 `KB_URL_BRIDGE_ENABLE=1`，会在两次 `extensionContext openURL` 均失败时，
|
||
/// 再尝试一次“响应链 openURL”兜底（上架有风险，请谨慎开启）。
|
||
/// - Parameters:
|
||
/// - primaryURL: 第一优先尝试的 URL（可为 Scheme 或 UL）
|
||
/// - fallbackURL: 失败时的备用 URL（可为 nil）
|
||
/// - ivc: 当前的 UIInputViewController（用于 extensionContext openURL）
|
||
/// - source: 作为响应链兜底的起点（可为 nil）
|
||
/// - completion: 最终是否“看起来已成功发起”打开动作（不保证一定跳转到 App）
|
||
+ (void)openPrimaryURL:(NSURL * _Nullable)primaryURL
|
||
fallbackURL:(NSURL * _Nullable)fallbackURL
|
||
usingInputController:(UIInputViewController *)ivc
|
||
source:(UIResponder * _Nullable)source
|
||
completion:(void (^ _Nullable)(BOOL success))completion;
|
||
|
||
/// 简化版：只针对单一 Scheme 做尝试。
|
||
+ (void)openScheme:(NSURL *)scheme
|
||
usingInputController:(UIInputViewController *)ivc
|
||
source:(UIResponder * _Nullable)source
|
||
completion:(void (^ _Nullable)(BOOL success))completion;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|