use libsass, deprecate ruby, simplify installation (#4206)

* use libsass, deprecate ruby, simplify installation

* update installation instructions, readme formatting
This commit is contained in:
Jason Dreyzehner 2016-05-10 16:12:46 -04:00 committed by Gustavo Maximiliano Cortez
parent 98471e952a
commit f1c03b8a49
No known key found for this signature in database
GPG Key ID: 15EDAD8D9F2EB1AF
3 changed files with 37 additions and 50 deletions

View File

@ -1,5 +1,9 @@
'use strict';
module.exports = function(grunt) {
require('load-grunt-tasks')(grunt);
// Project Configuration
grunt.initConfig({
pkg: grunt.file.readJSON('package.json'),
@ -238,20 +242,6 @@ module.exports = function(grunt) {
}
});
grunt.loadNpmTasks('grunt-contrib-concat');
grunt.loadNpmTasks('grunt-contrib-copy');
grunt.loadNpmTasks('grunt-contrib-watch');
grunt.loadNpmTasks('grunt-contrib-uglify');
grunt.loadNpmTasks('grunt-angular-gettext');
grunt.loadNpmTasks('grunt-browserify');
grunt.loadNpmTasks('grunt-exec');
grunt.loadNpmTasks('grunt-karma');
grunt.loadNpmTasks('grunt-karma-coveralls');
grunt.loadNpmTasks('grunt-node-webkit-builder');
grunt.loadNpmTasks('grunt-contrib-compress');
grunt.loadNpmTasks('grunt-string-replace');
grunt.loadNpmTasks('grunt-contrib-sass');
grunt.registerTask('default', ['nggettext_compile', 'exec:version', 'exec:coinbase', 'browserify', 'sass', 'concat', 'copy:icons']);
grunt.registerTask('prod', ['default', 'uglify']);
grunt.registerTask('translate', ['nggettext_extract']);

View File

@ -5,7 +5,7 @@
Copay is an easy-to-use, open-source, multiplatform, multisignature, secure bitcoin wallet platform for both individuals and companies. Copay uses [Bitcore Wallet Service](https://github.com/bitpay/bitcore-wallet-service) (BWS) for peer synchronization and network interfacing.
Binary versions of Copay are available for download at [Copay.io](https://copay.io/#download). Copay Binaries are signed with the key copay@bitpay.com [See here for details](https://github.com/bitpay/copay#how-to-verify-copay-signatures)
Binary versions of Copay are available for download at [Copay.io](https://copay.io/#download). Copay Binaries are signed with the key `copay@bitpay.com` See the section [`How to Verify Copay Signatures`](https://github.com/bitpay/copay#how-to-verify-copay-signatures) for details.
## Main Features
@ -27,35 +27,25 @@ Binary versions of Copay are available for download at [Copay.io](https://copay.
- Multiple languages supported
- Available for [iOS](https://itunes.apple.com/us/app/copay/id951330296), [Android](https://play.google.com/store/apps/details?id=com.bitpay.copay&hl=en), [Windows Phone](http://www.windowsphone.com/en-us/store/app/copay-wallet/4372479b-a064-4d18-8bd3-74a3bdb81c3a), [Chrome App](https://chrome.google.com/webstore/detail/copay/cnidaodnidkbaplmghlelgikaiejfhja?hl=en), [Linux](https://github.com/bitpay/copay/releases/latest), [Windows](https://github.com/bitpay/copay/releases/latest) and [OS X](https://github.com/bitpay/copay/releases/latest) devices
## Installation
## Install For Development
Clone the source:
Clone the repo and open the directory:
```sh
git clone https://github.com/bitpay/copay.git
cd copay
```
Install [bower](http://bower.io/) and [grunt](http://gruntjs.com/getting-started) if you haven't already:
Ensure you have [Node](https://nodejs.org/) installed, then install and start Copay:
```sh
npm install -g bower
npm install -g grunt-cli
```
Build Copay:
```sh
sudo gem install sass
bower install
npm install
grunt
npm start
```
Then visit `localhost:3000` in your browser.
Visit [`localhost:3000`](http://localhost:3000/) to view the app.
> **Note:** Other browser extensions could have access to Copay internal data and compromise the user's private key when running Copay as a web page. For optimal security, you should disable all third-party browser extensions when using Copay in this manner.
> **Note:** This method should only be used for development purposes. When running Copay in a normal browser environment, browser extensions and other malicious code might have access to internal data and private keys. For production use, see the latest official [releases](https://github.com/bitpay/copay/releases/).
## Build Copay App Bundles
@ -151,7 +141,7 @@ Previous versions of Copay used files as backups. See the following section.
It is possible to recover funds from a Copay Wallet without using Copay or the Wallet Service, check the [Copay Recovery Tool](https://github.com/bitpay/copay-recovery).
## Wallet Export format
## Wallet Export Format
Copay encrypts the backup with the [Stanford JS Crypto Library](http://bitwiseshiftleft.github.io/sjcl/). To extract the private key of your wallet you can use https://bitwiseshiftleft.github.io/sjcl/demo/, copy the backup to 'ciphertext' and enter your password. The resulting JSON will have a key named: `xPrivKey`, that is the extended private key of your wallet. That information is enough to sign any transaction from your wallet, so be careful when handling it!
@ -227,34 +217,35 @@ This will download all partial and complete language translations while also cle
*Gracias totales!*
## Release schedules
## Release Schedules
Copay uses the `MAJOR.MINOR.BATCH` convention for versioning. Any release that adds features should modify the MINOR or MAJOR number.
### Bug Fixing Releases
We release bug fixes as soon as possible for all platforms. Usually around a week after patches, a new release is made with language translation updates (like 1.1.4 and then 1.1.5). There is no coordination so all platforms are updated at the same time.
### Minor and Major releases
### Minor and Major Releases
- t+0: tag the release 1.2 and "text lock" (meaning only non-text related bug fixes. Though this rule is sometimes broken, it's good to make a rule.)
- t+7: testing for 1.2 is finished, translation is also finished, and 1.2.1 is tagged with all translations along with bug fixes made in the last week.
- t+7: iOS is submitted for 1.2.1. All other platforms are submitted with auto-release off.
- t + (~17): All platforms 1.2.1 are released when Apple approves the iOS application update.
## How to verify Copay signatures
## How to Verify Copay Signatures
1. Download the `copay@bitpay.com` public key (`gpg --recv-keys 1112CFA1`)
2. Download Copay binary (`$FILENAME`) and signature file (`$FILENAME.sig`)
3. Verify the signature by running:
1. Download copay@bitpay.com public key (`gpg --recv-keys 1112CFA1`)
1. Download Copay binary ($FILENAME) and signature file ($FILENAME.sig)
1. Check it by running:
``` bash
$ gpg --verify \
$FILENAME.sig \
$FILENAME
# It should say:
"Good signature from "Copay (visit copay.io) <copay@bitpay.com>"
# It should return:
Good signature from "Copay (visit copay.io) <copay@bitpay.com>"
```
### Public Key for Copay binaries
### Public Key for Copay Binaries
Instead of importing the public key from a public server (like gnu's) you can grab it from here:
```

View File

@ -58,21 +58,26 @@
"shelljs": "^0.3.0"
},
"scripts": {
"preinstall": "bower install",
"postinstall": "npm run build",
"build": "grunt",
"start": "node app.js",
"test": "./node_modules/.bin/grunt test-coveralls"
"test": "./node_modules/.bin/grunt test-coveralls",
"clean": "git clean -dfx"
},
"devDependencies": {
"adm-zip": "^0.4.7",
"angular": "1.4.6",
"angular-mocks": "1.4.10",
"bhttp": "^1.2.1",
"bower": "^1.7.9",
"chai": "^3.5.0",
"cordova": "5.4.1",
"cordova-android": "5.1.1",
"grunt-contrib-sass": "^1.0.0",
"grunt-karma": "^1.0.0",
"grunt-karma-coveralls": "^2.5.4",
"grunt-node-webkit-builder": "^1.0.2",
"grunt-sass": "^1.2.0",
"grunt-string-replace": "^1.2.1",
"karma": "^0.13.22",
"karma-chai": "^0.1.0",
@ -83,6 +88,7 @@
"karma-mocha-reporter": "^2.0.3",
"karma-phantomjs-launcher": "^1.0.0",
"karma-sinon": "^1.0.5",
"load-grunt-tasks": "^3.5.0",
"mocha": "^2.4.5",
"phantomjs-prebuilt": "^2.1.7",
"xcode": "^0.8.2"