跳到主要内容
版本：v7

iOS

环境要求​

  • 国内最低 iOS 11.0，海外最低 iOS 13.0。
  • XCode 16 或更高版本。

接入前准备​

请联系平台同事获取最新的 SDK 压缩包，解压后选择需要的 framework 和 bundle 导入到您的 project 中。

集成 XDSDK​

  1. 下载的压缩包解压后分为两部分 ThirdSDK 和 XDSDK，其中所有的 framework 均为动态库，导入后请设置为 Embed & Sign，具体说明如下：
必选项：
- XDAccountSDK.framework  登录
- XDPaymentSDK.framework  支付
- XDCommonSDK.framework   基础库
- XDTapSDK4WrapperSDK.framework  TapSDK 封装库
- TapTapMomentResource.bundle TapTap 资源包
- TapTapLoginResource.bundle TapTap 资源包
- TapTapComplianceResource.bundle TapTap 资源包
- TapTapAchievementResource.bundle TapTap 资源包

可选项：
XDCNWrapper.framework 国内三方 SDK ，按需添加
XDGlobalWrapper.framework 海外三方 SDK ，按需添加
  1. 将 前文中的 XDConfig.json 文件 导入到 XCode 工程中。
备注
  • 如果使用 Google 登录或 firebase 埋点，请在 Firebase 后台下载 GoogleService-Info.plist 并添加到项目中。

添加系统依赖库​

请检查项目中是否已自动添加以下依赖项：

LocalAuthentication.framework
AuthenticationServices.framework
SystemConfiguration.framework
Accelerate.framework
SafariServices.framework
Webkit.framework
CoreTelephony.framework
Security.framework
libc++.tdb
AVFoundation.framework
AdServices.framework

AdServices.framework -> 需要在 Build Phases - Link Binary With Libraries 中设置为 Optional 若运行时遇到相关依赖库加载报错，可改为 Optional 尝试（AuthenticationServices.framework iOS 12 以上才支持，请改为 Optional ）。

配置编译选项​

在 Build Setting 中的 Other Link Flag 中添加 -ObjC。

在 Capabilities 中按需打开 In-App Purchase 、Push Notifications 、Sign In With Apple 等功能。

配置 URL Types​

详细内容请咨询平台同事。

配置 Schemes​

在应用的 info.plist 中配置以下内容。

<key>LSApplicationQueriesSchemes</key>
<array>
	<string>sinaweibo</string>
	<string>weibosdk</string>
	<string>weibosdk2.5</string>
	<string>weibosdk3.3</string>
	<string>mqqopensdkapiV2</string>
	<string>mqq</string>
	<string>mqqapi</string>
	<string>tim</string>
	<string>mqqopensdknopasteboard</string>
	<string>weixin</string>
	<string>weixinULAPI</string>
	<string>weixinURLParamsAPI</string>
	<string>tapsdk</string>
	<string>tapiosdk</string>
	<string>fbapi</string>
	<string>fb-messenger-share-api</string>
	<string>lineauth2</string>
	<string>twitterauth</string>
	<string>xhsdiscover</string>
	<string>douyinopensdk</string>
	<string>douyinliteopensdk</string>
	<string>douyinsharesdk</string>
	<string>snssdk1128</string>
	<string>taptap</string>
	<string>tiktokopensdk</string>
	<string>tiktoksharesdk</string>
	<string>snssdk1180</string>
	<string>snssdk1233</string>
	<string>instagram</string>
	<string>kwai</string>
	<string>kwaiAuth2</string>
	<string>kwaiopenapi</string>
	<string>KwaiBundleToken</string>
	<string>kwai.clip.multi</string>
	<string>KwaiSDKMediaV2</string>
	<string>ksnebula</string>
</array>

配置权限列表​

SDK 涉及到的权限请求如下：

权限说明配置方式备注
相机权限在 info.plist 中配置 NSCameraUsageDescription 及描述文案。如：请允许 xxx 获取并使用您的相机。客服页面可能需要拍摄相关照片或视频
麦克风权限在 info.plist 中配置 NSMicrophoneUsageDescription 及描述文案。如：请允许 xxx 获取并使用您的麦克风。客服页面可能需要拍摄相关视频
相册权限在 info.plist 中配置 NSPhotoLibraryAddUsageDescription 及描述文案。如：请允许 xxx 获取并使用您的相册。客服页面可能需要访问照片

配置 IDFA​

如果您的应用需要打开 IDFA，则需要：

  1. 在 XDConfig.json 中将 idfa_enabled 设置为 true。
  2. 在应用中导入下列系统库： 
    AdSupport.framework
    AppTrackingTransparency.framework -> 需要在 Build Phases - Link Binary With Libraries 中设置为 Optional
  3. 在 info.plist 中配置 NSUserTrackingUsageDescription 及对应的文案。

做完上述配置后应用会在您调用初始化时自动尝试请求获取 IDFA 权限，此时会弹出系统的隐私权限请求弹窗。

配置 App 所需能力​

如果您的 APP 具有苹果登录、微信分享、推送等功能，需要在项目的 Target 下，点击 + Capabilities 按钮，添加自己所需的功能，具体开启方式如下图：

img