# 安装和升级

在使用 Matman 来构建项目之前，需要先安装 Node 和 [matman-cli](https://www.npmjs.com/package/matman-cli) 。

## 1. 安装 Node

matman 是基于 Node 来实现的，因此需要在本机安装 [Node](https://nodejs.org/) 。

为了获得更好的性能，推荐安装最新版本的 Node，进入 <https://nodejs.org/> 官网，选择 LTS 版本的 Node 安装即可。

安装完Node后，执行下面命令，查看当前Node版本：

```
$ node -v
v4.4.0
```

如果能正常输出Node的版本号，表示Node已安装成功(Windows系统可能需要重新打开cmd)。

## 2. 安装 matman-cli

[matman-cli](https://www.npmjs.com/package/matman-cli) 提供了一些命令行，用于初始化项目和构建等。

Node 安装成功后，执行如下 npm 命令安装 matman-cli （Mac或Linux的非root用户需要在命令行前面加 `sudo`，如：`sudo npm install -g matman-cli`）。

```
$ npm install -g matman-cli
```

npm 默认镜像是在国外，有时候安装速度很慢或者出现安装不了的情况，如果无法安装或者安装很慢，可以使用淘宝的镜像安装：

```
$ npm install -g cnpm --registry=https://registry.npm.taobao.org
$ cnpm install -g matman-cli
```

或者直接指定镜像安装：

```
$ npm install -g matman-cli --registry=https://registry.npm.taobao.org
```

全局安装 matman-cli 时，可能会出现以下错误。错误是由 electron 安装时造成的，详见 <https://github.com/matmanjs/matman-cli/issues/30> 。此时需要增加一些额外参数来安装：

```
$ npm install matman-cli -g --unsafe-perm=true --allow-root
```

matman-cli 安装完成后，执行命令 `matman --help`，查看帮助信息:

```
$ matman --help

  Usage: matman [options] [command]


  Commands:
      build                                    Build the code.


  Options:
      --version, -[v]           Print version and exit successfully.
      --help, -[h]              Print this help and exit successfully.


  Report bugs to https://github.com/matmanjs/matman/issues.
```

如果能正常输出 matman 的帮助信息，表示已安装成功。

## 3. 升级 matman-cli

> 为了能使用 matman 的所有功能，请记得将其升级到最新版本。

升级命令与安装命令类似，请参考上一节内容。