etcher/docs/PUBLISHING.md

Publishing Etcher

This is a small guide to package and publish Etcher to all supported operating systems.

Common Pre-requisites

• NodeJS

Make sure you're running the exact same NodeJS version as the one included with the current Electron build being used by Etcher to avoid any strange native dependencies issues.

• Bower
• UPX
• Python

Signing

OS X

1. Get our Apple Developer ID certificate for signing applications distributed outside the Mac App Store from the Resin.io Apple account.

2. Install the Developer ID certificate to your Mac's Keychain by double clicking on the certificate file.

The application will be signed automatically using this certificate when packaging for OS X.

Windows

1. Get access to our code signing certificate and decryption key as a Resin.io employee by asking for it to the relevant people.

2. Place the certificate in the root of the Etcher repository naming it certificate.p12.

Packaging

The resulting installers will be saved to etcher-release/installers.

Windows

Pre-requisites:

• NSIS
• Visual Studio Community 2013
• Rimraf
• asar

Run the following command from the Developer Command Prompt for VS2013, to ensure all Visual Studio command utilities are available in the %PATH%:

> .\scripts\build\windows.bat <arch>

OS X

Pre-requisites:

• XCode

Run the following command:

$ ./scripts/build/darwin.sh

GNU/Linux

Run the following command:

$ ./scripts/build/linux.sh <arch>

Publishing

• AWS CLI

Make sure you have the AWS CLI tool installed and configured to access Resin.io's production downloads S3 bucket.

The publishing script only runs on UNIX based operating systems for now. You can use something like Cygwin to run it on Windows.

Run the following command:

./scripts/publish.sh <file>