iOS SDK集成说明

前言

我们支持iOS 11.0系统及以上版本。

概述

本指南介绍了京媒SDK 在 iOS 应用中的集成。

京媒SDK 支持多种广告格式，包括开屏广告、信息流广告。

整合我们的开屏广告和信息流广告在您的应用程序，并遵循我们的平台集成介绍。

Ads ID

在进行 SDK 集成之前，您得先有一个 京媒合作平台 的账号，然后注册您的应用、创建广告位等操作，得到集成所必要的信息：appID 和 slotID。

appID: appID 是给开发者应用分配的唯一标识，您可以在京媒合作平台创建应用后即可获取 appID。

slotID: 是广告位的唯一标识。开发者可以创建多个广告位。 京媒SDK 广告位类型支持开屏、信息流四种广告类型。

注意

v2.0.0版本后，支持了单独广告功能进行集成，目前支持 模板开屏、模板信息流、媒体渲染广告单独集成。

例：如您只需开屏模板广告类型，则可集成基础模块 JADYunCore.xcframework 与 JADYunSplash.xcframework 。

步骤1. 将SDK添加到您的项目中

• pod接入方式：

  // 整包方式
  pod 'JADYun'
  // 分包方式
  pod 'JADYunCore'
  pod 'JADYunSplash'
  // 如需接入摇一摇功能
  pod 'JADYunMotion'
  

• 手动下载SDK方式:

  下载SDK后，直接将 JADYun.xcframework 文件拖入工程即可。

  如若你下载的多包，可直接将 JADYunCore.xcframework 与 JADYunSplash.xcframework 等文件拖入工程即可。

  如需接入摇一摇功能，需引入JADYunMotion.xcframework

  步骤2. Build Settings

1. Add Linker Flags

在Build Settings中添加配置:

Target ➣ Build Settings ➣ Linking ➣ Other Linker Flags:

具体操作如图：

2. App Transport Security Settings

添加一个名为 'App Transport Security Settings' 的字典，确保将次字典添加到 'Top Level Key'上。

在此字典中，添加一个名为 'Allow Arbitrary Loads' 的布尔值 并将其 设置为YES。

具体操作如图：

3. 运行环境配置

• 支持系统 iOS 11.X 及以上
• SDK 编译环境 Xcode 15.0 及以上
• 支持架构：x86-64，arm64

4. 添加依赖

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

• CoreMotion.framework
• SafariServices.framework
• CoreLocation.framework
• MapKit.framework
• AdSupport.framework
• CoreTelephony.framework
• SystemConfiguration.framework
• WebKit.framework
• ImageIO.framework
• Accelerate.framework
• Photos.framework
• AssetsLibrary.framework
• CoreServices.framework
• libz.tbd
• libsqlite3.tbd

具体操作如图：

5. Objective-C 集成

方式1：新建Swift File，创建完成后提示是否创建桥接文件，选择Create Bridging Header

具体操作如图：

方式2：新建桥接文件头文件并配置 Build Settings

具体操作如图：

6. Swift 集成

新建桥接文件头文件并配置 Build Settings

具体操作如图：

步骤 3. 京媒SDK 初始化

#import <JADYun/JADYunSDK.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {    
    [JADYunSDK initWithAppID:@"YOUR_JADYun_APP_ID" asyncCompletionHandler:^(BOOL success, NSError * _Nonnull error) {
        if (success) {
            dispatch_async(dispatch_get_main_queue(), ^{
                // work to do
            });
        }
    }];
}

如果您集成的为JADYunCore.xcframework，则注意头文件引用

#import <JADYunCore/JADYunSDK.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {    
    [JADYunSDK initWithAppID:@"YOUR_JADYun_APP_ID" asyncCompletionHandler:^(BOOL success, NSError * _Nonnull error) {
        if (success) {
            dispatch_async(dispatch_get_main_queue(), ^{
                // work to do
            });
        }
    }];
}

SDK Demo 工程接入注意事项

• appID 修改为京媒合作平台申请的 appID
• Build Settings - Bundle Identifier 修改为京媒合作平台申请的 ‘程序包名’

具体操作如图：

恭喜您完成了京媒SDK的集成。接下来需要做的工作：

1、在您的应用中集成开屏、信息流广告。 2、按照我们的指导手册集成广告。