HBuilderX 5.13+ 的 iOS 离线 SDK 已改为通过 CocoaPods 集成广告三方 SDK,SDK 包中不再提供
libGDTMobSDK.a、BUAdSDK.xcframework等广告三方库。请在Podfile中启用对应的 uni-AD Pod,不要再从SDK/Libs中查找或手动添加这些库。启用任意广告平台 Pod 时会自动带上广告公共依赖UniAd-Base。DCUniAd*.xcframework等 uni-AD 模块库仍包含在离线 SDK 中,由本地 Pod 自动集成;广告平台三方 SDK、系统库和资源依赖同样由 CocoaPods 自动处理,无需手动添加。
在示例工程 Podfile 的 uniapp_subspecs 中添加需要使用的广告平台。例如,接入腾讯优量汇时添加 UniAd-GDT:
uniapp_subspecs = [
'Core',
'UniAd-GDT',
]
修改后执行 pod install --no-repo-update,并使用生成的 .xcworkspace 打开工程。对应的广告三方 SDK(例如优量汇的 GDTMobSDK)会由 CocoaPods 自动引入,无需手动添加 libGDTMobSDK.a。
| 广告平台 | Pod subspec | 说明 |
|---|---|---|
| 穿山甲 | UniAd-CSJ | 自动依赖 UniAd-Base |
| Gromore | UniAd-Gromore | 自动依赖 UniAd-Base |
| 腾讯优量汇 | UniAd-GDT | 自动依赖 UniAd-Base |
| 快手 | UniAd-KS | 自动依赖 UniAd-Base |
| Sigmob | UniAd-Sigmob | 自动依赖 UniAd-Base |
| 百度 | UniAd-Baidu | 自动依赖 UniAd-Base |
| 微信小程序广告 | UniAd-WM | 自动依赖 UniAd-Base |
| 旺脉 | UniAd-WA | 自动依赖 UniAd-Base |
| AppLovin | UniAd-AppLovin | 自动依赖 UniAd-Base |
| Google AdMob | UniAd-GG | 自动依赖 UniAd-Base |
| AdMob Pangle Adapter | UniAd-GG-Pangle | 自动依赖 UniAd-Base |
| Gromore 短剧 | UniAd-GM-Content | 示例工程已配置所需 CocoaPods source |
| InMobi | UniAd-InMobi | 自动依赖 UniAd-Base |
| IronSource | UniAd-IronSource | 自动依赖 UniAd-Base |
| 快手内容联盟 | UniAd-KS-Content | 自动依赖 UniAd-Base |
| Liftoff / Vungle | UniAd-Liftoff | 自动依赖 UniAd-Base |
| Meta Audience Network | UniAd-Meta | 自动依赖 UniAd-Base |
| Mintegral | UniAd-Mintegral | 自动依赖 UniAd-Base |
| Pangle | UniAd-Pangle | 自动依赖 UniAd-Base |
| UnityAds | UniAd-Unity | 自动依赖 UniAd-Base |
| Oct | UniAd-Oct | 自动依赖 UniAd-Base |
| 泛连 | UniAd-FL | 自动依赖 UniAd-Base |
| 华夏乐游 | UniAd-YT | 自动依赖 UniAd-Base |
5.13+ 示例工程 Podfile 已配置广告 SDK 需要的 CocoaPods source。
uni-AD聚合目前国内流行的广告平台广点通(腾讯)、快手等,支持开屏广告和信息流、激励视频广告。
在打包原生工程中找到工程的配置文件-Info.plist ,然后添加marketChannel节点,节点内容格式为:包名|应用标识|广告标识|渠道 如io.dcloud.HB|appid|adid|apple
包名:对应xcode里的bundleid,如io.dcloud.HBuilder。
应用标识:对应5+或uni-app项目manifest.json中appid。
广告标识:联盟ID,开通广告后可在dev.dcloud.net.cn获取,如果没有开通广告,设置值为空即可。
渠道:可以填apple。
1.在info.plist文件里加DCLOUD_AD_ID节点,内容为自己申请的广告标识adid
2.把marketChannel节点的广告标识换成申请的广告标识。如下图所示:

