快应用 是移动互联网新型应用生态,与手机系统深度整合,为用户提供更加场景化的体验。具备传统 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",
},

但,由于中所周知的原因,很可能在您的机器上,会下载失败,无法成功获取;所以在 2021 年低,有将模版中的地址修改为 Gitee 仓库:
"devDependencies": {
"@tpes/quickapp": "git+https://gitee.com/vivoquickapp/quickapp-types.git",
}
如果您的项目建立较早,如今重新安装依赖,遇到这个问题。只需替换掉这个依赖地址,删除 package-lock.json
,重新安装(运行命令:npm i
)即可。当然,直接删除这个依赖也可以;只不过,提示接口补全,还有跳转功能,将会缺失。
您可能会感兴趣的文章