Skip to content

Latest commit

 

History

History
84 lines (52 loc) · 2.72 KB

build.md

File metadata and controls

84 lines (52 loc) · 2.72 KB

Build

This page is also available in Japanese, Korean, Russain, Simplified Chinese, French and German.

Environments

  • npm: 4.x
  • node: 7.x

You should use npm v4.x because $ grunt pre-build fails on v5.x.

Development

We use Webpack HMR to develop Boostnote. Running the following commands, at the top of the project directory, will start Boostnote with the default configurations.

Install the required packages using yarn.

$ yarn

Build and run.

$ yarn run dev-start

This command runs yarn run webpack and yarn run hot in parallel. It is the same as running these commands in two terminals.

The webpack will watch for code changes and then apply them automatically.

If the following error occurs: Failed to load resource: net::ERR_CONNECTION_REFUSED, please reload Boostnote.

net::ERR_CONNECTION_REFUSED

Notice

There are some cases where you have to refresh the app manually.

  1. When editing a constructor method of a component
  2. When adding a new css class (similar to 1: the CSS class is re-written by each component. This process occurs at the Constructor method.)

Deploy

We use Grunt to automate deployment. You can build the program by using grunt. However, we don't recommend this because the default task includes codesign and authenticode.

So, we've prepared a separate script which just makes an executable file.

This build doesn't work on npm v5.3.0. So you need to use v5.2.0 when you build it.

grunt pre-build

You will find the executable in the dist directory. Note, the auto updater won't work because the app isn't signed.

If you find it necessary, you can use codesign or authenticode with this executable.

Make own distribution packages (deb, rpm)

Distribution packages are created by exec grunt build on Linux platform (e.g. Ubuntu, Fedora).

Note: You can create both .deb and .rpm in a single environment.

After installing the supported version of node and npm, install build dependency packages.

Ubuntu/Debian:

$ sudo apt-get install -y rpm fakeroot

Fedora:

$ sudo dnf install -y dpkg dpkg-dev rpm-build fakeroot

Then execute grunt build.

$ grunt build

You will find .deb and .rpm in the dist directory.