快速找到所需文档，高效完成接入与排障

2.1 CocoaPods 引入（推荐）

在 Podfile 中添加：

platform :ios, '13.0'
use_frameworks!

target 'YOUR_APP' do
  pod 'UMCommon', '>= 7.6.7'   # 最低版本要求 7.6.7
  pod 'UMDevice'
end

说明：UMCommon 为静态库（vendored 静态 xcframework）。CocoaPods 在

use_frameworks! 下会自动完成静态库链接适配（注入 -ObjC 并链接其

所需系统库：sqlite3 / z / CoreTelephony / SystemConfiguration），

无需手工配置。执行 pod install 后以 .xcworkspace 打开工程。

2.2 didFinishLaunching 中初始化

#import <UMCommon/UMCommon.h>

- (BOOL)application:(UIApplication *)application
        didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 可选：开发期开启友盟日志
    [UMConfigure setLogEnabled:YES];

    // 友盟正式初始化（UMADK 与 UMConfigure 使用同一 appKey 注册，见 3.3）
    [UMConfigure initWithAppkey:@"YOUR_APPKEY" channel:@"App Store"];

    return YES;
}

2.3 顺序约束

[UMConfigure initWithAppkey:channel:] 必须先于 UMADK 初始化

（+initializeWithCompletion:）执行，否则设备标识相关数据缺失，影响

统计与风控。推荐在 didFinishLaunching 中按「UMConfigure → UMADK

初始化」顺序调用。

2.4 手动集成补充

不使用 CocoaPods 时，手动引入 UMCommon.xcframework（友盟官方渠道下载，

版本 ≥ 7.6.7），并在宿主 target Build Settings 中补齐：

3.1 依赖引入

方式一：CocoaPods 在线依赖（推荐）

在 Podfile 中添加（与第二章的 UMCommon 同一 target）：

pod 'UMADK', '1.1.0'

执行 pod install 后以 .xcworkspace 打开工程。

方式二：手动引入 UMADK.xcframework

将 UMADK.xcframework 拖入宿主工程（或 General > Frameworks, Libraries,

and Embedded Content 点击 + 添加），Embed 选项选择 Do Not Embed（SDK

为静态库，无需嵌入）。

两种方式等效，产物说明如下：

代码中统一引入唯一公开头：

#import <UMADK/UMADK.h>

3.2 签名登记（iOS 特有）

UMADK 初始化需登记宿主 App 的 bundleId + teamId，登记要求如下：

1. 服务端登记：接入前须将宿主 App 的 bundleId 与 teamId 登记至

   U-ADK 服务端（随 appKey 一起）；

2. 未登记后果：初始化失败（sCode=200050010，可经

   UMADKError.sCode 定位）；

3. TeamID 获取方式（三选一）：

   • 登录 developer.apple.com/account，

     Membership details 页查看 Team ID；

   • 打开工程 project.pbxproj 搜索 DEVELOPMENT_TEAM；

   • 命令行：xcodebuild -showBuildSettings | grep DEVELOPMENT_TEAM。

模拟器限制：UMADK 初始化在模拟器上无法走通（预期行为），

初始化与能力接口的验证须使用真机；如确有模拟器联调需求，见第九章

FAQ-1（手动注入签名描述文件即可，无需改动 SDK）。

3.3 初始化

ADK SDK 初始化通过 [UMADK initializeWithCompletion:] 完成，在

UMConfigure 初始化之后调用（appKey 与 UMConfigure 使用同一注册值，

UMCommon ≥ 7.6.7 初始化完成时 SDK 配置自动就绪，无需其他调用）：

完整示例（AppDelegate）：

#import "AppDelegate.h"
#import <UMADK/UMADK.h>
#import <UMCommon/UMCommon.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
        didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    // ① 友盟初始化（必须先于 UMADK 初始化，见 2.3）
    [UMConfigure initWithAppkey:@"YOUR_APPKEY" channel:@"App Store"];

    // ② 可选：开发期开启 SDK 调试日志（release 建议关闭）
    [UMADK setDebugMode:YES];

    // ③ UMADK 初始化：由业务侧按需显式调用（此处示例随启动触发）
    [UMADK initializeWithCompletion:^(UMADKError * _Nullable error) {
        dispatch_async(dispatch_get_main_queue(), ^{
            if (error == nil) {
                // SDK 就绪，可调用业务接口（[UMADK isReady] == YES）
            } else {
                // 初始化失败：error.code / error.sCode / error.source / error.message
            }
        });
    }];

    return YES;
}

