Ionic Capacitor 5应用提交Play控制台遇目标API级别不符问题

提交Ionic Capacitor 5应用更新至Google Play控制台时，收到如下错误提示：

您的应用当前目标API级别为26，必须至少针对API级别31构建，以确保使用最新的安全与性能优化API。请将应用的目标API级别更改为至少31。

但我已在variables.gradle中设置目标API级别为33：

minSdkVersion = 26
compileSdkVersion = 33
targetSdkVersion = 33
androidxActivityVersion = '1.7.0'
androidxAppCompatVersion = '1.6.1'
androidxCoordinatorLayoutVersion = '1.2.0'
androidxCoreVersion = '1.10.0'
androidxFragmentVersion = '1.5.6'
junitVersion = '4.13.2'
androidxJunitVersion = '1.1.5'
androidxEspressoCoreVersion = '3.5.1'
cordovaAndroidVersion = '10.1.1'
androidxMaterialVersion = '1.8.0'
androidxBrowserVersion = '1.5.0'
androidxExifInterfaceVersion = '1.3.6'
firebaseMessagingVersion = '23.1.2'
playServicesLocationVersion = '21.0.1'
// capacitor-background-geolocation variables
googlePlayServicesLocationVersion = '21.0.1'
coreSplashScreenVersion = '1.0.0'
androidxWebkitVersion = '1.6.1'
okHttpVersion = "4.9.1"
localBroadcastManagerVersion = "1.0.0"

应用的build.gradle配置如下：

apply plugin: 'com.android.application'

Project background_geolocation = project(':transistorsoft-capacitor-background-geolocation')
apply from: "${background_geolocation.projectDir}/app.gradle"

android {
    namespace "com.XXX"
    compileSdkVersion rootProject.ext.compileSdkVersion
    defaultConfig {
        applicationId 'com.XXX'
        minSdkVersion rootProject.ext.minSdkVersion
        targetSdk targetSdkVersion
        versionCode 24
        versionName '3.3.3'
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            // [background-geolocation] Proguard-rules
            proguardFiles "${background_geolocation.projectDir}/proguard-rules.pro"
        }
    }
}

repositories {
    flatDir{
        dirs '../capacitor-cordova-android-plugins/src/main/libs', 'libs'
    }
}

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
    implementation project(':capacitor-android')
    testImplementation "junit:junit:$junitVersion"
    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
    implementation project(':capacitor-cordova-android-plugins')
}

apply from: 'capacitor.build.gradle'

try {
    def servicesJSON = file('google-services.json')
    if (servicesJSON.text) {
        apply plugin: 'com.google.gms.google-services'
    }
} catch(Exception e) {
    logger.warn("google-services.json not found, google-services plugin not applied. Push Notifications won't work")
}

将minSdkVersion改为31时无错误，但会限制更新仅面向较新设备。请问问题出在哪里，如何在扩展对旧设备支持的前提下解决该问题？

问题出在build.gradle的defaultConfig块中，目标API版本的引用语法错误，导致没有正确加载variables.gradle中定义的targetSdkVersion=33，最终使用了默认值26。

1. 修复build.gradle中的版本引用 #

打开android/app/build.gradle，找到defaultConfig部分，将：

targetSdk targetSdkVersion

替换为：

targetSdkVersion rootProject.ext.targetSdkVersion

这个修改和minSdkVersion的引用语法保持一致，确保正确读取variables.gradle中定义的目标API版本。

2. 清理构建缓存并重新构建 #

执行以下命令清理旧的构建缓存，避免残留配置影响结果：

# macOS/Linux
./gradlew clean

# Windows
gradlew clean

然后重新构建发布版本：

# 用Gradle直接构建
./gradlew assembleRelease

# 或者用Capacitor命令构建
npx cap build android --prod

3. 验证并重新上传 #

构建完成后，重新生成的APK/AAB会正确使用targetSdkVersion=33，同时保留minSdkVersion=26，既满足Google Play的要求，又不会限制旧设备的用户更新。

内容的提问来源于stack exchange，提问作者user3550966