Vungle iOS SDK v. 1.0 - v.4.1 开发指南 (Swift)

这份指南会很快帮您使用Swift整合我们的iOS SDK到一个范例App。下载范例App代码--GitHub公开库

须知:

  • Vungle iOS SDK 只支持 iOS版本 7+
  • 集成SDK需要一个vungle的账户。所以在开始之前,如果没有的话 请创建一个
  • 在您创建vungle账户之后, 请到我们的控制面板页面之后,点击添加您的app。您需要以此来获得 App ID并添加到您的app以此使用我们的SDK。如下图红色位置。
  • Test Mode广告只能测试基本的广告播放,如果要测试更多功能请把app改到active模式。
  • 因为中国的网路状况,所以在测试的时候需要等几分钟,可以监测网络状况看视频缓存状况。)(Charles Proxy)
 

现在就可以开始集成SDK啦!一共有7步 :

1. 将Vungle 框架(Framework)添加到Xcode 项目中

Vungle iOS SDK不包括在上面的下载范例中,需要您要到Vungle的控制面板里下载。下载之后,请先解压缩,之后按以下步骤做:

打开解压缩的文件夹, 将VungleSDK.embeddedframework/文件夹拖曳并放到Xcode中,放到Frameworks

注意:VungleSDK.embeddedframework 文件夹是以组群添加 (黄色文件夹) 而不仅是一个参考 (蓝色文件夹)。

 

2. 添加其他需要的框架

由于 Vungle SDK 需要一些其他原生的框架也连接到您的项目中,请在您的项目中点击:

General > Linked Frameworks and Libraries

很多框架可能已经添加了,因为很多都是Xcode项目默认的框架,但是请确认以下的框架都有添加到您的项目当中:

  • AdSupport.framework
  • AudioToolbox.framework
  • AVFoundation.framework
  • CFNetwork.framework
  • CoreGraphics.framework
  • CoreMedia.framework
  • Foundation.framework
  • libz.dylib
  • libsqlite3.dylib
  • MediaPlayer.framework
  • QuartzCore.framework
  • StoreKit.framework
  • SystemConfiguration.framework
  • UIKit.framework
  • WebKit.framework

与此同时,也请检查VungleSDK框架也在Linked Frameworks and Libraries下面。 如果直接的拖曳行为没有产生自动链接的话,请手工添加,点击 '+' ,之后 'Add Other'。

3. 增加-ObjC linker flag

点击Build Settings,在Linking 部分添加-ObjC部分添加

4. 移除 iOS 状态栏(Status Bar)

这个不是必须的一步,但是我们推荐这样做,因为移除状态栏对Vungel的广告展示和体验更加流畅。如果要移除状态栏,请打开您的 Info.pList,添加行"View controller-based status bar appearance"并且设置为"No"

5.  增加Application Transport Security Exception

自从iOS9(通过Xcode 7新建的工程)以后, Application Transport Security需要所有的网络通道安全。您可以阅读更多iOS 9 SDK设置

可以在Info.plist文件中增加NSAppTransportSecurity项,并且其下面增加NSAllowsArbitraryLoads,值为 YES

 

6. 创建Bridging Header文件

  • 在您的工程里创建Objective C文件(File->New->File [Objective C for iOS])。
  • Xcode将会询问您是否创建一个bridging header文件。请接收并创建。

  • 删除新的Objective C文件,但保留bridging header文件${YOURPROJ}-Bridging-Header.h。
  • 在该Bridging header文件中, 添加#import <VungleSDK/VungleSDK.h>

 

7. 添加代码!

  • 初始化 SDK - 请在程序开始时初始化SDK,以便有足够的时间来缓存广告。就像范例app中一样, 把初始化SDK放在AppDelegate中didFinishLaunchingWithOptions这个方法当中(推荐)。

    AppDelegate.swift : didFinishLaunchingWithOptions:

    var appID = "Your AppID Here"
    var sdk = VungleSDK.sharedSDK()
    // 初始化
    sdk.startWithAppId(appID)

 

  • 播放广告 - 在didFinishLaunchingWithOptions方法中初始化SDK后,只需要在任意的ViewContoller中调用如下代码:
  • TopViewController.swift

    var sdk = VungleSDK.sharedSDK()
    sdk.playAd(self)
    

 

高级设置

如果您想了解更多有关Vungle IOS SDK的高级设置(个性化、事件监听器等),欢迎查看我们的高级设置

还有其它问题?提交请求

评论