iOS ShareSDK 集成 Skill

当用户希望把 MobTech ShareSDK 集成到 iOS 工程，或希望把已有工程整理成可接入 ShareSDK 的状态时，使用本 skill。

适用场景

当用户提到以下任一主题时，使用本 skill：

• iOS ShareSDK 集成
• MobTech ShareSDK iOS 接入
• iOS 社交分享 SDK 配置
• CocoaPods 集成 ShareSDK
• ShareSDK 的 Podfile 配置
• ShareSDK 的 Info.plist 配置
• ShareSDK 的 MOBAppKey / MOBAppSecret 配置
• ShareSDK iOS 隐私合规
• uploadPrivacyPermissionStatus 调用时机
• 微信 / QQ / 微博分享或登录在 ShareSDK 中的平台注册
• URL Scheme、LSApplicationQueriesSchemes、Universal Link、Associated Domains 配置
• iOS 项目里增加分享能力
• 帮我配置微信分享 / QQ 分享 / 微博分享
• 迁移或清理旧 ShareSDK demo 残留

如果用户问题明确与 iOS 的 ShareSDK 接入、工程配置、平台参数、隐私合规、社交分享或第三方授权登录有关，应优先使用本 skill。

输出语言

• 默认使用中文与用户沟通
• 代码、配置键名、类名、命令名保持原文
• 回答要短，先给结论，再给动作

官方资料

主文档：

• https://www.mob.com/wiki/detailed?wiki=4&id=14
• https://www.mob.com/wiki/detailed?wiki=500&id=14

执行时高频需要参考的关联官方页面：

• https://www.mob.com/wiki/detailed?wiki=499&id=14
• https://www.mob.com/wiki/detailed?wiki=747&id=14
• https://policy.zztfly.com/sdk/share/privacy

已确认的官方事实

以下信息已经可以作为本 skill 的执行依据，不需要再假设：

• 官方推荐的 iOS 集成方式包含 CocoaPods 与手动集成
• 默认开发环境要求为 Xcode 9.1.0+、iOS 8.0+
• 用户未特别指定时，默认走 CocoaPods 集成
• Pod 主模块是 pod 'mob_sharesdk'
• UI 模块是 pod 'mob_sharesdk/ShareSDKUI'
• 常见平台模块包括：
  • pod 'mob_sharesdk/ShareSDKPlatforms/QQ'
  • pod 'mob_sharesdk/ShareSDKPlatforms/SinaWeibo'
  • pod 'mob_sharesdk/ShareSDKPlatforms/WeChat'
  • pod 'mob_sharesdk/ShareSDKPlatforms/WeChatFull'
• WeChat 与 WeChatFull 不能共存，只能选一个
• 如需分享菜单 UI，除 ShareSDKUI 外还可能需要 pod 'mob_sharesdk/ShareSDKExtension'
• 可选配置文件分享模块是 pod 'mob_sharesdk/ShareSDKConfigFile'
• Info.plist 里需要配置 MOBAppKey 与 MOBAppSecret
• 隐私同意后、在使用 SDK 能力前，需要调用 MobSDK uploadPrivacyPermissionStatus
• 第三方平台注册通常在 application:didFinishLaunchingWithOptions: 中调用 [ShareSDK registPlatforms:^{}]
• 微信、QQ、微博在当前官方示例里都带有 universalLink 参数
• Other Linker Flags 需要添加 -ObjC
• 使用 Xcode 15 编译时，官方文档额外要求在 Other Linker Flags 中添加 -ld64
• 微博需要补 ATS 配置
• 如果要强制 HTTPS，可在 Info.plist 中配置 MOBForceHttps = YES
• iOS 13+ 下，微博、微信、QQ、Line 需要校验 Universal Link，并在工程中配置 Associated Domains
• showShareActionSheet 的 onStateChanged 回调共 6 个参数：(SSDKResponseState, SSDKPlatformType, [AnyHashable: Any]?, SSDKContentEntity?, (any Error)?, Bool)
• showShareActionSheet 必须传 sheetConfiguration: 参数（不能省略），类型为 SSUIShareSheetConfiguration *，需先 #import \x3CShareSDKUI/ShareSDKUI.h>
• SSDKContentType 的自动判断枚举值为 .auto（不是 .typeAuto）
• 纯 Swift 工程须创建 ObjC 桥接头导入 \x3CShareSDK/ShareSDK.h>、\x3CMOBFoundation/MOBFoundation.h>

Swift 注意事项

1. 纯 Swift / SwiftUI 工程需创建 ObjC 桥接头

纯 Swift 工程需要创建 {Target}-Bridging-Header.h，导入 ObjC 头文件后才可调用 MobSDK / ShareSDK API：

