入门
在您开始使用 TPLLBA 进行 iOS 开发之前,需要下载 iOS 的 TPLLBA SDK。
步骤 1:获取 Xcode 的最新版本
要使用 TPLLBA SDK 为 iOS 构建项目,您需要 版本 9.0 或更高 的 Xcode。
步骤 2:安装 SDK
TPLLBA iOS SDK 可作为 CocoaPods pod 提供。CocoaPods 是一个开源的依赖管理器,适用于 Swift 和 Objective-C 的 Cocoa 项目。
如果您还没有 CocoaPods 工具,请在 macOS 的终端中运行以下命令进行安装。有关详细信息,请参阅CocoaPods 入门指南。
sudo gem install cocoapods
为 TPLLBA iOS SDK 创建一个 Podfile
文件,并使用它安装 API 和其依赖项
-
如果您还没有 Xcode 项目,请现在创建一个并将其保存在本地计算机上。(如果您是 iOS 开发的初学者,请创建一个单视图应用程序。)
-
在项目目录中创建一个名为
Podfile
的文件。该文件定义了项目依赖关系。 -
编辑
Podfile
并添加您的依赖项。下面是一个包括您为 TPLLBA iOS SDK 需要的依赖项的示例
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
pod 'TPLLBA'
end
-
保存
Podfile
-
在终端中打开包含
Podfile
的目录
cd <path-to-project>
-
运行
pod install
命令。这将安装Podfile
中指定的 API 以及它们可能具有的任何依赖项。 -
关闭 Xcode,然后双击项目目录中的
.xcworkspace
文件以打开 Xcode。从现在开始,您必须使用.xcworkspace
文件来打开项目。
步骤 3: 实现
以下代码演示了如何在应用程序中启动 TPLLBA 引擎。
现在,更新你应用程序的 AppDelegate
类内部的一些方法。
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// Override point for customization after application launch.
LBAds.shared().initializeAdsWithAppId("APP_ID")
return true
}
设置 APNS 令牌以发送推送通知
func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
// Convert token to string
let deviceTokenString = deviceToken.reduce("", {$0 + String(format: "%02X", $1)})
LBAds.shared().setAPNSToken(deviceTokenString)
}
停止后台服务
func applicationDidEnterBackground(_ application: UIApplication) {
LBAds.shared().applicationDidEnterBackground()
}
在应用程序变得活跃时启动服务
func applicationDidBecomeActive(_ application: UIApplication) {
LBAds.shared().applicationWillEnterForeground()
}
低于 iOS 10 支持
将以下代码添加以显示广告通知
func application(_ application: UIApplication, didReceive notification: UILocalNotification) {
LBAds.shared().notificationTapped(notification)
}
重要提示
以下设置是使 SDK 正常运行的必要条件
- App Transport Security 设置:允许任意加载:是
- 隐私 - 总是使用位置 - 使用描述:[向用户显示的消息]
- 隐私 - 总是和在使用时使用位置 - 使用描述:[向用户显示的消息]
- 隐私 - 在使用时使用位置 - 使用描述:[向用户显示的消息]
在功能列表中
- 启用后台模式以更新位置和后台获取
- 开启远程通知