ToBid

简体中文

English

简体中文

English

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'9.0
Admobpod 'ToBid-iOS/AdmobAdapter'12.0
AppLovinpod 'ToBid-iOS/AppLovinAdapter'11.0
百度pod 'ToBid-iOS/BaiduAdapter'8.0
穿山甲pod 'ToBid-iOS/TouTiaoAdapter'10.0
腾讯优量汇pod 'ToBid-iOS/GDTAdapter'9.0
IronSourcepod 'ToBid-iOS/IronSourceAdapter'11.0
Klevinpod 'ToBid-iOS/KlevinAdapter'9.0
快手pod 'ToBid-iOS/KSAdapter'9.0
Mintegralpod 'ToBid-iOS/MintegralAdapter'9.0
UnityAdspod 'ToBid-iOS/UnityAdsAdapter'10.0
Vunglepod 'ToBid-iOS/VungleAdapter'11.0
美数pod 'ToBid-iOS/MSAdAdapter'10.0
趣盟pod 'ToBid-iOS/QuMengAdapter'11.0
京媒pod 'JADYunAdapter'11.0
自定义竞价回传插件pod 'ToBid-iOS/BidResultAdapter'9.0

当导入某个适配器时，会自动通过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，点击“+”，依次添加下列依赖库

  • CoreML.framework （SDK4.0.0及以上版本新增,穿山甲/Gromore6.3.0.0及以上版本新增）

以下是TOBID需要的库，手动集成还需参考添加的渠道需要的依赖库。

  • libc++abi.tbd
  • 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