Skip to content

SDK接入配置

1. 聚合SDK导入

1.1. framework直接导入

获取相应版本的framework库,导入项目工程即可。

必须导入的库:
WindFoundation.xcframework
WindSDK.xcframework
WindMillSDK.xcframework

三方SDK根据需要,导入对应的SDK和适配器即可。详细请查看【第三方广告网络配置说明】

1.2. cocoapod引入

在podfile文件中添加:

objective-c
#核心库,必须添加
pod 'ToBid-iOS'
  
# 各平台的Adapter和sdk根据需要自行选择导入,参考下方PodCode
NetworkPod Code
ToBidpod 'ToBid-iOS'
Admobpod 'ToBid-iOS/AdmobAdapter'
AppLovinpod 'ToBid-iOS/AppLovinAdapter'
百度pod 'ToBid-iOS/BaiduAdapter'
穿山甲pod 'ToBid-iOS/TouTiaoAdapter'
腾讯优量汇pod 'ToBid-iOS/GDTAdapter'
IronSourcepod 'ToBid-iOS/IronSourceAdapter'
Klevinpod 'ToBid-iOS/KlevinAdapter'
快手pod 'ToBid-iOS/KSAdapter'
Mintegralpod 'ToBid-iOS/MintegralAdapter'
UnityAdspod 'ToBid-iOS/UnityAdsAdapter'
Vunglepod 'ToBid-iOS/VungleAdapter'

当导入某个适配器时,会自动通过pod下载对应渠道的SDK,由于Adapter和第三方广告SDK会存在版本兼容问题,所以我们建议通过pod Adapter的方式去依赖第三方广告SDK来确保不会有任何的版本兼容问题。

如果您想要引入特定版本的SDK则需要在pod 语句后面添加版本号(以1.0.0版本为例)、例如: pod 'ToBid-iOS', '1.5.0'

2. Xcode编译选项设置

2.1. Other Linker Flags

在Xcode中选择项目的Targets->Build Settings,配置Other Linker Flags 增加 -ObjC

2.2. 添加HTTP权限

  • 工程plist文件设置,点击右边的information Property List后边的 "+" 展开

添加 App Transport Security Settings,先点击左侧展开箭头,再点右侧加号,Allow Arbitrary Loads 选项自动加入,修改值为 YES。 SDK API 已经全部支持HTTPS,但是广告主素材存在非HTTPS情况。

注意:Allow Arbitrary Loads in Web Content key存在时会忽略Allow Arbitrary Loads的设置(iOS10之后)

xml
<key>NSAppTransportSecurity</key>
    <dict>
         <key>NSAllowsArbitraryLoads</key>
         <true/>
    </dict>

2.3. 添加定位权限

该权限非必须,sdk不包含任何请求定位权限的代码,也不会主动请求定位权限。

工程info.plist文件设置,点击右边的information Property List后边的 "+" 展开 添加Privacy - Location When In Use Usage Description。

2.4. 运行环境配置

  • 支持系统 iOS 9.0 及以上;
  • SDK编译环境 Xcode 12.0 + ;
  • 支持架构:x86-64, armv7, arm64

2.5. 添加依赖库

工程需要在TARGETS -> Build Phases中找到Link Binary With Libraries,点击“+”,依次添加下列依赖库

  • StoreKit.framework
  • CFNetwork.framework
  • CoreMedia.framework
  • AdSupport.framework
  • CoreMotion.framework
  • MediaPlayer.framework
  • CoreGraphics.framework
  • AVFoundation.framework
  • CoreLocation.framework
  • CoreTelephony.framework
  • SafariServices.framework
  • MobileCoreServices.framework
  • WebKit.framework
  • SystemConfiguration.framework
  • AdSupport.framework
  • ImageIO.framework
  • AudioToolbox.framework
  • libc++.tbd
  • libz.tbd
  • libbz2.tbd
  • libsqlite3.tbd