Skip to main content

导入和配置

  • 如果您是初次使用TradPlus SDK,我们建议您利用Demo来了解SDK的使用。

一、添加SDK到项目工程#

TradPlus支持通过 gradle 添加 SDK 到工程中,开发者可以通过TradPlusSDK下载平台获取 Gradle引用

二、清单文件配置#

开发者需在App级别的AndroidManifest.xml文件中添加如下配置:

<manifest
xmlns:android="http://schemas.android.com/apk/res/android"
package="your package name"
xmlns:tools="http://schemas.android.com/tools">
<!--声明权限-->
<!--穿山甲CSJ国内 必要权限-->
<permission
android:name="${applicationId}.openadsdk.permission.TT_PANGOLIN"
android:protectionLevel="signature" />
<uses-permission android:name="${applicationId}.openadsdk.permission.TT_PANGOLIN" />
<!--穿山甲CSJ 国内、Pangle V45以下,请务必添加,否则黑屏 -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!--Android 12 以上,同意获取 Android Advertiser Identifier -->
<uses-permission android:name="android.permission.AD_ID" />
<application
<!-- 视频广告的硬件加速 -->
android:hardwareAccelerated="true"
<!-- AndroidV9.2写入SDK,无需配置;老版本升级的项目会因清单文件中有添加过该配置导致报错,删除配置即可 -->
<!-- 添加网络安全配置,文件见下文 -->
android:networkSecurityConfig="@xml/network_security_config">
<!-- Apache的兼容 -->
<uses-library android:name="org.apache.http.legacy" android:required="false"/>
</application>
</manifest>
  • 在项目的res/xml文件夹新增network_security_config.xml,内容如下:
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<domain-config
cleartextTrafficPermitted="true">
<domain includeSubdomains="true">127.0.0.1</domain>
</domain-config>
</network-security-config>

三、混淆配置#

  • 开启混淆后,在proguard-rules.pro中添加混淆配置
-keep public class com.tradplus.** { *; }
-keep class com.tradplus.ads.** { *; }

四、初始化SDK#

  • 建议在Application中初始化SDK
TradPlusSdk.initSdk(context, "您在TradPlus平台创建的应用ID");

五、资源优化#

广告SDK的资源不能被混淆,如果使用第三方的资源优化框架,请配置SDK的资源为白名单,例如:

TradPlus#

R.string.tp_*
R.drawable.tp_*
R.layout.tp_*
R.id.tp_*

集成交叉推广#

R.string.cp_*
R.drawable.cp_*
R.layout.cp_*
R.id.cp_*

集成游可赢Klevin#

R.anim.klevin_*
R.color.klevin_*
R.drawable.klevin_*
R.id.klevin_*
R.layout.klevin_*
R.mipmap.klevin_*
R.string.klevin_*
R.integer.klevin_*
R.style.klevin_*
R.dimen.klevin_*
R.xml.klevin_*

集成Pangle#

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
tools:keep="@layout/tt_*,
@layout/notification_*,
@anim/tt_*,
@drawable/tt_*,
@string/tt_*,
@color/tt_*,
@string/ad*,
@string/star_*,
@dimen/tt_*,
@integer/tt_*,
@style/tt_*,
@style/Theme.Dialog.TT_*,
@style/tt_*,
@style/quick_*,
@style/EditTextStyle*"
@attr/tt_*"/>
  • 除此之外,Pangle还需要根据接入的Pangle版本进行白明单资源配置
  • 下载 whiteList.txt

集成腾讯优量汇#

"R.integer.min_screen_width_bucket",
"R.style.DialogAnimationUp",
"R.style.DialogAnimationRight",
"R.style.DialogFullScreen",
"R.drawable.gdt_*"

集成Mintegral#

"R.string.mbridge*",
"R.layout.mbridge*",
"R.drawable.mbridge*",
"R.anim.mbridge*",
"R.color.mbridge*",
"R.style.mbridge*",
"R.id.mbridge*"

六、注意事项#

在测试应用时,Admob和Meta请确保使用的是测试广告,而不是正式广告,否则会有封号风险。

//开启测试模式,上线前注释
TestDeviceUtil.setNeedTestDevice(true,"测试设备ID");