@end

完整可运行参照：仓库内 Example/UMADKDemo 演示工程（初始化由界面按钮显式触发）。

3.4 调试模式

开发阶段可开启调试日志（release 包建议关闭）：

[UMADK setDebugMode:YES];   // 开启：全部日志（d/w）输出
[UMADK setDebugMode:NO];    // 关闭：零日志（release 默认）

敏感凭证在任何日志级别下均恒定脱敏，不会明文输出；开关仅控制日志

可见性。

3.5 版本号查询（1.1.0 新增）

获取当前 SDK 版本：[UMADK sdkVersion] 返回当前 SDK 版本号字符串（如 @"1.1.0"）；

与初始化状态无关，任意时刻可调，不发起网络请求。

4.1 非流式聊天

接口：+ (void)chatWithRequest:(UMADKChatRequest *)request completion:(void (^)(UMADKChatResult *result, UMADKError *error))completion

请求参数（UMADKChatRequest）：

返回（UMADKChatResult，字段详见第五章）：content（完整回答）/ reasoning（思考过程，可空）/ meta / usage / traceId / rawJson。

#import <UMADK/UMADK.h>

UMADKMessage *message = [UMADKMessage messageWithRole:@"user"
                                            content:@"你好，请介绍一下自己"];
UMADKChatRequest *request = [UMADKChatRequest requestWithMessages:@[message]];

[UMADK chatWithRequest:request completion:^(UMADKChatResult * _Nullable result,
                                           UMADKError * _Nullable error) {
    dispatch_async(dispatch_get_main_queue(), ^{
        if (error != nil) {
            // 错误处理见第六章
            return;
        }
        NSString *answer = result.content;
        NSString *reasoning = result.reasoning;   // 思考过程，可为 nil
        UMADKUsageInfo *usage = result.usage;      // 用量与计费
        // 更新 UI ...
    });
}];

4.2 流式聊天（SSE，四回调）

接口：+ (void)chatStreamWithRequest:(UMADKChatRequest *)request onMeta:(...) onDelta:(...) onDone:(...) onError:(...)

请求参数：与 4.1 完全一致（同一个 UMADKChatRequest，见 4.1 参数表）。

回调参数说明：

#import <UMADK/UMADK.h>

UMADKMessage *message = [UMADKMessage messageWithRole:@"user"
                                            content:@"写一首关于春天的诗"];
UMADKChatRequest *request =
        [[UMADKChatRequest alloc] initWithModel:@"auto"
                                      messages:@[message]
                                     sessionId:nil
                                enableThinking:YES        // 开启深度思考
                                   loadHistory:YES
                                   imageParams:nil];

__block NSMutableString *contentBuffer = [NSMutableString string];

[UMADK chatStreamWithRequest:request
                     onMeta:^(UMADKMetaInfo *meta) {
    // 首事件，至多一次：保存 sessionId 用于多轮会话
    NSString *sessionId = meta.sessionId;
}
                    onDelta:^(UMADKDeltaEvent *delta) {
    // 零到多次，后台串行队列按序触发
    if ([delta.type isEqualToString:UMADKDeltaTypeContent]) {
        [contentBuffer appendString:delta.delta];
        NSString *snapshot = [contentBuffer copy];
        dispatch_async(dispatch_get_main_queue(), ^{
            // textView.text = snapshot; 逐字刷新 UI
        });
    } else if ([delta.type isEqualToString:UMADKDeltaTypeReasoning]) {
        // 思考过程增量
    }
}
                     onDone:^(UMADKUsageInfo *usage) {
    // 至多一次，与 onError 互斥；流式完成，获取用量
    int64_t totalTokens = usage.totalTokens;
}
                    onError:^(UMADKError *error) {
    // 至多一次，与 onDone 互斥；终态后不再触发任何回调
    dispatch_async(dispatch_get_main_queue(), ^{
        // 展示 error.message
    });
}];

回调时序：onMeta 先于一切 onDelta；onDone 与 onError 互斥、各至多

一次；终态后不再触发任何回调。

4.3 文生图

文生图与文本生成同一入口，须通过流式接口 chatStreamWithRequest:

调用，模型须为 modelType = image_generation 的模型（经 listModels

动态获取，勿硬编码模型名）。

