Cordova Angular应用集成CodePush插件后白屏报CodePush无'ɵmod'属性错误

报错Type CodePush does not have 'ɵmod' property本质是Angular Ivy编译逻辑触发的元数据校验失败：
Angular在解析NgModule的imports数组时，会要求数组里的每一个元素都是合法的Angular模块，会去读取每个类上由编译器生成的内部标记属性ɵmod来验证模块合法性。把不属于NgModule的CodePush类误塞进imports数组时，就会因为找不到这个属性直接抛错，触发后续的白屏问题。

• 第一优先级：修正错误的模块导入逻辑
  绝大多数场景下，这个报错都是照着过时教程把CodePush当成Angular模块导入导致的。CodePush是原生能力的JS封装服务，本身不是NgModule，完全不需要出现在imports数组里。
  先检查你的app.module.ts文件，找到类似下面的错误写法，把这行代码从imports数组里删除：

  // 错误写法：直接将CodePush作为NgModule导入，直接触发报错
  @NgModule({
    declarations: [AppComponent],
    imports: [
      // 其他合法的Angular模块比如BrowserModule、IonicModule
      CodePush // 删掉这行
    ]
  })
  export class AppModule {}
  

  如果需要在应用里注入CodePush实例，只需要把它放到providers数组中即可，后续在组件、服务里通过依赖注入直接使用，比如：

  // 正确写法：在providers中声明，不放到imports
  @NgModule({
    providers: [
      CodePush
    ]
  })
  export class AppModule {}
  

• 第二优先级：校验依赖版本的兼容性
  改完导入逻辑如果还报同样的错，就要检查版本错配问题：
  • 如果你使用Angular 13及以上版本，不能搭配3.x及更早版本的@awesome-cordova-plugins/code-push包。旧版本的插件是为Angular View Engine渲染器设计的，没有适配Ivy的元数据生成逻辑，哪怕导入逻辑正确，也会触发元数据校验失败。
  • 兼容匹配规则：Angular 12及以上版本，需要搭配6.x及以上版本的@awesome-cordova-plugins/code-push；Cordova-android 10及以上版本，需要搭配2.0.8及以上版本的原生codepush插件，不要使用已经停止维护的早期弃用版本。
    核对版本不对的话，直接安装匹配的最新稳定版即可。
• 第三优先级：清理旧编译缓存
  修正代码和依赖后，Angular CLI的历史编译缓存可能还保留着之前错误的模块映射关系，导致明明代码已经改对，还是报之前的旧报错。直接删除项目根目录下的.angular缓存文件夹、node_modules/.cache目录，重新执行生产构建，再把构建产物同步到Cordova项目中运行即可。
• 兜底方案：跳过Angular封装直接调用原生接口
  如果不需要用到插件的封装层，完全可以绕开所有Angular层面的依赖注入逻辑，直接在应用启动时读取全局的window.CodePush对象调用原生能力，从根源上避免把CodePush类传入Angular的模块校验流程。

内容的提问来源于stack exchange，提问作者Phone Naing Kha