Skip to content

Latest commit

 

History

History
41 lines (25 loc) · 1.66 KB

README.md

File metadata and controls

41 lines (25 loc) · 1.66 KB

prebuild-ci

Use CI like travis and appveyor to auto upload prebuilds.

Requires you to use prebuild@6 or later.

Motivation

It's great to provide prebuilds with your native node modules, so consumers don't have to compile them on install - a pre made binary will simply be fetched. It can however be cumbersome to create those binaries yourself, you need to run the appropriate scripts on every OS you desire to ship. This module provides an alternative by creating and uploading those binaries in the CI environments you use, so for example using travis and appveyor you can cover all node versions on mac OS, linux and windows, automatically!

Usage

Add prebuild-ci to your "test" script or CI configuration, like this:

  "scripts": {
    "test": "mocha && prebuild-ci"  
  }

Also configure your CI environments to set the environment variable PREBUILD_TOKEN to your prebuild upload token, and make sure this variable is only set on pull requests from the same repository.

Then, whenever a CI job passes and updates "version" in the module's package.json, the prebuild for the current environment will be uploaded to GitHub.

That means that in order to have prebuilds for all desired os / node combinations, make sure to run each of those in a CI job.

Pro Tipp: In order for prebuilds to be available as soon as a new version is published to npm, wait with the actual npm publish until all the CI jobs have completed.

Installation

$ npm install --save prebuild-ci

License

MIT