两种方式创建uni-app项目
1 通过HBuilderX创建
MacOSX安装HBuilderX
HBuilderX下载地址: 下载地址
MacOSX，软件必须安装到
/Applications目录，如未安装到此目录，可能会出现插件安装失败、项目创建失败等问题。
如果启动遇到下列问题，请到【系统设置】中解决。
image.png
image.png
配置文件目录
配置文件目录，如下：
$HOME/Library/Application\ Support/HBuilder\ X$HOME/Library/Caches/HBuilder\ X
请注意： mac上，如果路径包含空格，需要\进行转义
启动问题
某些情况下，MacOSX HBuilderX无法启动，解决方法如下：
删除.lock文件
打开操作系统终端，输入如下命令：
rm -f $HOME/Library/Application\ Support/HBuilder\ X/.lock
如删除.lock文件还无法解决启动问题，请尝试删除配置文件目录, 详见。
重置配置文件目录
如在HBuilderX内，曾设置过快捷键、代码块、以及其它设置项，如需保存，删除前，建议备份。 目录：$HOME/Library/Application\ Support/HBuilder\ X/user
#### 备份配置文件，如不需要，请略过
cp -r $HOME/Library/Application\ Support/HBuilder\ X $HOME/Desktop/HX
#### 直接删除配置文件目录
rm -r $HOME/Library/Application\ Support/HBuilder\ X
rm -r $HOME/Library/Caches/HBuilder\ X
工程创建
在点击工具栏里的文件 -> 新建 -> 项目（快捷键Ctrl+N）：
新建
选择uni-app类型，输入工程名，选择模板，点击创建，即可成功创建。
uni-app自带的模板有 默认的空项目模板、Hello uni-app 官方组件和API示例，还有一个重要模板是 uni ui项目模板，日常开发推荐使用该模板，已内置大量常用组件。
模版选择
通过命令行创建:可以使用
cli方式创建项目，另见文档。
运行uni-app
- 浏览器运行：进入hello-uniapp项目，点击工具栏的运行 -> 运行到浏览器 -> 选择浏览器，即可体验 uni-app 的 web 版。
image.png
- 运行App到手机或模拟器：使用电压足够的usb端口连接手机，设置中开启USB调试，手机上允许电脑设备调试手机，进入hello-uniapp项目，点击工具栏的运行 -> 运行App到手机或模拟器，即可在该设备里面体验uni-app。
image.png
* 如手机或模拟器无法识别，请点击[常见故障排查指南](https://uniapp.dcloud.net.cn/tutorial/run/run-app-faq.html)。
- 如需运行在苹果手机真机上，注意需使用自定义基座。详见
- 在微信开发者工具里运行：进入hello-uniapp项目，点击工具栏的运行 -> 运行到小程序模拟器 -> 微信开发者工具，即可在微信开发者工具里面体验uni-app。
image.png
**注意**：如果是第一次使用，需要先配置小程序ide的相关路径，才能运行成功。如下图，需在输入框输入微信开发者工具的安装路径。
image.png
**注意**：微信开发者工具需要开启服务端口 在微信工具的设置->安全中。
- 在支付宝小程序开发者工具里运行：进入hello-uniapp项目，点击工具栏的运行 -> 运行到小程序模拟器 -> 支付宝小程序开发者工具，即可在支付宝小程序开发者工具里面体验uni-app。
image.png
- 在百度、抖音、QQ、快应用（分联盟和华为）、快手、飞书、360、京东等小程序开发工具里运行：内容同上
安卓开启开发者模式
image.png
