Skip to content

Commit e1ef4dd

Browse files
JusterZhugitee-org
JusterZhu
authored and
gitee-org
committed
!63 readme
Merge pull request !63 from Juster Zhu/dev
2 parents a65765d + ad75e48 commit e1ef4dd

File tree

1 file changed

+62
-73
lines changed

1 file changed

+62
-73
lines changed

‎README_en.md‎

Lines changed: 62 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -1,94 +1,83 @@
11
# GeneralUpdate #
22
![](https://img.shields.io/github/license/JusterZhu/GeneralUpdate?color=blue)
33

4-
54
![](imgs/GeneralUpdate_h.png)
65

7-
### 1.Component introduction ###
8-
9-
- GeneralUpdate is an open source automatic upgrade component based on .NET Standard 2.0
10-
- Operating environment：.NET7、.NET MAUI、Visual studio 2022(Preview)
11-
12-
| function | Supported or not | note |
13-
| ------------------------------------------------- | ---------------- | ------------------------------------------------------------ |
14-
| Resume the upload at a breakpoint | yes | If a single update fails, the contents of the update package will continue to download the previous update on the next startup. (Reference components take effect by default) |
15-
| Update version-by-version | yes | If the current version of the client differs from the server by more than one version, it is updated one by one according to the release date of the multiple versions. (Reference components take effect by default) |
16-
| Binary differential update | yes | Compare the old and new versions to generate patch files by differential algorithms. (Reference components take effect by default) |
17-
| Incremental update functionality | yes | Only the currently modified files are updated compared to the previous version，And delete files that do not exist in the current version. (Reference components take effect by default) |
18-
| Force an update | yes | Force an update directly after opening the client. |
19-
| Multi-branch updates | yes | When a product has multiple branches, you need to update the corresponding content according to different branches. |
20-
| The latest version push | yes | Based on the SignalR implementation, push the latest version. |
21-
| Client programs and server programs apply updates | yes | Both C/S and B/S programs are available. |
22-
| Multi-platform, operating system | Partial support | Windows、Android |
23-
| Multilingual | To be verified | You can also write this component as a console program as an update "script". Update applications in other languages. |
24-
| Skip updates | yes | Support injection pop-up window allows users to decide whether to update this release, and the update will not take effect when the server decides to force it. |
25-
| Upgrade each other | yes | The main program updates the upgrade program, and the upgrade program updates the main program. |
26-
| Black list | yes | Files and file extensions from the blacklist are skipped during the update process. |
27-
| OSS | yes | Minimal updates require only the version configuration file of version.json to be placed on the file server. Components are updated and downloaded based on the version information in the configuration file.(Supported windows，MAUI Android) |
28-
| Restore | test | Each version is backed up during a version-by-version update and rolled back version-by-version if the update fails. |
29-
| Driver upgrade | yes | The driver file (.INF) of each version is backed up during the version-by-version update and is rolled back version-by-version if the update fails. |
30-
| Will message | test | The upgrade is checked for success at boot and upgrade, and if it fails, the previous backup is restored according to the last word. The last word is that the will_message.json file in the C:\generalupdate_willmessages directory was automatically created before the update. will_message.json is about the file directory of the persistent rollback backup.(need to deploy GeneralUpdate. SystemService system service) |
31-
| A list of custom methods | 支持 | Inject a custom collection of methods that are executed before the update starts. Execute a custom method list, and if there are any exceptions, you will be notified by exception subscription.(It is recommended to check the current software environment before updating) |
32-
6+
## 1. Component Introduction ##
337

8+
GeneralUpdate is an open-source automatic update component based on .NET Standard 2.0.
349

35-
### 2.Help documentation ###
10+
Documentation
3611

37-
- explainer video： https://www.bilibili.com/video/BV1aX4y137dd
38-
- Official website： http://justerzhu.cn/
39-
- Quick Start： https://mp.weixin.qq.com/s/pRKPFe3eC0NSqv9ixXEiTg
40-
- Use the tutorial video：https://www.bilibili.com/video/BV1FT4y1Y7hV
41-
- Doc : https://gitee.com/GeneralLibrary/GeneralUpdate/tree/master/doc
12+
- Official website: https://www.justerzhu.cn/
13+
- Tutorial video: https://www.bilibili.com/video/BV1FT4y1Y7hV
4214

43-
### 3.Open source address ###
44-
45-
### 3.1 Current project GeneralUpdate
15+
Current Project GeneralUpdate
4616

4717
- https://github.com/JusterZhu/GeneralUpdate
4818
- https://gitee.com/Juster-zhu/GeneralUpdate
4919

50-
### 3.2 Packaging tool project address GeneralUpdate.Tools
20+
MAUI GeneralUpdate.Maui
21+
22+
- https://github.com/GeneralLibrary/GeneralUpdate.Maui
23+
24+
Packaging Tool Project Address GeneralUpdate.Tools
5125

5226
- https://github.com/GeneralLibrary/GeneralUpdate.Tools
5327
- https://gitee.com/GeneralTeam/GeneralUpdate.Tools
5428

55-
### 3.3 Sample project address GeneralUpdate-Samples
29+
Sample Project Address GeneralUpdate-Samples
5630

5731
- https://github.com/GeneralLibrary/GeneralUpdate-Samples
58-
5932
- https://gitee.com/GeneralTeam/GeneralUpdate-Samples
6033

61-
### 4.Support frame
62-
63-
| frame name | support |
64-
| -------------------------- | ------- |
65-
| .NET Core 2.0 | yes |
66-
| .NET 5 ... to last version | yes |
67-
| .NET Framework 4.6.1 | yes |
68-
69-
| UI frame name | support |
70-
| ------------- | ---------------------------------- |
71-
| WPF | yes |
72-
| UWP | Not updatable in store mode |
73-
| MAUI | Compatible (Android) |
74-
| Avalonia | yes |
75-
| WinUI | Not verified, waiting for feedback |
76-
| Console | yes |
77-
| winform | yes |
78-
79-
| server-side frame | support |
80-
| ----------------- | -------------------- |
81-
| ASP.NET | pending verification |
82-
83-
### Operating system
84-
85-
| operating system name | support |
86-
| --------------------- | ----------------------- |
87-
| Windows | yes |
88-
| Linux | pending verification |
89-
| Mac | pending verification |
90-
| iOS | Not currently supported |
91-
| Android | yes |
92-
| raspberry pie | Not currently supported |
93-
| Kylin V10 (FT-S2500) | yes |
94-
| Kylin V10 (x64) | yes |
34+
Feature Introduction:
35+
36+
| Feature | Supported | Remarks |
37+
| -------------------------- | -------------- | ------------------------------------------------------------ |
38+
| Resume Download | Yes | If an update fails, it continues from the last update on the next startup. (Enabled by default) |
39+
| Version-by-Version Update | Yes | If the client is several versions behind the server, it updates one version at a time based on release dates. (Enabled by default) |
40+
| Binary Differential Update | Yes | Generates patch files using a differential algorithm between new and old versions. (Enabled by default) |
41+
| Incremental Update | Yes | Only updates modified files compared to the previous version and deletes files not present in the current version. (Enabled by default) |
42+
| Forced Update | Yes | Forces an update right after opening the client. |
43+
| Multi-Branch Update | Yes | Updates different content based on different branches of a product. |
44+
| Latest Version Push | Yes | Implements Signal R to push the latest version. |
45+
| Multi-Language | To be verified | Can also be written as a console application to update applications in other languages. |
46+
| Skip Update | Yes | Allows injecting a prompt for users to decide whether to update; does not apply if forced by the server. |
47+
| Mutual Upgrade | Yes | The main program can update the upgrade program, and vice versa. |
48+
| Blacklist | Yes | Skips files and file extensions listed in the blacklist during updates. |
49+
| OSS | Yes | Simplified update mechanism, requiring only a version.json file on the file server. Updates based on the version information in the configuration file. |
50+
| Rollback and Backup | Yes | Backs up local client files before updating; rolls back if the client fails to start or crashes. |
51+
| Driver Update | To be verified | Backs up drivers locally before updating; rolls back if the client fails to start or crashes. |
52+
| Custom Method List | Yes | Injects a custom method collection executed before the update starts. Notifies through exception subscription if any exception occurs. (Recommended to check the software environment before updating) |
53+
| AOT | Yes | Supports AOT compilation and release. |
54+
55+
## 2. Supported Frameworks
56+
57+
| .NET Framework Name | Supported |
58+
| -------------------------- | --------- |
59+
| .NET Core 2.0 | Yes |
60+
| .NET 5 ... to last version | Yes |
61+
| .NET Framework 4.6.1 | Yes |
62+
63+
| UI Framework Name | Supported |
64+
| ----------------- | ---------------------------------------- |
65+
| WPF | Yes |
66+
| UWP | Not updatable in store mode |
67+
| MAUI | Currently supports Android platform only |
68+
| Avalonia | Yes |
69+
| WinUI | Yes |
70+
| Console | Yes |
71+
| WinForms | Yes |
72+
73+
## 3. Operating Systems
74+
75+
| Operating System Name | Supported |
76+
| ------------------------- | -------------- |
77+
| Windows | Yes |
78+
| Linux | Yes |
79+
| Android | Yes |
80+
| Kylin V10 (Feiteng S2500) | Yes |
81+
| Kylin V10 (x64) | Yes |
82+
| Ubuntu | Yes |
83+
| Loongson (Loongnix) | To be verified |

0 commit comments

Comments
 (0)