旧Ionic Capacitor项目打包签名APK遇依赖与类型兼容问题求助

问题背景 #

项目环境：

Ionic:
Ionic CLI                     : 6.17.1 (/usr/local/lib/node_modules/@ionic/cli)
Ionic Framework               : @ionic/angular 5.9.4
@angular-devkit/build-angular : 0.1102.19
@angular-devkit/schematics    : 11.2.19
@angular/cli                  : 11.1.4
@ionic/angular-toolkit        : 3.1.1

Capacitor:
Capacitor CLI      : 2.4.6
@capacitor/android : 2.5.0
@capacitor/core    : 2.5.0
@capacitor/ios     : not installed

Utility:
cordova-res : 0.15.4
native-run  : not installed globally

项目基于Ionic+Capacitor开发，引入了@awesome-cordova-plugins/barcode-scanner、@awesome-cordova-plugins/in-app-browser等Cordova插件，打包签名APK时遇到以下核心问题：

1. 无法从已废弃的jcenter仓库找到org.apache.cordova:framework:7.0.0依赖
2. 升级cordovaAndroidVersion到10.1.1后，出现Activity cannot be converted to AppCompatActivity类型转换错误
3. Capacitor 2版本无npx cap migrate命令，无法使用该方案迁移配置

解决方案 #

1. 替换仓库并升级Cordova Android版本 #

打开android/build.gradle，移除jcenter仓库并替换为mavenCentral，同时指定cordovaAndroidVersion为10.1.1：

// android/build.gradle
buildscript {
    repositories {
        google()
        mavenCentral() // 替换jcenter
    }
    // 保留原有buildscript配置
}

allprojects {
    repositories {
        google()
        mavenCentral() // 替换jcenter
        maven { url 'https://maven.google.com' } // 保留谷歌仓库
    }
}

ext {
    cordovaAndroidVersion = '10.1.1' // 升级到兼容的版本
}

2. 修复Activity与AppCompatActivity兼容问题 #

Capacitor 2默认的MainActivity继承自Activity，但高版本Cordova插件依赖AppCompatActivity，需要修改android/app/src/main/java/[你的包名]/MainActivity.java：

• 将父类从Activity改为AppCompatActivity
• 新增对应的包导入

修改后的代码示例：

package com.yourpackage;

import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity; // 新增导入
import com.getcapacitor.BridgeActivity;

public class MainActivity extends AppCompatActivity { // 替换Activity为AppCompatActivity
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        BridgeActivity.load(this); // 保留原有初始化逻辑
    }
}

若项目中存在其他自定义Activity类，需同步修改继承关系为AppCompatActivity。

3. 手动同步Capacitor与Cordova插件配置 #

由于Capacitor 2不支持cap migrate命令，需手动重置Android项目：

1. 删除旧的Android项目目录：

   rm -rf android
   

2. 重新生成Android项目并同步依赖：

   npx cap add android
   npx cap sync android
   

3. 重新安装项目依赖并同步：

   npm install
   npx cap sync android
   

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

最后执行清理缓存和打包命令：

cd android
./gradlew clean
./gradlew assembleRelease

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