注意事项
"$miliqk"、"$miliqkApi"被占用
miliqk有很多的自带的js工具函数,挂载在$miliqk
对象中,而$miliqk
又挂载在Vue.prototype
中,所以,请勿占用$miliqk
变量名并 挂载到Vue.prototype
。同理,请勿占用$miliqkApi
变量名并挂载到Vue.prototype
。
Vue2 scss 预编译器默认更换为 dart-sass
Tips
uni-app 更新提示:4.56.2025031210【重要】 Vue2 scss 预编译器默认已由 node-sass 更换为 dart-sass,如果您的代码使用了 dart-sass 不支持的旧语法,可能存在部分不兼容的问题。 解决方案:
- 方案1:调整为 dart-sass 支持的语法,将深度选择器 /deep/ 调整为 ::v-deep,详情:https://uniapp.dcloud.net.cn/tutorial/syntax-css.html#css-preprocessor
- 方案2:如果您希望继续使用node-sass,您可以在 manifest.json 中配置 "sassImplementationName": "node-sass",详情:https://uniapp.dcloud.net.cn/tutorial/syntax-css.html#css-preprocessor
miliqk
插件对nvue的支持
什么是nvue
?见关于nvue
miliqk
插件仅首页支持nvue, 其他组件为了兼容多端,暂时不适配。
对VUE3的支持
miliqk
插件全面支持VUE3
技术点要求
miliqk
依赖SCSS
预处理器,所以您需要给HBuilder X安装 “sass/scss编译” 插件,详见快速上手miliqk
基于HX的最新版本开发,旧版本可能会不兼容,如遇问题,请升级HX尝试是否可解决miliqk
要求项目开启uniapp的V3版本,V3有很大的优势,详见V3版本介绍- HX2.5.5稳定版正式引入
easycom
,建议开发者升级HX到2.5.1及以上的稳定版,详见关于easycom
关于Hbuilder X
uniapp依赖于HX,uniapp经过这两年发展(2018-2020),势头强劲,茁壮成长。我们目睹了整个过程,陪着uniapp一起成长,感慨能有 一家良心企业能扎根技术,埋头苦干,把APP,H5还有各家小程序做到大一统,同时也愤慨各家大厂的小程序各自为营,仿佛倒退到多年前 各家浏览器大战的时代,让人唏嘘不已。
根据我们的经验,我们强烈建议:
- 开发者在开发线上项目的时候只使用HX的稳定版
- 初学者不要使用HX内测版,不然会碰到莫名其妙的问题,会挫败学习信心
- 每当HX更新大功能的时候,比如以往的自定义组件模式,近来的V3版本,还是目前的uniCloud,或者以后可能关于nuve的大功能,线上项目请过一段时间再使用。
- 建议喜欢尝鲜并熟悉uniapp的用户,在电脑分别安装HX的稳定版和内测版,尝鲜使用内测版,开发使用稳定版,二者分别更新,互不干扰
编译调试
开发的时候,特别是写布局的时候,我们建议使用chrome或者HX内置的浏览器,需要说明的是,电脑浏览器的预览效果是不精细的, 写完之后,可以手机连上电脑同一局域网的WiFi,在手机浏览器上再进行细微的调整。
写完布局再写逻辑的时候,如果还需要兼容小程序和APP,一定要每写完一个页面,就用APP基座和小程序真机进行调试,这能及早发现问题,否则会剪不断理还乱。
内网穿透
有时候需要通过花生壳等工具,进行内网穿透,让外部的人可以访问到本地的调试网页,这时由于webpack-dev-server
会默认检查hostname
, 去掉此限制即可,在uniapp项目根目录下新建vue.config.js
文件(如果有,不用创建),修改如下内容:
module.exports = {
configureWebpack: {
devServer: {
disableHostCheck: true
}
}
}