1 | # 安装 cli 及使用
|
2 |
|
3 | ## 安装
|
4 |
|
5 | cli 项目基于 node,请确保已具备较新的 node 环境(>=8.0.0),推荐使用 node 版本管理工具 [nvm](https://github.com/creationix/nvm) 来管理 node,这样不仅可以很方便地切换 node 版本,而且全局安装时候也不用加 sudo 了。
|
6 |
|
7 | ### cli 工具安装
|
8 |
|
9 | 首先,你需要使用 npm 或者 yarn 全局安装`@syberos/cli`,或者直接使用[npx](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b):
|
10 |
|
11 | ```bash
|
12 | # 使用 npm 安装 CLI
|
13 | $ npm install -g @syberos/cli
|
14 | # OR 使用 yarn 安装 CLI
|
15 | $ yarn global add @syberos/cli
|
16 | ```
|
17 |
|
18 | ### 注意事项
|
19 |
|
20 | 值得一提的是,如果安装过程出现`sass`相关的安装错误,请在安装[`mirror-config-china`](https://www.npmjs.com/package/mirror-config-china)后重试。
|
21 |
|
22 | ```bash
|
23 | $ npm install -g mirror-config-china
|
24 | ```
|
25 |
|
26 | ## 使用
|
27 |
|
28 | ### 创建项目
|
29 |
|
30 | 使用命令创建模板项目
|
31 |
|
32 | ```bash
|
33 | $ syberh init myApp
|
34 | ```
|
35 |
|
36 | ![syberh init myApp command screenshot](/img/init_myapp.png)
|
37 |
|
38 | 在创建完项目之后,会默认开始安装项目所需要的依赖,安装使用的工具按照 yarn>cnpm>npm 顺序进行检测,一般来说,依赖安装会比较顺利,但某些情况下可能会安装失败,这时候你可以在项目目录下自己使用安装命令进行安装
|
39 |
|
40 | ```bash
|
41 | # 使用 yarn 安装依赖
|
42 | $ yarn
|
43 | # OR 使用 cnpm 安装依赖
|
44 | $ cnpm install
|
45 | # OR 使用 npm 安装依赖
|
46 | $ npm install
|
47 | ```
|
48 |
|
49 | 进入项目目录开始开发
|
50 |
|
51 | ### 注意事项
|
52 |
|
53 | 值得一提再提的是,如果安装过程出现`sass`相关的安装错误,请在安装[`mirror-config-china`](https://www.npmjs.com/package/mirror-config-china)后重试。
|
54 |
|
55 | ```bash
|
56 | $ npm install -g mirror-config-china
|
57 | ```
|
58 |
|
59 | ### 检查环境
|
60 |
|
61 | ```bash
|
62 | $ syberh doctor
|
63 | ```
|
64 |
|
65 | ### 编译打包
|
66 |
|
67 | 开发过程中可以使用模拟器或真机运行应用
|
68 |
|
69 | ```bash
|
70 | # debug 运行于模拟器
|
71 | $ syberh build --type simulator --debug
|
72 |
|
73 | # debug运行于手机
|
74 | $ syberh build --type device --debug
|
75 |
|
76 | # 只打包不运行
|
77 | $ syberh build
|
78 | ```
|
79 |
|
80 | ## 更新
|
81 |
|
82 | 更新 syberh CLI 工具
|
83 |
|
84 | ```bash
|
85 | # npm
|
86 | npm i -g @syberos/cli@latest
|
87 | # yarn
|
88 | yarn global add @syberos/cli@latest
|
89 | ```
|