请求参数：同 4.1 UMADKChatRequest（model 传 image_generation 模型的 displayName），其中 imageParams 子参数如下：

返回：图链经 onDelta 以 type=content 整段 Markdown 一次性下发（形如 ![生成图片1](<oss-url>)）。

#import <UMADK/UMADK.h>

UMADKMessage *message = [UMADKMessage messageWithRole:@"user"
                                            content:@"一只在滑雪的柴犬"];
// 文生图参数：size/quality/n，nil 与越界值按缺省处理
UMADKImageParams *imageParams =
        [[UMADKImageParams alloc] initWithSize:@"1024x1024"
                                      quality:@"medium"
                                            n:1];
UMADKChatRequest *request =
        [[UMADKChatRequest alloc] initWithModel:@"<image_generation 模型 displayName>"
                                      messages:@[message]
                                     sessionId:nil
                                enableThinking:NO
                                   loadHistory:YES
                                   imageParams:imageParams];

[UMADK chatStreamWithRequest:request
                     onMeta:^(UMADKMetaInfo *meta) {}
                    onDelta:^(UMADKDeltaEvent *delta) {
    if ([delta.type isEqualToString:UMADKDeltaTypeContent]) {
        // 图链以 type=content 整段 Markdown 一次性下发，
        // 形如 ![生成图片1](<oss-url>)；解析 URL 后经
        // NSURLSession 下载或图片库加载
        NSString *markdownImage = delta.delta;
    }
}
                     onDone:^(UMADKUsageInfo *usage) {}
                    onError:^(UMADKError *error) {}];

缺省常量：UMADKImageParamsDefaultSize（"1024x1024"）/

UMADKImageParamsDefaultQuality（"low"）/ UMADKImageParamsDefaultN（1）/

UMADKImageParamsMaxN（4）。全缺省可直接 [UMADKImageParams defaultParams]。

图链判断请使用 UMADKDeltaTypeContent（图链以 type=content 下发）。

4.4 模型列表

接口：+ (void)listModelsWithCompletion:(void (^)(NSArray<UMADKModelInfo *> *models, UMADKError *error))completion

请求参数：无。

返回（NSArray<UMADKModelInfo *>）：

列表顺序由服务端返回（auto 通常排首位）。

#import <UMADK/UMADK.h>

[UMADK listModelsWithCompletion:^(NSArray<UMADKModelInfo *> * _Nullable models,
                                  UMADKError * _Nullable error) {
    dispatch_async(dispatch_get_main_queue(), ^{
        if (error != nil) {
            return;
        }
        for (UMADKModelInfo *model in models) {
            NSLog(@"%@ | type=%@ | tier=%@ | thinking=%@",
                  model.displayName, model.modelType, model.tier,
                  model.supportsThinking ? @"YES" : @"NO");
        }
    });
}];

4.5 多轮会话

会话 ID 由接入方自行保存与传递：

首轮不传 sessionId，从 meta.sessionId 获取后，后续轮次随请求传入；

loadHistory=YES（缺省）时服务端自动拼接同一 session 历史。

#import <UMADK/UMADK.h>

__block NSString *savedSessionId = nil;

// 第一轮：不传 sessionId
UMADKChatRequest *first = [UMADKChatRequest requestWithMessages:
        @[[UMADKMessage messageWithRole:@"user" content:@"我叫小明"]]];

[UMADK chatStreamWithRequest:first
                     onMeta:^(UMADKMetaInfo *meta) {
    savedSessionId = meta.sessionId;   // 保存（sess- 前缀，服务端生成）
}
                    onDelta:^(UMADKDeltaEvent *delta) {}
                     onDone:^(UMADKUsageInfo *usage) {
    // 第二轮：携带 sessionId，服务端拼接历史
    UMADKChatRequest *second =
            [[UMADKChatRequest alloc] initWithModel:@"auto"
                                          messages:@[[UMADKMessage messageWithRole:@"user"
                                                                          content:@"我叫什么？"]]
                                         sessionId:savedSessionId
                                    enableThinking:NO
                                       loadHistory:YES
                                       imageParams:nil];
    [UMADK chatStreamWithRequest:second
                         onMeta:^(UMADKMetaInfo *meta) {}
                        onDelta:^(UMADKDeltaEvent *delta) {
        // 模型将回答「小明」
    }
                         onDone:^(UMADKUsageInfo *usage) {}
                        onError:^(UMADKError *error) {}];
}
                    onError:^(UMADKError *error) {}];

