Skip to content

Commit

Permalink
添加英文翻译
Browse files Browse the repository at this point in the history
  • Loading branch information
@JusterZhu
JusterZhu committed Dec 2, 2024
1 parent bf7e782 commit c9f8b37
Show file tree
Hide file tree
Showing 84 changed files with 708 additions and 958 deletions.
197 changes: 96 additions & 101 deletions website/docs/doc/Component Introduction.md
View file

Large diffs are not rendered by default.

80 changes: 40 additions & 40 deletions website/docs/doc/GeneralClient.OSS.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,59 +2,59 @@
sidebar_position: 9
---

### 定义
### Definition

命名空间：GeneralUpdate.ClientCore
Namespace: GeneralUpdate.ClientCore

程序集：GeneralUpdate.ClientCore.dll
Assembly: GeneralUpdate.ClientCore.dll



**OSS**

OSS的全称是对象存储服务（Object Storage Service），做服务端技术栈开发的小伙伴肯定对这个不陌生在 各大云服务器厂商都会提供类似的服务,说简单点就是一个文件服务器。例如：阿里云OSS、腾讯云COS、华 为云OBS，其实它们只是名字不一样功能服务都差不多。然后本更新组件新功能的实现思路非常相似那么就 选择了OSS来为该功能命名，而且方便开发者一眼能get到这个功能的作用（需要使用组件 GeneralUpdate.ClientCore、GeneralUpdate.Core）。
OSS stands for Object Storage Service. For those developing server-side technology stacks, this term is likely familiar, as major cloud service providers offer similar services. Simply put, it's a file server. Examples include Alibaba Cloud OSS, Tencent Cloud COS, and Huawei Cloud OBS. While they have different names, their functionalities are quite similar. The new feature of this update component is implemented in a very similar manner, so we chose OSS to name this feature, making it easy for developers to quickly understand its purpose (requires the use of components GeneralUpdate.ClientCore, GeneralUpdate.Core).



**GeneralClientOSS**

GeneralClientOSS类是另外一种更新机制与GeneralClientBootstrap不同的是，GeneralClientOSS不需要编写服务端的代码直接根据OSS文件服务器的version.josn的版本信息进行更新，简化了新手使用本组件的门槛。
The GeneralClientOSS class is another update mechanism. Unlike GeneralClientBootstrap, GeneralClientOSS does not require writing server-side code and directly updates based on the version information from the version.json file on the OSS file server, simplifying the threshold for beginners using this component.

```c#
public sealed class GeneralClientOSS
```

nuget安装
NuGet Installation

```shell
NuGet\Install-Package GeneralUpdate.ClientCore -Version 3.0.0
```



### 示例
### Example

#### OSS流程
#### OSS Process

![](imgs/oss_flow.png)

1.准备version.json版本信息配置文件，更新文件（update.zip）更新文件和之前的打包方式一样。
1. Prepare the version.json configuration file and update files (update.zip) just like in previous packaging methods.

![](imgs/oss_version_json.png)

2.Client启动时直接请求OSS服务器或文件服务器，下载version.json文件。
2. When the Client starts, it directly requests the OSS server or file server to download the version.json file.

![](imgs/oss_util.png)

3.下载到本地之后解析版本信息内容判断是否需要更新，如果将信息通过进程启动传递Upgrade（Client自我 关闭）。
3. After downloading to the local system, it parses the version information to determine if an update is needed. If so, it passes the information to Upgrade through a process launch (Client self-closes).

4.Upgrade启动之后直接去下载update.zip，下载到本地之后直接解压覆盖本地文件。
4. After Upgrade starts, it directly downloads update.zip and extracts it locally to overwrite the local files.

5.Upgrade更新完成之后把Client启动起来，自我关闭。更新结束。 GeneralUpdateOSS的功能和GeneralUpdateBootstrap功能对比来说，使用的门槛非常低如果公司对自动 更新的要求不高的话可以使用这个功能。一句话概括这个功能就是下载version.json根据文件里的内容去逐 版本下载更新包，下载下来之后直接解压更新就结束了。
5. After the Upgrade completes, it starts the Client and self-closes. The update ends. Compared to the GeneralUpdateBootstrap function, the GeneralUpdateOSS function has a very low usage threshold. If the company does not have high requirements for automatic updates, this feature can be used. In summary, this function downloads the version.json and updates based on the content in the file, downloading each version's update package and extracting it to complete the update.



以下示例定义方法，包含GeneralClientOSS使用方法。
The following example defines methods, including the usage of GeneralClientOSS.

