tencent cloud

常见构建问题

PDF
聚焦模式
字号
最后更新时间: 2025-12-19 23:01:35

接入小程序 SDK 后,执行项目编译构建时,出现如下 AAPT 问题

AAPT: error: attribute android:requestLegacyExternalStorage not found.
解决方法:
AndroidManifest.xml<application> 标签下添加如下配置:
<application
android:theme="@style/AppTheme"
tools:replace="android:icon"
tools:remove="android:requestLegacyExternalStorage">
/application>

接入小程序 SDK 后,执行项目编译构建时,出现如下“Duplicate class android.support.v4”问题

Duplicate class android.support.v4.app.INotificationSideChannel found in modules core-1.3.1-runtime (androidx.core:core:1.3.1) and support-v4-21.0.3-runtime (com.android.support:support-v4:21.0.3)
解决方法:
gradle.properties中添加如下代码:
android.useAndroidX=true
android.enableJetifier=true

接入小程序 SDK 后,执行项目编译构建时,出现如下“compileDebugJavaWithJavac”版本匹配问题:

Execution failed for task ':app:kaptGenerateStubsDebugKotlin'.
> 'compileDebugJavaWithJavac' task (current target is 1.8) and 'kaptGenerateStubsDebugKotlin' task (current target is 17) jvm target compatibility should be set to the same Java version.
Consider using JVM toolchain: https://kotl.in/gradle/jvm/toolchain
解决方法:
将 build.gradle 中的 compileOptions 中的 JDK 版本修改为合适版本。
android {

compileOptions {
sourceCompatibility JavaVersion.VERSION_17 //需要匹配kapt版本
targetCompatibility JavaVersion.VERSION_17 //需要匹配kapt版本
}
}

接入小程序 SDK 后,执行项目编译构建时,出现如下“java.lang.NoClassDefFound,ProxyService”问题,如下图


解决方法:
检查工程中是否有如下配置,如果有则去掉。
kapt.include.compile.classpath=false

小程序 SDK 支持的最小 Android 系统版本是多少?

最小 SDK 版本(minSdkVersion):21,对应 Android 版本为 Android 5.0。

如何移除 SDK中不需要的语言资源

SDK 默认支持英语、法语、阿拉伯语、印度尼西亚语等多种语言,您可以在 app 模块 build.gradle 下添加 resConfigs,配置支持的语言列表,以达到移除其他语言资源的目的。
android {
defaultConfig {
// 配置您需要支持的语言,其他语言会被排除
resConfigs "en", "fr"
}
}

如何解决 libc++_shared.so 不满足 16KB 页面对齐要求问题

TCSAS SDK 中已经集成了支持 16KB 对齐的 libc++_shared.so,不过 superapp 中可能会因为使用了低版本 NDK或者其他第三方库引入低版本 libc++_shared.so,导致编译警告或者运行时错误,解决办法如下:
1. 升级 NDK 至 24 及以上版本。
2. 升级引入低版本 libc++_shared.so 的 SDK。
3. 如果无法通过以上两种方法解决,还可以手动拷贝一份 ndk24r 以上版本中的 libc++_shared.so 至 app module 中,结合构建脚本中packagingOptions.pickFirst规则来强制升级 libc++_shared.so。



帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