44 lines
1.5 KiB
Objective-C
44 lines
1.5 KiB
Objective-C
//
|
||
// KBSkinService.h
|
||
// keyBoard
|
||
//
|
||
// 统一的键盘皮肤下载/应用服务。
|
||
// - App 端调用，一处封装本地图标导出 / 网络图标下载 / 背景图下载逻辑
|
||
// - 内部会检查键盘是否开启完全访问，并在不足时给出提示或引导
|
||
//
|
||
|
||
#import <Foundation/Foundation.h>
|
||
#import <UIKit/UIKit.h>
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
typedef void(^KBSkinApplyCompletion)(BOOL success);
|
||
|
||
/// 皮肤资源来源
|
||
typedef NS_ENUM(NSUInteger, KBSkinSourceMode) {
|
||
/// 远程 Zip：通过网络下载 zip_url 并解压到 App Group
|
||
KBSkinSourceModeRemoteZip = 0,
|
||
/// 本地 bundle Zip：从主 App bundle 中读取 zip_url 指定的 zip 文件并解压到 App Group
|
||
KBSkinSourceModeLocalBundleZip = 1,
|
||
};
|
||
|
||
/// 皮肤下载与应用服务（仅主 App 使用）
|
||
@interface KBSkinService : NSObject
|
||
|
||
+ (instancetype)shared;
|
||
|
||
/// 根据后端返回的皮肤 JSON 下载并应用皮肤。
|
||
///
|
||
/// @param skinJSON 与后端约定的皮肤结构（包含 id/name/background_image/hidden_keys/key_icons 等）
|
||
/// @param presenting 用于弹出“键盘权限引导页”的控制器，可为 nil
|
||
/// @param mode 资源来源模式：远程 / 本地 bundle
|
||
/// @param completion 应用完成回调（下载/写入全部结束后调用，success 表示是否成功）
|
||
- (void)applySkinWithJSON:(NSDictionary *)skinJSON
|
||
fromViewController:(nullable UIViewController *)presenting
|
||
mode:(KBSkinSourceMode)mode
|
||
completion:(nullable KBSkinApplyCompletion)completion;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|