English
Log In
You can then view all documents
Installation/Android/工程配置
工程配置
Last updated 2022-09-21 14:03:50

注意:此版本sdk不适用于中国以外的安卓商店/渠道。开发者如果有海外流量对接需求,烦请发送邮件至pangle_support@bytedance.com,以便获取到正确的海外专属安卓SDK版本进行对接。

SDK集成

申请应用的CodeId

请在穿山甲平台上创建好应用ID和广告位ID


方式一:导入aar及SDK依赖的jar包

将本SDK压缩包内的open_ad_sdk.aar复制到Application Module/libs文件夹(没有的话须手动创建), 并将以下代码添加到您app的build.gradle中:


方式二:从穿山甲3.5.0.6版本开始,开发者也可以使用Gradle依赖导入穿山甲SDK

步骤一:添加仓库

project级别的build.gradle文件中添加Maven的引用,url 'https://artifact.bytedance.com/repository/pangle'

示例:

步骤二:添加依赖

在主modulebuild.gradle文件添加SDK依赖

Gradle版本要求:

自3400版本开始,穿山甲支持了Android R,引入了Android R的 <queries> 标签,需要对gradle版本进行限制,限制范围为:3.3.3、 3.4.3、 3.5.4、3.6.4、4.0.1 ,开发者根据自身情况酌情升级


AndroidManifest配置

添加权限

注意: 穿山甲SDK不强制获取以上权限,即使没有获取可选权限SDK也能正常运行;获取以上权限将帮助穿山甲优化投放广告精准度和用户的交互体验,提高eCPM。

建议在广告请求前,合适的时机调用SDK提供的方法,在用户可以授权的情况下获取到声明中的权限,提高广告变现效率


provider配置

注意(1)为不影响下载类型广告使用 无论APP处于任何阶段provider都需要在清单文件中正常配置(2)为不影响到广告的转化及收益 请务必在清单文件中配置xxx.TTMultiProvider(3)${applicationId} 必须与开发者包名保持一致,否则会引发崩溃问题


适配Anroid7.0及以上如果您的应用需要在Anroid7.0及以上环境运行,请在AndroidManifest中添加如下代码:

在res/xml目录下,新建一个xml文件file_paths,在该文件中添加如下代码:

为了适配下载和安装相关功能,在工程中引用的包 com.android.support:support-v4:24.2.0使用24.2.0以及以上版本

注意:单进程或多进程都必须配置


运行环境配置

本SDK可运行于Android4.0 (API Level 14) 及以上版本。<uses-sdk android:minSdkVersion="14" android:targetSdkVersion="24" />

如果开发者声明targetSdkVersion到API 23以上,请确保调用本SDK的任何接口前,已经申请到了SDK要求的所有权限,否则SDK部分特性可能受限


代码混淆

如果您需要使用proguard混淆代码,需确保不要混淆SDK的代码。 请在proguard.cfg文件(或其他混淆文件)尾部添加如下配置:35xx以及以下版本混淆规则如下:

36xx版本-38xx版本混淆规则如下

3900版本及以上版本混淆规则如下

4000版本混淆规则:以aar包里的混淆文件为准

注意: SDK代码被混淆后会导致广告无法展现或者其它异常


支持架构

注意: 3900以及以上版本SDK默认支持armeabi-v7a,arm64-v8a两种架构,如果有其他架构(armeabi架构)需求,请联系技术支持同学; 3900以下版本SDK中使用的so文件支持五种架构:x86,x86_64,armeabi,armeabi-v7a,arm64-v8a

您可以在应用中的build.gradle中使用abiFilters选择支持的架构。如下所示:

说明:1、36xx-38xx版本中穿山甲增加了libmetasec_ml.so 库。2、36xx-38xx版本若开发者使用armeabi架构,那么需要把armeabi-v7a下的 libmetasec_ml.so 拷贝到armeabi目录下使用。


白名单配置

注意:平台SDK包中whiteList.txt 白名单上的资源不支持混淆



Contents
Contact us