mirror of
https://github.com/balena-io/etcher.git
synced 2025-11-09 10:28:32 +00:00
Compare commits
48 Commits
v1.15.4
...
aethernet/
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
308e7c2585 | ||
|
|
b5042e9b9f | ||
|
|
81910d27ee | ||
|
|
ab386a8521 | ||
|
|
80a96160a2 | ||
|
|
6fae328f1f | ||
|
|
81b0eed4d4 | ||
|
|
b786c8bc10 | ||
|
|
856b426dc9 | ||
|
|
197a8f9c57 | ||
|
|
bc4ee48c1b | ||
|
|
0d9ac71088 | ||
|
|
a0fc9bbd68 | ||
|
|
7e0519df9a | ||
|
|
bf0360e7f4 | ||
|
|
62bae7c52e | ||
|
|
802f5b2980 | ||
|
|
496f131c4b | ||
|
|
f582b0215c | ||
|
|
4c3c4babea | ||
|
|
6ec0550b4c | ||
|
|
4e9039c244 | ||
|
|
e479b95d72 | ||
|
|
926ff2b754 | ||
|
|
394b64319d | ||
|
|
96fa53b6ee | ||
|
|
9b54e2af0b | ||
|
|
b01cf3c2e1 | ||
|
|
46307d85d8 | ||
|
|
772df8f5e7 | ||
|
|
04fa3dcd8c | ||
|
|
6538864de4 | ||
|
|
480adc3426 | ||
|
|
c11db0a279 | ||
|
|
6f7570d265 | ||
|
|
ae976894a3 | ||
|
|
cd00f78c05 | ||
|
|
3c1dd6ce29 | ||
|
|
5099c6ff21 | ||
|
|
c63c98b80a | ||
|
|
6834dae281 | ||
|
|
df7854111a | ||
|
|
c0404597c0 | ||
|
|
64eafdc6f0 | ||
|
|
b51418814f | ||
|
|
748f9d9147 | ||
|
|
5c8c4ea412 | ||
|
|
e6d33eda2b |
2
.github/actions/publish/action.yml
vendored
2
.github/actions/publish/action.yml
vendored
@@ -15,7 +15,7 @@ inputs:
|
|||||||
default: "accounts+apple@balena.io"
|
default: "accounts+apple@balena.io"
|
||||||
NODE_VERSION:
|
NODE_VERSION:
|
||||||
type: string
|
type: string
|
||||||
default: "14.x"
|
default: "16.x"
|
||||||
VERBOSE:
|
VERBOSE:
|
||||||
type: string
|
type: string
|
||||||
default: "true"
|
default: "true"
|
||||||
|
|||||||
2
.github/actions/test/action.yml
vendored
2
.github/actions/test/action.yml
vendored
@@ -12,7 +12,7 @@ inputs:
|
|||||||
# --- custom environment
|
# --- custom environment
|
||||||
NODE_VERSION:
|
NODE_VERSION:
|
||||||
type: string
|
type: string
|
||||||
default: "14.x"
|
default: "16.x"
|
||||||
VERBOSE:
|
VERBOSE:
|
||||||
type: string
|
type: string
|
||||||
default: "true"
|
default: "true"
|
||||||
|
|||||||
1
.github/workflows/flowzone.yml
vendored
1
.github/workflows/flowzone.yml
vendored
@@ -27,3 +27,4 @@ jobs:
|
|||||||
repo_description: "Flash OS images to SD cards & USB drives, safely and easily."
|
repo_description: "Flash OS images to SD cards & USB drives, safely and easily."
|
||||||
repo_homepage: https://etcher.io/
|
repo_homepage: https://etcher.io/
|
||||||
repo_enable_wiki: true
|
repo_enable_wiki: true
|
||||||
|
cloudflare_website: "etcher"
|
||||||
|
|||||||
@@ -1,3 +1,191 @@
|
|||||||
|
- commits:
|
||||||
|
- subject: add-flash-with-etcher-to-docs
|
||||||
|
hash: 856b426dc98925f5e339976a5cac144f4bb4ea59
|
||||||
|
body: ""
|
||||||
|
footer:
|
||||||
|
Change-type: patch
|
||||||
|
change-type: patch
|
||||||
|
author: Lizzie Epton
|
||||||
|
nested: []
|
||||||
|
version: 1.18.6
|
||||||
|
title: ""
|
||||||
|
date: 2023-03-21T13:24:18.265Z
|
||||||
|
- commits:
|
||||||
|
- subject: "patch: add apt-get update in flowzone preinstall"
|
||||||
|
hash: 0d9ac710880e6b9413b09e4c35a505034d1e9d51
|
||||||
|
body: libudev package has changed and cannot be installed if we not update apt
|
||||||
|
cache
|
||||||
|
footer: {}
|
||||||
|
author: Edwin Joassart
|
||||||
|
nested: []
|
||||||
|
version: 1.18.5
|
||||||
|
title: ""
|
||||||
|
date: 2023-03-09T11:30:34.540Z
|
||||||
|
- commits:
|
||||||
|
- subject: "patch: bump etcher-sdk to 8.3.1"
|
||||||
|
hash: bf0360e7f46ac620f95021e0c48a3a04d302e725
|
||||||
|
body: ""
|
||||||
|
footer: {}
|
||||||
|
author: JOASSART Edwin
|
||||||
|
nested: []
|
||||||
|
version: 1.18.4
|
||||||
|
title: ""
|
||||||
|
date: 2023-03-02T17:31:31.788Z
|
||||||
|
- commits:
|
||||||
|
- subject: fix-typo
|
||||||
|
hash: 496f131c4b024dfcd17fde5173016f70c0d0599c
|
||||||
|
body: ""
|
||||||
|
footer:
|
||||||
|
Change-type: patch
|
||||||
|
change-type: patch
|
||||||
|
author: Lizzie Epton
|
||||||
|
nested: []
|
||||||
|
- subject: edits-to-info-about-efp
|
||||||
|
hash: f582b0215c2cf66acf652afdaa47353e1a7eac07
|
||||||
|
body: ""
|
||||||
|
footer:
|
||||||
|
Change-type: patch
|
||||||
|
change-type: patch
|
||||||
|
author: Lizzie Epton
|
||||||
|
nested: []
|
||||||
|
- subject: Add reference to etcher-efp in publishing.md
|
||||||
|
hash: 4c3c4babea5efdadbed7ba0df85f08b68a7b6f20
|
||||||
|
body: |
|
||||||
|
Add reference to etcher-efp in publishing.md
|
||||||
|
footer:
|
||||||
|
Change-type: patch
|
||||||
|
change-type: patch
|
||||||
|
author: Edwin Joassart
|
||||||
|
nested: []
|
||||||
|
version: 1.18.3
|
||||||
|
title: ""
|
||||||
|
date: 2023-02-22T12:12:40.270Z
|
||||||
|
- commits:
|
||||||
|
- subject: "patch: organize docs"
|
||||||
|
hash: e479b95d72bed6a50ae6a971598a18d8a7562f0d
|
||||||
|
body: ""
|
||||||
|
footer: {}
|
||||||
|
author: mcraa
|
||||||
|
nested: []
|
||||||
|
- subject: "patch: actualized develop guide"
|
||||||
|
hash: 926ff2b7549d8b187b18ee452ce48c62f6cd3531
|
||||||
|
body: ""
|
||||||
|
footer: {}
|
||||||
|
author: mcraa
|
||||||
|
nested: []
|
||||||
|
- subject: "patch: updated commit message guide"
|
||||||
|
hash: 394b64319de11b1010b8acfe160de13a6f3851cd
|
||||||
|
body: ""
|
||||||
|
footer: {}
|
||||||
|
author: mcraa
|
||||||
|
nested: []
|
||||||
|
- subject: add-item-from-FAQs
|
||||||
|
hash: 96fa53b6ee4ec7a29522df488b927074c0f301ca
|
||||||
|
body: ""
|
||||||
|
footer:
|
||||||
|
Change-type: patch
|
||||||
|
change-type: patch
|
||||||
|
author: Lizzie Epton
|
||||||
|
nested: []
|
||||||
|
- subject: "patch: removed gt characters from contributing guide"
|
||||||
|
hash: 9b54e2af0b9356bb73e197cccbcc2ff89673361f
|
||||||
|
body: ""
|
||||||
|
footer: {}
|
||||||
|
author: mcraa
|
||||||
|
nested: []
|
||||||
|
- subject: "patch: added docosaurus site name"
|
||||||
|
hash: b01cf3c2e1c3a7a234c8b957bd570ecdca81e0c1
|
||||||
|
body: ""
|
||||||
|
footer: {}
|
||||||
|
author: mcraa
|
||||||
|
nested: []
|
||||||
|
version: 1.18.2
|
||||||
|
title: ""
|
||||||
|
date: 2023-02-21T13:17:09.606Z
|
||||||
|
- commits:
|
||||||
|
- subject: "patch: use @electron/remote for locating rpiboot files"
|
||||||
|
hash: 04fa3dcd8c619dce927221cef5799b5210354d2e
|
||||||
|
body: ""
|
||||||
|
footer: {}
|
||||||
|
author: mcraa
|
||||||
|
nested: []
|
||||||
|
version: 1.18.1
|
||||||
|
title: ""
|
||||||
|
date: 2023-02-15T14:54:45.951Z
|
||||||
|
- commits:
|
||||||
|
- subject: Update to Electron 19
|
||||||
|
hash: c11db0a2797a6b1093dd3fa6f55bee5f100c6da4
|
||||||
|
body: ""
|
||||||
|
footer:
|
||||||
|
Change-type: minor
|
||||||
|
change-type: minor
|
||||||
|
author: Akis Kesoglou
|
||||||
|
nested: []
|
||||||
|
- subject: Remove Spectron and related (low-value) tests
|
||||||
|
hash: 6f7570d265e4b457afe832d00e5f45e0bf5a8a53
|
||||||
|
body: >
|
||||||
|
Spectron is long deprecated and abandoned and the browser tests are so
|
||||||
|
rudimentary that it’s no longer worth having them around. We will
|
||||||
|
introduce a proper browser-based test suite in the short term — it’s a
|
||||||
|
project in progress.
|
||||||
|
footer:
|
||||||
|
Change-type: minor
|
||||||
|
change-type: minor
|
||||||
|
author: Akis Kesoglou
|
||||||
|
nested: []
|
||||||
|
version: 1.18.0
|
||||||
|
title: ""
|
||||||
|
date: 2023-02-14T18:07:05.870Z
|
||||||
|
- commits:
|
||||||
|
- subject: Update to Electron 17 and Node 16
|
||||||
|
hash: 3c1dd6ce29ddf43ef35e58236d25713fa2026c10
|
||||||
|
body: |
|
||||||
|
This is the latest Electron version officially supported by Spectron.
|
||||||
|
footer:
|
||||||
|
Change-type: minor
|
||||||
|
change-type: minor
|
||||||
|
author: Akis Kesoglou
|
||||||
|
nested: []
|
||||||
|
version: 1.17.0
|
||||||
|
title: ""
|
||||||
|
date: 2023-02-14T16:18:54.834Z
|
||||||
|
- commits:
|
||||||
|
- subject: Update to Electron 14
|
||||||
|
hash: df7854111a901b620e3284edf10768d308ce7755
|
||||||
|
body: ""
|
||||||
|
footer:
|
||||||
|
Change-type: minor
|
||||||
|
change-type: minor
|
||||||
|
author: Akis Kesoglou
|
||||||
|
nested: []
|
||||||
|
version: 1.16.0
|
||||||
|
title: ""
|
||||||
|
date: 2023-02-14T12:40:40.820Z
|
||||||
|
- commits:
|
||||||
|
- subject: "patch: app: i18n: Translation: Update zh-TW strings * Improve
|
||||||
|
translate. * Sync layout with English strings ts file."
|
||||||
|
hash: b51418814f5ef48d09e3157c92bda5eab173dbd5
|
||||||
|
body: ""
|
||||||
|
footer:
|
||||||
|
Signed-off-by: Edward Wu <bluehome.wu@gmail.com>
|
||||||
|
signed-off-by: Edward Wu <bluehome.wu@gmail.com>
|
||||||
|
author: Edward Wu
|
||||||
|
nested: []
|
||||||
|
version: 1.15.6
|
||||||
|
title: ""
|
||||||
|
date: 2023-02-13T11:23:13.079Z
|
||||||
|
- commits:
|
||||||
|
- subject: revert auto-update feature
|
||||||
|
hash: e6d33eda2b8f767679a43f8056e20098b0f2f6d9
|
||||||
|
body: ""
|
||||||
|
footer:
|
||||||
|
Change-type: patch
|
||||||
|
change-type: patch
|
||||||
|
author: JOASSART Edwin
|
||||||
|
nested: []
|
||||||
|
version: 1.15.5
|
||||||
|
title: ""
|
||||||
|
date: 2023-02-03T14:25:19.611Z
|
||||||
- commits:
|
- commits:
|
||||||
- subject: Switch to `@electron/remote`
|
- subject: Switch to `@electron/remote`
|
||||||
hash: 7ee174edcecbfc2d7370db6d4185b3ee4eedbe28
|
hash: 7ee174edcecbfc2d7370db6d4185b3ee4eedbe28
|
||||||
|
|||||||
63
CHANGELOG.md
63
CHANGELOG.md
@@ -3,6 +3,69 @@
|
|||||||
All notable changes to this project will be documented in this file.
|
All notable changes to this project will be documented in this file.
|
||||||
This project adheres to [Semantic Versioning](http://semver.org/).
|
This project adheres to [Semantic Versioning](http://semver.org/).
|
||||||
|
|
||||||
|
# v1.18.6
|
||||||
|
## (2023-03-21)
|
||||||
|
|
||||||
|
* add-flash-with-etcher-to-docs [Lizzie Epton]
|
||||||
|
|
||||||
|
# v1.18.5
|
||||||
|
## (2023-03-09)
|
||||||
|
|
||||||
|
* patch: add apt-get update in flowzone preinstall [Edwin Joassart]
|
||||||
|
|
||||||
|
# v1.18.4
|
||||||
|
## (2023-03-02)
|
||||||
|
|
||||||
|
* patch: bump etcher-sdk to 8.3.1 [JOASSART Edwin]
|
||||||
|
|
||||||
|
# v1.18.3
|
||||||
|
## (2023-02-22)
|
||||||
|
|
||||||
|
* fix-typo [Lizzie Epton]
|
||||||
|
* edits-to-info-about-efp [Lizzie Epton]
|
||||||
|
* Add reference to etcher-efp in publishing.md [Edwin Joassart]
|
||||||
|
|
||||||
|
# v1.18.2
|
||||||
|
## (2023-02-21)
|
||||||
|
|
||||||
|
* patch: organize docs [mcraa]
|
||||||
|
* patch: actualized develop guide [mcraa]
|
||||||
|
* patch: updated commit message guide [mcraa]
|
||||||
|
* add-item-from-FAQs [Lizzie Epton]
|
||||||
|
* patch: removed gt characters from contributing guide [mcraa]
|
||||||
|
* patch: added docosaurus site name [mcraa]
|
||||||
|
|
||||||
|
# v1.18.1
|
||||||
|
## (2023-02-15)
|
||||||
|
|
||||||
|
* patch: use @electron/remote for locating rpiboot files [mcraa]
|
||||||
|
|
||||||
|
# v1.18.0
|
||||||
|
## (2023-02-14)
|
||||||
|
|
||||||
|
* Update to Electron 19 [Akis Kesoglou]
|
||||||
|
* Remove Spectron and related (low-value) tests [Akis Kesoglou]
|
||||||
|
|
||||||
|
# v1.17.0
|
||||||
|
## (2023-02-14)
|
||||||
|
|
||||||
|
* Update to Electron 17 and Node 16 [Akis Kesoglou]
|
||||||
|
|
||||||
|
# v1.16.0
|
||||||
|
## (2023-02-14)
|
||||||
|
|
||||||
|
* Update to Electron 14 [Akis Kesoglou]
|
||||||
|
|
||||||
|
# v1.15.6
|
||||||
|
## (2023-02-13)
|
||||||
|
|
||||||
|
* patch: app: i18n: Translation: Update zh-TW strings * Improve translate. * Sync layout with English strings ts file. [Edward Wu]
|
||||||
|
|
||||||
|
# v1.15.5
|
||||||
|
## (2023-02-03)
|
||||||
|
|
||||||
|
* revert auto-update feature [JOASSART Edwin]
|
||||||
|
|
||||||
# v1.15.4
|
# v1.15.4
|
||||||
## (2023-02-02)
|
## (2023-02-02)
|
||||||
|
|
||||||
|
|||||||
19
README.md
19
README.md
@@ -53,9 +53,10 @@ confidence.
|
|||||||
2. Update and install:
|
2. Update and install:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
sudo apt-get update
|
sudo apt-get update #you can use apt instead of apt-get as well
|
||||||
sudo apt-get install balena-etcher-electron
|
sudo apt-get install balena-etcher-electron
|
||||||
```
|
```
|
||||||
|
>Note: after v1.7.9 the package name changed to `balena-etcher` (no electron at the end)
|
||||||
|
|
||||||
##### Uninstall
|
##### Uninstall
|
||||||
|
|
||||||
@@ -87,6 +88,7 @@ apt-get update
|
|||||||
```sh
|
```sh
|
||||||
sudo dnf install -y balena-etcher-electron
|
sudo dnf install -y balena-etcher-electron
|
||||||
```
|
```
|
||||||
|
>Note: after v1.7.9 the package name changed to `balena-etcher` (no electron at the end)
|
||||||
|
|
||||||
###### Uninstall
|
###### Uninstall
|
||||||
|
|
||||||
@@ -110,6 +112,7 @@ rm /etc/yum.repos.d/balena-etcher-source.repo
|
|||||||
```sh
|
```sh
|
||||||
sudo yum install -y balena-etcher-electron
|
sudo yum install -y balena-etcher-electron
|
||||||
```
|
```
|
||||||
|
>Note: after v1.7.9 the package name changed to `balena-etcher` (no electron at the end)
|
||||||
|
|
||||||
###### Uninstall
|
###### Uninstall
|
||||||
|
|
||||||
@@ -134,6 +137,7 @@ rm /etc/yum.repos.d/balena-etcher-source.repo
|
|||||||
sudo zypper up
|
sudo zypper up
|
||||||
sudo zypper install balena-etcher-electron
|
sudo zypper install balena-etcher-electron
|
||||||
```
|
```
|
||||||
|
>Note: after v1.7.9 the package name changed to `balena-etcher` (no electron at the end)
|
||||||
|
|
||||||
##### Uninstall
|
##### Uninstall
|
||||||
|
|
||||||
@@ -169,6 +173,19 @@ yay -S balena-etcher
|
|||||||
```sh
|
```sh
|
||||||
yay -R balena-etcher
|
yay -R balena-etcher
|
||||||
```
|
```
|
||||||
|
#### WinGet (Windows)
|
||||||
|
|
||||||
|
This package is updated by [gh-action](https://github.com/vedantmgoyal2009/winget-releaser), and is kept up to date automatically.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
winget install balenaEtcher #or Balena.Etcher
|
||||||
|
```
|
||||||
|
|
||||||
|
##### Uninstall
|
||||||
|
|
||||||
|
```sh
|
||||||
|
winget uninstall balenaEtcher
|
||||||
|
```
|
||||||
|
|
||||||
#### Chocolatey (Windows)
|
#### Chocolatey (Windows)
|
||||||
|
|
||||||
|
|||||||
74
afterPack.js
74
afterPack.js
@@ -1,20 +1,23 @@
|
|||||||
'use strict'
|
"use strict";
|
||||||
|
|
||||||
const cp = require('child_process')
|
const cp = require("child_process");
|
||||||
const fs = require('fs')
|
const fs = require("fs");
|
||||||
const outdent = require('outdent')
|
const outdent = require("outdent");
|
||||||
const path = require('path')
|
const path = require("path");
|
||||||
|
const builder = require("electron-builder");
|
||||||
|
const { flipFuses, FuseVersion, FuseV1Options } = require("@electron/fuses");
|
||||||
|
|
||||||
exports.default = function(context) {
|
exports.default = async function (context) {
|
||||||
if (context.packager.platform.name !== 'linux') {
|
if (context.packager.platform.name === "linux") {
|
||||||
return
|
const scriptPath = path.join(
|
||||||
}
|
context.appOutDir,
|
||||||
const scriptPath = path.join(context.appOutDir, context.packager.executableName)
|
context.packager.executableName
|
||||||
const binPath = scriptPath + '.bin'
|
);
|
||||||
cp.execFileSync('mv', [scriptPath, binPath])
|
const binPath = scriptPath + ".bin";
|
||||||
fs.writeFileSync(
|
cp.execFileSync("mv", [scriptPath, binPath]);
|
||||||
scriptPath,
|
fs.writeFileSync(
|
||||||
outdent({trimTrailingNewline: false})`
|
scriptPath,
|
||||||
|
outdent({ trimTrailingNewline: false })`
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
# Resolve symlinks. Warning, readlink -f doesn't work on MacOS/BSD
|
# Resolve symlinks. Warning, readlink -f doesn't work on MacOS/BSD
|
||||||
@@ -26,6 +29,41 @@ exports.default = function(context) {
|
|||||||
"\${script_dir}"/${context.packager.executableName}.bin "$@" --no-sandbox
|
"\${script_dir}"/${context.packager.executableName}.bin "$@" --no-sandbox
|
||||||
fi
|
fi
|
||||||
`
|
`
|
||||||
)
|
);
|
||||||
cp.execFileSync('chmod', ['+x', scriptPath])
|
cp.execFileSync("chmod", ["+x", scriptPath]);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Adapted from https://github.com/electron-userland/electron-builder/issues/6365#issue-1033809141
|
||||||
|
const ext = {
|
||||||
|
darwin: ".app",
|
||||||
|
win32: ".exe",
|
||||||
|
linux: ".bin",
|
||||||
|
}[context.electronPlatformName];
|
||||||
|
|
||||||
|
const IS_LINUX = context.electronPlatformName === "linux";
|
||||||
|
const executableName = IS_LINUX
|
||||||
|
? context.packager.appInfo.productFilename.toLowerCase().replace("-dev", "")
|
||||||
|
: context.packager.appInfo.productFilename; // .toLowerCase() to accomodate Linux file named `name` but productFileName is `Name` -- Replaces '-dev' because on Linux the executable name is `name` even for the DEV builds
|
||||||
|
|
||||||
|
const IS_APPLE_SILICON =
|
||||||
|
context.electronPlatformName === "darwin" &&
|
||||||
|
context.arch === builder.Arch.arm64;
|
||||||
|
|
||||||
|
const electronBinaryPath = path.join(
|
||||||
|
context.appOutDir,
|
||||||
|
`${executableName}${ext}`
|
||||||
|
);
|
||||||
|
|
||||||
|
console.log(electronBinaryPath);
|
||||||
|
|
||||||
|
await flipFuses(electronBinaryPath, {
|
||||||
|
version: FuseVersion.V1,
|
||||||
|
resetAdHocDarwinSignature: IS_APPLE_SILICON, // necessary for building on Apple Silicon
|
||||||
|
[FuseV1Options.RunAsNode]: false,
|
||||||
|
[FuseV1Options.EnableCookieEncryption]: true,
|
||||||
|
[FuseV1Options.EnableNodeOptionsEnvironmentVariable]: false,
|
||||||
|
[FuseV1Options.EnableNodeCliInspectArguments]: false,
|
||||||
|
// [FuseV1Options.EnableEmbeddedAsarIntegrityValidation]: true, // Only affects macOS builds, but breaks them -- https://github.com/electron/fuses/issues/7
|
||||||
|
[FuseV1Options.OnlyLoadAppFromAsar]: false,
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|||||||
@@ -12,67 +12,29 @@ over the commit history.
|
|||||||
- Be able to automatically reference relevant changes from a dependency
|
- Be able to automatically reference relevant changes from a dependency
|
||||||
upgrade.
|
upgrade.
|
||||||
|
|
||||||
The guidelines are inspired by the [AngularJS git commit
|
|
||||||
guidelines][angular-commit-guidelines].
|
|
||||||
|
|
||||||
Commit structure
|
Commit structure
|
||||||
----------------
|
----------------
|
||||||
|
|
||||||
Each commit message consists of a header, a body and a footer. The header has a
|
Each commit message needs to specify the semver-type. Which can be `patch|minor|major`.
|
||||||
special format that includes a type, a scope and a subject.
|
See the [Semantic Versioning][semver] specification for a more detailed explanation of the meaning of these types.
|
||||||
|
See balena commit guidelines for more info about the whole commit structure.
|
||||||
|
|
||||||
```
|
```
|
||||||
<type>(<scope>): <subject>
|
<semver-type>: <subject>
|
||||||
|
```
|
||||||
|
or
|
||||||
|
```
|
||||||
|
<subject>
|
||||||
<BLANK LINE>
|
<BLANK LINE>
|
||||||
<body>
|
<details>
|
||||||
<BLANK LINE>
|
<BLANK LINE>
|
||||||
<footer>
|
Change-Type: <semver-type>
|
||||||
```
|
```
|
||||||
|
|
||||||
The subject should not contain more than 70 characters, including the type and
|
The subject should not contain more than 70 characters, including the type and
|
||||||
scope, and the body should be wrapped at 72 characters.
|
scope, and the body should be wrapped at 72 characters.
|
||||||
|
|
||||||
Type
|
|
||||||
----
|
|
||||||
|
|
||||||
Must be one of the following:
|
|
||||||
|
|
||||||
- `feat`: A new feature.
|
|
||||||
- `fix`: A bug fix.
|
|
||||||
- `minifix`: A minimal fix that doesn't warrant an entry in the CHANGELOG.
|
|
||||||
- `docs`: Documentation only changes.
|
|
||||||
- `style`: Changes that do not affect the meaning of the code (white-space,
|
|
||||||
formatting, missing semi-colons, JSDoc annotations, comments, etc).
|
|
||||||
- `refactor`: A code change that neither fixes a bug nor adds a feature.
|
|
||||||
- `perf`: A code change that improves performance.
|
|
||||||
- `test`: Adding missing tests.
|
|
||||||
- `chore`: Changes to the build process or auxiliary tools and libraries.
|
|
||||||
- `upgrade`: A version upgrade of a project dependency.
|
|
||||||
|
|
||||||
Scope
|
|
||||||
-----
|
|
||||||
|
|
||||||
The scope is required for types that make sense, such as `feat`, `fix`,
|
|
||||||
`test`, etc. Certain commit types, such as `chore` might not have a clearly
|
|
||||||
defined scope, in which case its better to omit it.
|
|
||||||
|
|
||||||
Subject
|
|
||||||
-------
|
|
||||||
|
|
||||||
The subject should contain a short description of the change:
|
|
||||||
|
|
||||||
- Use the imperative, present tense.
|
|
||||||
- Don't capitalize the first letter.
|
|
||||||
- No dot (.) at the end.
|
|
||||||
|
|
||||||
Footer
|
|
||||||
------
|
|
||||||
|
|
||||||
The footer contains extra information about the commit, such as tags.
|
|
||||||
|
|
||||||
**Breaking Changes** should start with the word BREAKING CHANGE: with a space
|
|
||||||
or two newlines. The rest of the commit message is then used for this.
|
|
||||||
|
|
||||||
Tags
|
Tags
|
||||||
----
|
----
|
||||||
|
|
||||||
@@ -121,125 +83,4 @@ Closes: https://github.com/balena-io/etcher/issues/XXX
|
|||||||
Fixes: https://github.com/balena-io/etcher/issues/XXX
|
Fixes: https://github.com/balena-io/etcher/issues/XXX
|
||||||
```
|
```
|
||||||
|
|
||||||
### `Change-Type: <type>`
|
|
||||||
|
|
||||||
This tag is used to determine the change type that a commit introduces. The
|
|
||||||
following types are supported:
|
|
||||||
|
|
||||||
- `major`
|
|
||||||
- `minor`
|
|
||||||
- `patch`
|
|
||||||
|
|
||||||
This tag can be omitted for commits that don't change the application from the
|
|
||||||
user's point of view, such as for refactoring commits.
|
|
||||||
|
|
||||||
Examples:
|
|
||||||
|
|
||||||
```
|
|
||||||
Change-Type: major
|
|
||||||
Change-Type: minor
|
|
||||||
Change-Type: patch
|
|
||||||
```
|
|
||||||
|
|
||||||
See the [Semantic Versioning][semver] specification for a more detailed
|
|
||||||
explanation of the meaning of these types.
|
|
||||||
|
|
||||||
### `Changelog-Entry: <message>`
|
|
||||||
|
|
||||||
This tag is used to describe the changes introduced by the commit in a more
|
|
||||||
human style that would fit the `CHANGELOG.md` better.
|
|
||||||
|
|
||||||
If the commit type is either `fix` or `feat`, the commit will take part in the
|
|
||||||
CHANGELOG. If this tag is not defined, then the commit subject will be used
|
|
||||||
instead.
|
|
||||||
|
|
||||||
You explicitly can use this tag to make a commit whose type is not `fix` nor
|
|
||||||
`feat` appear in the `CHANGELOG.md`.
|
|
||||||
|
|
||||||
Since whatever your write here will be shown *as it is* in the `CHANGELOG.md`,
|
|
||||||
take some time to write a decent entry. Consider the following guidelines:
|
|
||||||
|
|
||||||
- Use the imperative, present tense.
|
|
||||||
- Capitalize the first letter.
|
|
||||||
|
|
||||||
There is no fixed length limit for the contents of this tag, but always strive
|
|
||||||
to make as short as possible without compromising its quality.
|
|
||||||
|
|
||||||
Examples:
|
|
||||||
|
|
||||||
```
|
|
||||||
Changelog-Entry: Fix EPERM errors when flashing to a GPT drive.
|
|
||||||
```
|
|
||||||
|
|
||||||
Complete examples
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
```
|
|
||||||
fix(GUI): ignore extensions before the first non-compressed extension
|
|
||||||
|
|
||||||
Currently, we extract all the extensions from an image path and report back
|
|
||||||
that the image is invalid if *any* of the extensions is not valid , however
|
|
||||||
this can cause trouble with images including information between dots that are
|
|
||||||
not strictly extensions, for example:
|
|
||||||
|
|
||||||
elementaryos-0.3.2-stable-i386.20151209.iso
|
|
||||||
|
|
||||||
Etcher will consider `20151209` to be an invalid extension and therefore
|
|
||||||
will prevent such image from being selected at all.
|
|
||||||
|
|
||||||
As a way to allow these corner cases but still make use of our enforced check
|
|
||||||
controls, the validation routine now only consider extensions starting from the
|
|
||||||
first non compressed extension.
|
|
||||||
|
|
||||||
Change-Type: patch
|
|
||||||
Changelog-Entry: Don't interpret image file name information between dots as image extensions.
|
|
||||||
Fixes: https://github.com/balena-io/etcher/issues/492
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
```
|
|
||||||
upgrade: etcher-image-write to v5.0.2
|
|
||||||
|
|
||||||
This version contains a fix to an `EPERM` issue happening to some Windows user,
|
|
||||||
triggered by the `write` system call during the first ~5% of a flash given that
|
|
||||||
the operating system still thinks the drive has a file system.
|
|
||||||
|
|
||||||
Change-Type: patch
|
|
||||||
Changelog-Entry: Upgrade `etcher-image-write` to v5.0.2.
|
|
||||||
Link: https://github.com/balena-io-modules/etcher-image-write/blob/master/CHANGELOG.md#502---2016-06-27
|
|
||||||
Fixes: https://github.com/balena-io/etcher/issues/531
|
|
||||||
```
|
|
||||||
|
|
||||||
***
|
|
||||||
|
|
||||||
```
|
|
||||||
feat(GUI): implement update notifier functionality
|
|
||||||
|
|
||||||
Auto-update functionality is not ready for usage. As a workaround to
|
|
||||||
prevent users staying with older versions, we now check for updates at
|
|
||||||
startup, and if the user is not running the latest version, we present a
|
|
||||||
modal informing the user of the availiblity of a new version, and
|
|
||||||
provide a call to action to open the Etcher website in his web browser.
|
|
||||||
|
|
||||||
Extra features:
|
|
||||||
|
|
||||||
- The user can skip the update, and tell the program to delay the
|
|
||||||
notification for 7 days.
|
|
||||||
|
|
||||||
Misc changes:
|
|
||||||
|
|
||||||
- Center modal with flexbox, to allow more flexibility on the modal height.
|
|
||||||
interacting with the S3 server.
|
|
||||||
- Implement `ManifestBindService`, which now serves as a backend for the
|
|
||||||
`manifest-bind` directive to allow the directive's functionality to be
|
|
||||||
re-used by other services.
|
|
||||||
- Namespace checkbox styles that are specific to the settings page.
|
|
||||||
|
|
||||||
Change-Type: minor
|
|
||||||
Changelog-Entry: Check for updates and show a modal prompting the user to download the latest version.
|
|
||||||
Closes: https://github.com/balena-io/etcher/issues/396
|
|
||||||
```
|
|
||||||
|
|
||||||
[angular-commit-guidelines]: https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md#commit
|
|
||||||
[semver]: http://semver.org
|
[semver]: http://semver.org
|
||||||
|
|||||||
@@ -17,11 +17,11 @@ Developing
|
|||||||
|
|
||||||
#### Common
|
#### Common
|
||||||
|
|
||||||
- [NodeJS](https://nodejs.org) (at least v6.11)
|
- [NodeJS](https://nodejs.org) (at least v16.11)
|
||||||
- [Python 2.7](https://www.python.org)
|
- [Python 3](https://www.python.org)
|
||||||
- [jq](https://stedolan.github.io/jq/)
|
- [jq](https://stedolan.github.io/jq/)
|
||||||
- [curl](https://curl.haxx.se/)
|
- [curl](https://curl.haxx.se/)
|
||||||
- [npm](https://www.npmjs.com/) (version 6.7)
|
- [npm](https://www.npmjs.com/)
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
pip install -r requirements.txt
|
pip install -r requirements.txt
|
||||||
@@ -33,16 +33,16 @@ You might need to run this with `sudo` or administrator permissions.
|
|||||||
|
|
||||||
- [NSIS v2.51](http://nsis.sourceforge.net/Main_Page) (v3.x won't work)
|
- [NSIS v2.51](http://nsis.sourceforge.net/Main_Page) (v3.x won't work)
|
||||||
- Either one of the following:
|
- Either one of the following:
|
||||||
- [Visual C++ 2015 Build Tools](http://landinghub.visualstudio.com/visual-cpp-build-tools) containing standalone compilers, libraries and scripts
|
- [Visual C++ 2019 Build Tools](https://visualstudio.microsoft.com/vs/features/cplusplus/) containing standalone compilers, libraries and scripts
|
||||||
- Install the [windows-build-tools](https://github.com/felixrieseberg/windows-build-tools) via npm with `npm install --global windows-build-tools`
|
- The [windows-build-tools](https://github.com/felixrieseberg/windows-build-tools#windows-build-tools) should be installed along with NodeJS
|
||||||
- [Visual Studio Community 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48146) (free) (other editions, like Professional and Enterprise, should work too)
|
- [Visual Studio Community 2019](https://visualstudio.microsoft.com/vs/) (free) (other editions, like Professional and Enterprise, should work too)
|
||||||
**NOTE:** Visual Studio 2015 doesn't install C++ by default. You have to rerun the
|
**NOTE:** Visual Studio doesn't install C++ by default. You have to rerun the
|
||||||
setup, select "Modify" and then check `Visual C++ -> Common Tools for Visual
|
setup, select "Modify" and then check `Visual C++ -> Common Tools for Visual
|
||||||
C++ 2015` (see http://stackoverflow.com/a/31955339)
|
C++` (see http://stackoverflow.com/a/31955339)
|
||||||
- [MinGW](http://www.mingw.org)
|
- [MinGW](http://www.mingw.org)
|
||||||
|
|
||||||
You might need to `npm config set msvs_version 2015` for node-gyp to correctly detect
|
You might need to `npm config set msvs_version 2019` for node-gyp to correctly detect
|
||||||
the version of Visual Studio you're using (in this example VS2015).
|
the version of Visual Studio you're using (in this example VS2019).
|
||||||
|
|
||||||
The following MinGW packages are required:
|
The following MinGW packages are required:
|
||||||
|
|
||||||
@@ -61,7 +61,7 @@ as well.
|
|||||||
|
|
||||||
#### Linux
|
#### Linux
|
||||||
|
|
||||||
- `libudev-dev` for libusb (install with `sudo apt install libudev-dev` for example)
|
- `libudev-dev` for libusb (for example install with `sudo apt install libudev-dev`, or on fedora `systemd-devel` contains the required package)
|
||||||
|
|
||||||
### Cloning the project
|
### Cloning the project
|
||||||
|
|
||||||
@@ -70,28 +70,13 @@ git clone --recursive https://github.com/balena-io/etcher
|
|||||||
cd etcher
|
cd etcher
|
||||||
```
|
```
|
||||||
|
|
||||||
### Installing npm dependencies
|
|
||||||
|
|
||||||
**NOTE:** Please make use of the following command to install npm dependencies rather
|
|
||||||
than simply running `npm install` given that we need to do extra configuration
|
|
||||||
to make sure native dependencies are correctly compiled for Electron, otherwise
|
|
||||||
the application might not run successfully.
|
|
||||||
|
|
||||||
If you're on Windows, **run the command from the _Developer Command Prompt for
|
|
||||||
VS2015_**, to ensure all Visual Studio command utilities are available in the
|
|
||||||
`%PATH%`.
|
|
||||||
|
|
||||||
```sh
|
|
||||||
make electron-develop
|
|
||||||
```
|
|
||||||
|
|
||||||
### Running the application
|
### Running the application
|
||||||
|
|
||||||
#### GUI
|
#### GUI
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# Build the GUI
|
# Build the GUI
|
||||||
npm run webpack
|
npm run webpack #or npm run build
|
||||||
# Start Electron
|
# Start Electron
|
||||||
npm start
|
npm start
|
||||||
```
|
```
|
||||||
@@ -119,10 +104,6 @@ systems as they can before sending a pull request.
|
|||||||
*The test suite is run automatically by CI servers when you send a pull
|
*The test suite is run automatically by CI servers when you send a pull
|
||||||
request.*
|
request.*
|
||||||
|
|
||||||
We also rely on various `make` targets to perform some common tasks:
|
|
||||||
|
|
||||||
- `make lint`: Run the linter.
|
|
||||||
- `make sass`: Compile SCSS files.
|
|
||||||
|
|
||||||
We make use of [EditorConfig] to communicate indentation, line endings and
|
We make use of [EditorConfig] to communicate indentation, line endings and
|
||||||
other text editing default. We encourage you to install the relevant plugin in
|
other text editing default. We encourage you to install the relevant plugin in
|
||||||
@@ -132,20 +113,7 @@ process.
|
|||||||
Updating a dependency
|
Updating a dependency
|
||||||
---------------------
|
---------------------
|
||||||
|
|
||||||
Given we use [npm shrinkwrap][shrinkwrap], we have to take extra steps to make
|
- Commit *both* `package.json` and `package-lock.json`.
|
||||||
sure the `npm-shrinkwrap.json` file gets updated correctly when we update a
|
|
||||||
dependency.
|
|
||||||
|
|
||||||
Use the following steps to ensure everything goes flawlessly:
|
|
||||||
|
|
||||||
- Run `make electron-develop` to ensure you don't have extraneous dependencies
|
|
||||||
you might have brought during development, or you are running older
|
|
||||||
dependencies because you come from another branch or reference.
|
|
||||||
|
|
||||||
- Install the new version of the dependency. For example: `npm install --save
|
|
||||||
<package>@<version>`. This will update the `npm-shrinkwrap.json` file.
|
|
||||||
|
|
||||||
- Commit *both* `package.json` and `npm-shrinkwrap.json`.
|
|
||||||
|
|
||||||
Diffing Binaries
|
Diffing Binaries
|
||||||
----------------
|
----------------
|
||||||
|
|||||||
@@ -44,3 +44,9 @@ Etcher requires an available [polkit authentication agent](https://wiki.archlinu
|
|||||||
## May I run Etcher in older macOS versions?
|
## May I run Etcher in older macOS versions?
|
||||||
|
|
||||||
Etcher GUI is based on the [Electron](http://electron.atom.io/) framework, [which only supports macOS 10.10 and newer versions](https://github.com/electron/electron/blob/master/docs/tutorial/support.md#supported-platforms).
|
Etcher GUI is based on the [Electron](http://electron.atom.io/) framework, [which only supports macOS 10.10 and newer versions](https://github.com/electron/electron/blob/master/docs/tutorial/support.md#supported-platforms).
|
||||||
|
|
||||||
|
## Can I use the Flash With Etcher button on my site?
|
||||||
|
|
||||||
|
You can use the Flash with Etcher button on your site or blog, if you have an OS that you want your users to be able to easily flash using Etcher, add the following code where you want to button to be:
|
||||||
|
|
||||||
|
`<a href="https://efp.balena.io/open-image-url?imageUrl=<your image URL>"><img src="http://balena.io/flash-with-etcher.png" /></a>`
|
||||||
@@ -8,10 +8,14 @@ Releasing
|
|||||||
|
|
||||||
### Release Types
|
### Release Types
|
||||||
|
|
||||||
- **snapshot** (default): A continues snapshot of current master, made by the CI services
|
- **draft**: A continues snapshot of current master, made by the CI services
|
||||||
- **production**: Full releases
|
- **pre-release** (default): A continues snapshot of current master, made by the CI services
|
||||||
|
- **release**: Full releases
|
||||||
|
|
||||||
|
Draft release is created from each PR, tagged with the branch name.
|
||||||
|
All merged PR will generate a new tag/version as a *pre-release*.
|
||||||
|
Mark the pre-release as final when it is necessary, then distribute the packages in alternative channels as necessary.
|
||||||
|
|
||||||
### Flight Plan
|
|
||||||
|
|
||||||
#### Preparation
|
#### Preparation
|
||||||
|
|
||||||
@@ -33,9 +37,8 @@ Releasing
|
|||||||
- [Update the website](https://github.com/balena-io/etcher-homepage)
|
- [Update the website](https://github.com/balena-io/etcher-homepage)
|
||||||
- Wait 2-3 hours for analytics (Sentry, Amplitude) to trickle in and check for elevated error rates, or regressions
|
- Wait 2-3 hours for analytics (Sentry, Amplitude) to trickle in and check for elevated error rates, or regressions
|
||||||
- If regressions arise; pull the release, and release a patched version, else:
|
- If regressions arise; pull the release, and release a patched version, else:
|
||||||
- [Upload deb & rpm packages to Bintray](#uploading-packages-to-bintray)
|
- [Upload deb & rpm packages to Cloudfront](#uploading-packages-to-cloudfront)
|
||||||
- [Upload build artifacts to Amazon S3](#uploading-binaries-to-amazon-s3)
|
- Post changelog with `#release-notes` tag on internal chat
|
||||||
- Post changelog with `#release-notes` tag on Flowdock
|
|
||||||
- If this release packs noteworthy major changes:
|
- If this release packs noteworthy major changes:
|
||||||
- Write a blog post about it, and / or
|
- Write a blog post about it, and / or
|
||||||
- Write about it to the Etcher mailing list
|
- Write about it to the Etcher mailing list
|
||||||
@@ -57,46 +60,16 @@ export ANALYTICS_AMPLITUDE_TOKEN="xxxxxx"
|
|||||||
|
|
||||||
**NOTE:** Make sure to adjust the path as necessary (here the Etcher repository has been cloned to `/home/$USER/code/etcher`)
|
**NOTE:** Make sure to adjust the path as necessary (here the Etcher repository has been cloned to `/home/$USER/code/etcher`)
|
||||||
|
|
||||||
```bash
|
|
||||||
./scripts/build/docker/run-command.sh -r x64 -s . -c "make distclean"
|
|
||||||
```
|
|
||||||
|
|
||||||
##### Generating artifacts
|
##### Generating artifacts
|
||||||
|
|
||||||
```bash
|
The artifacts are generated by the CI and published as draft-release or pre-release.
|
||||||
# x64
|
`electron-builder` is used to create the packaged application.
|
||||||
|
|
||||||
# Build Debian packages
|
|
||||||
./scripts/build/docker/run-command.sh -r x64 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-debian"
|
|
||||||
# Build RPM packages
|
|
||||||
./scripts/build/docker/run-command.sh -r x64 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-redhat"
|
|
||||||
# Build AppImages
|
|
||||||
./scripts/build/docker/run-command.sh -r x64 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-appimage"
|
|
||||||
|
|
||||||
# x86
|
|
||||||
|
|
||||||
# Build Debian packages
|
|
||||||
./scripts/build/docker/run-command.sh -r x86 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-debian"
|
|
||||||
# Build RPM packages
|
|
||||||
./scripts/build/docker/run-command.sh -r x86 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-redhat"
|
|
||||||
# Build AppImages
|
|
||||||
./scripts/build/docker/run-command.sh -r x86 -s . -c "make electron-develop && make RELEASE_TYPE=production electron-installer-appimage"
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Mac OS
|
#### Mac OS
|
||||||
|
|
||||||
**ATTENTION:** For production releases you'll need the code-signing key,
|
**ATTENTION:** For production releases you'll need the code-signing key,
|
||||||
and set `CSC_NAME` to generate signed binaries on Mac OS.
|
and set `CSC_NAME` to generate signed binaries on Mac OS.
|
||||||
|
|
||||||
```bash
|
|
||||||
make electron-develop
|
|
||||||
|
|
||||||
# Build the zip
|
|
||||||
make RELEASE_TYPE=production electron-installer-app-zip
|
|
||||||
# Build the dmg
|
|
||||||
make RELEASE_TYPE=production electron-installer-dmg
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Windows
|
#### Windows
|
||||||
|
|
||||||
**ATTENTION:** For production releases you'll need the code-signing key,
|
**ATTENTION:** For production releases you'll need the code-signing key,
|
||||||
@@ -105,38 +78,10 @@ and set `CSC_LINK`, and `CSC_KEY_PASSWORD` to generate signed binaries on Window
|
|||||||
**NOTE:**
|
**NOTE:**
|
||||||
- Keep in mind to also generate artifacts for x86, with `TARGET_ARCH=x86`.
|
- Keep in mind to also generate artifacts for x86, with `TARGET_ARCH=x86`.
|
||||||
|
|
||||||
```bash
|
|
||||||
make electron-develop
|
|
||||||
|
|
||||||
# Build the Portable version
|
### Uploading packages to Cloudfront
|
||||||
make RELEASE_TYPE=production electron-installer-portable
|
|
||||||
# Build the Installer
|
|
||||||
make RELEASE_TYPE=production electron-installer-nsis
|
|
||||||
```
|
|
||||||
|
|
||||||
### Uploading packages to Bintray
|
Log in to cloudfront and upload the `rpm` and `deb` files.
|
||||||
|
|
||||||
```bash
|
|
||||||
export BINTRAY_USER="username@account"
|
|
||||||
export BINTRAY_API_KEY="youruserapikey"
|
|
||||||
```
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./scripts/publish/bintray.sh -c "etcher" -t "production" -v "1.2.1" -o "etcher" -p "debian" -y "debian" -r "x64" -f "dist/etcher-electron_1.2.1_amd64.deb"
|
|
||||||
./scripts/publish/bintray.sh -c "etcher" -t "production" -v "1.2.1" -o "etcher" -p "debian" -y "debian" -r "x86" -f "dist/etcher-electron_1.2.1_i386.deb"
|
|
||||||
./scripts/publish/bintray.sh -c "etcher" -t "production" -v "1.2.1" -o "etcher" -p "redhat" -y "redhat" -r "x64" -f "dist/etcher-electron-1.2.1.x86_64.rpm"
|
|
||||||
./scripts/publish/bintray.sh -c "etcher" -t "production" -v "1.2.1" -o "etcher" -p "redhat" -y "redhat" -r "x86" -f "dist/etcher-electron-1.2.1.i686.rpm"
|
|
||||||
```
|
|
||||||
|
|
||||||
### Uploading binaries to Amazon S3
|
|
||||||
|
|
||||||
```bash
|
|
||||||
export S3_KEY="..."
|
|
||||||
```
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./scripts/publish/aws-s3.sh -b "balena-production-downloads" -v "1.2.1" -p "etcher" -f "dist/<filename>"
|
|
||||||
```
|
|
||||||
|
|
||||||
### Dealing with a Problematic Release
|
### Dealing with a Problematic Release
|
||||||
|
|
||||||
|
|||||||
@@ -7,44 +7,9 @@ systems.
|
|||||||
Release Types
|
Release Types
|
||||||
-------------
|
-------------
|
||||||
|
|
||||||
Etcher supports **production** and **snapshot** release types. Each is
|
Etcher supports **pre-release** and **final** release types as does Github. Each is
|
||||||
published to a different S3 bucket, and production release types are code
|
published to Github releases.
|
||||||
signed, while snapshot release types aren't and include a short git commit-hash
|
The release version is generated automatically from the commit messasges.
|
||||||
as a build number. For example, `1.0.0-beta.19` is a production release type,
|
|
||||||
while `1.0.0-beta.19+531ab82` is a snapshot release type.
|
|
||||||
|
|
||||||
In terms of comparison: `1.0.0-beta.19` (production) < `1.0.0-beta.19+531ab82`
|
|
||||||
(snapshot) < `1.0.0-rc.1` (production) < `1.0.0-rc.1+7fde24a` (snapshot) <
|
|
||||||
`1.0.0` (production) < `1.0.0+2201e5f` (snapshot). Keep in mind that if you're
|
|
||||||
running a production release type, you'll only be prompted to update to
|
|
||||||
production release types, and if you're running a snapshot release type, you'll
|
|
||||||
only be prompted to update to other snapshot release types.
|
|
||||||
|
|
||||||
The build system creates (and publishes) snapshot release types by default, but
|
|
||||||
you can build a specific release type by setting the `RELEASE_TYPE` make
|
|
||||||
variable. For example:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
make <target> RELEASE_TYPE=snapshot
|
|
||||||
make <target> RELEASE_TYPE=production
|
|
||||||
```
|
|
||||||
|
|
||||||
We can control the version range a specific Etcher version will consider when
|
|
||||||
showing the update notification dialog by tweaking the `updates.semverRange`
|
|
||||||
property of `package.json`.
|
|
||||||
|
|
||||||
Update Channels
|
|
||||||
---------------
|
|
||||||
|
|
||||||
Etcher has a setting to include the unstable update channel. If this option is
|
|
||||||
set, Etcher will consider both stable and unstable versions when showing the
|
|
||||||
update notifier dialog. Unstable versions are the ones that contain a `beta`
|
|
||||||
pre-release tag. For example:
|
|
||||||
|
|
||||||
- Production unstable version: `1.4.0-beta.1`
|
|
||||||
- Snapshot unstable version: `1.4.0-beta.1+7fde24a`
|
|
||||||
- Production stable version: `1.4.0`
|
|
||||||
- Snapshot stable version: `1.4.0+7fde24a`
|
|
||||||
|
|
||||||
Signing
|
Signing
|
||||||
-------
|
-------
|
||||||
@@ -73,63 +38,19 @@ Packaging
|
|||||||
|
|
||||||
The resulting installers will be saved to `dist/out`.
|
The resulting installers will be saved to `dist/out`.
|
||||||
|
|
||||||
Run the following commands:
|
Run the following commands on all platforms with the right arguments:
|
||||||
|
|
||||||
### OS X
|
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
make electron-installer-dmg
|
./node_modules/electron-builder build <...>
|
||||||
make electron-installer-app-zip
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### GNU/Linux
|
|
||||||
|
|
||||||
```sh
|
Publishing to Cloudfront
|
||||||
make electron-installer-appimage
|
|
||||||
make electron-installer-debian
|
|
||||||
```
|
|
||||||
|
|
||||||
### Windows
|
|
||||||
|
|
||||||
```sh
|
|
||||||
make electron-installer-zip
|
|
||||||
make electron-installer-nsis
|
|
||||||
```
|
|
||||||
|
|
||||||
Publishing to Bintray
|
|
||||||
---------------------
|
---------------------
|
||||||
|
|
||||||
We publish GNU/Linux Debian packages to [Bintray][bintray].
|
We publish GNU/Linux Debian packages to [Cloudfront][cloudfront].
|
||||||
|
|
||||||
Make sure you set the following environment variables:
|
Log in to cloudfront and upload the `rpm` and `deb` files.
|
||||||
|
|
||||||
- `BINTRAY_USER`
|
|
||||||
- `BINTRAY_API_KEY`
|
|
||||||
|
|
||||||
Run the following command:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
make publish-bintray-debian
|
|
||||||
```
|
|
||||||
|
|
||||||
Publishing to S3
|
|
||||||
----------------
|
|
||||||
|
|
||||||
- [AWS CLI][aws-cli]
|
|
||||||
|
|
||||||
Make sure you have the [AWS CLI tool][aws-cli] installed and configured to
|
|
||||||
access balena.io's production or snapshot S3 bucket.
|
|
||||||
|
|
||||||
Run the following command to publish all files for the current combination of
|
|
||||||
_platform_ and _arch_ (building them if necessary):
|
|
||||||
|
|
||||||
```sh
|
|
||||||
make publish-aws-s3
|
|
||||||
```
|
|
||||||
|
|
||||||
Also add links to each AWS S3 file in [GitHub Releases][github-releases]. See
|
|
||||||
[`v1.0.0-beta.17`](https://github.com/balena-io/etcher/releases/tag/v1.0.0-beta.17)
|
|
||||||
as an example.
|
|
||||||
|
|
||||||
Publishing to Homebrew Cask
|
Publishing to Homebrew Cask
|
||||||
---------------------------
|
---------------------------
|
||||||
@@ -147,8 +68,12 @@ Post messages to the [Etcher forum][balena-forum-etcher] announcing the new vers
|
|||||||
of Etcher, and including the relevant section of the Changelog.
|
of Etcher, and including the relevant section of the Changelog.
|
||||||
|
|
||||||
[aws-cli]: https://aws.amazon.com/cli
|
[aws-cli]: https://aws.amazon.com/cli
|
||||||
[bintray]: https://bintray.com
|
[cloudfront]: https://cloudfront.com
|
||||||
[etcher-cask-file]: https://github.com/caskroom/homebrew-cask/blob/master/Casks/balenaetcher.rb
|
[etcher-cask-file]: https://github.com/caskroom/homebrew-cask/blob/master/Casks/balenaetcher.rb
|
||||||
[homebrew-cask]: https://github.com/caskroom/homebrew-cask
|
[homebrew-cask]: https://github.com/caskroom/homebrew-cask
|
||||||
[balena-forum-etcher]: https://forums.balena.io/c/etcher
|
[balena-forum-etcher]: https://forums.balena.io/c/etcher
|
||||||
[github-releases]: https://github.com/balena-io/etcher/releases
|
[github-releases]: https://github.com/balena-io/etcher/releases
|
||||||
|
|
||||||
|
Updating EFP / Success-Banner
|
||||||
|
-----------------------------
|
||||||
|
Etcher Featured Project is automatically run based on an algorithm which promoted projects from the balena marketplace which have been contributed by the community, the algorithm prioritises projects which give uses the best experience. Editing both EFP and the Etcher Success-Banner can only be done by someone from balena, instruction are on the [Etcher-EFP repo (private)](https://github.com/balena-io/etcher-efp)
|
||||||
|
|||||||
@@ -3,6 +3,11 @@ Etcher User Documentation
|
|||||||
|
|
||||||
This document contains how-tos and FAQs oriented to Etcher users.
|
This document contains how-tos and FAQs oriented to Etcher users.
|
||||||
|
|
||||||
|
Config
|
||||||
|
------
|
||||||
|
Etcher's configuration is saved to the `config.json` file in the apps folder.
|
||||||
|
Not all the options are surfaced to the UI. You may edit this file to tweak settings even before launching the app.
|
||||||
|
|
||||||
Why is my drive not bootable?
|
Why is my drive not bootable?
|
||||||
-----------------------------
|
-----------------------------
|
||||||
|
|
||||||
@@ -218,3 +223,5 @@ macOS 10.10 (Yosemite) and newer versions][electron-supported-platforms].
|
|||||||
[unetbootin]: https://unetbootin.github.io
|
[unetbootin]: https://unetbootin.github.io
|
||||||
[windows-iot-dashboard]: https://developer.microsoft.com/en-us/windows/iot/downloads
|
[windows-iot-dashboard]: https://developer.microsoft.com/en-us/windows/iot/downloads
|
||||||
[woeusb]: https://github.com/slacka/WoeUSB
|
[woeusb]: https://github.com/slacka/WoeUSB
|
||||||
|
|
||||||
|
See [PUBLISHING](/docs/PUBLISHING.md) for more details about release types.
|
||||||
@@ -187,8 +187,6 @@ export class SafeWebview extends React.PureComponent<
|
|||||||
const { webContents, ...webviewEvent } = event;
|
const { webContents, ...webviewEvent } = event;
|
||||||
analytics.logEvent('SafeWebview loaded', {
|
analytics.logEvent('SafeWebview loaded', {
|
||||||
...webviewEvent,
|
...webviewEvent,
|
||||||
screen_height: webContents?.hostWebContents.browserWindowOptions.height,
|
|
||||||
screen_width: webContents?.hostWebContents.browserWindowOptions.width,
|
|
||||||
});
|
});
|
||||||
this.setState({
|
this.setState({
|
||||||
shouldShow: event.statusCode === HTTP_OK,
|
shouldShow: event.statusCode === HTTP_OK,
|
||||||
|
|||||||
@@ -1,33 +1,33 @@
|
|||||||
const translation = {
|
const translation = {
|
||||||
translation: {
|
translation: {
|
||||||
|
continue: '繼續',
|
||||||
ok: '好',
|
ok: '好',
|
||||||
cancel: '取消',
|
cancel: '取消',
|
||||||
continue: '繼續',
|
|
||||||
skip: '跳過',
|
skip: '跳過',
|
||||||
sure: '我確定',
|
sure: '我確定',
|
||||||
warning: '請注意!',
|
warning: '請注意!',
|
||||||
attention: '請注意',
|
attention: '請注意',
|
||||||
failed: '失敗',
|
failed: '失敗',
|
||||||
completed: '完畢',
|
completed: '完成',
|
||||||
yesExit: '是的,可以退出',
|
|
||||||
reallyExit: '真的要現在退出 Etcher 嗎?',
|
|
||||||
yesContinue: '是的,繼續',
|
yesContinue: '是的,繼續',
|
||||||
|
reallyExit: '真的要現在結束 Etcher 嗎?',
|
||||||
|
yesExit: '是的,可以結束',
|
||||||
progress: {
|
progress: {
|
||||||
starting: '正在啓動……',
|
starting: '正在啟動……',
|
||||||
decompressing: '正在解壓……',
|
decompressing: '正在解壓縮……',
|
||||||
flashing: '正在燒錄……',
|
flashing: '正在燒錄……',
|
||||||
finishing: '正在結束……',
|
finishing: '正在結束……',
|
||||||
verifying: '正在驗證……',
|
verifying: '正在驗證……',
|
||||||
failing: '失敗……',
|
failing: '失敗……',
|
||||||
},
|
},
|
||||||
message: {
|
message: {
|
||||||
sizeNotRecommended: '大小不推薦',
|
sizeNotRecommended: '大小不建議',
|
||||||
tooSmall: '空間太小',
|
tooSmall: '空間太小',
|
||||||
locked: '被鎖定',
|
locked: '被鎖定',
|
||||||
system: '系統盤',
|
system: '系統',
|
||||||
containsImage: '存放源鏡像',
|
containsImage: '存放來源映像檔',
|
||||||
largeDrive: '很大的磁盤',
|
largeDrive: '很大的磁碟',
|
||||||
sourceLarger: '所選的鏡像比目標盤大了 {{byte}} 比特。',
|
sourceLarger: '所選的映像檔比目標磁碟大了 {{byte}} 位元組。',
|
||||||
flashSucceed_one: '燒錄成功',
|
flashSucceed_one: '燒錄成功',
|
||||||
flashSucceed_other: '燒錄成功',
|
flashSucceed_other: '燒錄成功',
|
||||||
flashFail_one: '燒錄失敗',
|
flashFail_one: '燒錄失敗',
|
||||||
@@ -39,87 +39,72 @@ const translation = {
|
|||||||
andFailTarget_other: '並燒錄失敗了 {{num}} 個目標',
|
andFailTarget_other: '並燒錄失敗了 {{num}} 個目標',
|
||||||
succeedTo: '{{name}} 被成功燒錄 {{target}}',
|
succeedTo: '{{name}} 被成功燒錄 {{target}}',
|
||||||
exitWhileFlashing:
|
exitWhileFlashing:
|
||||||
'您當前正在刷機。 關閉 Etcher 可能會導致您的磁盤無法使用。',
|
'您目前正在刷寫。關閉 Etcher 可能會導致您的磁碟無法使用。',
|
||||||
looksLikeWindowsImage:
|
looksLikeWindowsImage:
|
||||||
'看起來您正在嘗試刻錄 Windows 鏡像。\n\n與其他鏡像不同,Windows 鏡像需要特殊處理才能使其可啓動。 我們建議您使用專門爲此目的設計的工具,例如 <a href="https://rufus.akeo.ie">Rufus</a> (Windows)、<a href="https://github. com/slacka/WoeUSB">WoeUSB</a> (Linux) 或 Boot Camp 助理 (macOS)。',
|
'看起來您正在嘗試燒錄 Windows 映像檔。\n\n與其他映像檔不同,Windows 映像檔需要特殊處理才能使其可啟動。我們建議您使用專門為此目的設計的工具,例如 <a href="https://rufus.akeo.ie">Rufus</a> (Windows)、<a href="https://github. com/slacka/WoeUSB">WoeUSB</a> (Linux) 或 Boot Camp 助理 (macOS)。',
|
||||||
image: '鏡像',
|
image: '映像檔',
|
||||||
drive: '磁盤',
|
drive: '磁碟',
|
||||||
missingPartitionTable:
|
missingPartitionTable:
|
||||||
'看起來這不是一個可啓動的{{type}}。\n\n這個{{type}}似乎不包含分區表,因此您的設備可能無法識別或無法正確啓動。',
|
'看起來這不是一個可啟動的{{type}}。\n\n這個{{type}}似乎不包含分割表,因此您的設備可能無法識別或無法正確啟動。',
|
||||||
largeDriveSize: '這是個很大的磁盤!請檢查並確認它不包含對您很重要的信息',
|
largeDriveSize: '這是個很大容量的磁碟!請檢查並確認它不包含對您來說存放很重要的資料',
|
||||||
systemDrive: '選擇系統盤很危險,因爲這將會刪除你的系統',
|
systemDrive: '選擇系統分割區很危險,因為這將會刪除你的系統',
|
||||||
sourceDrive: '源鏡像位於這個分區中',
|
sourceDrive: '來源映像檔位於這個分割區中',
|
||||||
noSpace: '磁盤空間不足。 請插入另一個較大的磁盤並重試。',
|
noSpace: '磁碟空間不足。請插入另一個較大的磁碟並重試。',
|
||||||
genericFlashError:
|
genericFlashError:
|
||||||
'出了點問題。如果源鏡像曾被壓縮過,請檢查它是否已損壞。\n{{error}}',
|
'出了點問題。如果來源映像檔曾被壓縮過,請檢查它是否已損壞。\n{{error}}',
|
||||||
validation:
|
validation:
|
||||||
'寫入已成功完成,但 Etcher 在從磁盤讀取鏡像時檢測到潛在的損壞問題。 \n\n請考慮將鏡像寫入其他磁盤。',
|
'寫入已成功完成,但 Etcher 在從磁碟讀取映像檔時檢測到潛在的損壞問題。\n\n請考慮將映像檔寫入其他磁碟。',
|
||||||
openError: '打開 {{source}} 時出錯。\n\n錯誤信息: {{error}}',
|
openError: '打開 {{source}} 時發生錯誤。\n\n錯誤訊息: {{error}}',
|
||||||
flashError: '燒錄 {{image}} {{targets}} 失敗。',
|
flashError: '燒錄 {{image}} {{targets}} 失敗。',
|
||||||
unplug:
|
unplug:
|
||||||
'看起來 Etcher 失去了對磁盤的連接。 它是不是被意外拔掉了?\n\n有時這個錯誤是因爲讀卡器出了故障。',
|
'看起來 Etcher 失去了對磁碟的連接。是不是被意外拔掉了?\n\n有時這個錯誤是因為讀卡器出了故障。',
|
||||||
cannotWrite:
|
cannotWrite:
|
||||||
'看起來 Etcher 無法寫入磁盤的這個位置。 此錯誤通常是由故障的磁盤、讀取器或端口引起的。 \n\n請使用其他磁盤、讀卡器或端口重試。',
|
'看起來 Etcher 無法寫入磁碟的這個位置。此錯誤通常是由故障的磁碟、讀取器或連接埠引起的。\n\n請使用其他磁碟、讀卡器或連接埠重試。',
|
||||||
childWriterDied:
|
childWriterDied:
|
||||||
'寫入進程意外崩潰。請再試一次,如果問題仍然存在,請聯繫 Etcher 團隊。',
|
'寫入處理程序意外崩潰。請再試一次,如果問題仍然存在,請聯絡 Etcher 團隊。',
|
||||||
badProtocol: '僅支持 http:// 和 https:// 開頭的網址。',
|
badProtocol: '僅支援 http:// 和 https:// 開頭的網址。',
|
||||||
},
|
},
|
||||||
target: {
|
target: {
|
||||||
selectTarget: '選擇目標磁盤',
|
selectTarget: '選擇目標磁碟',
|
||||||
plugTarget: '請插入目標磁盤',
|
plugTarget: '請插入目標磁碟',
|
||||||
targets: '個目標',
|
targets: '個目標',
|
||||||
change: '更改',
|
change: '更改',
|
||||||
},
|
},
|
||||||
menu: {
|
|
||||||
edit: '編輯',
|
|
||||||
view: '視圖',
|
|
||||||
devTool: '打開開發者工具',
|
|
||||||
window: '窗口',
|
|
||||||
help: '幫助',
|
|
||||||
pro: 'Etcher 專業版',
|
|
||||||
website: 'Etcher 的官網',
|
|
||||||
issue: '提交一個 issue',
|
|
||||||
about: '關於 Etcher',
|
|
||||||
hide: '隱藏 Etcher',
|
|
||||||
hideOthers: '隱藏其它窗口',
|
|
||||||
unhide: '取消隱藏',
|
|
||||||
quit: '退出 Etcher',
|
|
||||||
},
|
|
||||||
source: {
|
source: {
|
||||||
useSourceURL: '使用鏡像網絡地址',
|
useSourceURL: '使用映像檔網址',
|
||||||
auth: '驗證',
|
auth: '驗證',
|
||||||
username: '輸入用戶名',
|
username: '輸入使用者名稱',
|
||||||
password: '輸入密碼',
|
password: '輸入密碼',
|
||||||
unsupportedProtocol: '不支持的協議',
|
unsupportedProtocol: '不支持的通訊協定',
|
||||||
windowsImage: '這可能是 Windows 系統鏡像',
|
windowsImage: '這可能是 Windows 系統映像檔',
|
||||||
partitionTable: '找不到分區表',
|
partitionTable: '找不到分割表',
|
||||||
errorOpen: '打開源鏡像時出錯',
|
errorOpen: '打開來源映像檔時出錯',
|
||||||
fromFile: '從文件燒錄',
|
fromFile: '從檔案燒錄',
|
||||||
fromURL: '從在線地址燒錄',
|
fromURL: '從網址燒錄',
|
||||||
clone: '克隆磁盤',
|
clone: '再製磁碟',
|
||||||
image: '鏡像信息',
|
image: '映像檔訊息',
|
||||||
name: '名稱:',
|
name: '名稱:',
|
||||||
path: '路徑:',
|
path: '路徑:',
|
||||||
selectSource: '選擇源',
|
selectSource: '選擇來源',
|
||||||
plugSource: '請插入源磁盤',
|
plugSource: '請插入來源磁碟',
|
||||||
osImages: '系統鏡像格式',
|
osImages: '系統映像檔格式',
|
||||||
allFiles: '任何文件格式',
|
allFiles: '任何檔案格式',
|
||||||
enterValidURL: '請輸入一個正確的地址',
|
enterValidURL: '請輸入正確的網址',
|
||||||
},
|
},
|
||||||
drives: {
|
drives: {
|
||||||
name: '名稱',
|
name: '名稱',
|
||||||
size: '大小',
|
size: '大小',
|
||||||
location: '位置',
|
location: '位置',
|
||||||
find: '找到 {{length}} 個',
|
find: '找到 {{length}} 個',
|
||||||
select: '選定 {{select}}',
|
select: '選取 {{select}}',
|
||||||
showHidden: '顯示 {{num}} 個隱藏的磁盤',
|
showHidden: '顯示 {{num}} 個隱藏的磁碟',
|
||||||
systemDriveDanger: '選擇系統盤很危險,因爲這將會刪除你的系統!',
|
systemDriveDanger: '選擇系統分割區很危險,因為這將會刪除你的系統!',
|
||||||
openInBrowser: 'Etcher 會在瀏覽器中打開 {{link}}',
|
openInBrowser: 'Etcher 會在瀏覽器中打開 {{link}}',
|
||||||
changeTarget: '改變目標',
|
changeTarget: '更改目標',
|
||||||
largeDriveWarning: '您即將擦除一個非常大的磁盤',
|
largeDriveWarning: '您即將格式化一個非常大的磁碟',
|
||||||
largeDriveWarningMsg: '您確定所選磁盤不是存儲磁盤嗎?',
|
largeDriveWarningMsg: '您確定所選磁碟不是儲存資料的磁碟嗎?',
|
||||||
systemDriveWarning: '您將要擦除系統盤',
|
systemDriveWarning: '您將要格式化系統分割區',
|
||||||
systemDriveWarningMsg: '您確定要燒錄到系統盤嗎?',
|
systemDriveWarningMsg: '您確定要燒錄到系統分割區嗎?',
|
||||||
},
|
},
|
||||||
flash: {
|
flash: {
|
||||||
another: '燒錄另一目標',
|
another: '燒錄另一目標',
|
||||||
@@ -129,22 +114,39 @@ const translation = {
|
|||||||
flash: '燒錄',
|
flash: '燒錄',
|
||||||
flashNow: '現在燒錄!',
|
flashNow: '現在燒錄!',
|
||||||
skip: '跳過了驗證',
|
skip: '跳過了驗證',
|
||||||
moreInfo: '更多信息',
|
moreInfo: '更多資訊',
|
||||||
speedTip:
|
speedTip:
|
||||||
'通過將鏡像大小除以燒錄時間來計算速度。\n由於我們能夠跳過未使用的部分,因此具有EXT分區的磁盤鏡像燒錄速度更快。',
|
'透過將映像檔大小除以燒錄時間來計算速度。\n由於我們能夠跳過未使用的部分,因此具有 ext 分割區的磁碟映像檔燒錄速度更快。',
|
||||||
speed: '速度:{{speed}} MB/秒',
|
speed: '速度:{{speed}} MB/秒',
|
||||||
speedShort: '{{speed}} MB/秒',
|
speedShort: '{{speed}} MB/秒',
|
||||||
eta: '預計還需要:{{eta}}',
|
eta: '預計還需要:{{eta}}',
|
||||||
failedTarget: '失敗的燒錄目標',
|
failedTarget: '目標燒錄失敗',
|
||||||
failedRetry: '重試燒錄失敗目標',
|
failedRetry: '重試燒錄失敗的目標',
|
||||||
flashFailed: '燒錄失敗。',
|
flashFailed: '燒錄失敗。',
|
||||||
flashCompleted: '燒錄成功!',
|
flashCompleted: '燒錄成功!',
|
||||||
},
|
},
|
||||||
settings: {
|
settings: {
|
||||||
errorReporting: '匿名地向 balena.io 報告運行錯誤和使用統計',
|
errorReporting: '匿名向 balena.io 回報程式錯誤和使用統計資料',
|
||||||
autoUpdate: '自動更新',
|
autoUpdate: '自動更新',
|
||||||
settings: '軟件設置',
|
settings: '軟體設定',
|
||||||
systemInformation: '系統信息',
|
systemInformation: '系統資訊',
|
||||||
|
trimExtPartitions:
|
||||||
|
'修改原始映像檔上未分配的空間(在 ext 類型分割區中)',
|
||||||
|
},
|
||||||
|
menu: {
|
||||||
|
edit: '編輯',
|
||||||
|
view: '預覽',
|
||||||
|
devTool: '打開開發者工具',
|
||||||
|
window: '視窗',
|
||||||
|
help: '協助',
|
||||||
|
pro: 'Etcher 專業版',
|
||||||
|
website: 'Etcher 的官網',
|
||||||
|
issue: '提交 issue',
|
||||||
|
about: '關於 Etcher',
|
||||||
|
hide: '隱藏 Etcher',
|
||||||
|
hideOthers: '隱藏其它視窗',
|
||||||
|
unhide: '取消隱藏',
|
||||||
|
quit: '結束 Etcher',
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -176,7 +176,6 @@ async function createMainWindow() {
|
|||||||
contextIsolation: false,
|
contextIsolation: false,
|
||||||
webviewTag: true,
|
webviewTag: true,
|
||||||
zoomFactor: width / defaultWidth,
|
zoomFactor: width / defaultWidth,
|
||||||
enableRemoteModule: true,
|
|
||||||
},
|
},
|
||||||
});
|
});
|
||||||
|
|
||||||
@@ -208,10 +207,27 @@ async function createMainWindow() {
|
|||||||
)}`,
|
)}`,
|
||||||
);
|
);
|
||||||
|
|
||||||
|
const page = mainWindow.webContents;
|
||||||
|
remoteMain.enable(page);
|
||||||
|
|
||||||
|
page.once('did-frame-finish-load', async () => {
|
||||||
|
console.log('packageUpdatable', packageUpdatable);
|
||||||
|
autoUpdater.on('error', (err) => {
|
||||||
|
logMainProcessException(err);
|
||||||
|
});
|
||||||
|
if (packageUpdatable) {
|
||||||
|
try {
|
||||||
|
const checkForUpdatesTimer = 300000;
|
||||||
|
checkForUpdates(checkForUpdatesTimer);
|
||||||
|
} catch (err) {
|
||||||
|
logMainProcessException(err);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
return mainWindow;
|
return mainWindow;
|
||||||
}
|
}
|
||||||
|
|
||||||
electron.app.allowRendererProcessReuse = false;
|
|
||||||
electron.app.on('window-all-closed', electron.app.quit);
|
electron.app.on('window-all-closed', electron.app.quit);
|
||||||
|
|
||||||
// Sending a `SIGINT` (e.g: Ctrl-C) to an Electron app that registers
|
// Sending a `SIGINT` (e.g: Ctrl-C) to an Electron app that registers
|
||||||
|
|||||||
23087
package-lock.json
generated
23087
package-lock.json
generated
File diff suppressed because it is too large
Load Diff
35
package.json
35
package.json
@@ -2,7 +2,7 @@
|
|||||||
"name": "balena-etcher",
|
"name": "balena-etcher",
|
||||||
"private": true,
|
"private": true,
|
||||||
"displayName": "balenaEtcher",
|
"displayName": "balenaEtcher",
|
||||||
"version": "1.15.4",
|
"version": "1.18.6",
|
||||||
"packageType": "local",
|
"packageType": "local",
|
||||||
"main": "generated/etcher.js",
|
"main": "generated/etcher.js",
|
||||||
"description": "Flash OS images to SD cards and USB drives, safely and easily.",
|
"description": "Flash OS images to SD cards and USB drives, safely and easily.",
|
||||||
@@ -14,9 +14,9 @@
|
|||||||
},
|
},
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"build": "npm run webpack",
|
"build": "npm run webpack",
|
||||||
"flowzone-preinstall-linux": "sudo apt-get install -y xvfb libudev-dev && cat < electron-builder.yml | yq e .deb.depends[] - | xargs -L1 echo | sed 's/|//g' | xargs -L1 sudo apt-get --ignore-missing install || true",
|
"flowzone-preinstall-linux": "sudo apt-get update && sudo apt-get install -y xvfb libudev-dev && cat < electron-builder.yml | yq e .deb.depends[] - | xargs -L1 echo | sed 's/|//g' | xargs -L1 sudo apt-get --ignore-missing install || true",
|
||||||
"flowzone-preinstall-macos": "true",
|
"flowzone-preinstall-macos": "true",
|
||||||
"flowzone-preinstall-windows": "true",
|
"flowzone-preinstall-windows": "npx node-gyp install",
|
||||||
"flowzone-preinstall": "npm run flowzone-preinstall-linux",
|
"flowzone-preinstall": "npm run flowzone-preinstall-linux",
|
||||||
"lint-css": "prettier --write lib/**/*.css",
|
"lint-css": "prettier --write lib/**/*.css",
|
||||||
"lint-ts": "balena-lint --fix --typescript typings lib tests scripts/clean-shrinkwrap.ts webpack.config.ts",
|
"lint-ts": "balena-lint --fix --typescript typings lib tests scripts/clean-shrinkwrap.ts webpack.config.ts",
|
||||||
@@ -24,12 +24,11 @@
|
|||||||
"postinstall": "electron-rebuild -t prod,dev,optional",
|
"postinstall": "electron-rebuild -t prod,dev,optional",
|
||||||
"sanity-checks": "bash scripts/ci/ensure-all-file-extensions-in-gitattributes.sh",
|
"sanity-checks": "bash scripts/ci/ensure-all-file-extensions-in-gitattributes.sh",
|
||||||
"start": "./node_modules/.bin/electron .",
|
"start": "./node_modules/.bin/electron .",
|
||||||
"test-macos": "npm run lint && npm run test-gui && npm run test-shared && npm run test-spectron && npm run sanity-checks",
|
|
||||||
"test-gui": "electron-mocha --recursive --reporter spec --window-config tests/gui/window-config.json --require ts-node/register/transpile-only --require-main tests/gui/allow-renderer-process-reuse.ts --full-trace --no-sandbox --renderer tests/gui/**/*.ts",
|
"test-gui": "electron-mocha --recursive --reporter spec --window-config tests/gui/window-config.json --require ts-node/register/transpile-only --require-main tests/gui/allow-renderer-process-reuse.ts --full-trace --no-sandbox --renderer tests/gui/**/*.ts",
|
||||||
"test-linux": "npm run lint && xvfb-run --auto-servernum npm run test-gui && xvfb-run --auto-servernum npm run test-shared && xvfb-run --auto-servernum npm run test-spectron && npm run sanity-checks",
|
|
||||||
"test-shared": "electron-mocha --recursive --reporter spec --require ts-node/register/transpile-only --require-main tests/gui/allow-renderer-process-reuse.ts --full-trace --no-sandbox tests/shared/**/*.ts",
|
"test-shared": "electron-mocha --recursive --reporter spec --require ts-node/register/transpile-only --require-main tests/gui/allow-renderer-process-reuse.ts --full-trace --no-sandbox tests/shared/**/*.ts",
|
||||||
"test-spectron": "mocha --recursive --reporter spec --require ts-node/register/transpile-only --require-main tests/gui/allow-renderer-process-reuse.ts tests/spectron/runner.spec.ts",
|
"test-macos": "npm run lint && npm run test-gui && npm run test-shared && npm run sanity-checks",
|
||||||
"test-windows": "npm run lint && npm run test-gui && npm run test-shared && npm run test-spectron && npm run sanity-checks",
|
"test-linux": "npm run lint && xvfb-run --auto-servernum npm run test-gui && xvfb-run --auto-servernum npm run test-shared && npm run sanity-checks",
|
||||||
|
"test-windows": "npm run lint && npm run test-gui && npm run test-shared && npm run sanity-checks",
|
||||||
"test": "echo npm run test-{linux,windows,macos}",
|
"test": "echo npm run test-{linux,windows,macos}",
|
||||||
"watch": "webpack serve --no-optimization-minimize --config ./webpack.dev.config.ts",
|
"watch": "webpack serve --no-optimization-minimize --config ./webpack.dev.config.ts",
|
||||||
"webpack": "webpack"
|
"webpack": "webpack"
|
||||||
@@ -52,7 +51,8 @@
|
|||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@balena/lint": "5.4.2",
|
"@balena/lint": "5.4.2",
|
||||||
"@balena/sudo-prompt": "9.2.1-workaround-windows-amperstand-in-username-0849e215b947987a643fe5763902aea201255534",
|
"@balena/sudo-prompt": "9.2.1-workaround-windows-amperstand-in-username-0849e215b947987a643fe5763902aea201255534",
|
||||||
"@electron/remote": "^1.2.2",
|
"@electron/fuses": "^1.6.1",
|
||||||
|
"@electron/remote": "^2.0.9",
|
||||||
"@fortawesome/fontawesome-free": "5.15.4",
|
"@fortawesome/fontawesome-free": "5.15.4",
|
||||||
"@sentry/electron": "^4.1.2",
|
"@sentry/electron": "^4.1.2",
|
||||||
"@svgr/webpack": "5.5.0",
|
"@svgr/webpack": "5.5.0",
|
||||||
@@ -60,8 +60,8 @@
|
|||||||
"@types/copy-webpack-plugin": "6.4.3",
|
"@types/copy-webpack-plugin": "6.4.3",
|
||||||
"@types/mime-types": "2.1.1",
|
"@types/mime-types": "2.1.1",
|
||||||
"@types/mini-css-extract-plugin": "1.4.3",
|
"@types/mini-css-extract-plugin": "1.4.3",
|
||||||
"@types/mocha": "8.2.3",
|
"@types/mocha": "^9.1.1",
|
||||||
"@types/node": "14.18.34",
|
"@types/node": "^16.18.12",
|
||||||
"@types/node-ipc": "9.2.0",
|
"@types/node-ipc": "9.2.0",
|
||||||
"@types/react": "16.14.34",
|
"@types/react": "16.14.34",
|
||||||
"@types/react-dom": "16.9.17",
|
"@types/react-dom": "16.9.17",
|
||||||
@@ -77,14 +77,14 @@
|
|||||||
"css-loader": "5.2.7",
|
"css-loader": "5.2.7",
|
||||||
"d3": "4.13.0",
|
"d3": "4.13.0",
|
||||||
"debug": "4.3.4",
|
"debug": "4.3.4",
|
||||||
"electron": "^13.6.9",
|
"electron": "^19.1.9",
|
||||||
"electron-builder": "^23.6.0",
|
"electron-builder": "^23.6.0",
|
||||||
"electron-mocha": "^10.1.0",
|
"electron-mocha": "^11.0.2",
|
||||||
"electron-notarize": "1.2.2",
|
"electron-notarize": "1.2.2",
|
||||||
"electron-rebuild": "3.2.3",
|
"electron-rebuild": "^3.2.9",
|
||||||
"electron-updater": "5.3.0",
|
"electron-updater": "5.3.0",
|
||||||
"esbuild-loader": "2.20.0",
|
"esbuild-loader": "2.20.0",
|
||||||
"etcher-sdk": "^8.2.0",
|
"etcher-sdk": "8.3.1",
|
||||||
"file-loader": "6.2.0",
|
"file-loader": "6.2.0",
|
||||||
"husky": "4.3.8",
|
"husky": "4.3.8",
|
||||||
"i18next": "21.10.0",
|
"i18next": "21.10.0",
|
||||||
@@ -92,7 +92,7 @@
|
|||||||
"lint-staged": "10.5.4",
|
"lint-staged": "10.5.4",
|
||||||
"lodash": "4.17.21",
|
"lodash": "4.17.21",
|
||||||
"mini-css-extract-plugin": "1.6.2",
|
"mini-css-extract-plugin": "1.6.2",
|
||||||
"mocha": "8.4.0",
|
"mocha": "^9.1.1",
|
||||||
"native-addon-loader": "2.0.1",
|
"native-addon-loader": "2.0.1",
|
||||||
"node-ipc": "9.2.1",
|
"node-ipc": "9.2.1",
|
||||||
"omit-deep-lodash": "1.1.7",
|
"omit-deep-lodash": "1.1.7",
|
||||||
@@ -108,7 +108,6 @@
|
|||||||
"semver": "7.3.8",
|
"semver": "7.3.8",
|
||||||
"simple-progress-webpack-plugin": "1.1.2",
|
"simple-progress-webpack-plugin": "1.1.2",
|
||||||
"sinon": "9.2.4",
|
"sinon": "9.2.4",
|
||||||
"spectron": "15.0.0",
|
|
||||||
"string-replace-loader": "3.1.0",
|
"string-replace-loader": "3.1.0",
|
||||||
"style-loader": "2.0.0",
|
"style-loader": "2.0.0",
|
||||||
"styled-components": "5.3.6",
|
"styled-components": "5.3.6",
|
||||||
@@ -125,9 +124,9 @@
|
|||||||
"webpack-dev-server": "4.11.1"
|
"webpack-dev-server": "4.11.1"
|
||||||
},
|
},
|
||||||
"engines": {
|
"engines": {
|
||||||
"node": ">=14"
|
"node": ">=16"
|
||||||
},
|
},
|
||||||
"versionist": {
|
"versionist": {
|
||||||
"publishedAt": "2023-02-02T18:26:46.572Z"
|
"publishedAt": "2023-03-21T13:24:18.905Z"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -3,7 +3,11 @@ const { app } = require('electron');
|
|||||||
|
|
||||||
if (app !== undefined) {
|
if (app !== undefined) {
|
||||||
// tslint:disable-next-line:no-var-requires
|
// tslint:disable-next-line:no-var-requires
|
||||||
require('@electron/remote/main').initialize();
|
const remoteMain = require('@electron/remote/main');
|
||||||
|
|
||||||
app.allowRendererProcessReuse = false;
|
remoteMain.initialize();
|
||||||
|
|
||||||
|
app.on('browser-window-created', (_event, window) =>
|
||||||
|
remoteMain.enable(window.webContents),
|
||||||
|
);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,66 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright 2017 balena.io
|
|
||||||
*
|
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
||||||
* you may not use this file except in compliance with the License.
|
|
||||||
* You may obtain a copy of the License at
|
|
||||||
*
|
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
*
|
|
||||||
* Unless required by applicable law or agreed to in writing, software
|
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
* See the License for the specific language governing permissions and
|
|
||||||
* limitations under the License.
|
|
||||||
*/
|
|
||||||
|
|
||||||
import { expect } from 'chai';
|
|
||||||
import { platform } from 'os';
|
|
||||||
import { Application } from 'spectron';
|
|
||||||
import * as electronPath from 'electron';
|
|
||||||
|
|
||||||
// TODO: spectron fails to start on the CI with:
|
|
||||||
// Error: Failed to create session.
|
|
||||||
// unknown error: Chrome failed to start: exited abnormally
|
|
||||||
if (platform() !== 'darwin') {
|
|
||||||
describe('Spectron', function () {
|
|
||||||
// Mainly for CI jobs
|
|
||||||
this.timeout(40000);
|
|
||||||
|
|
||||||
const app = new Application({
|
|
||||||
path: electronPath as unknown as string,
|
|
||||||
args: ['--no-sandbox', '.'],
|
|
||||||
});
|
|
||||||
|
|
||||||
before('app:start', async () => {
|
|
||||||
await app.start();
|
|
||||||
});
|
|
||||||
|
|
||||||
after('app:stop', async () => {
|
|
||||||
if (app && app.isRunning()) {
|
|
||||||
await app.stop();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
describe('Browser Window', () => {
|
|
||||||
it('should open a browser window', async () => {
|
|
||||||
// We can't use `isVisible()` here as it won't work inside
|
|
||||||
// a Windows Docker container, but we can approximate it
|
|
||||||
// with these set of checks:
|
|
||||||
const bounds = await app.browserWindow.getBounds();
|
|
||||||
expect(bounds.height).to.be.above(0);
|
|
||||||
expect(bounds.width).to.be.above(0);
|
|
||||||
expect(await app.browserWindow.isMinimized()).to.be.false;
|
|
||||||
expect(
|
|
||||||
(await app.browserWindow.isVisible()) ||
|
|
||||||
(await app.browserWindow.isFocused()),
|
|
||||||
).to.be.true;
|
|
||||||
});
|
|
||||||
|
|
||||||
it('should set a proper title', async () => {
|
|
||||||
// @ts-ignore (SpectronClient.getTitle exists)
|
|
||||||
return expect(await app.client.getTitle()).to.equal('balenaEtcher');
|
|
||||||
});
|
|
||||||
});
|
|
||||||
});
|
|
||||||
}
|
|
||||||
@@ -276,19 +276,17 @@ const commonConfig = {
|
|||||||
`,
|
`,
|
||||||
replace: "require('./build/Release/Generator.node')",
|
replace: "require('./build/Release/Generator.node')",
|
||||||
}),
|
}),
|
||||||
// Use the copy of blobs in the generated folder and rename node_modules -> modules
|
|
||||||
// See the renameNodeModules function above
|
|
||||||
replace(/node_modules\/node-raspberrypi-usbboot\/build\/index\.js$/, {
|
replace(/node_modules\/node-raspberrypi-usbboot\/build\/index\.js$/, {
|
||||||
search:
|
search:
|
||||||
"return await readFile(Path.join(__dirname, '..', 'blobs', filename));",
|
"return await readFile(Path.join(__dirname, '..', 'blobs', filename));",
|
||||||
replace: outdent`
|
replace: outdent`
|
||||||
const { app, remote } = require('electron');
|
const remote = require('@electron/remote');
|
||||||
return await readFile(
|
return await readFile(
|
||||||
Path.join(
|
Path.join(
|
||||||
// With macOS universal builds, getAppPath() returns the path to an app.asar file containing an index.js file which will
|
// With macOS universal builds, getAppPath() returns the path to an app.asar file containing an index.js file which will
|
||||||
// include the app-x64 or app-arm64 folder depending on the arch.
|
// include the app-x64 or app-arm64 folder depending on the arch.
|
||||||
// We don't care about the app.asar file, we want the actual folder.
|
// We don't care about the app.asar file, we want the actual folder.
|
||||||
(app || remote.app).getAppPath().replace(/\\.asar$/, () => process.platform === 'darwin' ? '-' + process.arch : ''),
|
remote.app.getAppPath().replace(/\\.asar$/, () => process.platform === 'darwin' ? '-' + process.arch : ''),
|
||||||
'generated',
|
'generated',
|
||||||
__dirname.replace('node_modules', 'modules'),
|
__dirname.replace('node_modules', 'modules'),
|
||||||
'..',
|
'..',
|
||||||
|
|||||||
Reference in New Issue
Block a user