mirrors/electron
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions 1

📝 Some more words

Browse source
This commit is contained in:
Felix Rieseberg 2018-02-01 09:43:26 -08:00
commit 495c6dcff5
1 changed files with 12 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

26
docs/tutorial/snapcraft-guide.md
View file

@ -6,17 +6,17 @@ for any Snapcraft environment, including the Ubuntu Software Center.
## Background and Requirements ## Background and Requirements
Together with the broader Linux community, Canonical aims to fix many of the Together with the broader Linux community, Canonical aims to fix many of the
common software installation problems with the [`snapcraft`](snapcraft.io) common software installation problems with the [`snapcraft`][snapcraft.io)
project. Snaps are containerized software packages that include required project. Snaps are containerized software packages that include required
dependencies, auto-update, and work on all major Linux distributions without dependencies, auto-update, and work on all major Linux distributions without
system modification. system modification.
There are three ways to create a `.snap` file: There are three ways to create a `.snap` file:
1) Using `electron-installer-snap`, which takes `electron-packager's` output 1) Using `electron-installer-snap`, which takes `electron-packager's` output.
2) Using an already created `.deb` package 2) Using an already created `.deb` package.
3) Using [`electron-forge`](electron-forge) or 3) Using [`electron-forge`][electron-forge] or
[`electron-builder`](electron-builder), both tools that come with `snap` [`electron-builder`][electron-builder], both tools that come with `snap`
support out of the box. This is the easiest option. support out of the box. This is the easiest option.
In all cases, you will need to have the `snapcraft` tool installed. We In all cases, you will need to have the `snapcraft` tool installed. We
@ -27,7 +27,7 @@ snap install snapcraft --classic
``` ```
While it _is possible_ to install `snapcraft` on macOS using Homebrew, it While it _is possible_ to install `snapcraft` on macOS using Homebrew, it
is not able to build `snap` packages and is focused on managed packages is not able to build `snap` packages and is focused on managing packages
in the store. in the store.
# Using `electron-installer-snap` # Using `electron-installer-snap`
@ -41,7 +41,7 @@ npm install --save-dev electron-installer-snap
## Step 1: Package Your Electron Application ## Step 1: Package Your Electron Application
Package the application using [electron-packager](electron-packager) (or a Package the application using [electron-packager][electron-packager] (or a
similar tool). Make sure to remove `node_modules` that you don't need in your similar tool). Make sure to remove `node_modules` that you don't need in your
final application, since any module you don't actually need will just increase final application, since any module you don't actually need will just increase
your application's size. your application's size.
@ -77,7 +77,7 @@ npx electron-installer-snap --src=out/myappname-linux-x64
``` ```
If you have an existing build pipeline, you can use `electron-installer-snap` If you have an existing build pipeline, you can use `electron-installer-snap`
programmatically. For more information, see the [API docs](snapcraft-syntax). programmatically. For more information, see the [API docs][snapcraft-syntax].
```js ```js
const snap = require('electron-installer-snap') const snap = require('electron-installer-snap')
@ -97,14 +97,14 @@ building blocks.
If you do not already have a `.deb` package, using `electron-installer-snap` If you do not already have a `.deb` package, using `electron-installer-snap`
might be an easier path to create snap packages. However, multiple solutions might be an easier path to create snap packages. However, multiple solutions
for creating Debian packages exist, including [`electron-forge`](electron-forge), for creating Debian packages exist, including [`electron-forge`][electron-forge],
[`electron-builder`](electron-builder) or [`electron-builder`][electron-builder] or
[`electron-installer-debian`](electron-installer-debian). [`electron-installer-debian`][electron-installer-debian].
## Step 2: Create a snapcraft.yaml ## Step 2: Create a snapcraft.yaml
For more information on the available configuration options, see the For more information on the available configuration options, see the
[documentation on the snapcraft syntax](https://docs.snapcraft.io/build-snaps/syntax). [documentation on the snapcraft syntax][snapcraft-syntax].
Let's look at an example: Let's look at an example:
```yaml ```yaml
@ -125,8 +125,6 @@ parts:
source-type: deb source-type: deb
after: after:
- desktop-gtk2 - desktop-gtk2
build-packages:
- patchelf
stage-packages: stage-packages:
- libasound2 - libasound2
- libgconf2-4 - libgconf2-4