#import \x3CShareSDK/ShareSDK.h>
#import \x3CShareSDKUI/ShareSDKUI.h>
#import \x3CMOBFoundation/MOBFoundation.h>

并在 project.pbxproj 的目标 build settings 中添加：

SWIFT_OBJC_BRIDGING_HEADER = {Target}/{Target}-Bridging-Header.h;

2. onStateChanged 回调签名

showShareActionSheet 的 onStateChanged 回调包含 6 个参数（不是 4 个）：

onStateChanged: { state, platformType, userData, entity, error, flag in
    switch state {
    case .success:
        print("分享成功")
    case .fail:
        print("分享失败: \(error?.localizedDescription ?? "")")
    case .cancel:
        print("分享取消")
    default:
        break
    }
}

参数含义：(SSDKResponseState, SSDKPlatformType, [AnyHashable: Any]?, SSDKContentEntity?, (any Error)?, Bool)

3. SSDKContentType 枚举

正确的自动类型枚举值为 .auto（不是 .typeAuto，该case不存在）：

let shareParams = NSMutableDictionary()
shareParams.ssdkSetupShareParams(
    byText: "分享文本",
    images: nil,
    url: URL(string: "https://example.com"),
    title: "标题",
    type: .auto  // ✅ 正确
)

不编造规则

不要编造以下内容：

• 依赖坐标之外的版本号
• 平台凭证
• 未启用平台的 URL Scheme、白名单和回调逻辑
• 项目里不存在的初始化入口
• 用户实际业务里的分享按钮落点

如果文档没有明确说明，或者当前工程无法安全推断，必须写：

文档未明确，需向用户确认

默认执行策略

• 默认集成方式：CocoaPods
• 默认先生成覆盖 iOS Share 支持平台的完整配置模板，不先追问“要接哪些平台”
• 默认以用户填写的 ShareSDK_Config.xlsx 为准决定平台范围：填写则集成，未填写则默认不集成
• 默认不把未填写的平台写进工程
• 默认不运行 pod install / pod update，先给用户看计划，再执行
• 默认把 SDK 初始化放在用户隐私同意之后

执行流程

严格按以下顺序推进：

1. 先扫描工程，再给方案。
2. 先生成配置模板，再等用户填写。
3. 先读取并校验 Excel，再确定平台范围。
4. 修改前先给最小改动计划。
5. 依赖安装前先征求用户确认。
6. 完成后生成项目内说明文档。

第一步：扫描工程

优先扫描以下内容：

• .xcodeproj / .xcworkspace
• Podfile
• Package.swift
• AppDelegate / SceneDelegate / SwiftUI @main
• Info.plist
• 是否已有 ShareSDK、MobSDK、MOBAppKey、LSApplicationQueriesSchemes、CFBundleURLTypes
• 是否已有 Associated Domains
• 当前 Bundle Identifier

推荐命令：

• rg --files -g '*.xcodeproj' -g '*.xcworkspace' -g 'Podfile' -g 'Package.swift'
• rg -n 'ShareSDK|MobSDK|MOBAppKey|MOBAppSecret|LSApplicationQueriesSchemes|CFBundleURLTypes|Associated Domains|uploadPrivacyPermissionStatus|registPlatforms'

扫描后先给出一段简短结论，包含：

• 当前工程的依赖方式
• 当前入口结构
• 是否已有 ShareSDK 残留
• 下一步是生成配置模板还是直接读取已有 ShareSDK_Config.xlsx

第二步：注册社交平台信息

2-1 生成配置模板文件

扫描工程后，如未发现用户项目根目录已有 ShareSDK_Config.xlsx，执行：

1. 运行本 skill 目录下的 assets/generate_excel_template.py。
2. 使用脚本生成或更新本 skill 目录下的 assets/ShareSDK_Config_Template.xlsx。
3. 将 assets/ShareSDK_Config_Template.xlsx 复制到用户项目根目录。
4. 在用户项目根目录命名为 ShareSDK_Config.xlsx。

模板必须包含：

• 基础信息 Sheet
• 平台申请地址 Sheet
• 每个平台独立 Sheet

支持的 iOS Share 平台至少包含以下这些，模板中都要出现：

国内平台：

• 抖音
• 新浪微博
• QQ
• 微信
• 企业微信
• 有道云笔记
• 印象笔记
• 易信好友
• 明道
• 人人网
• 开心网
• 钉钉(DingTalk)
• 美拍
• 中国移动
• 中国电信（天翼）
• 快手
• 支付宝

国外平台：