3.在info.plist文件里配置NSUserTrackingUsageDescription隐私描述,详细配置可参考如下链接。
参考:https://ask.dcloud.net.cn/article/36107
以下“依赖库 / 系统库 / 依赖资源”表格仅适用于 HBuilderX 5.12 及以下版本的 iOS 离线 SDK。HBuilderX 5.13+ 不再随 SDK 包提供表中的广告平台三方库,请使用上方的本地 Pod 集成方式。
| 依赖库 | 系统库 | 依赖资源 |
|---|---|---|
| DCUniAdCsj.xcframework、BUAdSDK.xcframework、CSJMediation.xcframework | Accelerate.framework、AdSupport.framework、AudioToolbox.framework、AVFoundation.framework、CoreGraphics.framework、CoreImage.framework、CoreLocation.framework、CoreMotion.framework、CoreMedia.framework、CoreTelephony.framework、CoreText.framework、ImageIO.framework、JavaScriptCore.framework、MapKit.framework、MediaPlayer.framework、MobileCoreServices.framework、QuartzCore.framework、Security.framework、StoreKit.framework、SystemConfiguration.framework、UIKit.framework、WebKit.framework、DeviceCheck.framework、libbz2.tbd、libc++.tbd、libiconv.tbd、libresolv.9.tbd、libsqlite3.tbd、libxml2.tbd、libz.tbd、libc++abi.tbd、CoreML.framework(4.26新增)、CoreHaptics.framework(4.83新增) | CSJAdSDK.bundle |
| 依赖库 | 系统库 | 依赖资源 |
|---|---|---|
| DCUniAdGm.xcframework、BUAdSDK.xcframework、CSJMediation.xcframework | Accelerate.framework、AdSupport.framework、AudioToolbox.framework、AVFoundation.framework、CoreGraphics.framework、CoreImage.framework、CoreLocation.framework、CoreMotion.framework、CoreMedia.framework、CoreTelephony.framework、CoreText.framework、ImageIO.framework、JavaScriptCore.framework、MapKit.framework、MediaPlayer.framework、MobileCoreServices.framework、QuartzCore.framework、Security.framework、StoreKit.framework、SystemConfiguration.framework、UIKit.framework、WebKit.framework、DeviceCheck.framework、libbz2.tbd、libc++.tbd、libiconv.tbd、libresolv.9.tbd、libsqlite3.tbd、libxml2.tbd、libz.tbd、libc++abi.tbd、CoreML.framework(4.26新增)、CoreHaptics.framework(4.83新增) | CSJAdSDK.bundle |
| 依赖库 | 系统库 | 依赖资源 |
|---|---|---|
| DCUniAdGdt.xcframework、GDTMobSDK.xcframework、Tquic.xcframework | AdSupport.framework、CoreLocation.framework、QuartzCore.framework、SystemConfiguration.framework、CoreTelephony.framework、Security.framework、StoreKit.framework、AVFoundation.framework、WebKit.framework、JavaScriptCore.framework、libz.tbd、libc++.tbd、libxml2.tbd、sqlite3.tbd | 无 |
优量汇的隐私清单需要手动合并到App的隐私清单中内容如下

| 依赖库 | 系统库 | 依赖资源 |
|---|---|---|
| DCUniAdKs.xcframework、KSAdSDK.xcframework(动态库) | Foundation.framework、UIKit.framework、MobileCoreServices.framework、CoreGraphics.framework、Security.framework、SystemConfiguration.framework、CoreTelephony.framework、AdSupport.framework、CoreData.framework、StoreKit.framework、AVFoundation.framework、MediaPlayer.framework、CoreMedia.framework、WebKit.framework、Accelerate.framework、CoreLocation.framework、AVKit.framework、MessageUI.framework、QuickLook.framework、AddressBook.framework、CoreMotion.framework、libz.tbd、libresolv.9.tbd、libsqlite3.tbd、libc++.tbd、libc++abi.tbd | 无 |
快手广告SDK使用Libs/KSAdSDK.xcframework 快手内容联盟SDK(包含广告SDK)使用Libs/KSAdSDK.framework
| 依赖库 | 系统库 | 依赖资源 |
|---|---|---|
| DCUniAdSgm.xcframework、WindSDK.xcframework、WindFoundation.xcframework | StoreKit.framework、CFNetwork.framework、CoreMedia.framework、AdSupport.framework、CoreGraphics.framework、AVFoundation.framework、CoreLocation.framework、CoreTelephony.framework、SafariServices.framework、MobileCoreServices.framework、WebKit.framework、SystemConfiguration.framework、ImageIO.framework、libz.tbd、libsqlite3.tbd | 无 |
| 依赖库 | 系统库 | 依赖资源 |
|---|---|---|
| DCUniAdBd.xcframework、BaiduMobAdSDK.framework | StoreKit.framework、SafariServices.framework、MessageUI.framework、CoreMedia.framework、CoreMotion.framework、SystemConfiguration.framework、CoreLocation.framework、CoreTelephony.framework、AVFoundation.framework、AdSupport.framework、Webkit.framework、libc++.tbd | baidumobadsdk.bundle |
| 依赖库 | 系统库 | 依赖资源 |
|---|---|---|
| libWeChatSDK.a、DCUniAdWm.xcframework | CoreGraphics.framework、Security.framework、Webkit.framework | 无 |
1.在工程的 info -> URL types 中添加配置,identifier 填写weixin,URL Schemes 填写wx[后面填写appid],如下图所示

2.在 info.plist 添加 Schemes 白名单

3.配置Associated Domains(域名),填写通用链接域名

4.在 info.plist 添加 weixin 项,填写微信 appid 及 UniversalLinks,值和您在微信开放平台配置的一致,参考如下:

| 依赖库 | 系统库 | 依赖资源 |
|---|---|---|
| OctAdSDK.xcframework、OctCore.xcframework、OctUniAdSDK.xcframework | AdSupport.framework、libc++.tbd | OctAdSDK.bundle、OctCore.bundle |
| 依赖库 | 系统库 | 依赖资源 |
|---|---|---|
| FLAdSaas.xcframework、FLAdUniAdapter.xcframework | AdSupport.framework | 无 |
| 依赖库 | 系统库 | 依赖资源 |
|---|---|---|
| YouTuiAdSDK.xcframework、YTRelayFoundation.xcframework、DCUniAdYT.xcframework | AdSupport.framework | YouTuiAdSDK.bundle |
如果出现uni-AD业务状态提醒如下:

1、请在Xcode工程中删除未在uni-AD广告平台申请的广告相关的配置(包括库,资源文件等),例如在uni-AD广告平台添加了穿山甲的广告,但没有添加广点通的广告,这时需要删除掉广点通广告的相关配置。
2、如果是自己集成的广告(如,穿山甲、广点通),需要在Xcode工程中删除自己集成的广告,同时建议去uni-AD广告平台申请广告。
3、HBuilderX 5.12 及以下版本手动集成 uni-AD 时,uni 项目必须添加 libDCUniAdWeexModule.a。HBuilderX 5.13+ 启用任意 UniAd-* Pod 后会自动依赖 UniAd-Base 并集成该库,无需手动添加。