# NuStore使用说明

## 简介

        .net core 部署有两种方式，一种是独立式部署（SCD），另一种是框架依赖式部署（FDD）。以SCD方式生成发布包时，dotnet会将所有依赖打包到一个文件夹内，并为应用程序生成可执行文件。以FDD方式部署的程序是不用安装.net core 运行时的，而在FDD模式下需要安装对应版本的.net core 运行时，两者的区别可参考：[.net core application deployment](https://docs.microsoft.com/en-us/dotnet/core/deploying/)。

        用VS开发时，默认采用的是FDD模式，但将发布包部署到服务器上时可能会出现以下错误：

![assembly specified in the dependencies manifest was not found](https://2001686505-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFW2LfOnEvZdmccmkWf%2F-LFW522sDFxpkCX1nhFx%2F-LFW9WqYzcN_9Hdg_s8S%2Fsnipaste_20180621_150522.png?alt=media\&token=fbdf65a8-4109-4ff1-9087-abeef539f2f5)

        导致这个问题的原因是VS默认以 manifest的方式打包，对于本地Store中存在的公共包将不会被包含在发布包中，只会将其记录入\*.deps.json文件中。所以当开发机与服务器Store目录中的包不一致时就会出现以上问题。一般的解决办法是将`PublishWithAspNetCoreTargetManifest`改为`false`，以停用manifest文件，但这会导致发布包变得无比巨大（虽然比SCD生成的文件少，但也会有200+的文件），当然我们也可以让编译服务器与部署服务器的Store环境一致或指定manifest文件来解决以上问题。对于本地Store的作用可参考： [Runtime package store](https://docs.microsoft.com/en-us/dotnet/core/deploying/runtime-store)

        上文已经了解到Store的作用，其实我们手动将缺少的或未被包含在发布包的中Package拷到Store目录也可以解决问题。既然如此，NuStore作用就是：自动完成deps文件分析并从NuGet中下载依赖包，然后将其放入Store目录，这样发布包只需要包含不属于NuGet的包即可，最大化的减小发布包的体积。

### 安装

```
dotnet tool install -g NuStore
```

### 更新

```
dotnet tool update -g NuStore
```

### 卸载

```
dotnet tool uninstall -g NuStore
```

## 用法

```
nustore verb [options]
```

        直接使用`nustore restore`命令时，工具会加载当前目录中的\*.deps.json文件，并将下载的包保存到 usr/local/share/dotnet/store目录（macOS/Linux）或 C:/Program Files/dotnet/store目录中（Windows）。使用`nustore --help`可获取更多帮助。

{% hint style="info" %}
.netcore2.1在centos下的安装目录为/usr/share/dotnet/，但微软官方文档为：usr/local/share/dotnet/store。所以在linux环境下使用时，请使用--dir参数指定为正确的目录。
{% endhint %}

## 参数

### Verbs

1. restore  下载所有依赖包
2. minify    精简当前发布包

### restore Options

| 选项            | 说明                                                                                                   |
| ------------- | ---------------------------------------------------------------------------------------------------- |
| -p  --deps    | 指定deps文件。默认搜索当前目录中的\*.deps.json文件                                                                    |
| -d  --dir     | 将包下载到指定的目录中。默认usr/local/share/dotnet/store目录（macOS/Linux）或 C:/Program Files/dotnet/store目录中（Windows） |
| -f  --force   | 是否覆盖已下载的包，默认为否                                                                                       |
| --nuget       | 指定NuGet Api服务地址。默认： <https://api.nuget.org/v3/index.json>                                            |
| -e  --exclude | 排除指定的包，支持正则，多个要件使用分号分隔                                                                               |
| -s  --special | 下载指定的包，支持正则，多个条件使用分号分隔                                                                               |
| --runtime     | netcoreapp2.0/netcoreapp2.1，默认从deps文件中分析                                                             |
| --arch        | x64/x86，默认从deps文件中分析                                                                                 |
| --verbosity   | 显示详细日志                                                                                               |
| --help        | 获取restore的帮助信息                                                                                       |

{% hint style="info" %}
当--special与--exclude都存在时，先判断是否为Special包，再判断是否为Exclude包
{% endhint %}

## 示例

使用 e:/nustore/test.deps.json依赖文件，排除所有名称以Micosoft.和System开头的包，但下载Microsoft.Extensions.Logging包或其它包。

```

nustore restore --dir="e:/nustore" --deps="e:/nustore/test.deps.json" --exclude="^microsoft.*;^System.*" -s "Microsoft\.Extensions.Logging"
```

## 代码

<https://github.com/aspark/nustore>