如何解决「快应用」无法正常编译构建？

快应用

快应用是移动互联网新型应用生态，与手机系统深度整合，为用户提供更加场景化的体验。具备传统 APP 完整的应用体验，但无需安装、即点即用。快应用开发基于前端技术栈，构建是基于 Webpack 二次开发工具：hap-toolkit；在实际开发中，或可能遇到些问题，导致不能正常编译构建；本文就可能导致不能构建的原因、以及解决方案，做下探讨。

如何解决「快应用」无法正常编译构建？

无法安装过 `types/quickapp` 依赖

快应用开发工具，提供了强大的语法辅助功能；其中 JS（Script）代码自动补全，有基于 quickapp-types（ts typing for quickapp）实现；由于各种原因（TypeScript type 机制、Definitely Typed 限制、npm quickapp-types 名称被占用、要方便随时更新等）， quickapp-types 被迫存在以下限制：

开发者本地安装；
依赖名须为： @types/quickapp；
无法提交至 Definitely Typed ；

因此，在早期的模版中， @types/quickapp 依赖地址，写的是 Github 地址，如下代码（package.json）：

"devDependencies": {
    "@types/quickapp": "git+https://github.com/vivoquickapp/quickapp-types.git",
},

快应用 types quickapp 依赖安装失败

但，由于中所周知的原因，很可能在您的机器上，会下载失败，无法成功获取；所以在 2021 年低，有将模版中的地址修改为 Gitee 仓库：

"devDependencies": {
    "@types/quickapp": "git+https://gitee.com/vivoquickapp/quickapp-types.git",
}

如果您的项目建立较早，如今重新安装依赖，遇到这个问题。只需替换掉这个依赖地址，删除 package-lock.json，重新安装（运行命令：npm i）即可。当然，直接删除这个依赖也可以；只不过，提示接口补全，还有跳转功能，将会缺失。

您可能会感兴趣的文章

快应用

ib\util\AsyncQueue.js:280:12)
	at processImmediate (node:internal/timers:464:21)
[ERROR] Module build failed (from ../../AppData/Local/Programs/MultiDeviceIDE/resources/app/extensions/hap-debugger/node_modules/@hap-toolkit/dsl-xvm/lib/loaders/extract-css-loader.js):
ModuleBuildError: Module build failed (from ./node_modules/sass-loader/dist/cjs.js):
Error: Cannot find module 'schema-utils'
Require stack:
- d:\Users\xyzo\MultiDeviceProjects\my-application-0711\node_modules\sass-loader\dist\index.js
- d:\Users\xyzo\MultiDeviceProjects\my-application-0711\node_modules\sass-loader\dist\cjs.js

[ERROR] Module build failed (from ../../AppData/Local/Programs/MultiDeviceIDE/resources/app/extensions/hap-debugger/node_modules/@hap-toolkit/dsl-xvm/lib/loaders/extract-css-loader.js):
ModuleBuildError: Module build failed (from ./node_modules/sass-loader/dist/cjs.js):
Error: Cannot find module 'ajv'
Require stack:
- d:\Users\xyzo\MultiDeviceProjects\my-application-07-11-01\node_modules\schema-utils\dist\validate.js

如报如上错误，只需重启 IDE 即可（至于为何报这个错误，或可能与 lock 文件有关，仍需探究）。