Skip to main content

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>