• Line
• Facebook
• Twitter
• Google+
• LinkedIn
• Flickr
• Pinterest
• Tumblr
• Dropbox
• Instagram
• VKontakte
• Kakao
• YouTube
• Telegram
• Reddit
• TikTok
• SnapChat

复制完成后，必须告知用户：

已在你项目的根目录生成 {path}/ShareSDK_Config.xlsx 配置文件。

请打开该文件，按以下步骤填写：
1. 在"基础信息"Sheet 中填写 MobTech 的 appKey 和 appSecret
   （从 https://www.mob.com/ 注册应用获取）
2. 在相应平台的 Sheet 中填写需要启用的平台配置
   （填写则集成，不填写则默认不集成）
3. "平台申请地址"Sheet 中有各开放平台的申请链接

填写完成后告诉我"填好了"，我将继续下一步。

2-2 等待用户填写完成

生成 ShareSDK_Config.xlsx 后必须暂停，不要继续修改工程。

等待用户回复：

• 填好了
• 已填写
• 配置好了
• 或其它明确表示 Excel 已填写完成的表达

用户未明确表示填写完成前，不读取配置、不改 Podfile、不改 Info.plist、不写初始化代码。

不要在这一步先问用户“你想集成哪些平台”。

2-3 读取并验证配置

用户表示填写完成后，读取用户项目根目录的 ShareSDK_Config.xlsx。

平台启用规则：

• 某个平台 Sheet 中只要用户填写了有效平台凭证或关键配置字段，就视为“要集成”
• 某个平台 Sheet 完全留空，则视为“不集成”
• 不要要求用户额外再口头确认平台列表

验证规则：

类型转换规则：

• appId、appKey、appSecret、userName、path 等标识符字段，强制转为字符串，即使 Excel 中填写的是数字，如 12345，也要转为 "12345"。
• withShareTicket、bypassApproval、shareByAppClient 等布尔字段，转为 true / false，不加引号。
• miniprogramType 等数字字段，转为整数，不加引号。

如果不合法，必须停止并提示：

配置信息验证失败，请修正以下问题：

{具体问题列表}
- 第 1 条：{问题描述}
- 第 2 条：{问题描述}

请修改 Excel 文件后保存，然后重新告诉我"填好了"。

如果合法，提取配置信息，进入第三步。

第三步：提取集成配置

从已验证通过的 ShareSDK_Config.xlsx 提取后续集成所需配置。

基础信息：

• mobAppKey
• mobAppSecret
• bundleIdentifier
• teamId
• integrationMode
• needShareUI
• needAuth
• 已启用平台集合

按平台提取时，遵守：

• 平台是否启用，以对应 Sheet 是否填写为准
• 未填写的平台，不进入后续 Podfile、Info.plist、URL Scheme、白名单、平台注册代码

按平台提取：

• WeChat：appId、appSecret、universalLink、useWeChatFull
• QQ：appId、appKey、enableUniversalLink、universalLink
• SinaWeibo：appKey、appSecret、redirectUrl、universalLink

其它平台：

• 只提取模板里该平台 Sheet 中实际填写的字段
• 若文档未明确某平台 iOS 所需字段，写 文档未明确，需向用户确认

扫描工程后再确认：

• 初始化落点文件
• 分享按钮或服务层落点
• 是否需要 Associated Domains
• 是否已有隐私弹窗与同意回调

第四步：改动前计划

修改任何文件前，先给出最小改动计划。典型涉及：

• Podfile
• Info.plist
• AppDelegate.*
• SceneDelegate.*
• SwiftUI App 入口文件
• 独立的 ShareSDKRegister 或 ShareSDKService
• 业务层分享入口
• 项目内说明文档，例如 ShareSDKIntegrationNotes.md

计划应说明：

• 每个文件为什么改
• 哪些配置来自官方文档
• 哪些值仍需用户提供

第五步：实施规则

A. CocoaPods 依赖

默认按 CocoaPods 集成。

Pod 选择规则：

• 必选：pod 'mob_sharesdk'
• 需要官方分享 UI：pod 'mob_sharesdk/ShareSDKUI'
• 需要弹出官方分享菜单能力时，补 pod 'mob_sharesdk/ShareSDKExtension'
• 需要配置文件分享能力时，按需补 pod 'mob_sharesdk/ShareSDKConfigFile'
• 微信按需求二选一：
  • pod 'mob_sharesdk/ShareSDKPlatforms/WeChat'
  • pod 'mob_sharesdk/ShareSDKPlatforms/WeChatFull'
• QQ：pod 'mob_sharesdk/ShareSDKPlatforms/QQ'
• 微博：pod 'mob_sharesdk/ShareSDKPlatforms/SinaWeibo'