4.6 场景化能力（七场景，1.1.0 新增）

SDK 提供 text/nlp/translate/ocr/vision/asr/tts 七个场景化类方法（类方法 + 场景专属 Request/Result + completion block）：

使用说明：

• 无需指定模型：场景请求不传 model，非法场景/参数由服务端返回错误码 200001000；

• 媒体输入二选一：本地文件路径（imageFilePath/audioFilePath，须先落盘；走云端执行时 SDK 自动完成素材上传）或已持有的素材 URL（imageUrl/audioUrl），二者必须且只能传一个（同传或均缺回调 1001）；不支持 base64 内联；

• 参数错误经回调返回：必填缺失、互斥冲突等参数错误通过 completion 回调 UMADKError(source=LOCAL, code=1001) 返回，不会抛出异常；

• 执行层读取：成功回调结果的 executedBy 标注本次执行层（UMADKExecutedByVendor/UMADKExecutedByCloud）；云端执行时另有 meta/traceId，端侧执行时两者为 nil；

• 回调后台线程：与既有能力一致，UI 操作须切主线程；completion 传 nil 为 no-op。

端侧执行相关说明：

• tts 两种音频形态：端侧执行时通过 audioData 交付本地合成音频（16-bit LE mono 裸 PCM，采样率见 structured.audio_sample_rate，可构造 WAV 头播放，audioUrl 为 nil）；云端执行时返回 audioUrl（audioData 为 nil）。两字段互斥，按非空判断消费即可。长文本合成超时上限 30s，超时自动转云端执行。

• asr 端侧执行说明：asr 命中端侧执行时，音频经 Apple 服务器识别（音频会离开设备，但不经过友盟云端），依赖系统授权与网络，需宿主声明语音识别权限（见第一章权限 key 清单）；SDK 自身不发起录音，麦克风权限仅宿主自行实现录音时需要。

• text 场景端侧可用性：text 场景端侧执行依赖 FoundationModels（iOS 26 + Apple Intelligence，A17 Pro+），仅限海外已激活 Apple Intelligence 的设备，国内设备恒走云端执行。

本地错误码：1001 参数错误；1002 未初始化；1004 网络/执行异常；1006 设备能力不可用（常规策略下 SDK 会自动转云端执行，通常不会遇到）。

便捷入口——常用参数组合的简化构造：

结构化返回说明：各场景 structured 字段的存在条件与元素结构在 4.7「七场景参数与返回明细」逐字段说明，要点如下：

• vision：端侧执行时 structured.result.{faces/objects/labels/items} 可直接解析（见 4.7.5）；云端执行时勿解析内部子键；

• nlp：structured.tokens 键名两条执行路径一致；partOfSpeech 端侧执行时可能缺失、两条路径取值体系不同，仅用于展示（见 4.7.2）；

• tts：音频时长统一为 structured.duration_ms（毫秒，两条执行路径均有）；

• ocr / asr：识别全文经 content 消费（两条执行路径均有），其余结构化字段按条件存在（见 4.7.4 / 4.7.6）。

• ⚠️ 当前版本限制：vision 云端执行按实测参考形态解析（见 4.7.5）；ocr 云端执行的 structured.result 内部结构未定型，只消费 content（见 4.7.4）。

示例（text 摘要，便捷入口）：

#import <UMADK/UMADK.h>

// 最简形态（无可选参数）：
// UMADKTextRequest *request = [UMADKTextRequest requestWithText:@"（待摘要的长文本）"
//                                                          task:UMADKTextTaskSummarize];

// 含可选参数（全参形态 + messageWithContent 便捷消息工厂）：
UMADKTextRequest *request = [[UMADKTextRequest alloc]
        initWithMessages:@[[UMADKMessage messageWithContent:@"（待摘要的长文本）"]]
                    task:UMADKTextTaskSummarize   // @"SUMMARIZE"
                  prompt:nil
               maxLength:@100
                   style:UMADKTextStyleConcise    // @"CONCISE"
                language:@"zh"];

[UMADK textWithRequest:request
            completion:^(UMADKTextResult * _Nullable result,
                         UMADKError * _Nullable error) {
    if (error != nil) {
        NSLog(@"text 失败：%@（code=%ld, traceId=%@）",
              error.message, (long)error.code, error.traceId);
        return;
    }
    NSLog(@"摘要：%@（executedBy=%ld）", result.content,
          (long)result.executedBy);
}];

