Update CONTRIBUTING.md

This commit is contained in:
lilia 2017-04-10 11:06:39 -07:00 committed by Scott Nonnenberg
parent 7e1bee1082
commit d12c94d44e
No known key found for this signature in database
GPG key ID: A4931C09644C654B

View file

@ -16,16 +16,21 @@ If you start working on an issue, leave a comment to let others know. It is
also a good idea to outline your approach to the problem in order to get also a good idea to outline your approach to the problem in order to get
feedback. feedback.
## Installation
* Clone the repo
* Open Chrome
* Go to chrome://extensions/
* Enable developer mode (checkbox on the top right)
* Click "Load unpacked extension..."
* Point to the repo directory
## Developer Setup ## Developer Setup
``
npm install # install dependencies
npm start # run
``
Some features, such as native notifications, will not work locally until you
package for your platform:
```
npm run pack-staging # build a packaged app dir in ./dist
```
```
npm run dist-staging # build installer (.dmg, .exe, or .deb)
```
For development, you should always be using the staging server. For development, you should always be using the staging server.
Registrations on the staging server are completely partitioned from the Registrations on the staging server are completely partitioned from the
@ -33,8 +38,7 @@ production server that the mobile apps use. A production app from the Play
store or iTunes is hard-coded to connect to the production server. If you wish store or iTunes is hard-coded to connect to the production server. If you wish
to pair your phone and computer, or test sending between the browser and to pair your phone and computer, or test sending between the browser and
mobile, **you must build a mobile client that targets the staging server** mobile, **you must build a mobile client that targets the staging server**
(see below, under (see below, under [Linking](#linking)).
[Linking](#linking)).
## Linking ## Linking
@ -42,7 +46,6 @@ mobile, **you must build a mobile client that targets the staging server**
0. Build Signal for Android or iOS from source, and point its TextSecure service URL to `textsecure-service-staging.whispersystems.org`: 0. Build Signal for Android or iOS from source, and point its TextSecure service URL to `textsecure-service-staging.whispersystems.org`:
- **on Android:** Replace the `SIGNAL_URL` value in [build.gradle](https://github.com/WhisperSystems/Signal-Android/blob/master/build.gradle) - **on Android:** Replace the `SIGNAL_URL` value in [build.gradle](https://github.com/WhisperSystems/Signal-Android/blob/master/build.gradle)
- **on iOS:** Replace the `textSecureServerURL` value in `TSConstants.h`(located in the SignalServiceKit pod) - **on iOS:** Replace the `textSecureServerURL` value in `TSConstants.h`(located in the SignalServiceKit pod)
This task is 1% search and replace, 99% setting up your build environment. Instructions are available for both This task is 1% search and replace, 99% setting up your build environment. Instructions are available for both
the [Android](https://github.com/WhisperSystems/Signal-Android/blob/master/BUILDING.md) the [Android](https://github.com/WhisperSystems/Signal-Android/blob/master/BUILDING.md)
and [iOS](https://github.com/WhisperSystems/Signal-iOS/blob/master/BUILDING.md) projects. and [iOS](https://github.com/WhisperSystems/Signal-iOS/blob/master/BUILDING.md) projects.