Skip to content

Commit b605fba

Browse files
JusterZhuJusterZhu
committed
Modify Chinese annotations
1 parent 198eb1e commit b605fba

File tree

9 files changed

+119
-135
lines changed

9 files changed

+119
-135
lines changed

‎website/docs/doc/Component Introduction.md‎

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,13 @@ sidebar_position: 1
5858

5959

6060

61-
### 2.统一语言（Unifying Language）
61+
### 2.使用引导
62+
63+
![](imgs/bootstrap.jpg)
64+
65+
66+
67+
### 3.统一语言（Unifying Language）
6268

6369
在开始使用GeneralUpdate之前我们需要先知道体系中的一些基础概念。
6470

@@ -81,7 +87,7 @@ sidebar_position: 1
8187

8288

8389

84-
### 3.GeneralUpdate提供什么？
90+
### 4.GeneralUpdate提供什么？
8591

8692
##### 组件功能
8793

@@ -152,7 +158,7 @@ sc delete GeneralUpdate.SystemService
152158

153159

154160

155-
### 4.GeneralUpdate支持什么？
161+
### 5.GeneralUpdate支持什么？
156162

157163
##### .NET框架
158164

@@ -210,7 +216,7 @@ sc delete GeneralUpdate.SystemService
210216

211217
这是一个绝佳的机会，不仅可以推动技术的进步，也可以提高您的品牌知名度和社区影响力。我们相信，您的赞助将会对这个开源项目产生深远的影响。此外所有的赞助将用于购买GeneralUpdate实物周边产品奖励给项目贡献代码的社区伙伴，如果有实际贡献的小伙伴可以联系下方邮箱与我取得联系。
212218

213-
个人能力有限，目前项目的大小已经超出个人维护的精力范围之外设计维护实属不易，期待您的积极参与，让我们携手共创未来！
219+
目前项目的大小已经超出个人维护的精力范围之外设计维护实属不易，期待您的积极参与，让我们携手共创未来！
214220

215221
谢谢！
216222

‎website/docs/doc/GeneralClient.OSS.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -86,10 +86,10 @@ GeneralUpdateOSS提供以下能力。
8686

8787
#### 方法
8888

89-
| Method | |
90-
| ---------------------- | ------------------------------------------ |
91-
| Start() | Starting an OSS update . |
92-
| AddListenerException() | Listen for internal exception information. |
89+
| Method | |
90+
| ---------------------- | ---------------------- |
91+
| Start() | 启动OSS更新。 |
92+
| AddListenerException() | 监听组件内部异常信息。 |
9393

9494

9595

@@ -127,7 +127,7 @@ ParamsOSS 更新配置参数，详细内容参考本文档🌴ParamsOSS。
127127

128128
**参数**
129129

130-
**parameter** ParamsOSS安卓平台的跟新配置参数。
130+
**parameter** ParamsOSS 安卓平台的跟新配置参数。
131131

132132
**upgradeAppName** 需要升级的应用名称。
133133

@@ -137,7 +137,7 @@ ParamsOSS 更新配置参数，详细内容参考本文档🌴ParamsOSS。
137137

138138
**方法**
139139

140-
Monitor download progress.
140+
监听下载进度。
141141

142142
```c#
143143
public static void AddListenerDownloadProcess(Action<object, OSSDownloadArgs> callbackAction);
@@ -171,7 +171,7 @@ callbackAction Action<object, OSSDownloadArgs>
171171

172172
**方法**
173173

174-
Listen for internal exception information.
174+
监听组件内部异常。
175175

176176
```c#
177177
public static void AddListenerException(Action<object, ExceptionEventArgs> callbackAction);

‎website/docs/doc/GeneralUpdate.ClientCore.md‎

Lines changed: 44 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -219,8 +219,8 @@ GeneralClientBootstrap提供以下能力。
219219
| Config() | 更新相关内容配置参数，url 服务器地址及 端口号, appSecretKey客户端唯一标识用于 区分产品分支。 |
220220
| GetOption() | 获取更新配置。 |
221221
| Strategy() | 设置当前更新策略，例如：如果是Windows 平台则使用WindowsStrategy， linux...mac...android以此类推。 |
222-
| SetCustomSkipOption() | Let the user decide whether to update in the state of non-mandatory update. |
223-
| AddCustomOption() | Add an asynchronous custom operation. In theory, any custom operation can be done. It is recommended to register the environment check method to ensure that there are normal dependencies and environments after the update is completed. |
222+
| SetCustomSkipOption() | 让用户在非强制更新的状态下决定是否进行更新。 |
223+
| AddCustomOption() | 添加一个异步的自定义操作。理论上，任何自定义操作都可以完成。建议注册环境检查方法，以确保更新完成后存在正常的依赖和环境。 |
224224
| AddListenerMultiAllDownloadCompleted() | 完成所有的下载任务通知。 |
225225
| AddListenerMultiDownloadProgress() | 单个或多个更新包下载通知事件。 |
226226
| AddListenerMultiDownloadCompleted() | 单个或多个更新包下载完成事件。 |
@@ -234,58 +234,56 @@ GeneralClientBootstrap提供以下能力。
234234

