f53071fd5c64dabecb7a3c86e9dc76c1.png


uni-app支持通过 HBuilderX可视化界面、vue-cli命令行两种方式快速创建项目。本篇文章讲解uni-app通过 HBuilderX可视化界面构建项目。可视化的方式比较简单,HBuilderX内置相关环境,开箱即用,无需配置node。开始之前,开发者需先下载安装如下工具:

1.HBuilderX:官方IDE。建议下载App开发版,如下载标准版,还需在插件管理中安装uni-app插件。2.微信开发者工具:必备调试预览工具。

A.创建uni-app

1.在点击工具栏里的文件 -> 新建 -> 项目:

3513ccdbcc553301825119922366f26f.png

2.选择uni-app,输入工程名,如:hello-uniapp,点击创建,即可成功创建 uni-app。点击模板里的 Hello uni-app 即可体验官方示例建议创建普通项目。

811a60b9890ec3f0211f47e46f5d5413.png

B.运行uni-app

1.真机运行:连接手机,开启USB调试,进入hello-uniapp项目,点击工具栏的运行 -> 真机运行 -> 选择运行的设备,即可在该设备里面体验uni-app。

976c09fa426b6c14f011666b1d1a23df.png


2.浏览器运行:进入hello-uniapp项目,点击工具栏的运行 -> 运行到浏览器 -> 选择浏览器,即可在浏览器里面体验uni-app 的 H5 版。

0bf0900ccc60584510dcb29482b4a2e8.png

3.在微信开发者工具里运行:进入hello-uniapp项目,点击工具栏的运行 -> 运行到小程序模拟器 -> 微信开发者工具,即可在微信开发者工具里面体验uni-app。 

2b054f409807b3b59254bd0c8828c164.png

注意

如果是第一次使用,需要先配置小程序ide的相关路径,才能运行成功。
如下图,在HBuilderX的工具-运行配置-小程序运行配置中 ,在输入框输入微信开发者工具的安装路径。
若HBuilderX不能正常启动微信开发者工具,很有可能是路径填写错误,或者微信开发者工具版本过低,或者微信开发工具内未填写appid。请注意HBuilderX的报警提示,然后更改正确。
如果都正常还是无法启动成功,需要开发者手动启动,将uni-app生成小程序工程的路径拷贝到微信开发者工具里面,(uni-app默认把项目编译到根目录的unpackage目录,那么生成小程序目录是unpackage/dist/dev/mp-weixin)。成功之后在HBuilderX里面开发,在微信开发者工具里面就可看到实时的效果。

2aa79137c449bdaf90e830fb55fa24c8.png

4.支付宝小程序和百度小程序同理微信小程序

C.发布uni-app

1.打包为原生App(云端)

在HBuilderX工具栏,点击发行,选择原生app-云端打包,如下图:

4708e4f8c13d4e3acb29768400de43c4.png

出现如下界面,点击打包即可。

04a43b23a9214c16b1d03da5db9e4783.png

2.打包为原生App(离线)

uni-app 支持离线打包,在 HBuilderX 生成离线打包资源,即可进行离线打包。在HBuilderX工具栏,点击发行,选择本地打包,如下图,点击即可生成离线打包资源。

838677b6cb396a9199aa0114658b200e.png

3.发布为H5

1.在 manifest.json 的可视化界面,进行如下配置(发行在网站根目录可不配置应用基本路径),此时发行网站路径是 www.xxx.com/h5。

12843e0aa3ff3bf40c00bc06e16c732d.png

2.在HBuilderX工具栏,点击发行,选择网站-H5手机版,如下图,点击即可生成 H5 的相关资源文件,保存于 unpackage 目录。

bfd260357f4f920eab8286bf714d5cbd.png

注意:history 模式发行需要后台配置支持,详见:history 模式的后端配置  启动https协议请勾选,否则页面会一片空白

4.发布为小程序

A.发布为微信小程序:1. 申请微信小程序AppID,参考:微信教程。2. 在HBuilderX中顶部菜单依次点击 "发行" => "小程序-微信",输入小程序名称和appid点击发行即可在 unpackage/dist/build/mp-weixin 生成微信小程序项目代码。

69e586b5a8f27f598d199823e130a75e.png3. 在微信开小程序发者工具中,导入生成的微信小程序项目,测试项目代码运行正常后,点击"上传"按钮,之后按照 "提交审核" => "发布" 小程序标准流程,逐步操作即可,详细查看:微信官方教程。

B.发布为支付宝小程序:

1.入驻支付宝小程序,参考:支付宝小程序教程。
2.在HBuilderX中顶部菜单依次点击 "发行" => "小程序-支付宝",即可在 /unpackage/dist/build/mp-alipay 生成支付宝小程序项目代码。

0beefb4a39539519136674323b04dde2.png

 3.在支付宝小程序开发者工具中,导入生成的支付宝小程序项目,测试项目代码运行正常后,点击"上传"按钮上传代码,在 支付宝小程序后台,选择刚提交的版本点击提交审核,详见:支付宝小程序文档。

C.发布为百度小程序与微信小程序同理

交流

我是小叶,现在是一名中高级前端工程师,目前正处在不断学习跟探索的道路上。接下来会跟大家分享在学习路上遇到的各种问题以及生活中的温暖陪伴, 让我带你走进小叶的世界!

f030258e01750c05699cfd05e8313f26.png

更多推荐