依赖安装动作规则：

• 改 Podfile 之前先告知用户
• 运行 pod install 或 pod update 前先询问用户
• 若 mob_sharesdk 搜索不到，可建议：
  • pod setup
  • 再执行依赖更新
• 如果本机 Ruby 版本 ≥ 4.0，pod install 可能遇到 Encoding::CompatibilityError（Unicode Normalization 兼容问题），需要先设置：

  export LANG=en_US.UTF-8
  pod install
  

• 不要在 skill 中默认删除 CocoaPods 缓存；如必须清缓存，先征求用户确认

B. 初始化与隐私

向用户说明

根据 MobTech 隐私合规要求和中国区 App 上架规范，使用 ShareSDK 需要在用户同意隐私政策后才能初始化 SDK。

你需要在 App 中：

1. 首次启动时展示《隐私政策》弹窗
2. 用户点击"同意"按钮后，调用隐私授权代码
3. 用户点击"不同意"则不应调用

初始化顺序必须遵守：

1. 用户阅读并同意隐私政策
2. 调用 MobSDK uploadPrivacyPermissionStatus:YES ...
3. 再进入 ShareSDK 初始化与业务调用

可使用的官方接口：

+ (void)uploadPrivacyPermissionStatus:(BOOL)isAgree
                             onResult:(void (^_Nullable)(BOOL success))handler;

或：

+ (void)uploadPrivacyPermissionStatus:(BOOL)isAgree
                  privacyDataDelegate:(id\x3CMOBFoundationPrivacyDelegate> _Nullable)privacyDataDelegate
                             onResult:(void (^_Nullable)(BOOL success))handler;

如果工程已有统一隐私网关，优先挂到已有同意回调之后。

如果工程没有隐私弹窗，不要直接帮用户创建完整产品方案；先明确指出这是阻塞项。

C. 平台注册

平台注册优先放在启动阶段，并保持集中管理。

可采用：

• 独立 Objective-C / Swift 注册辅助类
• AppDelegate 内单点封装方法

官方示例可确认的平台注册方法包括：

• setupQQWithAppId:appkey:enableUniversalLink:universalLink:
• setupWeChatWithAppId:appSecret:universalLink:
• setupSinaWeiboWithAppkey:appSecret:redirectUrl:universalLink:

只注册当前启用的平台。

D. Info.plist

至少校验并按需写入：

• MOBAppKey
• MOBAppSecret
• CFBundleURLTypes
• LSApplicationQueriesSchemes

可按需写入：

• ATS 配置
• MOBTwitterVer
• MOBForceHttps

⚠️ 物理 Info.plist 要点（替代 GENERATE_INFOPLIST_FILE 时）

如果工程使用 GENERATE_INFOPLIST_FILE = YES（Xcode 自动生成），而你需要改为物理 Info.plist 文件，务必在 Info.plist 中包含以下关键键，否则安装会失败：

\x3Ckey>CFBundleIdentifier\x3C/key>
\x3Cstring>$(PRODUCT_BUNDLE_IDENTIFIER)\x3C/string>
\x3Ckey>CFBundlePackageType\x3C/key>
\x3Cstring>APPL\x3C/string>
\x3Ckey>CFBundleExecutable\x3C/key>
\x3Cstring>$(EXECUTABLE_NAME)\x3C/string>
\x3Ckey>CFBundleVersion\x3C/key>
\x3Cstring>$(CURRENT_PROJECT_VERSION)\x3C/string>
\x3Ckey>CFBundleShortVersionString\x3C/key>
\x3Cstring>$(MARKETING_VERSION)\x3C/string>

同时，在 project.pbxproj 中将目标的：

• GENERATE_INFOPLIST_FILE = YES → 删除
• 新增 INFOPLIST_FILE = {Target}/Info.plist;
• 删除所有 INFOPLIST_KEY_* 条目（因为它们已被物理文件覆盖）

URL Scheme 规则，当前官方已明确：

• 微博：wb{appKey}
• 微信：{wxAppId}
• Facebook：fb{apiKey}
• Twitter：twitterkit-{consumerKey}
• QQ / QZone：
  • tencent{appId}
  • QQ{appId的8位大写十六进制}

如果只启用微信 / QQ / 微博，就不要把 Facebook / Twitter 相关项写进工程。

E. 白名单

LSApplicationQueriesSchemes 只加入当前启用平台需要的条目。

官方文档已列出常见平台白名单，尤其关注：