235235
| 属性 |
236236
| ------------------------------------------------------------ |
237-
| **MainUpdateUrl** string Update check api address. |
237+
| **MainUpdateUrl** string 更新检查api地址。 |
238238
| **AppType** int 1:ClientApp 2:UpdateApp |
239-
| **UpdateUrl** string Update check api address. |
240-
| **AppName** string Need to start the name of the app. |
241-
| **MainAppName** string Need to start the name of the app. |
242-
| **Format** string Update package file format(Defult format is Zip). |
243-
| **IsUpgradeUpdate** bool Whether an update is required to upgrade the application. |
244-
| **IsMainUpdate** bool Whether the main application needs to be updated. |
245-
| **UpdateLogUrl** string Update log web address. |
246-
| **UpdateVersions** List VersionInfo Version information that needs to be updated. |
247-
| **Encoding** Encoding The encoding format for file operations. |
248-
| **DownloadTimeOut** int Time-out event for file download. |
249-
| **AppSecretKey** string application key. |
250-
| **ClientVersion** string Client current version. |
251-
| **LastVersion** string The latest version. |
252-
| **InstallPath** string installation path (for update file logic). |
253-
| **TempPath** string Download file temporary storage path (for update file logic). |
254-
| **ProcessBase64** string Configuration parameters for upgrading the terminal program. |
255-
| **Platform** string The platform to which the current strategy belongs. |
256-
| **BlackFiles** List string Files in the blacklist will skip the update. |
257-
| **BlackFormats** List string File formats in the blacklist will skip the update. |
258-
| **DriveEnabled** bool Whether to enable the driver upgrade function. |
259-
| **WillMessageEnabled** bool Whether open note function, if you want to start needs to be synchronized to deploy 'GeneralUpdate. SystemService' service. |
260-
261-
239+
| **UpdateUrl** string Update 更新检查api地址。 |
240+
| **AppName** string 需要启动应用程序的名称。 |
241+
| **MainAppName** string 需要启动主应用程序的名称。 |
242+
| **Format** string 更新包文件格式（默认格式为Zip）。 |
243+
| **IsUpgradeUpdate** bool 是否需要更新来升级应用程序。 |
244+
| **IsMainUpdate** bool 主应用程序是否需要更新。 |
245+
| **UpdateLogUrl** string 更新日志网页地址。 |
246+
| **UpdateVersions** List 需要更新的版本信息VersionInfo。 |
247+
| **Encoding** Encoding 文件操作的编码格式。 |
248+
| **DownloadTimeOut** int 下载超时时间。 |
249+
| **AppSecretKey** string 应用程序密钥，需要和服务器约定好。 |
250+
| **ClientVersion** string 客户端当前版本号。 |
251+
| **LastVersion** string 最新版本号。 |
252+
| **InstallPath** string 安装路径（用于更新文件逻辑）。 |
253+
| **TempPath** string 下载文件临时存储路径（用于更新文件逻辑）。 |
254+
| **ProcessBase64** string 升级终端程序的配置参数。 |
255+
| **Platform** string 当前策略所属的平台。（Windows\linux\Mac） |
256+
| **BlackFiles** List 黑名单中的文件将跳过更新。 |
257+
| **BlackFormats** 黑名单中的文件格式将跳过更新。 |
258+
| **DriveEnabled** bool 是否启用驱动升级功能。 |
259+
| **WillMessageEnabled** bool 是否开启遗言功能，如果想要启动需要同步部署'GeneralUpdate. SystemService'服务。 |
262260

263261
### 🌴Configinfo
264262

265-
| **属性** |
266-
| ------------------------------------------------------------ |
267-
| **AppType** int 1:ClientApp 2:UpdateApp |
268-
| **AppName** string Need to start the name of the app. |
269-
| **AppSecretKey** string application key. |
270-
| **ClientVersion** string Client current version. |
271-
| **UpdateUrl** string Update check api address. |
272-
| **UpdateLogUrl** string Update log web address. |
273-
| **InstallPath** string installation path (for update file logic). |
274-
| **MainUpdateUrl** string Update check api address. |
275-
| **MainAppName** string Client app name. |
263+
| **属性** |
264+
| ----------------------------------------------------- |
265+
| **AppType** int 1:ClientApp 2:UpdateApp |
266+
| **AppName** string 需要启动应用程序的名称。 |
267+
| **AppSecretKey** string 应用程序密钥。 |
268+
| **ClientVersion** string 客户端当前版本。 |
269+
| **UpdateUrl** string 更新检查api地址。 |
270+
| **UpdateLogUrl** string 更新日志网页地址。 |
271+
| **InstallPath** string 安装路径（用于更新文件逻辑）。 |
272+
| **MainUpdateUrl** string 更新检查api地址。 |
273+
| **MainAppName** string 主客户端应用名称 |
276274

