在前面的小节中,我们已经对uni-app做了简单的介绍,相信大家都对uni-app有了一定的了解。
本小节带领大家创建第一个uni-app项目。
创建uni-app项目有两种方式:第一种是通过官方的开发者工具HBuilder来创建,第二种是通过vue-cli命令行创建。
使用cli创建项目,编译器是安装在单独的项目下面的,升级时需要手动命令升级,只对这一个项目生效。
使用HBuilderX创建项目,编译器是装在HBuilderX的插件目录下面了,HBuilderX版本更新,编译器就会一起更新升级,对所有项目生效。日常开发建议大家直接使用HBuilder创建项目就可以了。
HBuilderX是uni-app官方推出的开发者工具,里面内置了开发环境,不需要额外配置nodejs环境,可以帮我们省去很多麻烦。
先来点开官方网址下载HBuilderX开发者工具,建议下载App开发版。
接下来,我们通过刚刚下载的HBuilderX开发者工具创建一个uni-app项目,要跟着一起操作哦。点击工具栏中的文件->新建->项目:
会出现一个弹窗,接下来我们需要选择uni-app类型,输入项目名称,修改项目路径,选择合适的模板,点击创建,项目就创建成功啦。
选择模板的时候,有几个模板选项。分别是:
打开pages/index/index.vue文件,将标签的内容替换成下面的代码。实例:
1.运行到浏览器
点击工具栏中的运行->运行到浏览器->选择相应的浏览器运行:
选择浏览器之后,HBuilderX开发者工具会出现正在编译的提示,第一次运行会慢一点,编译成功后,自动打开浏览器并显示项目的页面。可以看到HelloWorld打印出来了。
2.运行到内置浏览器
点击工具栏中的运行->运行到内置浏览器,会出现一个Web浏览器的弹出框,第一次打开会比较慢,需要耐心等一会才会出现项目的页面。
3.运行到手机或模拟器
使用这个功能需要先用数据线连接手机,否则会提示“未检测到手机或模拟器,请稍后再试”。
数据线连接手机后,我们再点击工具栏中的运行->运行到手机或模拟器。系统会自动在我们手机上面安装HBuilderX手机版。
在手机上面打开HBuilderX手机版,就可以看到HelloWorld页面。
Tips:如果打开手机版HBuilderX没有看到正确的页面,可以关掉手机应用进程,重新打开看一下。如果编译出错,点击查看工具栏中的运行->运行到手机或模拟器->真机运行常见故障排除指南,排除错误。
4.运行到小程序模拟器
第一次使用小程序模拟器,需要先安装小程序开发者工具,并在工具栏->运行->运行到小程序模拟器->运行设置中设置小程序开发者工具安装的路径。
点击工具栏的运行->运行到小程序模拟器->百度开发者工具,在百度开发者工具中打开HBuilderX控制台中提示的项目路径,就可以在百度开发者工具中体验uni-app。
点击工具栏的运行->运行到小程序模拟器->支付宝小程序开发者工具,在支付宝小程序开发者工具中打开HBuilderX控制台中提示的项目路径,就可以在支付宝小程序开发者工具中体验uni-app。
点击工具栏的运行->运行到小程序模拟器->字节跳动开发者工具,在字节跳动开发者工具中打开HBuilderX控制台中提示的项目路径,就可以在字节跳动开发者工具中体验uni-app。
我们在终端通过vue-cli命令行创建uni-app项目,在创建项目之前,需要保证电脑已经配置了nodejs环境。
npminstall-g@vue/cli4.2创建uni-app项目创建正式版项目,对应HBuilderX最新正式版,最常用
vuecreate-pdcloudio/uni-preset-vuemy-project使用alpha版项目,对应HBuilderX最新alpha版,可能不太稳定
vuecreate-pdcloudio/uni-preset-vue#alphamy-alpha-project创建项目的过程中会提示选择项目模板,一般选择默认模板就可以了。
如果想要选择自定义模板,需要先填写一个uni-app模板地址,这个地址可以是托管在GitHub上面的仓库地址,地址格式为userName/repositoryName,比如dcloudio/uni-template-picture就是下载图片模板。
更多的下载方式,可以参考这个插件的说明:download-git-repo
npmrundev:%PLATFORM%%PLATFORM%可取值如下:
Tips:dev模式编译出的各平台代码存放于根目录下的/dist/dev/目录,打开各平台开发工具选择对应的平台目录即可进行预览(h5平台不会在此目录,存在于缓存中);build模式编译出的各平台代码存放于根目录下的/dist/build/目录,发布时选择此目录进行发布;dev和build模式的区别:dev模式有SourceMap可以方便的进行断点调试;build模式进行代码进行压缩,体积更小更适合发布为正式版应用;进行环境判断时,dev模式process.env.NODE_ENV的转换开发,构建模式process.env.NODE_ENV的转换生产。
本节主要介绍了uni-app项目创建的两种方式,本节的重点如下: