Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
df122b1f
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3172
Star
105
Fork
804
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
67
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
67
合并请求
67
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
df122b1f
编写于
2月 10, 2022
作者:
hbcui1984
提交者:
DCloud_LXH
2月 11, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
补充CLI工具
上级
ad5cbdbe
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
102 addition
and
1 deletion
+102
-1
docs/worktile/CLI.md
docs/worktile/CLI.md
+102
-1
未找到文件。
docs/worktile/CLI.md
浏览文件 @
df122b1f
### cli 工具
\ No newline at end of file
`uni-app`
提供有完整的
`cli`
脚手架,可以通过
`vue-cli`
创建、运行、发行
`uni-app`
项目。
## 环境安装
全局安装vue-cli
```
shell
npm
install
-g
@vue/cli
```
## 创建uni-app
*
使用正式版(对应HBuilderX最新正式版)
```
shell
vue create
-p
dcloudio/uni-preset-vue my-project
```
*
使用alpha版(对应HBuilderX最新alpha版)
```
shell
vue create
-p
dcloudio/uni-preset-vue#alpha my-alpha-project
```
*
使用Vue3/Vite版
*
创建以 javascript 开发的工程(如命令行创建失败,请直接访问
[
gitee
](
https://gitee.com/dcloud/uni-preset-vue/repository/archive/vite.zip
)
下载模板)
```
shell
npx degit dcloudio/uni-preset-vue#vite my-vue3-project
```
*
创建以 typescript 开发的工程(如命令行创建失败,请直接访问
[
gitee
](
https://gitee.com/dcloud/uni-preset-vue/repository/archive/vite-ts.zip
)
下载模板)
```
shell
npx degit dcloudio/uni-preset-vue#vite-ts my-vue3-project
```
此时,会提示选择项目模板(使用Vue3/Vite版不会提示,目前只支持创建默认模板),初次体验建议选择
`hello uni-app`
项目模板,如下所示:
<div>
<img
src=
"https://img.cdn.aliyun.dcloud.net.cn/guide/uniapp/h5-cli-01.png"
width=
"300"
>
</div>
#### 自定义模板
选择自定义模板时,需要填写 uni-app 模板地址,这个地址其实就是托管在云端的仓库地址。以 GitHub 为例,地址格式为
`userName/repositoryName`
,如
`dcloudio/uni-template-picture`
就是下载图片模板。
更多支持的下载方式,请参考这个插件的说明:
[
download-git-repo
](
https://www.npmjs.com/package/download-git-repo
)
#### 国内特殊情况
模板项目存放于 Github,由于国内网络环境问题,可能下载失败。针对此问题可以尝试如下措施:
*
更换网络重试,比如使用 4g 网络
*
在设备或路由器的网络设置中增加 DNS(如:8.8.8.8)
*
在设备中增加固定的 hosts(如:140.82.113.4 github.com)
#### 修改依赖为指定版本@cliversion
可以使用
[
@dcloudio/uvm
](
https://www.npmjs.com/package/@dcloudio/uvm
)
管理编译器的版本:
*
更新到最新正式版
```
shell
npx @dcloudio/uvm
```
*
更新到最新 alpha 版
```
shell
npx @dcloudio/uvm alpha
```
*
更新到正式版指定版本
```
shell
npx @dcloudio/uvm 3.2.12.20211029
```
*
更新到 alpha 版指定版本
```
shell
npx @dcloudio/uvm 3.2.14.20211112-alpha
```
## 运行、发布uni-app
```
shell
# 运行uni-app项目,测试预览使用
npm run dev:%PLATFORM%
# 正式发行uni-app项目
npm run build:%PLATFORM%
```
``%PLATFORM%``
可取值如下:
|值|平台|
|---|---|
|app-plus|app平台生成打包资源(支持npm run build:app-plus,可用于持续集成。不支持run,运行调试仍需在HBuilderX中操作)|
|h5|H5|
|mp-alipay|支付宝小程序|
|mp-baidu|百度小程序|
|mp-weixin|微信小程序|
|mp-toutiao|字节跳动小程序|
|mp-lark|飞书小程序|
|mp-qq|qq 小程序|
|mp-360|360 小程序|
|mp-kuaishou|快手小程序|
|quickapp-webview|快应用(webview)|
|quickapp-webview-union|快应用联盟|
|quickapp-webview-huawei|快应用华为|
可以自定义更多条件编译平台,比如钉钉小程序,参考
[
package.json文档
](
https://uniapp.dcloud.io/collocation/package
)
。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录