Angular转Ionic应用后访问Cordova插件报模块找不到错误
将Angular项目转换为Ionic后,应用在Android真机运行正常,但集成ionic-screen-recorder插件时,编译报错找不到cordova-plugin-screenrecord模块,当前技术栈版本为Angular 11.0.2、TypeScript 4.0.5、Ionic 6.12.3。
Cordova类原生插件的JS接口是运行时由原生层注入的,并非可直接在编译阶段import的npm模块,同时你是从纯Angular项目迁移到Ionic,大概率存在插件安装不完整、错误引入原生模块的问题。
第一步:通过官方命令补全插件安装,不要手动在package.json添加依赖
先删除package.json中手动添加的插件依赖项,执行npm install清理旧配置后,再执行以下命令,确保插件不仅在npm依赖中,同时被注册到原生工程:# 安装Cordova原生插件 ionic cordova plugin add cordova-plugin-screenrecord # 安装对应兼容Angular11的Ionic Native封装(如果使用该封装) npm install @ionic-native/screen-recorder@5安装完成后执行
ionic cordova prepare android同步原生工程配置。若你使用Capacitor替代Cordova,安装完插件后执行
npx cap sync同步原生工程配置即可。第二步:移除代码中直接引入
cordova-plugin-screenrecord的import语句
这类底层Cordova原生插件的接口是运行时注入的,不需要在编译阶段引入,直接import会触发打包器找不到模块的报错。
如果使用第三方TS封装包(即你已安装的ionic-screen-recorder),仅import封装包本身即可;如果没有使用封装包,改用运行时从window对象获取的方式调用,同时加平台判断避免开发环境报错:// 错误写法(直接删除):import 'cordova-plugin-screenrecord' // 正确写法(使用封装包时):import { ScreenRecorder } from 'ionic-screen-recorder'; import { Platform } from '@ionic/angular'; constructor(private platform: Platform) { this.platform.ready().then(() => { // 无封装包时,从运行时注入的cordova对象获取插件 const screenRecorder = window['cordova']?.plugins?.screenrecord; if (!screenRecorder) { console.warn('当前环境不支持屏幕录制插件'); return; } // 后续正常调用插件方法即可 }); }第三步:补充TypeScript类型声明,避免TS编译报错
如果需要给window上的插件属性加类型提示,在项目src文件夹下新建declarations.d.ts文件,添加以下声明:declare global { interface Window { cordova: { plugins: { screenrecord: any } } } } export {};第四步:开发环境注意事项
不要在浏览器端(ionic serve启动的Web环境)直接测试该插件,浏览器没有原生注入的Cordova对象,相关逻辑必须在Android真机/模拟器上调试。
内容的提问来源于stack exchange,提问作者Sriram

