You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Ionic 5中更新Android目标API等级?解决Google Play报错

解决Ionic 5上传AAB时的API Level 31要求问题(无需修改原生Android配置)

方法1:通过config.xml配置

直接在项目根目录的config.xml中添加/修改配置,无需触碰Android原生文件:

  • 找到或新增<platform name="android">块,加入以下偏好设置:
<platform name="android">
    <!-- 指定目标API Level为31及以上 -->
    <preference name="android-targetSdkVersion" value="31" />
    <!-- 可选:根据需求设置最低兼容SDK版本 -->
    <preference name="android-minSdkVersion" value="21" />
</platform>

修改完成后重新构建AAB:

# Capacitor项目
ionic build && ionic capacitor build android --prod --release

# Cordova项目
ionic cordova build android --prod --release

方法2:构建时通过环境变量临时指定

如果不想修改config.xml,可在构建命令中通过环境变量直接指定目标SDK版本:

# Cordova项目
ANDROID_TARGET_SDK_VERSION=31 ionic cordova build android --prod --release

# Capacitor项目
ANDROID_TARGET_SDK_VERSION=31 ionic capacitor sync android
ionic capacitor build android --prod --release

方法3:升级Cordova Android平台版本

低版本cordova-android默认目标SDK较低,升级到支持API 31的版本即可自动适配:

# 移除旧平台
ionic cordova platform rm android
# 安装支持API31的版本(10.x及以上版本均支持)
ionic cordova platform add android@10.1.1

升级后重新构建项目,默认目标SDK会满足Google Play的要求。

验证配置有效性

构建完成后,可通过以下方式确认目标API Level是否生效:

  • 查看自动生成的platforms/android/app/build.gradle文件,检查targetSdkVersion值是否为31及以上
  • 用Android Studio打开项目,在File > Project Structure > Modules > app中查看Target SDK Version

注意:若使用Capacitor,需确保@capacitor/android版本为3.x及以上,这类版本原生支持API Level 31,执行capacitor sync即可同步配置。

内容的提问来源于stack exchange,提问作者ahadcse

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.02 23:55:25