4.7 七场景参数与返回明细

[UMADK ocrWithRequest:request completion:^(UMADKOcrResult *result, UMADKError *error) {
    if (error != nil) { /* 失败处理，见第六章 */ return; }
    NSString *text = result.content;                    // 恒有字段，直接消费
    if (result.executedBy == UMADKExecutedByVendor) {
        NSArray *blocks = result.structured[@"blocks"]; // 端侧执行形态
    } else {
        // 云端执行形态
    }
}];

{
  "structured": {
    "task": "TOKENIZATION",
    "tokens": [
      {"text": "友盟", "partOfSpeech": "Noun", "startOffset": 0, "endOffset": 2}
    ],
    "dominant_language": "zh"
  }
}

{
  "structured": {
    "tokens": [
      {"text": "友盟", "startOffset": 0, "endOffset": 2, "partOfSpeech": "NR"}
    ],
    "entities": [
      {"text": "友盟", "type": "ORG", "startOffset": 0, "endOffset": 2, "confidence": 0.98}
    ],
    "keywords": [
      {"text": "开发者数据服务", "score": 0.92}
    ]
  }
}

UMADKOcrRequest *request = [[UMADKOcrRequest alloc]
        initWithImageFilePath:localImagePath        // 与 imageUrl 互斥二选一
                     imageUrl:nil
                         task:UMADKOcrTaskGeneral   // @"GENERAL"
                languageHints:@[@"zh"]];
// 需要补充指令时改用全参初始化器（末位 messages 形参）
[UMADK ocrWithRequest:request
           completion:^(UMADKOcrResult * _Nullable result,
                        UMADKError * _Nullable error) {
    NSString *text = result.content;                // 恒有，两条执行路径均可用
    if (result.executedBy == UMADKExecutedByVendor) {
        NSArray *blocks = result.structured[@"blocks"];  // 端侧：按块取 text/boundingBox
    }
}];

// FACE_DETECTION
{"task":"FACE_DETECTION","result":{"faces":[
  {"boundingBox":{"x":95,"y":0,"width":905,"height":999},"confidence":0.998}
]}}

// OBJECT_DETECTION
{"task":"OBJECT_DETECTION","result":{"objects":[
  {"bbox_2d":[28,254,723,894],"category":"laptop"},
  {"bbox_2d":[554,454,701,654],"category":"mug"}
]}}

// IMAGE_CLASSIFICATION
{"task":"IMAGE_CLASSIFICATION","result":{
  "category":"技术文档",
  "subcategories":["人工智能","边缘计算","云原生"],
  "confidence":0.95
}}

{
  "structured": {
    "task": "OBJECT_DETECTION",
    "result": {
      "objects": [
        {"label": "矩形区域", "confidence": 0.95, "box": [180, 88, 500, 576]}
      ]
    }
  }
}

UMADKChatRequest

构造方式：便捷工厂 +requestWithMessages:（全缺省）；全参 designated

initializer -initWithModel:messages:sessionId:enableThinking:loadHistory:imageParams:

（nil model 回退 "auto"）。对象不可变。

UMADKMessage

构造：+messageWithRole:content: / +messageWithContent:（后者构造用户消息，场景化调用推荐）。

UMADKImageParams

UMADKChatResult（非流式完整响应）

UMADKMetaInfo

UMADKDeltaEvent

类型常量：

UMADKUsageInfo

UMADKModelInfo

UMADKModelInfo 不含 rawJson 字段。

UMADKError

三 ID 语义分工（sessionId / requestId / traceId）

排查单请求链路问题时优先使用 traceId（可提供给友盟技术支持用于服务端链路检索）。多轮会话中 sessionId 恒定而 traceId 每次不同。

6.1 UMADKError 结构说明

所有错误路径统一收敛为 UMADKError 对象（不可变），字段见第五章末表。

6.2 Source 枚举含义

6.3 本地错误码

6.4 错误处理示例

