4

CustomKeyboard/Network/KBNetworkManager.h

@@ -19,8 +19,15 @@ typedef NS_ERROR_ENUM(KBNetworkErrorDomain, KBNetworkError) {
     KBNetworkErrorDecodeFailed = 4,
 };
 
-/// 简单的 JSON 回调：json 为 NSDictionary/NSArray 或者在非 JSON 情况下返回 NSData
-typedef void(^KBNetworkCompletion)(id _Nullable jsonOrData, NSURLResponse * _Nullable response, NSError * _Nullable error);
+/// JSON 回调（扩展侧目前很少使用 JSON，可按需扩展）
+typedef void(^KBNetworkCompletion)(NSDictionary *_Nullable json,
+                                   NSURLResponse * _Nullable response,
+                                   NSError * _Nullable error);
+
+/// 二进制回调：用于下载 zip、图片等原始数据
+typedef void(^KBNetworkDataCompletion)(NSData *_Nullable data,
+                                       NSURLResponse *_Nullable response,
+                                       NSError *_Nullable error);
 
 @interface KBNetworkManager : NSObject
 
@@ -45,6 +52,12 @@ typedef void(^KBNetworkCompletion)(id _Nullable jsonOrData, NSURLResponse * _Nul
                                 headers:(nullable NSDictionary<NSString *, NSString *> *)headers
                               completion:(KBNetworkCompletion)completion;
 
+/// GET 原始二进制数据（不做 JSON 解析）
+- (nullable NSURLSessionDataTask *)GETData:(NSString *)path
+                                 parameters:(nullable NSDictionary *)parameters
+                                    headers:(nullable NSDictionary<NSString *, NSString *> *)headers
+                                  completion:(KBNetworkDataCompletion)completion;
+
 /// POST JSON 请求，jsonBody 会以 application/json 发送
 - (nullable NSURLSessionDataTask *)POST:(NSString *)path
                                jsonBody:(nullable id)jsonBody
@@ -54,4 +67,3 @@ typedef void(^KBNetworkCompletion)(id _Nullable jsonOrData, NSURLResponse * _Nul
 @end
 
 NS_ASSUME_NONNULL_END
-