docs: mention alternative tooling (#39337)

* docs: mention alternative tooling

* Update forge-overview.md

* Update forge-overview.md
This commit is contained in:
Erick Zhao 2023-08-24 03:03:30 -07:00 коммит произвёл GitHub
Родитель 35969939a1
Коммит 381c955bca
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
1 изменённых файлов: 41 добавлений и 8 удалений

Просмотреть файл

@ -4,15 +4,48 @@ Electron Forge is a tool for packaging and publishing Electron applications.
It unifies Electron's build tooling ecosystem into It unifies Electron's build tooling ecosystem into
a single extensible interface so that anyone can jump right into making Electron apps. a single extensible interface so that anyone can jump right into making Electron apps.
<details>
<summary>Alternative tooling</summary>
If you do not want to use Electron Forge for your project, there are other
third-party tools you can use to distribute your app.
These tools are maintained by members of the Electron community,
and do not come with official support from the Electron project.
**Electron Builder**
A "complete solution to package and build a ready-for-distribution Electron app"
that focuses on an integrated experience. [`electron-builder`](https://github.com/electron-userland/electron-builder) adds a single dependency and manages all further requirements internally.
`electron-builder` replaces features and modules used by the Electron
maintainers (such as the auto-updater) with custom ones.
**Hydraulic Conveyor**
A [desktop app deployment tool](https://hydraulic.dev) that supports
cross-building/signing of all packages from any OS without the need for
multi-platform CI, can do synchronous web-style updates on each start
of the app, requires no code changes, can use plain HTTP servers for updates and
which focuses on ease of use. Conveyor replaces the Electron auto-updaters
with Sparkle on macOS, MSIX on Windows, and Linux package repositories.
Conveyor is a commercial tool that is free for open source projects. There's
an example of [how to package GitHub Desktop](https://hydraulic.dev/blog/8-packaging-electron-apps.html)
which can be used for learning.
</details>
## Getting started ## Getting started
The [Electron Forge docs][] contain detailed information on taking your application The [Electron Forge docs][] contain detailed information on taking your application
from source code to your end users' machines. from source code to your end users' machines.
This includes: This includes:
* Packaging your application [(package)][] - Packaging your application [(package)][]
* Generating executables and installers for each OS [(make)][], and, - Generating executables and installers for each OS [(make)][], and,
* Publishing these files to online platforms to download [(publish)][]. - Publishing these files to online platforms to download [(publish)][].
For beginners, we recommend following through Electron's [tutorial][] to develop, build, For beginners, we recommend following through Electron's [tutorial][] to develop, build,
package and publish your first Electron app. If you have already developed an app on your machine package and publish your first Electron app. If you have already developed an app on your machine
@ -20,11 +53,11 @@ and want to start on packaging and distribution, start from [step 5][] of the tu
## Getting help ## Getting help
* If you need help with developing your app, our [community Discord server][discord] is a great place - If you need help with developing your app, our [community Discord server][discord] is a great place
to get advice from other Electron app developers. to get advice from other Electron app developers.
* If you suspect you're running into a bug with Forge, please check the [GitHub issue tracker][] - If you suspect you're running into a bug with Forge, please check the [GitHub issue tracker][]
to see if any existing issues match your problem. If not, feel free to fill out our bug report to see if any existing issues match your problem. If not, feel free to fill out our bug report
template and submit a new issue. template and submit a new issue.
[Electron Forge Docs]: https://www.electronforge.io/ [Electron Forge Docs]: https://www.electronforge.io/
[step 5]: ./tutorial-5-packaging.md [step 5]: ./tutorial-5-packaging.md