本文旨在记录初步接入过程遇到的一点点小问题，更详细的文档还是要参考官方文档。
一、项目版本
GradlePlugin：8.0.2
Gradle：8.0
Kotlin：1.7.20
compileSdk：34
compose-bom:2022.10.00
AS：2022.2.1
穿山甲：5.6.0.7
二、接入穿山甲SDK
1.添加穿山甲SDK下载仓库
maven {
url 'https://artifact.bytedance.com/repository/pangle'
}
2.添加穿山甲SDK
implementation 'com.pangle.cn:ads-sdk-pro:5.6.0.7'
3.添加必要权限
在当下隐私政策要求越来越严，如果不是必要场景尽量不要添加可选权限，且在初始化的时候配置SDK不可主动获取。
<!--必要权限-->
<uses-permission android:name="android.permission.INTERNET" />
<!--必要权限，解决安全风险漏洞，发送和注册广播事件需要调用带有传递权限的接口-->
<permission
android:name="${applicationId}.openadsdk.permission.TT_PANGOLIN"
android:protectionLevel="signature" />
<uses-permission android:name="${applicationId}.openadsdk.permission.TT_PANGOLIN" />
<!--可选权限-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>
<uses-permission android:name="android.permission.GET_TASKS"/>
<!--可选，穿山甲提供"获取地理位置权限"和"不给予地理位置权限，开发者传入地理位置参数"两种方式上报用户位置，两种方式均可不选，添加位置权限或参数将帮助投放定位广告-->
<!--请注意：无论通过何种方式提供给穿山甲用户地理位置，均需向用户声明地理位置权限将应用于穿山甲广告投放，穿山甲不强制获取地理位置信息-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!--demo场景用到的权限，不是必须的-->
<uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.EXPAND_STATUS_BAR" />
<!-- 穿山甲3400版本新增：建议添加"query_all_package"权限，穿山甲将通过此权限在Android R系统上判定广告对应的应用是否在用户的app上安装，避免投放错误的广告，以此提高用户的广告体验。若添加此权限，需要在您的用户隐私文档中声明！ -->
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"/>
4.添加provider
<provider
android:name="com.bytedance.sdk.openadsdk.TTFileProvider"
android:authorities="${applicationId}.TTFileProvider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths" />
</provider>
<provider
android:name="com.bytedance.sdk.openadsdk.multipro.TTMultiProvider"
android:authorities="com.lee.tts.TTMultiProvider"
android:exported="false" />
5.添加so库构架
官网表示其他构架需要联系其技术支持。
ndk {
abiFilters 'armeabi-v7a', 'arm64-v8a'
}
6.初始化SDK
//强烈建议在应用对应的Application#onCreate()方法中调用，避免出现content为null的异常
TTAdSdk.init(mContext, TTAdConfig.Builder()
.appId("5438863")//xxxxxxx为穿山甲媒体平台注册的应用ID
.useTextureView(true) //默认使用SurfaceView播放视频广告,当有SurfaceView冲突的场景，可以使用TextureView
.appName("文本转语音助手")
.titleBarTheme(TTAdConstant.TITLE_BAR_THEME_DARK)//落地页主题
.allowShowNotify(true) //是否允许sdk展示通知栏提示,若设置为false则会导致通知栏不显示下载进度，存在违规风险，请勿随意更改
.debug(true) //测试阶段打开，可以通过日志排查问题，上线时去除该调用
.directDownloadNetworkType(TTAdConstant.NETWORK_STATE_WIFI) //允许直接下载的网络状态集合,没有设置的网络下点击下载apk会有二次确认弹窗，弹窗中会披露应用信息
.supportMultiProcess(false) //是否支持多进程，true支持
.customController(object : TTCustomController() { // 隐私信息控制开关
/**
* 是否允许SDK主动使用地理位置信息
*
* @return true可以获取，false禁止获取。默认为true
*/
override fun isCanUseLocation(): Boolean {
return false
}
/**
* 当isCanUseLocation=false时，可传入地理位置信息，穿山甲sdk使用您传入的地理位置信息
*
* @return 地理位置参数
*/
// override fun getTTLocation(): TTLocation? {
// return null
// }
/**
* 是否允许SDK主动使用手机硬件参数，如：imei
*
* @return true可以使用，false禁止使用。默认为true
*/
override fun isCanUsePhoneState(): Boolean {
return false
}
/**
* 当isCanUsePhoneState=false时，可传入imei信息，穿山甲sdk使用您传入的imei信息
*
* @return imei信息
*/
// override fun getDevImei(): String? {
// return null
// }
/**
* 是否允许SDK主动使用ACCESS_WIFI_STATE权限
*
* @return true可以使用，false禁止使用。默认为true
*/
// override fun isCanUseWifiState(): Boolean {
// return true
// }
/**
* 是否允许SDK主动使用WRITE_EXTERNAL_STORAGE权限
*
* @return true可以使用，false禁止使用。默认为true
*/
override fun isCanUseWriteExternal(): Boolean {
return false
}
/**
* 开发者可以传入oaid
* 信通院OAID的相关采集------如何获取OAID：
* 1. 移动安全联盟官网http://www.msa-alliance.cn/
* 2. 信通院统一SDK下载http://msa-alliance.cn/col.jsp?id=120
* @return oaid
*/
// override fun getDevOaid(): String? {
// return null
// }
/**
* 是否允许SDK主动获取设备上应用安装列表的采集权限
*
* @return true可以使用，false禁止使用。默认为true
*/
override fun alist(): Boolean {
return false
}
/**
* 是否允许SDK主动获取ANDROID_ID
*
* 4600新增
*
* @return 默认true 允许 ， false 不允许
*/
// override fun isCanUseAndroidId(): Boolean {
// return true
// }
/**
* 是否允许SDK在申明和授权了的情况下使用录音权限
*
* @return true 允许 false 不允许
*/
// override fun isCanUsePermissionRecordAudio(): Boolean {
// return true
// }
})
.build())
7.启动SDK
穿山甲需要启动才能正常使用。
TTAdSdk.start(object : TTAdSdk.Callback {
override fun success() {
Log.d(TAG, "TTAdSdk.start success.")
}
override fun fail(code: Int, msg: String?) {
Log.d(TAG, "TTAdSdk.start fail. code=$code, msg=$msg")
}
})
三、填坑
1.FileProvider
从第二节第4点可以看到provider的meta-data是android.support.FILE_PROVIDER_PATHS，正常来说我们升级到AndroidX用的应该是androidx.core.content.FileProvider，我们先保持跟穿山甲文档一致然后运行。
Caused by: java.lang.ClassNotFoundException: Didn't find class "android.support.v4.content.FileProvider"
我们可以看到报错了，那改成 androidx.core.content.FileProvider再运行呢？还是一样的错，那就不是这个问题，如果有过support项目升级的经验，我们就知道在升级AndroidX的时候AS在gradle.properties添加了如下配置：
android.useAndroidX=true
# Automatically convert third-party libraries to use AndroidX
android.enableJetifier=true
useAndroidX不用说，关键是enableJetifier=true，看注释说的是自动将第三方SDK转换成使用AndroidX。看到这里就知道了，首先TTFileProvider用的是android.support的FileProvider，只能通过设置enableJetifier去转换。那么meta-data到底能不能改呢？带着这个疑问，我们继续运行：
java.lang.RuntimeException: Unable to get provider com.bytedance.sdk.openadsdk.TTFileProvider: java.lang.IllegalArgumentException: Missing android.support.FILE_PROVIDER_PATHS meta-data
看到报错就知道还是只能照着文档写，不能改！
2.ClassNotFoundException
解决完FileProvider问题后继续运行，这时候又有报错了。
Caused by: java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/fragment/app/FragmentActivity;
Caused by: java.lang.ClassNotFoundException: Didn't find class "androidx.appcompat.view.ContextThemeWrapper"
这两个问题其实跟FileProvider是相连的，第三方SDK在enableJetifier=true时转换成AndroidX了，但是新建的项目并没有引用AndroidX的fragment，所以就报错了，加上就可以了。其实如果不是新建项目改成了compose应该是没有这个问题的，我记得compose之前创建项目会有相关依赖。
implementation 'androidx.appcompat:appcompat:1.6.1'
implementation 'androidx.fragment:fragment-ktx:1.5.5'
四、开屏广告
前面配置好了到这一步其实就简单了，只是有始有终再多写两句。
首先，我们需要在穿山甲平台创建一个应用，具体截图就不插入了，没什么难点。
然后，从文档了解到，如果需要播放广告，我们需要为应用新建广告位，比如开屏广告位，新建好之后会有个广告代码位字符串，这是我们请求相应广告位广告的关键。
最后，上代码。
mTTAdNative = TTAdSdk.getAdManager().createAdNative(this)
val adSlot = AdSlot.Builder()
.setCodeId("888565580")
//不区分渲染方式，要求开发者同时设置setImageAcceptedSize（单位：px）和setExpressViewAcceptedSize（单位：dp ）接口，不同时设置可能会导致展示异常。
.setImageAcceptedSize(resources.displayMetrics.widthPixels, resources.displayMetrics.heightPixels)
.setExpressViewAcceptedSize(resources.displayMetrics.widthPixels / resources.displayMetrics.density + 0.5f, resources.displayMetrics.heightPixels / resources.displayMetrics.density + 0.5f)
.setAdLoadType(TTAdLoadType.PRELOAD)//推荐使用，用于标注此次的广告请求用途为预加载（当做缓存）还是实时加载，方便后续为开发者优化相关策略
.build()
mTTAdNative.loadSplashAd(adSlot, object : TTAdNative.CSJSplashAdListener {
//开屏素材加载成功
override fun onSplashLoadSuccess() {
Log.d(TAG, "onSplashLoadSuccess")
}
//加载开屏素材失败
override fun onSplashLoadFail(p0: CSJAdError?) {
Log.d(TAG, "onSplashLoadFail=${p0?.msg}")
//开发者处理跳转到APP主页面逻辑
gotoMain()
}
//开屏渲染成功，可以展示开屏
override fun onSplashRenderSuccess(ad: CSJSplashAd?) {
Log.d(TAG, "onSplashRenderSuccess")
ad?.let {
mSplashView = it.splashView
return
}
//开发者处理跳转到APP主页面逻辑
gotoMain()
}
override fun onSplashRenderFail(ad: CSJSplashAd?, err: CSJAdError?) {
Log.d(TAG, "onSplashRenderFail=${err?.msg}")
//开发者处理跳转到APP主页面逻辑
gotoMain()
}
}, 3500)
至此穿山甲SDK的接入就已经完成了，后续的业务请根据自身需求进行开发。