本地Cordova插件路径配置及cordova prepare构建报错咨询

嘿，我刚好碰到过一模一样的情况！当你把自定义插件放在项目子目录、又不想提交node_modules/、plugins/、platforms/这些自动生成目录时，cordova prepare 经常会因为找不到插件的正确来源而报错。别慌，按下面的步骤来解决：

1. 确保自定义插件的package.json配置正确 #

首先检查你的自定义插件子目录里的package.json，必须包含cordova字段来声明插件的核心信息——这是Cordova识别本地插件的关键。比如：

{
  "name": "cordova-plugin-my-custom",
  "version": "1.0.0",
  "cordova": {
    "id": "cordova-plugin-my-custom",
    "platforms": ["android", "ios"] // 按需添加你需要的平台
  }
}

这里的cordova.id必须和你项目config.xml里的插件名称完全一致，比如config.xml里的<plugin name="cordova-plugin-my-custom" .../>，名字要丝毫不差。

2. 在项目根目录的package.json里添加本地插件依赖 #

因为你没提交plugins/目录，Cordova需要明确知道去哪里找这个本地插件。在项目根目录的package.json的dependencies里加一行，指向你的插件子目录路径：

"dependencies": {
  // 其他依赖...
  "cordova-plugin-my-custom": "file:./plugins/cordova-plugin-my-custom" // 换成你的实际路径
}

这样npm install的时候，会自动把本地插件关联到node_modules里，Cordova就能找到它了。

3. 按正确顺序执行命令 #

检出项目后，别直接跑cordova prepare，按这个顺序来：

# 先安装所有依赖（包括本地插件）
npm install --verbose

# 再让Cordova准备平台和插件
cordova prepare --verbose

这一步会让Cordova从node_modules里读取插件信息，自动重新生成plugins/和platforms/目录里的内容，不需要你手动复制插件文件。

4. 检查config.xml的插件引用 #

确保config.xml里的插件引用没有多余的src属性（除非你特意要覆盖路径），可以改成这样：

<plugin name="cordova-plugin-my-custom" spec="1.0.0" />

这里的spec要和自定义插件package.json里的version完全一致。

5. 还是报错？试试清空缓存重来 #

有时候Cordova或npm的缓存会搞事情，执行以下命令清空后再试：

# 清空Cordova缓存
cordova clean

# 删除npm相关文件
rm -rf node_modules
rm package-lock.json

# 重新安装依赖+prepare
npm install
cordova prepare --verbose

这样操作下来，应该就能解决cordova prepare的报错问题，实现不提交自动生成目录、构建时自动生成的需求了。

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