uni-app支持通过 HBuilderX可视化界面、vue-cli命令行两种方式快速创建项目。

HBuilderX可视化界面（推荐）

可视化的方式比较简单，HBuilderX内置相关环境，开箱即用，无需配置nodejs。

开始之前，开发者需先下载安装如下工具：

HBuilderX：官方IDE下载地址【下载App开发版】

• 创建uni-app

在点击工具栏里的文件 -> 新建 -> 项目：选择uni-app，输入工程名，如：hello-uniapp，点击创建，即可成功创建 uni-app。点击模板里的 Hello uni-app 即可体验官方示例。

• 运行uni-app

进入hello-uniapp项目，点击工具栏的运行 -> 运行到浏览器 -> 选择浏览器，即可在浏览器里面体验uni-app 的 H5 版, 点击工具栏的运行 -> 真机运行 -> 选择运行的设备，即可在该设备里面体验uni-app, 点击工具栏的运行 -> 运行到小程序模拟器 -> 微信开发者工具，即可在微信开发者工具里面体验uni-app,点击工具栏的运行 -> 运行到小程序模拟器 -> 支付宝小程序开发者工具，即可在支付宝小程序开发者工具里面体验uni-app,点击工具栏的运行 -> 运行到小程序模拟器 -> 字节跳动开发者工具，即可在字节跳动开发者工具里面体验uni-app。

运行的快捷键是Ctrl+r

• 发布uni-app

发布为微信小程序：[发布其他见官网]

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

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

vue-cli命令行

HBuilderX：官方IDE下载地址【下载App标准版】

除了可视化界面，也可以使用 cli 脚手架，可以通过 vue-cli 创建 uni-app 项目。

注意：

• vue-cli 版本必须是3.x
• cli 版本更新快于HBuilderX正式版。HBuilderX正式版所包含的uni-app编译器一般是在cli版发布一段时间并稳定后才会更新到HBuilderX正式版。cli版适合喜欢鼓捣的尝鲜者，其好处是可以及时获取新功能，坏处是稳定性不如HBuilderX正式版，但因为开源，所以也欢迎开发者一起完善。

全局安装vue-cli

npm install -g @vue/cli

创建uni-app

vue create -p dcloudio/uni-preset-vue my-project

此时，会提示选择项目模板，初次体验建议选择 hello uni-app 项目模板，如下所示：

自定义模板

选择自定义模板时，需要填写 uni-app 模板地址，这个地址其实就是托管在云端的仓库地址。以 GitHub 为例，地址格式为 userName/repositoryName，如 dcloudio/uni-template-picture 就是下载图片模板。

更多支持的下载方式，请参考这个插件的说明：download-git-repo

运行并发布uni-app

npm run dev:%PLATFORM%
npm run build:%PLATFORM%