grunt-build-atom-shell 0 npm

Grunt task to build Electron and rebuild node modules

3 years after MIT

grunt-build-atom-shell

Build atom-shell from Git, and rebuild native modules. This is a mostly drop-in replacement for grunt-download-atom-shell, in that, you can replace your use of it with this package at the same point in the Atom build process and everything should Just Work.

Why even would I do this?

The main reason to do this is because of atom/atom-shell#713 - trying to rename Atom after-the-fact isn't possible on Windows without some serious rigging. This package fixes that issue, as well as allows you to use arbitrary builds of Atom Shell (i.e. no more waiting for a new release for a bugfix).

Installation

Install npm package, next to your project's Gruntfile.js file:

npm install --save-dev grunt-build-atom-shell

Add this line to your project's Gruntfile.js:

grunt.loadNpmTasks('grunt-build-atom-shell');

Options

  • buildDir - Required Where to put the downloaded atom-shell
  • tag - Required A tag, branch, or commit of Atom Shell to build
  • projectName - Required A short name for your project (originally 'atom')
  • productName - Required The name of the final binary generated (originally 'Atom')
  • targetDir - Where to put the resulting atom-shell, defaults to ./atom-shell
  • config - Either 'Debug' or 'Release', defaults to 'Release'
  • remoteUrl - The Git remote url to download from, defaults to official Atom Shell
  • nodeVersion - The version of Node.js to use; see the section below for how to configure this

Example

Gruntfile.js

module.exports = function(grunt) {
  grunt.initConfig({
    'build-atom-shell': {
      tag: 'v0.19.5',
      nodeVersion: '0.18.0',
      buildDir: (process.env.TMPDIR || process.env.TEMP || '/tmp') + '/atom-shell',
      projectName: 'mycoolapp',
      productName: 'MyCoolApp'
    }
  });
};

Correctly setting nodeVersion

Different versions of Atom Shell expect to be linked against different versions of node.js. Since grunt-build-atom-shell allows you to use arbitrary commits of Atom Shell, there is no way for it to know which version is correct to use, so it must be explicitly provided. If you don't explicitly provide a version, we will guess the latest version, which may or may not be correct.

  • 0.19.x series - 0.18.0
  • 0.20.x series - 0.20.0
  • 0.21.x series - 0.21.0
  • 0.22.x series - 0.22.0

These numbers don't match the official node.js versions, because they also reflect patches that Atom puts into node.js to make it compatible with Chromium.

Related Repositories

grunt-electron-app-builder

grunt-electron-app-builder

grunt plugin to ease the building of atom-shell based applications ...

aspm

aspm

Atom-Shell Package Manager (inofficial) ...

vuplicity

vuplicity

A cross-platform GUI for Duplicity backups, powered by Atom Electron. ...

grunt-asar

grunt-asar

Grunt plugin to generate asar archives for atom-shell. ...

hellowebapp-atom

hellowebapp-atom

boilerplate webapp using atom-shell ...


Top Contributors

paulcbetts yrashk ziahamza muan maxkorp salbahra ttilley yshrsmz

Dependencies

package version
cp-file ^2.2.0
fs-plus ^2.3.2
glob ^5.0.6
grunt 0.4
npm ~1.4.5
rx ^2.3.20
underscore ^1.7.0

Releases

-   v2.0.4 zip tar
-   v2.0.3 zip tar
-   v2.0.2 zip tar
-   v2.0.1 zip tar
-   v2.0.0 zip tar
-   v1.1.5 zip tar
-   v1.1.3 zip tar
-   v1.1.2 zip tar
-   v1.1.1 zip tar
-   v1.1.0 zip tar
-   v1.0.0 zip tar
-   v0.1.8 zip tar
-   v0.1.7 zip tar
-   v0.1.6 zip tar
-   v0.1.4 zip tar
-   v0.1.3 zip tar
-   v0.1.2 zip tar
-   v0.1.1 zip tar
-   v0.1.0 zip tar
-   1.1.4 zip tar
-   0.1.5 zip tar