Merge pull request #12455 from hpstory/hpstory/add_zh_hans_docs

Update zh-Hans docs
4 years ago · 8973c864fd
4 changed files with 263 additions and 5 deletions
--- a/docs/zh-Hans/CLI-New-Command-Samples.md
+++ b/docs/zh-Hans/CLI-New-Command-Samples.md
@ -0,0 +1,248 @@
+# ABP CLI - 新解决方案命令示例
+
+`abp new`命令基于abp模板创建abp解决方案或其他组件. [ABP CLI](CLI.md)有一些参数可以用于创建新的ABP解决方案. 在本文档中, 我们将向你展示一些创建新的解决方案的命令示例. 所有的项目名称都是`Acme.BookStore`. 目前, 唯一可用的移动端项目是`React Native`移动端应用程序. 可用的数据库提供程序有`Entity Framework Core`和`MongoDB`. 所有命令都以`abp new`开头.
+
+## Angular
+
+以下命令用于创建Angular UI项目:
+
+* 在新文件夹中创建项目, **Entity Framework Core**, 非移动端应用程序:  
+
+  ````bash
+  abp new Acme.BookStore -u angular --mobile none --database-provider ef -csf
+  ````
+  
+* 在新文件夹中创建项目, **Entity Framework Core**, 默认应用程序模板, **拆分Identity Server**:
+
+  ```bash
+  abp new Acme.BookStore -t app -u angular -m none --separate-identity-server --database-provider ef -csf
+  ```
+
+* 在新文件夹中创建项目, **Entity Framework Core**, **自定义连接字符串**:
+
+  ```bash
+  abp new Acme.BookStore -u angular -csf --connection-string Server=localhost;Database=MyDatabase;Trusted_Connection=True
+  ```
+
+* 在`C:\MyProjects\Acme.BookStore`中创建解决方案, **MongoDB**, 默认应用程序模板, 包含移动端项目:
+
+  ```bash
+  abp new Acme.BookStore -u angular --database-provider mongodb --output-folder C:\MyProjects\Acme.BookStore
+  ```
+
+* 在新文件夹中创建项目, **MongoDB**, 默认应用程序模板, 不创建移动端应用程序, **拆分Identity Server**:
+
+  ```bash
+  abp new Acme.BookStore -t app -u angular -m none --separate-identity-server --database-provider mongodb -csf
+  ```
+
+## MVC
+
+以下命令用于创建MVC UI项目:
+
+* 在新文件夹中创建项目, **Entity Framework Core**, 不创建移动端应用程序:
+
+  ```bash
+  abp new Acme.BookStore -t app -u mvc --mobile none --database-provider ef -csf
+  ```
+
+* 在新文件夹中创建项目, **Entity Framework Core**, **分层结构** (*Web和HTTP API层是分开的*), 不创建移动端应用程序:
+
+  ```bash
+  abp new Acme.BookStore -u mvc --mobile none --tiered --database-provider ef -csf
+  ```
+
+* 在新文件夹中创建项目, **MongoDB**, 不创建移动端应用程序:
+
+  ```bash
+  abp new Acme.BookStore -t app -u mvc --mobile none --database-provider mongodb -csf
+  ```
+  
+* 在新文件夹中创建项目, **MongoDB**, **分层结构**:
+
+  ```bash
+  abp new Acme.BookStore -u mvc --tiered --database-provider mongodb -csf
+  ```
+
+
+## Blazor
+
+以下命令用于创建Blazor项目:
+
+* **Entity Framework Core**, 不创建移动端应用程序:
+
+  ```bash
+  abp new Acme.BookStore -t app -u blazor --mobile none
+  ```
+
+* **Entity Framework Core**, **拆分Identity Server**, 包含移动端应用程序:
+  
+  ```bash
+  abp new Acme.BookStore -u blazor --separate-identity-server
+  ```
+
+* 在新文件夹中创建项目, **MongoDB**, 不创建移动端应用程序:
+
+  ```bash
+  abp new Acme.BookStore -u blazor --database-provider mongodb --mobile none -csf
+  ```
+
+## Blazor Server
+
+以下命令用于创建Blazor项目:
+
+* **Entity Framework Core**, 不创建移动端应用程序:
+
+  ```bash
+  abp new Acme.BookStore -t app -u blazor-server --mobile none
+  ```
+
+* **Entity Framework Core**, **拆分Identity Server**, **拆分API Host**, 包含移动端应用程序:
+  
+  ```bash
+  abp new Acme.BookStore -u blazor-server --tiered
+  ```
+
+* 在新文件夹中创建项目, **MongoDB**, 不创建移动端应用程序:
+
+  ```bash
+  abp new Acme.BookStore -u blazor --database-provider mongodb --mobile none -csf
+  ```
+  
+## 无UI 
+
+在默认应用程序模板中, 始终有一个前端项目. 在这个选项中没有前端项目. 它有一个`HttpApi.Host`项目为你的HTTP WebAPI提供服务. 这个选项适合在你想创建一个WebAPI服务时使用.
+
+* 在新文件夹中创建项目, **Entity Framework Core**, 拆分Identity Server:
+
+    ```bash
+    abp new Acme.BookStore -u none --separate-identity-server -csf
+    ```
+* **MongoDB**, 不创建移动端应用程序:
+
+    ```bash
+    abp new Acme.BookStore -u none --mobile none --database-provider mongodb
+    ```
+    
+
+
+## 控制台应用程序
+
+这是一个基于.NET控制台应用程序的模板, 集成了ABP模块架构. 要创建控制台应用程序, 请使用以下命令:
+
+* 项目由以下文件组成: `Acme.BookStore.csproj`, `appsettings.json`, `BookStoreHostedService.cs`, `BookStoreModule.cs`, `HelloWorldService.cs` 和 `Program.cs`.
+
+  ```bash
+  abp new Acme.BookStore -t console -csf
+  ```
+
+## 模块
+
+模块是主项目使用的可重用子应用程序. 如果你正在构建微服务解决方案, 使用ABP模块是最佳方案. 由于模块不是最终的应用程序, 每个模块都有前端UI项目和数据库提供程序. 模块模板带有MVC UI, 可以在没有最终解决方案的情况下进行开发. 但是, 如果要在最终解决方案下开发模块, 可以添加`--no-ui`参数来去除MVC UI项目.
+
+* 包含前端: `MVC`, `Angular`, `Blazor`. 包含数据库提供程序: `Entity Framework Core`, `MongoDB`. 包含MVC启动项目.
+
+  ```bash
+  abp new Acme.IssueManagement -t module
+  ```
+* 与上面相同, 但不包括MVC启动项目.
+
+  ```bash
+  abp new Acme.IssueManagement -t module --no-ui
+  ```
+  
+* 创建模块并将其添加到解决方案中
+
+  ```bash
+  abp new Acme.IssueManagement -t module --add-to-solution-file
+  ```
+
+## 从特定版本创建解决方案
+
+创建解决方案时, 它总是使用最新版本创建. 要从旧版本创建项目, 可以使用`--version`参数.
+
+* 使用v3.3.0版本创建解决方案, 包含Angular UI和Entity Framework Core.
+
+  ```bash
+  abp new Acme.BookStore -t app -u angular -m none --database-provider ef -csf --version 3.3.0
+  ```
+
+要获取ABP版本列表, 请查看以下链接: https://www.nuget.org/packages/Volo.Abp.Core/
+
+## 从自定义模板创建
+
+ABP CLI使用默认的[应用程序模板](https://github.com/abpframework/abp/tree/dev/templates/app)创建项目. 如果要从自定义模板创建新的解决方案, 可以使用参数`--template-source`. 
+
+* 在`c:\MyProjects\templates\app`目录中使用模板, MVC UI, Entity Framework Core, 不创建移动端应用程序. 
+
+  ```bash
+  abp new Acme.BookStore -t app -u mvc --mobile none --database-provider ef --template-source "c:\MyProjects\templates\app"
+  ```
+
+* 除了此命令从URL `https://myabp.com/app-template.zip` 检索模板之外, 与上一个命令相同.
+
+  ```bash
+  abp new Acme.BookStore -t app -u mvc --mobile none --database-provider ef --template-source https://myabp.com/app-template.zip
+  ```
+
+## 创建预览版本
+
+ABP CLI始终使用最新版本. 要从预览(RC)版本创建解决方案, 请添加`--preview`参数.
+
+* 在新文件夹中创建项目, Blazor UI, Entity Framework Core, 不创建移动端应用程序, **使用最新版本**:
+
+  ```bash
+  abp new Acme.BookStore -t app -u blazor --mobile none -csf --preview
+  ```
+
+## 选择数据库管理系统
+
+默认的数据库管理系统是 `Entity Framework Core` / ` SQL Server`. 你可以通过使用`--database-management-system`参数选择DBMS. [可用的值](https://github.com/abpframework/abp/blob/dev/framework/src/Volo.Abp.Cli.Core/Volo/Abp/Cli/ProjectBuilding/Building/DatabaseManagementSystem.cs) 包括 `SqlServer`, `MySQL`, `SQLite`, `Oracle`, `Oracle-Devart`, `PostgreSQL`. 默认值是 `SqlServer`.
+
+* 在新文件夹中创建项目, Angular UI, **PostgreSQL** 数据库:
+
+  ```bash
+  abp new Acme.BookStore -u angular --database-management-system PostgreSQL -csf
+  ```
+
+## 使用静态HTTP端口
+
+ABP CLI始终为项目分配随机端口. 如果需要保留默认端口并且创建解决方案始终使用相同的HTTP端口, 请添加参数`--no-random-port`.
+
+* 在新文件夹中创建项目, MVC UI,  Entity Framework Core, **静态端口**:
+
+  ```bash
+  abp new Acme.BookStore --no-random-port -csf
+  ```
+
+## 引用本地ABP框架
+
+在ABP解决方案中, 默认情况下从NuGet引用ABP库. 有时, 你需要在本地将ABP库引用到你的解决方案中. 这利于调试框架本身. 本地ABP框架的根目录必须有`Volo.Abp.sln`文件. 你可以将以下目录的内容复制到你的文件系统中
+
+* MVC UI,  Entity Framework Core, **引用本地的ABP库**:
+
+本地路径必须是ABP存储库的根目录. 
+如果`C:\source\abp\framework\Volo.Abp.sln`是你的框架解决方案的路径, 那么你必须设置`--abp-path`参数值为`C:\source\abp`.
+
+  ```bash
+  abp new Acme.BookStore --local-framework-ref --abp-path C:\source\abp
+  ```
+
+**输出**:
+
+如下所示, 引用本地ABP框架库项目.
+
+```xml
+<ItemGroup>
+	<ProjectReference Include="C:\source\abp\framework\src\Volo.Abp.Autofac\Volo.Abp.Autofac.csproj" />
+	<ProjectReference Include="C:\source\abp\framework\src\Volo.Abp.AspNetCore.Serilog\Volo.Abp.AspNetCore.Serilog.csproj" />
+	<ProjectReference Include="C:\source\abp\framework\src\Volo.Abp.AspNetCore.Authentication.JwtBearer\Volo.Abp.AspNetCore.Authentication.JwtBearer.csproj" />
+	<ProjectReference Include="..\Acme.BookStore.Application\Acme.BookStore.Application.csproj" />
+	<ProjectReference Include="..\Acme.BookStore.HttpApi\Acme.BookStore.HttpApi.csproj" />
+	<ProjectReference Include="..\Acme.BookStore.EntityFrameworkCore\Acme.BookStore.EntityFrameworkCore.csproj" />
+</ItemGroup>    
+```
+
+## 另请参阅
+
+* [ABP CLI文档](CLI.md)
--- a/docs/zh-Hans/CLI.md
+++ b/docs/zh-Hans/CLI.md
@ -78,6 +78,8 @@ abp new Acme.BookStore
 * Acme.BookStore是解决方案的名称.
 * 常见的命名方式类似于 *YourCompany.YourProject*. 不过你可以使用自己喜欢的方式,如 *YourProject* (单级命名空间) 或 *YourCompany.YourProduct.YourModule* (三级命名空间).

+参阅[ABP CLI 创建新解决方案示例](CLI-New-Command-Samples.md)查看更多示例.
+
 #### Options

 * `--template` 或者 `-t`: 指定模板. 默认的模板是 `app`,会生成web项目.可用的模板有:
@ -407,4 +409,4 @@ abp install-libs [options]

 #### Options

-* ```--working-directory``` 或 ```-wd```: 指定工作目录, 当执行目录不包含项目文件时会很有用.
+* ```--working-directory``` 或 ```-wd```: 指定工作目录, 当执行目录不包含项目文件时会很有用.
--- a/docs/zh-Hans/Entities.md
+++ b/docs/zh-Hans/Entities.md
@ -28,7 +28,7 @@ public class Book : Entity<Guid>
 * 创建一个构造函数,获取ID作为参数传递给基类.
  * 如果没有为GUID Id赋值,**ABP框架会在保存时设置它**,但是在将实体保存到数据库之前最好在实体上有一个有效的Id.
 * 如果使用带参数的构造函数创建实体,那么还要创建一个 `private` 或 `protected`  构造函数. 当数据库提供程序从数据库读取你的实体时(反序列化时)将使用它.
-* 不要使用 `Guid.NewGuid()` 来设置Id! 在创建实体的代码中**使用[`IGuidGenerator`服务](Guid-Generation.md)**传递Id参数. `IGuidGenerator`经过优化可以产生连续的GUID.这对于关系数据库中的聚集索引非常重要.
+* 不要使用 `Guid.NewGuid()` 来设置Id! 在创建实体的代码中**使用[`IGuidGenerator`服务](Guid-Generation.md)** 传递Id参数. `IGuidGenerator`经过优化可以产生连续的GUID.这对于关系数据库中的聚集索引非常重要.

 示例实体:

--- a/docs/zh-Hans/docs-nav.json
+++ b/docs/zh-Hans/docs-nav.json
@ -409,14 +409,16 @@
                  "path": "Entities.md"
                },
                {
-                  "text": "值对象"
+                  "text": "值对象",
+                  "path": "Value-Objects.md"
                },
                {
                  "text": "仓储",
                  "path": "Repositories.md"
                },
                {
-                  "text": "领域服务"
+                  "text": "领域服务",
+                  "path": "Domain-Services.md"
                },
                {
                  "text": "规约",
@ -808,7 +810,13 @@
      "items": [
        {
          "text": "CLI",
-          "path": "CLI.md"
+          "path": "CLI.md",
+          "items": [
+            {
+              "text": "新命令示例",
+              "path": "CLI-New-Command-Samples.md"
+            }
+          ]
        },
        {
          "text": "API文档",