兩種方式創(chuàng)建uni-app項目
1 通過HBuilderX創(chuàng)建
MacOSX安裝HBuilderX
HBuilderX下載地址: 下載地址
MacOSX，軟件必須安裝到
/Applications目錄，如未安裝到此目錄，可能會出現(xiàn)插件安裝失敗、項目創(chuàng)建失敗等問題。
如果啟動遇到下列問題，請到【系統(tǒng)設(shè)置】中解決。
image.png
image.png
配置文件目錄
配置文件目錄，如下：
$HOME/Library/Application\ Support/HBuilder\ X$HOME/Library/Caches/HBuilder\ X
請注意： mac上，如果路徑包含空格，需要\進行轉(zhuǎn)義
啟動問題
某些情況下，MacOSX HBuilderX無法啟動，解決方法如下：
刪除.lock文件
打開操作系統(tǒng)終端，輸入如下命令：
rm -f $HOME/Library/Application\ Support/HBuilder\ X/.lock
如刪除.lock文件還無法解決啟動問題，請嘗試刪除配置文件目錄, 詳見。
重置配置文件目錄
如在HBuilderX內(nèi)，曾設(shè)置過快捷鍵、代碼塊、以及其它設(shè)置項，如需保存，刪除前，建議備份。 目錄：$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
工程創(chuàng)建
在點擊工具欄里的文件 -> 新建 -> 項目（快捷鍵Ctrl+N）：
新建
選擇uni-app類型，輸入工程名，選擇模板，點擊創(chuàng)建，即可成功創(chuàng)建。
uni-app自帶的模板有 默認的空項目模板、Hello uni-app 官方組件和API示例，還有一個重要模板是 uni ui項目模板，日常開發(fā)推薦使用該模板，已內(nèi)置大量常用組件。
模版選擇
通過命令行創(chuàng)建:可以使用
cli方式創(chuàng)建項目，另見文檔。
運行uni-app
- 瀏覽器運行：進入hello-uniapp項目，點擊工具欄的運行 -> 運行到瀏覽器 -> 選擇瀏覽器，即可體驗 uni-app 的 web 版。
image.png
- 運行App到手機或模擬器：使用電壓足夠的usb端口連接手機，設(shè)置中開啟USB調(diào)試，手機上允許電腦設(shè)備調(diào)試手機，進入hello-uniapp項目，點擊工具欄的運行 -> 運行App到手機或模擬器，即可在該設(shè)備里面體驗uni-app。
image.png
* 如手機或模擬器無法識別，請點擊[常見故障排查指南](https://uniapp.dcloud.net.cn/tutorial/run/run-app-faq.html)。
- 如需運行在蘋果手機真機上，注意需使用自定義基座。詳見
- 在微信開發(fā)者工具里運行：進入hello-uniapp項目，點擊工具欄的運行 -> 運行到小程序模擬器 -> 微信開發(fā)者工具，即可在微信開發(fā)者工具里面體驗uni-app。
image.png
**注意**：如果是第一次使用，需要先配置小程序ide的相關(guān)路徑，才能運行成功。如下圖，需在輸入框輸入微信開發(fā)者工具的安裝路徑。
image.png
**注意**：微信開發(fā)者工具需要開啟服務(wù)端口 在微信工具的設(shè)置->安全中。
- 在支付寶小程序開發(fā)者工具里運行：進入hello-uniapp項目，點擊工具欄的運行 -> 運行到小程序模擬器 -> 支付寶小程序開發(fā)者工具，即可在支付寶小程序開發(fā)者工具里面體驗uni-app。
image.png
- 在百度、抖音、QQ、快應(yīng)用（分聯(lián)盟和華為）、快手、飛書、360、京東等小程序開發(fā)工具里運行：內(nèi)容同上
安卓開啟開發(fā)者模式
image.png