```c#
Task.Run(async () =>
Expand All @@ -72,72 +72,72 @@ Task.Run(async () =>



### 注解
### Annotation

GeneralUpdateOSS提供以下能力。
GeneralUpdateOSS provides the following capabilities.

#### 属性
#### Properties

| Properties | |
| ---------- | ----------------- |
| ParamsOSS | OSS更新配置参数。 |
| Properties | Description |
| ---------- | ------------------------------------ |
| ParamsOSS | OSS update configuration parameters. |



#### 方法
#### Methods

| Method | |
| ---------------------- | ---------------------- |
| Start() | 启动OSS更新。 |
| AddListenerException() | 监听组件内部异常信息。 |
| Method | Description |
| ---------------------- | ----------------------------------------------------------- |
| Start() | Start the OSS update. |
| AddListenerException() | Listen for internal exception information of the component. |



### 🌴ParamsOSS

**属性**
**Properties**

**Url** string http的api服务端请求地址。
**Url** string: HTTP API server request address.

**AppName** string 应用名称。
**AppName** string: Application name.

**CurrentVersion** string 当前版本。
**CurrentVersion** string: Current version.

**VersionFileName** string 版本文件名称。
**VersionFileName** string: Version file name.



### 🌼Start()

**方法**
**Method**

启动OSS更新。
Start the OSS update.

```c#
public static async Task Start(ParamsOSS configParams, string upgradeAppName = "GeneralUpdate.Upgrade");
```



**参数类型**
**Parameter Types**

ParamsOSS 更新配置参数，详细内容参考本文档🌴ParamsOSS。
ParamsOSS: Update configuration parameters, detailed content can be found in this document under 🌴ParamsOSS.



**参数**
**Parameters**

**parameter** ParamsOSS 安卓平台的跟新配置参数。
**parameter** ParamsOSS: Update configuration parameters for the Android platform.

**upgradeAppName** 需要升级的应用名称。
**upgradeAppName**: Name of the application to be upgraded.



### 适用于
### Applicable to

| 产品 | 版本 |
| Product | Version |
| -------------- | ------------- |
| .NET | 5、6、7、8、9 |
| .NET | 5, 6, 7, 8, 9 |
| .NET Framework | 4.6.1 |
| .NET Standard | 2.0 |
| .NET Core | 2.0 |
74 changes: 37 additions & 37 deletions website/docs/doc/GeneralSpacestation.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,77 +4,77 @@ sidebar_position: 1

![](imgs\GeneralUpdate_h2.png)

## 产品介绍
## Product Introduction

GeneralLibrary团队针对企业级应用开发了GeneralSpacestation服务，解决对于自动升级管理方面的问题。整套系统所涉及到的所有组件内容均为自研、MIT或商用友好的开源组件，严格规避商用法律风险。
The GeneralLibrary team has developed the GeneralSpacestation service for enterprise applications, addressing issues related to automatic update management. All components involved in the entire system are self-developed, MIT-licensed, or open-source components friendly for commercial use, strictly avoiding legal risks in commercial use.

整套服务包含了以下内容：
The entire service includes the following:

| 名称 | 介绍 | 是否收费 | 详情 |
| -------------------- | ------------------------------ | --------- | ------------------------------------------------------- |
| GeneralUpdate | 桌面客户端自动升级解决方案 | 免费 | https://github.com/GeneralLibrary/GeneralUpdate |
| GeneralUpdate-Sample | 使用代码示例 | 免费 | https://github.com/GeneralLibrary/GeneralUpdate-Samples |
| GeneralUpdate.Admin | 自动升级管理服务可视化解决方案 | 收费 | https://www.justerzhu.cn/ |
| GeneralSpacestation | 自动升级管理服务解决方案 | 收费 | https://www.justerzhu.cn/ |
| 线上\下培训会议 | 帮助企业快速上手使用产品 | 附赠\收费 | 扫码咨询\可单独购买 |
| 使用手册 | 帮助企业快速上手使用产品 | 附赠\收费 | 扫码咨询\可单独购买 |
| 项目对接\咨询 | 帮助企业快速上手使用产品 | 附赠\收费 | 扫码咨询\可单独购买 |
| Name | Description | Cost | Details |
| -------------------------------- | ------------------------------------------------------ | ------------------ | ---------------------------------------------------------- |
| GeneralUpdate | Desktop client automatic update solution | Free | https://github.com/GeneralLibrary/GeneralUpdate |
| GeneralUpdate-Sample | Sample usage code | Free | https://github.com/GeneralLibrary/GeneralUpdate-Samples |
| GeneralUpdate.Admin | Visual solution for automatic update management | Paid | https://www.justerzhu.cn/ |
| GeneralSpacestation | Solution for automatic update management | Paid | https://www.justerzhu.cn/ |
| Online/Offline Training Sessions | Helps enterprises quickly get started with the product | Complimentary/Paid | Scan the code for consultation/can be purchased separately |
| User Manual | Helps enterprises quickly get started with the product | Complimentary/Paid | Scan the code for consultation/can be purchased separately |
| Project Integration/Consultation | Helps enterprises quickly get started with the product | Complimentary/Paid | Scan the code for consultation/can be purchased separately |



## 功能
## Features

### Tools 模块展示
### Tools Module Display

![](imgs\generalspacestation.png)

### Upgrade 模块展示
### Upgrade Module Display

![](imgs\generalspacestation2.png)



## 解决方案
## Solution

![](imgs\solution2.png)

![](imgs\solution.png)

介绍部分所涉及到的技术（包括但不限于 操作系统 \ 框架 \ 语言 \ 开源组件 等内容）：
Technologies involved in the introduction (including but not limited to operating systems, frameworks, languages, open-source components, etc.):

| 技术 | 备注 | 详情 |
| -------------- | --------------------------------------------------- | ------------------------------------------------------------ |
| .NET Core 9 | 微软公司旗下最新免费开源框架（MIT License） | https://dotnet.microsoft.com/zh-cn/download/dotnet/9.0 |
| C#13 | 微软公司旗下最新版本开源开发语言之一（MIT License） | https://dotnet.microsoft.com/zh-cn/languages/csharp |
| Aavalonia | Aavalonia团队的跨平台开源UI框架（MIT License） | https://avaloniaui.net/ |
| Prism.Avalonia | PrismLibrary团队项目结构框架（MIT License） | https://github.com/AvaloniaCommunity/Prism.Avalonia |
| Semi.Avalonia | irihi团队开源UI控件库框架（MIT License） | https://www.irihi.tech/ |
| ASP.NET Core | 微软旗下最新服务端框架（MIT License） | https://dotnet.microsoft.com/zh-cn/apps/aspnet |
| MySQL | Oracle公司旗下商用友好的数据库 | https://www.mysql.com/cn/ |
| DDD | 当下流行的架构\设计模式 | https://learn.microsoft.com/zh-cn/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/ |
| MVVM | 当下流行的架构\设计模式 | https://learn.microsoft.com/zh-cn/dotnet/architecture/maui/mvvm |
| AOT | GeneralUpdate所有组件全线支持、兼容AOT编译 | https://learn.microsoft.com/en-us/dotnet/core/deploying/native-aot/ |
| Linux (Ubuntu) | 本产品全线支持Linux操作系统 | https://cn.ubuntu.com/ |
| Windows | 支持win7以上版本的操作系统 | https://support.microsoft.com/zh-cn/welcometowindows |
| LoongOS | 国产（龙芯）操作系统（新世界） | https://www.loongson.cn/system/loongos |
| ...... | ...... | |
| Technology | Remarks | Details |
| -------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| .NET Core 9 | Latest free open-source framework by Microsoft (MIT License) | https://dotnet.microsoft.com/zh-cn/download/dotnet/9.0 |
| C#13 | One of the latest versions of Microsoft's open-source development languages (MIT License) | https://dotnet.microsoft.com/zh-cn/languages/csharp |
| Avalonia | Cross-platform open-source UI framework by the Avalonia team (MIT License) | https://avaloniaui.net/ |
| Prism.Avalonia | Project structure framework by PrismLibrary team (MIT License) | https://github.com/AvaloniaCommunity/Prism.Avalonia |
| Semi.Avalonia | Open-source UI control library framework by the irihi team (MIT License) | https://www.irihi.tech/ |
| ASP.NET Core | Latest server-side framework by Microsoft (MIT License) | https://dotnet.microsoft.com/zh-cn/apps/aspnet |
| MySQL | Commercial-friendly database by Oracle | https://www.mysql.com/cn/ |
| DDD | Popular architecture/design pattern | https://learn.microsoft.com/zh-cn/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/ |
| MVVM | Popular architecture/design pattern | https://learn.microsoft.com/zh-cn/dotnet/architecture/maui/mvvm |
| AOT | Full support for AOT compilation across all GeneralUpdate components | https://learn.microsoft.com/en-us/dotnet/core/deploying/native-aot/ |
| Linux (Ubuntu) | Full support for Linux operating systems | https://cn.ubuntu.com/ |
| Windows | Supports operating systems from Windows 7 onwards | https://support.microsoft.com/zh-cn/welcometowindows |
| LoongOS | Domestic (Loongson) operating system (New World) | https://www.loongson.cn/system/loongos |
| ...... | ...... | |



## 企业客户
## Corporate Clients

![](imgs\corporateclient1.png)

![](imgs\corporateclient2.png)



## 软著登记
## Software Registration

![](imgs\ruanzhu.png)

## 联系我们
## Contact Us

以下是企业咨询、报价、商务合作联系方式（加好友请注明来意拒绝闲聊，推荐加微信）。
Below are the contact details for enterprise inquiries, quotations, and business cooperation (please indicate your purpose when adding as a friend, casual chat is declined, adding on WeChat is recommended).

![](imgs\contact.png)
Loading

0 comments on commit c9f8b37

Please sign in to comment.