void HandleUMADKError(UMADKError *error) {
    switch (error.source) {
        case UMADKErrorSourceLocal:
            // 本地校验不通过：检查调用时机与参数（code 1001~1003）
            break;
        case UMADKErrorSourceNetwork:
            // 网络异常：提示用户检查网络，适当重试（code 1004）
            break;
        case UMADKErrorSourceGateway:
            // 服务端业务错误：经 error.sCode 获取九位错误码
            //（如 bundleId/teamId 未登记，sCode=200050010）
            break;
        case UMADKErrorSourceSSE:
            // 流式传输中服务端推送 error 事件
            break;
        case UMADKErrorSourceCredential:
            // 凭证问题（code 1005）：可重试 initializeWithCompletion:
            break;
    }
    NSLog(@"[UMADK] error code=%ld sCode=%lld message=%@",
          (long)error.code, (long long)error.sCode, error.message);
}

7.1 链接配置

CocoaPods 方式（3.1 方式一）无需以下配置，pod install 已自动处理；下表仅适用于手动引入 xcframework。

7.2 隐私清单（PrivacyInfo.xcprivacy）

SDK 产物双 slice 已内置 PrivacyInfo.xcprivacy（Apple 自 2024-05 起对

第三方 SDK 强制要求），无需接入方额外配置。申报内容摘要：

• 设备标识不关联用户身份（Linked=NO）；

• 用户标识信息按 Apple 规范关联申报（Linked=YES）；

• 收集用途仅为 App Functionality（风控）；

• 无跨 App 跟踪（不使用 IDFA）。

出口合规提示：SDK 仅使用系统标准 HTTPS 加密，宿主 App 请自行在

Info.plist 声明 ITSAppUsesNonExemptEncryption（App 级义务）。

7.3 混淆

iOS 平台无需额外混淆配置。

FAQ-1：能否在模拟器上跑通 UMADK 初始化与全链路？

默认不能（预期行为），但可通过手动注入签名描述文件实现，无需改动 SDK。

原因：初始化需要校验宿主 App 的签名信息（团队标识），模拟器构建

不具备有效的签名信息，因此初始化回调 1001（签名信息不可用）。真机

构建不受影响。

模拟器联调步骤（开发者在自己的开发环境注入自己的签名身份）：

1. 取得一份有效的 embedded.mobileprovision（二选一）：从最近一次真机构建的产物中拷出（<DerivedData>/.../Products/Debug-iphoneos/<App>.app/embedded.mobileprovision）；或从本机描述文件目录复制对应 profile（~/Library/MobileDevice/Provisioning Profiles/<uuid>.mobileprovision，可用 security cms -D -i <文件> 查看内容确认 bundleId 匹配）。

2. 将该文件重命名为 embedded.mobileprovision，拖入 Xcode 工程，勾选 app target 的 Target Membership（文件名必须完全一致，SDK 按 mainBundle 中该固定文件名读取）。

3. 以模拟器 destination 构建运行：初始化与全部能力即可在模拟器走通

   （前提：bundleId+teamId 已在服务端登记）。

注意事项：

• 该 profile 的 bundleId 必须与工程一致（通配符 profile 同样可用）；建议保持更新以免混淆。

• 真机构建不受影响：真机签名流程会使用系统嵌入的真实描述文件；为避免同名文件告警，可将该资源仅加入模拟器调试用的 target/configuration。

• 请勿将该文件随发布包上架：它属于开发调试产物，发布前建议从发布配置的资源中移除。

FAQ-2：初始化回调 1001（InvalidParameter，签名信息不可用）如何排查？

签名信息获取失败时初始化回调 1001（UMADKErrorCodeInvalidParameter）；

1002（NotInitialized）仅当初始化未完成时调用业务接口才会出现。

遇到 1001 按以下顺序自查：

1. 是否在模拟器上运行 → 见 FAQ-1（或改用真机）；

2. 真机上出现 1001（签名信息不可用）→ 检查构建签名配置（须为真实 provisioning

   签名，CODE_SIGNING_ALLOWED 不可为 NO）；

3. 1001（appKey 未注册）→ 检查 UMConfigure 是否正常初始化（UMCommon ≥ 7.6.7

   初始化完成时 SDK 配置自动就绪），并确认 appKey 非空（参见第六章本地错误码表）。

FAQ-3：分发包（TestFlight / App Store）还需要为 teamId 做额外配置吗？

不需要。 SDK 自动从 App 自身签名数据获取团队标识，接入方无需任何

额外配置。即使分发处理环节剥离了签名描述文件，SDK 仍可从签名信息中

正常获取，初始化不受影响。

模拟器联调例外：模拟器构建无有效签名信息，仍需按 FAQ-1 手动注入描述文件。

注：文中「初始化」均指 [UMADK initializeWithCompletion:] 调用。