277275

278276

279277
### 🍵UpdateOption
280278

281279
| **枚举** |
282280
| ------------------------------------------------------------ |
283-
| **Format** Update the file format of the package. |
284-
| **Encoding** Compress encoding. |
285-
| **MainApp** Main program name. |
286-
| **DownloadTimeOut** Timeout period (unit: second). If this parameter is not specified, the default timeout period is 30 seconds. |
287-
| **Drive** Whether to enable the driver upgrade function. |
288-
| **WillMessage** Whether open note function, if you want to start needs to be synchronized to deploy 'GeneralUpdate. SystemService' service. |
281+
| **Format** 更新包的文件格式。 |
282+
| **Encoding** 压缩编码。 |
283+
| **MainApp** 主程序名称。 |
284+
| **DownloadTimeOut** 超时时间（单位：秒）。如果未指定此参数，则默认超时时间为30秒。 |
285+
| **Drive** 是否启用驱动升级功能。 |
286+
| **WillMessage** 是否开启遗言功能，如果想要启动需要同步部署'GeneralUpdate. SystemService'服务。 |
289287

290288

291289

@@ -396,11 +394,11 @@ Configinfo
396394

397395
**info** Configinfo 客户端相关参数类。
398396

399-
**url** string Remote server address.
397+
**url** string 远程服务器地址。
400398

401399
**appSecretKey** string application key(与服务端约定好的密钥，用于区分客户端进行版本管理或指定客户端推送升级).
402400

403-
**appName** string The updater name does not need to contain an extension.
401+
**appName** string 更新程序的名称不需要包含扩展名。
404402

405403

406404

@@ -481,7 +479,7 @@ func Func<Task<bool>> 注入一个Task异步的自定义回调函数。
481479

482480
**方法**
483481

484-
Add an asynchronous custom operation. In theory, any custom operation can be done. It is recommended to register the environment check method to ensure that there are normal dependencies and environments after the update is completed.
482+
添加一个异步的自定义操作。理论上，任何自定义操作都可以完成。建议注册环境检查方法，以确保更新完成后存在正常的依赖和环境。
485483

