SDK 集成

一、TradPlus_Flutter_SDK 导入#

Flutter版本要求: flutter: ">=2.5.0"

1.通过pub.dev集成#

您可以通过 pub.dev集成TradPlus_Flutter_SDK插件

通过命令直接安装

flutter pub add tradplus_sdk

或手动在项目的 pubspec.yaml 中添加依赖，并执行 flutter pub get

dependencies:
  tradplus_sdk: ^1.1.7

然后引入插件

import 'package:tradplus_sdk/tradplus_sdk.dart';

2.手动下载集成#

第一步：下载TradPlus_Flutter_SDK插件#

sdk包含文件如下：

res：附带的默认原生广告布局

tradplus_sdk：flutter平台tradplus插件

第二步：工程目录下创建plugins文件夹,将下载好的SDK插件放入plugins文件夹中#

如图:

第三步：项目工程pubspec.yaml中添加本地依赖#

dependencies:
  flutter:
    sdk: flutter

  cupertino_icons: ^1.0.2
  # 添加TradPlus Flutter SDK本地依赖
  tradplus_sdk:
    path: plugins/tradplus_sdk/

第四步：引入插件#

import 'package:tradplus_sdk/tradplus_sdk.dart';

二、平台配置说明#

（1）Android平台配置#

第一步：TradPlusSDK下载平台下载SDK#

接入方式直接选择Android下载SDK
开发者要确认项目是AndroidX还是Support，引入错误会导致项目编译不过

第二步：导入SDK#

选择需要接入的广告源后，点击“生成接入代码”按钮获取需要的Gradle引用，如图一：

开发者需要将Maven库的引用添加到项目层级的build.gradle中，如图二：

将Gradle引用部分添加到app中build.gradle中，如图三：

第三步：SDK配置#

这步配置开发者需要在AndroidManifest文件中配置，位置如图三所示：

开发者可参考Android SDK配置文档在项目工程中进行配置

（2）IOS平台配置#

有两种导入SDK方式： cocopods配置导入及手动下载导入

cocopods 配置导入 SDK#

1、请至 iOS打包平台下载相关SDK , cocopods接入选择是

2、勾选需要集成的平台

3、选择生成代码

将生成的代码,修改为:

s.dependency 'TradPlusAdSDK', '7.8.10'
s.dependency 'TradPlusAdSDK/FacebookAdapter', '7.8.10'
s.dependency 'FBAudienceNetwork','6.11.1'
s.dependency 'TradPlusAdSDK/AdMobAdapter', '7.8.10'
s.dependency 'Google-Mobile-Ads-SDK','9.7.0'
s.dependency 'TradPlusAdSDK/AppLovinAdapter', '7.8.10'
s.dependency 'AppLovinSDK','11.4.3'
s.dependency 'TradPlusAdSDK/PangleAdapter', '7.8.10'
s.dependency 'Ads-CN/International', '4.5.1.6'
s.dependency 'Ads-CN/BUAdSDK', '4.5.1.6'

3.将修改后的配置添加到 tradplus_sdk.podspec 中

手动下载导入#

1、请至 iOS打包平台下载相关SDK，cocopods接入选择否

2、勾选需要集成的平台，选择生成代码并下载SDK zip包

3、将解压后的 TradPlusFrameworks 文件夹放置在插件iOS目录下

3. 在ios/Runner/Info.plis添加配置#

Http访问请求权限

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

配置 App Tracking Transparency (IDFA) 授权

<key>NSUserTrackingUsageDescription</key>
<string>点击"允许"以使用设备信息获得更加相关的广告内容，未经同意我们不会用于其他目的；开启后，您也可以前往系统“设置-隐私 ”中随时关闭</string>

建议在 ios/Runner/AppDelegate 中添加IDFA授权代码

Objc代码

#import <AppTrackingTransparency/AppTrackingTransparency.h>

 if (@available(iOS 14.5, *)) {
        [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
        }];
 }

swift代码

import AppTrackingTransparency

if #available(iOS 14.5, *) {
    ATTrackingManager.requestTrackingAuthorization { status in
    }
}

设置SKNetworkID

三方SKNetworkID配置

如使用 Admob 或 GoogleAdManager 时需要添加的配置

必须要将产品在 Admob 的唯一性标识写在客户端中，否则将会造成应用crash。

在Info.plist中添加 GADApplicationIdentifier配置, 应用发布时请替换成应用在Admob后台的appid。

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>