mirror of
https://github.com/velopack/velopack.git
synced 2025-10-25 15:19:22 +00:00
Update main readme to mention v3
This commit is contained in:
51
README.md
51
README.md
@@ -1,39 +1,25 @@
|
|||||||
| README.md |
|
|
||||||
|:---|
|
|
||||||
|
|
||||||
[](https://www.nuget.org/packages/Clowd.Squirrel/)
|
[](https://www.nuget.org/packages/Clowd.Squirrel/)
|
||||||
|
|
||||||
# Clowd.Squirrel
|
# Clowd.Squirrel
|
||||||
|
|
||||||
Squirrel is both a set of tools and a library, to completely manage both installation and updating your Desktop Windows application.
|
Squirrel is both a set of tools and a library, to completely manage both installation and updating your desktop application.
|
||||||
|
|
||||||
This project is a fork of the library [Squirrel.Windows](https://github.com/Squirrel/Squirrel.Windows). The main focus here has been to update to more modern tooling, such as upgrading the main libraries to `netstandard2.0`, upgrading the tools to `net6.0`, and adding lots of fixes for dotnet core support.
|
Feel free to join our discord to recieve updates or to ask questions:
|
||||||
|
|
||||||
This library will help you build a `Setup.exe`, integrated (or standalone `Update.exe`) application updater, and release updates to your users very quickly and easily. The `Setup.exe` and `Update.exe` produced by this library are completely dependency free, and can even help you bootstrap/install any number of runtimes your app needs (such as dotnet 5/6, .net 4.8 or others).
|
|
||||||
|
|
||||||
Feel free to join our discord for help or questions:
|
|
||||||
|
|
||||||
[](https://discord.gg/CjrCrNzd3F)
|
[](https://discord.gg/CjrCrNzd3F)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Migrating from Squirrel.Windows?
|
## Looking for info on v3.0 / cross-platform?
|
||||||
|
Clowd.Squirrel v3.0 is a ground-up re-write and now supports macos (linux in the future?). Documentation for this is very limited but I have started working on this [in the docs-v3 folder](docs-v3). This work is being done in the `develop` branch.
|
||||||
|
|
||||||
A couple of notes you should be aware of.
|
I will continue to support 2.x with critical fixes until further notice. This is currently the `master` branch.
|
||||||
- The command line interface for Squirrel.exe is massively different. Check 'Squirrel.exe -h' for more info.
|
|
||||||
- The command line for Update.exe here is compatible with the old Squirrel.
|
|
||||||
- Update.exe here is bigger (total 12.5mb) and is included in your packages.
|
|
||||||
- Migrating to this library is fully compatible, except for the way we detect SquirrelAware binaries. More info below.
|
|
||||||
- There have been a great many other improvements here. To see some of them [have a look at the feature matrix](#feature-matrix).
|
|
||||||
- Something detected as a virus? This was an issue at the old Squirrel, and also see [issue #28](https://github.com/clowd/Clowd.Squirrel/issues/28)
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## What Do We Want?
|
## What Do We Want?
|
||||||
|
|
||||||
Windows apps should be as fast and as easy to install and update as apps like Google Chrome. From an app developer's side, it should be really straightforward to create an installer for my app, and publish updates to it, without having to jump through insane hoops.
|
Apps should be as fast easy to install. Update should be seamless like Google Chrome. From a developer's side, it should be really straightforward to create an installer for my app, and publish updates to it, without having to jump through insane hoops.
|
||||||
|
|
||||||
* **Integrating** an app to use Squirrel should be extremely easy, provide a client API, and be developer friendly.
|
* **Integrating** an app to use Squirrel should be extremely easy, provide a client API, and be developer friendly.
|
||||||
* **Packaging** is really easy, can be automated, and supports delta update packages.
|
* **Packaging** is really easy, can be automated, and supports delta update packages.
|
||||||
@@ -43,6 +29,17 @@ Windows apps should be as fast and as easy to install and update as apps like Go
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## Migrating from Squirrel.Windows?
|
||||||
|
|
||||||
|
- The command line interface for Squirrel.exe is different. Check 'Squirrel.exe -h' for more info.
|
||||||
|
- The command line for Update.exe here is compatible with the old Squirrel.
|
||||||
|
- Update.exe here is bigger and is included in your packages. This means Update.exe will be updated each time you update your app. As long as you build delta packages, this will not impact the size of your updates.
|
||||||
|
- Migrating to this library is fully compatible, except for the way we detect SquirrelAware binaries. Follow the Quick Start guide.
|
||||||
|
- There have been a great many other improvements here. To see some of them [have a look at the feature matrix](#feature-matrix).
|
||||||
|
- Something detected as a virus? This was an issue at the old Squirrel, and also see [issue #28](https://github.com/clowd/Clowd.Squirrel/issues/28)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Quick Start For .NET Apps
|
## Quick Start For .NET Apps
|
||||||
|
|
||||||
1. Install the [Clowd.Squirrel Nuget Package](https://www.nuget.org/packages/Clowd.Squirrel/)
|
1. Install the [Clowd.Squirrel Nuget Package](https://www.nuget.org/packages/Clowd.Squirrel/)
|
||||||
@@ -147,20 +144,6 @@ Windows apps should be as fast and as easy to install and update as apps like Go
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Quick Start For Native / Other Apps
|
|
||||||
|
|
||||||
This quick start guide is coming soon. Refer to below for complete docs which contains native app instructions.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## More Documentation
|
|
||||||
|
|
||||||
**Note - most of the following documentation is now out of date and updates are also coming soon**
|
|
||||||
|
|
||||||
See the documentation [Table of Contents](docs/readme.md) for an overview of the available documentation.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Feature Matrix
|
## Feature Matrix
|
||||||
|
|
||||||
| Feature | Clowd.Squirrel | Squirrel.Windows |
|
| Feature | Clowd.Squirrel | Squirrel.Windows |
|
||||||
|
|||||||
Reference in New Issue
Block a user