486484
```c#
487485
public GeneralClientBootstrap AddCustomOption(List<Func<bool>> funcs);

‎website/docs/doc/GeneralUpdate.Core.md‎

Lines changed: 31 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -146,69 +146,49 @@ GeneralUpdateBootstrap提供以下能力。
146146

147147
**属性**
148148

149-
**MainUpdateUrl** string Update check api address.
150-
151-
**AppType** int 1:ClientApp 2:UpdateApp
152-
153-
**UpdateUrl** string Update check api address.
154-
155-
**AppName** string Need to start the name of the app.
156-
157-
**MainAppName** string Need to start the name of the app.
158-
159-
**Format** string Update package file format(Defult format is Zip).
160-
161-
**IsUpgradeUpdate** bool Whether an update is required to upgrade the application.
162-
163-
**IsMainUpdate** bool Whether the main application needs to be updated.
164-
165-
**UpdateLogUrl** string Update log web address.
166-
167-
**UpdateVersions** List VersionInfo Version information that needs to be updated.
168-
169-
**Encoding** Encoding The encoding format for file operations.
170-
171-
**DownloadTimeOut** int Time-out event for file download.
172-
173-
**AppSecretKey** string application key.
174-
175-
**ClientVersion** string Client current version.
176-
177-
**LastVersion** string The latest version.
178-
179-
**InstallPath**string installation path (for update file logic).
180-
181-
**TempPath** string Download file temporary storage path (for update file logic).
182-
183-
**ProcessBase64** string Configuration parameters for upgrading the terminal program.
184-
185-
**Platform** string The platform to which the current strategy belongs.
186-
187-
**BlackFiles** List string Files in the blacklist will skip the update.
188-
189-
**BlackFormats** List string File formats in the blacklist will skip the update.
190-
191-
**DriveEnabled** bool Whether to enable the driver upgrade function.
192-
193-
**WillMessageEnabled** bool Whether open note function, if you want to start needs to be synchronized to deploy 'GeneralUpdate. SystemService' service.
149+
| 属性 |
150+
| ------------------------------------------------------------ |
151+
| **MainUpdateUrl** string 更新检查api地址。 |
152+
| **AppType** int 1:ClientApp 2:UpdateApp |
153+
| **UpdateUrl** string Update 更新检查api地址。 |
154+
| **AppName** string 需要启动应用程序的名称。 |
155+
| **MainAppName** string 需要启动主应用程序的名称。 |
156+
| **Format** string 更新包文件格式（默认格式为Zip）。 |
157+
| **IsUpgradeUpdate** bool 是否需要更新来升级应用程序。 |
158+
| **IsMainUpdate** bool 主应用程序是否需要更新。 |
159+
| **UpdateLogUrl** string 更新日志网页地址。 |
160+
| **UpdateVersions** List 需要更新的版本信息VersionInfo。 |
161+
| **Encoding** Encoding 文件操作的编码格式。 |
162+
| **DownloadTimeOut** int 下载超时时间。 |
163+
| **AppSecretKey** string 应用程序密钥，需要和服务器约定好。 |
164+
| **ClientVersion** string 客户端当前版本号。 |
165+
| **LastVersion** string 最新版本号。 |
166+
| **InstallPath** string 安装路径（用于更新文件逻辑）。 |
167+
| **TempPath** string 下载文件临时存储路径（用于更新文件逻辑）。 |
168+
| **ProcessBase64** string 升级终端程序的配置参数。 |
169+
| **Platform** string 当前策略所属的平台。（Windows\linux\Mac） |
170+
| **BlackFiles** List 黑名单中的文件将跳过更新。 |
171+
| **BlackFormats** 黑名单中的文件格式将跳过更新。 |
172+
| **DriveEnabled** bool 是否启用驱动升级功能。 |
173+
| **WillMessageEnabled** bool 是否开启遗言功能，如果想要启动需要同步部署'GeneralUpdate. SystemService'服务。 |
194174

195175

196176

197177
### 🍵UpdateOption
198178

199179
**枚举**
200180

201-
**Format** Update the file format of the package.
181+
**Format** 更新包的文件格式。
202182

203-
**Encoding** Compress encoding.
183+
**Encoding** 压缩编码。
204184

205-
**MainApp** Main program name.
185+
**MainApp** 主程序名称。
206186

207-
**DownloadTimeOut** Timeout period (unit: second). If this parameter is not specified, the default timeout period is 30 seconds.
187+
**DownloadTimeOut** 超时时间（单位：秒）。如果未指定此参数，则默认超时时间为30秒。
208188

209-
**Drive** Whether to enable the driver upgrade function.
189+
**Drive** 是否启用驱动升级功能。
210190

211-
**WillMessage** Whether open note function, if you want to start needs to be synchronized to deploy 'GeneralUpdate. SystemService' service.
191+
**WillMessage** 是否开启遗言功能，如果想要启动需要同步部署'GeneralUpdate. SystemService'服务。
212192

213193

214194

‎website/docs/doc/GeneralUpdate.Differential.md‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -82,37 +82,37 @@ DifferentialCore提供增量识别，生成二进制补丁、补丁还原、设
8282

8383
**方法**
8484

85-
Generate patch file [Cannot contain files with the same name but different extensions] .
85+
生成补丁文件[不能包含文件名相同但扩展名不同的文件]。
8686

8787
```c#
8888
public async Task Clean(string sourcePath, string targetPath, string patchPath = null);
8989
```
9090

9191
**参数**
9292

93-
**sourcePath** Previous version folder path .
93+
**sourcePath** 上一个版本的文件夹路径。
9494

95-
**targetPath** Recent version folder path.
95+
**targetPath** 最近版本的文件夹路径。
9696

97-
**patchPath** Store discovered incremental update files in a temporary directory .
97+
**patchPath** 将发现的增量更新文件存储在临时目录中。
9898

9999

100100

101101
### 🌼Dirty()
102102

103103
**方法**
104104

105-
Apply patch [Cannot contain files with the same name but different extensions] .
105+
应用补丁[不能包含文件名相同但扩展名不同的文件]。
106106

107107
```c#
108108
public async Task Dirty(string appPath, string patchPath);
109109
```
110110

111111
**参数**
112112

113-
**appPath** Client application directory .
113+
**appPath** 客户端应用程序目录。
114114

115-
**patchPath** Patch file path.
115+
**patchPath** 补丁文件路径。
116116

117117

118118

@@ -128,9 +128,9 @@ public void SetBlocklist(List<string> blackFiles, List<string> blackFileFormats)
128128

129129
**参数**
130130

131-
**blackFiles** A collection of blacklist files that are skipped when updated.
131+
**blackFiles** 更新时跳过的黑名单文件的集合。
132132

133-
**blackFileFormats** A collection of blacklist file name extensions that are skipped on update.
133+
**blackFileFormats** 更新时跳过的黑名单文件名扩展名的集合。
134134

135135

136136

0 commit comments

Comments
 (0)