• 微博：sinaweibo、sinaweibohd、sinaweibosso、sinaweibohdsso、weibosdk、weibosdk2.5、weibosdk3.3
• 微信：weixin、weixinULAPI、weixinURLParamsAPI
• QQ / QZone：mqqOpensdkSSoLogin、mqqopensdkapiV2、tim、mqq、mqqapi、mqqopensdknopasteboard、mqqopensdknopasteboardios16、mqqopensdkminiapp、mqzone、mqqopensdkapiV4 等

不要在未启用平台时预埋其白名单。

F. Universal Link 与能力开关

当启用微博、微信、QQ、Line 时，优先检查是否需要：

• Associated Domains
• applinks:xxxx
• 工程证书 Team ID
• 正确的 Bundle ID

只有在用户已经提供 Universal Link，或工程中已有明确值时，才直接落地。

如果缺少 Universal Link，先告诉用户该项会阻塞对应平台在 iOS 13+ 的正常能力。

G. 业务调用

如果用户要求接分享功能，可基于官方 API 接入：

• 菜单分享：showShareActionSheet:customItems:shareParams:sheetConfiguration:onStateChanged:
• 直接分享：share:parameters:onStateChanged:
• 第三方登录：authorize:settings:onStateChanged:

⚠️ showShareActionSheet 完整签名（含 sheetConfiguration:）

let config = SSUIShareSheetConfiguration()
ShareSDK.showShareActionSheet(
    nil,                           // view (iPad 弹出参照视图)
    customItems: nil,              // items (nil 显示所有已集成平台)
    shareParams: shareParams,      // 分享参数
    sheetConfiguration: config     // 必传，不可省略
) { state, platformType, userData, entity, error, flag in
    // state: SSDKResponseState (.success / .fail / .cancel)
    // error: (any Error)? — 失败时才有值
    switch state {
    case .success:
        print("分享成功")
    case .fail:
        print("失败: \(error?.localizedDescription ?? "")")
    case .cancel:
        print("已取消")
    default:
        break
    }
}

⚠️ onStateChanged 回调签名（6 个参数）

onStateChanged: { state, platformType, userData, entity, error, flag in

⚠️ ssdkSetupShareParams 的 type 参数

官方支持的枚举值为 SSDKContentType，正确 case 是 .auto（不要写 .typeAuto，该值不存在）：

shareParams.ssdkSetupShareParams(
    byText: "文本",
    images: nil,
    url: URL(string: "https://example.com"),
    title: "标题",
    type: .auto  // ✅
)

但默认不要擅自把测试文案、测试图片 URL、测试标题直接写进正式业务代码。

第六步：校验

完成修改后至少做这些校验：

• Podfile 语法看起来无破坏
• Info.plist 中关键键存在且结构未损坏：
  • 如果是物理 Info.plist，确认包含 CFBundleIdentifier、CFBundlePackageType、CFBundleExecutable
  • 确认 MOBAppKey / MOBAppSecret 已填入
  • 确认 LSApplicationQueriesSchemes 只包含已启用平台的白名单
  • 确认 CFBundleURLTypes 中 URL Scheme 格式正确
• 入口文件已调用隐私同意后的初始化逻辑（先 uploadPrivacyPermissionStatus，再 registPlatforms）
• 注册代码只包含本次启用的平台
• 未把无关 demo 平台带入工程
• 如果是纯 Swift 工程，确认已创建 ObjC 桥接头并配置了 SWIFT_OBJC_BRIDGING_HEADER
• 确认 project.pbxproj 中已删除 GENERATE_INFOPLIST_FILE 和 INFOPLIST_KEY_*（当使用物理 Info.plist 时）

如用户允许安装依赖，再补：

• pod install
• 必要时最小构建校验

如果失败，要区分：

• 代码配置问题
• 本机 CocoaPods / Xcode / 签名环境问题

第七步：交付内容

完成后最终输出至少包含：

• 改了什么
• 还缺哪些平台凭证或 Universal Link
• 隐私同意后的初始化落点在哪
• 写入了哪些 Info.plist 键
• 使用了哪些官方链接

如用户允许，额外生成项目内说明文档，例如：

• ShareSDKIntegrationNotes.md

建议说明文档内容：

• 已启用的平台
• Pod 依赖清单
• 必填凭证清单
• URL Scheme 清单
• 白名单清单
• Universal Link / Associated Domains 清单
• 初始化入口
• 隐私接口调用时机
• 官方文档链接

边界

不要做这些事：

• 默认启用全部平台
• 未经确认就切换到 SPM 或手动集成
• 在用户未同意前自动执行 pod install
• 把测试分享代码直接塞进生产页面
• 在没有隐私同意链路时直接初始化 ShareSDK
• 把官方文档里无关平台的配置一并写入工程