Ionic Capacitor应用报错Cannot resolve symbol 'Whitelist'，无法构建Android项目

错误原因 #

Whitelist是旧版Cordova的类，Capacitor从4.x版本开始就将其重命名为Allowlist，而Capacitor 6已经完全移除了对Whitelist的支持。另外你的环境中Angular 8.1.3版本过旧，和Capacitor 6存在严重的兼容性冲突，这也是报错的诱因之一。

解决步骤 #

• 替换代码中的Whitelist为Allowlist
  找到Android项目中所有引用Whitelist的代码：

  1. 将导入语句从import org.apache.cordova.Whitelist;改为import com.getcapacitor.plugin.webview.Allowlist;
  2. 把代码中实例化、调用Whitelist的地方全部替换为Allowlist，比如Whitelist whitelist = new Whitelist();改成Allowlist allowlist = new Allowlist();

• 修正Capacitor配置
  打开capacitor.config.ts（或capacitor.config.json），确保用Capacitor 6的语法配置允许导航的域名，示例：

  export default {
    appId: 'com.your.app',
    appName: 'YourApp',
    webDir: 'www',
    server: {
      allowNavigation: ['*.your-domain.com', 'http://localhost:8100']
    }
  };
  

• 解决版本兼容性问题
  Angular 8是2019年的旧版本，Capacitor 6要求Angular 14及以上版本，二者不兼容。二选一处理：

  1. 升级Angular：逐步升级Angular到14+版本（建议选择长期支持版），先升级对应版本的Angular CLI，再升级核心依赖包，逐一处理过程中的依赖冲突。
  2. 降级Capacitor：如果暂时不想升级Angular，可降级到兼容Angular 8的Capacitor 3.x版本，执行命令：

     npm install @capacitor/core@3.9.0 @capacitor/android@3.9.0 @capacitor/ios@3.9.0 --save
     

• 清理重建项目

  1. 在Android Studio中执行Build > Clean Project，再执行Build > Rebuild Project
  2. 运行npx cap sync android重新同步Capacitor配置到Android项目

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