mirror of
https://github.com/oxen-io/session-android.git
synced 2024-11-27 20:15:21 +00:00
Niels Andriesse
GitHub
commit
11522db952
12
.github/ISSUE_TEMPLATE.md
vendored
12
.github/ISSUE_TEMPLATE.md
vendored
@ -3,18 +3,14 @@ You can also preview your report before submitting it. You may remove sections t
|
|||||||
|
|
||||||
Before we begin, please note that this tracker is only for issues. It is not for questions, comments, or feature requests.
|
Before we begin, please note that this tracker is only for issues. It is not for questions, comments, or feature requests.
|
||||||
|
|
||||||
If you would like to discuss a new feature or submit suggestions, please visit the community forum:
|
|
||||||
https://community.signalusers.org
|
|
||||||
|
|
||||||
If you are looking for support, please visit our support center:
|
If you are looking for support, please file an issue or:
|
||||||
https://support.signal.org/
|
or email team@loki.network
|
||||||
or email support@signal.org
|
|
||||||
|
|
||||||
Let's begin with a checklist: Replace the empty checkboxes [ ] below with checked ones [x] accordingly. -->
|
Let's begin with a checklist: Replace the empty checkboxes [ ] below with checked ones [x] accordingly. -->
|
||||||
|
|
||||||
- [ ] I have searched open and closed issues for duplicates
|
- [ ] I have searched open and closed issues for duplicates
|
||||||
- [ ] I am submitting a bug report for existing functionality that does not work as intended
|
- [ ] I am submitting a bug report for existing functionality that does not work as intended
|
||||||
- [ ] I have read https://github.com/signalapp/Signal-Android/wiki/Submitting-useful-bug-reports
|
|
||||||
- [ ] This isn't a feature request or a discussion topic
|
- [ ] This isn't a feature request or a discussion topic
|
||||||
|
|
||||||
----------------------------------------
|
----------------------------------------
|
||||||
@ -38,8 +34,6 @@ Describe here the issue that you are experiencing.
|
|||||||
<!-- replace the examples with your info -->
|
<!-- replace the examples with your info -->
|
||||||
**Device:** Manufacturer Model XVI
|
**Device:** Manufacturer Model XVI
|
||||||
**Android version:** 0.0.0
|
**Android version:** 0.0.0
|
||||||
**Signal version:** 0.0.0
|
**Session version:** 0.0.0
|
||||||
|
|
||||||
### Link to debug log
|
|
||||||
<!-- immediately after the bug has happened capture a debug log via Signal's advanced settings and paste the link below -->
|
|
||||||
|
|
||||||
|
|||||||
4
.github/PULL_REQUEST_TEMPLATE.md
vendored
4
.github/PULL_REQUEST_TEMPLATE.md
vendored
@ -1,12 +1,8 @@
|
|||||||
<!-- You can remove this first section if you have contributed before -->
|
<!-- You can remove this first section if you have contributed before -->
|
||||||
### First time contributor checklist
|
### First time contributor checklist
|
||||||
<!-- replace the empty checkboxes [ ] below with checked ones [x] accordingly -->
|
<!-- replace the empty checkboxes [ ] below with checked ones [x] accordingly -->
|
||||||
- [ ] I have read [how to contribute](https://github.com/signalapp/Signal-Android/blob/master/CONTRIBUTING.md) to this project
|
|
||||||
- [ ] I have signed the [Contributor License Agreement](https://whispersystems.org/cla/)
|
|
||||||
|
|
||||||
### Contributor checklist
|
### Contributor checklist
|
||||||
<!-- replace the empty checkboxes [ ] below with checked ones [x] accordingly -->
|
<!-- replace the empty checkboxes [ ] below with checked ones [x] accordingly -->
|
||||||
- [ ] I am following the [Code Style Guidelines](https://github.com/signalapp/Signal-Android/wiki/Code-Style-Guidelines)
|
|
||||||
- [ ] I have tested my contribution on these devices:
|
- [ ] I have tested my contribution on these devices:
|
||||||
* Device A, Android X.Y.Z
|
* Device A, Android X.Y.Z
|
||||||
* Device B, Android Z.Y
|
* Device B, Android Z.Y
|
||||||
|
|||||||
74
BUILDING.md
74
BUILDING.md
@ -1,74 +0,0 @@
|
|||||||
Building Signal
|
|
||||||
===============
|
|
||||||
|
|
||||||
Basics
|
|
||||||
------
|
|
||||||
|
|
||||||
Signal uses [Gradle](http://gradle.org) to build the project and to maintain
|
|
||||||
dependencies. However, you needn't install it yourself; the
|
|
||||||
"gradle wrapper" `gradlew`, mentioned below, will do that for you.
|
|
||||||
|
|
||||||
Building Signal
|
|
||||||
---------------
|
|
||||||
|
|
||||||
The following steps should help you (re)build Signal from the command line.
|
|
||||||
|
|
||||||
1. Checkout the Signal-Android project source with the command:
|
|
||||||
|
|
||||||
git clone https://github.com/signalapp/Signal-Android.git
|
|
||||||
|
|
||||||
2. Make sure you have the [Android SDK](https://developer.android.com/sdk/index.html) installed.
|
|
||||||
3. Ensure that the following packages are installed from the Android SDK manager:
|
|
||||||
* Android SDK Build Tools (see buildToolsVersion in build.gradle)
|
|
||||||
* SDK Platform (All API levels)
|
|
||||||
* Android Support Repository
|
|
||||||
* Google Repository
|
|
||||||
4. Create a local.properties file at the root of your source checkout and add an sdk.dir entry to it. For example:
|
|
||||||
|
|
||||||
sdk.dir=/Application/android-sdk-macosx
|
|
||||||
|
|
||||||
5. Using Java 8
|
|
||||||
|
|
||||||
6. Execute Gradle:
|
|
||||||
|
|
||||||
./gradlew build
|
|
||||||
|
|
||||||
Visual assets
|
|
||||||
----------------------
|
|
||||||
|
|
||||||
Source assets tend to be large binary blobs, which are best stored outside of git repositories. Some source files are SVGs that can be auto-colored and sized using a tool like [android-res-utils](https://github.com/sebkur/android-res-utils).
|
|
||||||
|
|
||||||
Sample command for generating our audio placeholder image:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pngs_from_svg.py ic_audio.svg /path/to/Signal/res/ 150 --color #000 --opacity 0.54 --suffix _light
|
|
||||||
pngs_from_svg.py ic_audio.svg /path/to/Signal/res/ 150 --color #fff --opacity 1.00 --suffix _light
|
|
||||||
```
|
|
||||||
|
|
||||||
Setting up a development environment
|
|
||||||
------------------------------------
|
|
||||||
|
|
||||||
[Android Studio](https://developer.android.com/sdk/installing/studio.html) is the recommended development environment.
|
|
||||||
|
|
||||||
1. Install Android Studio.
|
|
||||||
2. Open Android Studio. On a new installation, the Quickstart panel will appear. If you have open projects, close them using "File > Close Project" to see the Quickstart panel.
|
|
||||||
3. From the Quickstart panel, choose "Configure" then "SDK Manager".
|
|
||||||
4. In the SDK Tools tab of the SDK Manager, make sure that the "Android Support Repository" is installed, and that the latest "Android SDK build-tools" are installed. Click "OK" to return to the Quickstart panel.
|
|
||||||
5. From the Quickstart panel, choose "Checkout from Version Control" then "git".
|
|
||||||
6. Paste the URL for the Signal-Android project when prompted (https://github.com/signalapp/Signal-Android.git).
|
|
||||||
7. Android studio should detect the presence of a project file and ask you whether to open it. Click "yes".
|
|
||||||
9. Default config options should be good enough.
|
|
||||||
9. Project initialisation and build should proceed.
|
|
||||||
|
|
||||||
Contributing code
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
Code contributions should be sent via github as pull requests, from feature branches [as explained here](https://help.github.com/articles/using-pull-requests).
|
|
||||||
|
|
||||||
Mailing list
|
|
||||||
------------
|
|
||||||
|
|
||||||
Development discussion happens on the whispersystems mailing list.
|
|
||||||
[To join](https://lists.riseup.net/www/info/whispersystems)
|
|
||||||
Send emails to whispersystems@lists.riseup.net
|
|
||||||
|
|
||||||
@ -1,89 +0,0 @@
|
|||||||
# Contributing to Signal Android
|
|
||||||
|
|
||||||
Thank you for supporting Signal and looking for ways to help. Please note that some conventions here might be a bit different than what you are used to, even if you have contributed to other open source projects before. Reading this document will help you save time and work effectively with the developers and other contributors.
|
|
||||||
|
|
||||||
|
|
||||||
## Development Ideology
|
|
||||||
|
|
||||||
Truths which we believe to be self-evident:
|
|
||||||
|
|
||||||
1. **The answer is not more options.** If you feel compelled to add a preference that's exposed to the user, it's very possible you've made a wrong turn somewhere.
|
|
||||||
1. **The user doesn't know what a key is.** We need to minimize the points at which a user is exposed to this sort of terminology as extremely as possible.
|
|
||||||
1. **There are no power users.** The idea that some users "understand" concepts better than others has proven to be, for the most part, false. If anything, "power users" are more dangerous than the rest, and we should avoid exposing dangerous functionality to them.
|
|
||||||
1. **If it's "like PGP," it's wrong.** PGP is our guide for what not to do.
|
|
||||||
1. **It's an asynchronous world.** Be wary of anything that is anti-asynchronous: ACKs, protocol confirmations, or any protocol-level "advisory" message.
|
|
||||||
1. **There is no such thing as time.** Protocol ideas that require synchronized clocks are doomed to failure.
|
|
||||||
|
|
||||||
|
|
||||||
## Translations
|
|
||||||
|
|
||||||
Thanks to a dedicated community of volunteer translators, Signal is now available in more than one hundred languages. We use Transifex to manage our translation efforts, not GitHub. Any suggestions, corrections, or new translations should be submitted to the [Signal localization project for Android](https://www.transifex.com/signalapp/signal-android/).
|
|
||||||
|
|
||||||
|
|
||||||
## Issues
|
|
||||||
|
|
||||||
### Useful bug reports
|
|
||||||
1. Please search both open and closed issues to make sure your bug report is not a duplicate.
|
|
||||||
1. Read the [guide to submitting useful bug reports](https://github.com/signalapp/Signal-Android/wiki/Submitting-useful-bug-reports) before posting a bug.
|
|
||||||
|
|
||||||
### The issue tracker is for bugs, not feature requests
|
|
||||||
The GitHub issue tracker is not used for feature requests, but new ideas can be submitted and discussed on the [community forum](https://community.signalusers.org/c/feature-requests). The purpose of this issue tracker is to track bugs in the Android client. Bug reports should only be submitted for existing functionality that does not work as intended. Comments that are relevant and concise will help the developers solve issues more quickly.
|
|
||||||
|
|
||||||
### Send support questions to support
|
|
||||||
You can reach support by sending an email to support@signal.org or by visiting the [Signal Support Center](https://support.signal.org/) where you can also search for existing troubleshooting articles and find answers to frequently asked questions. Please do not post support questions on the GitHub issue tracker.
|
|
||||||
|
|
||||||
### GitHub is not a generic discussion forum
|
|
||||||
Conversations about open bug reports belong here. However, all other discussions should take place on the [community forum](https://community.signalusers.org). You can use the community forum to discuss anything that is related to Signal or to hang out with your fellow users in the "Off Topic" category.
|
|
||||||
|
|
||||||
### Don't bump issues
|
|
||||||
Every time someone comments on an issue, GitHub sends an email to [hundreds of people](https://github.com/signalapp/Signal-Android/watchers). Bumping issues with a "+1" (or asking for updates) generates a lot of unnecessary email notifications and does not help anyone solve the issue any faster. Please be respectful of everyone's time and only comment when you have new information to add.
|
|
||||||
|
|
||||||
### Open issues
|
|
||||||
|
|
||||||
#### If it's open, it's tracked
|
|
||||||
The developers read every issue, but high-priority bugs or features can take precedence over others. Signal is an open source project, and everyone is encouraged to play an active role in diagnosing and fixing open issues.
|
|
||||||
|
|
||||||
### Closed issues
|
|
||||||
|
|
||||||
#### "My issue was closed without giving a reason!"
|
|
||||||
Although we do our best, writing detailed explanations for every issue can be time consuming, and the topic also might have been covered previously in other related issues.
|
|
||||||
|
|
||||||
|
|
||||||
## Pull requests
|
|
||||||
|
|
||||||
### Smaller is better
|
|
||||||
Big changes are significantly less likely to be accepted. Large features often require protocol modifications and necessitate a staged rollout process that is coordinated across millions of users on multiple platforms (Android, iOS, and Desktop).
|
|
||||||
|
|
||||||
Try not to take on too much at once. As a first-time contributor, we recommend starting with small and simple PRs in order to become familiar with the codebase. Most of the work should go into discovering which three lines need to change rather than writing the code.
|
|
||||||
|
|
||||||
### Sign the Contributor License Agreement (CLA)
|
|
||||||
You will need to [sign our CLA](https://signal.org/cla/) before your pull request can be merged.
|
|
||||||
|
|
||||||
### Follow the Code Style Guidelines
|
|
||||||
Ensure that your code adheres to the [Code Style Guidelines](https://github.com/signalapp/Signal-Android/wiki/Code-Style-Guidelines) before submitting a pull request.
|
|
||||||
|
|
||||||
### Submit finished and well-tested pull requests
|
|
||||||
Please do not submit pull requests that are still a work in progress. Pull requests should be thoroughly tested and ready to merge before they are submitted.
|
|
||||||
|
|
||||||
### Merging can sometimes take a while
|
|
||||||
If your pull request follows all of the advice above but still has not been merged, this usually means that the developers haven't had time to review it yet. We understand that this might feel frustrating, and we apologize. The Signal team is still small, but [we are hiring](https://signal.org/workworkwork/).
|
|
||||||
|
|
||||||
|
|
||||||
## How can I contribute?
|
|
||||||
There are several other ways to get involved:
|
|
||||||
* Help new users learn about Signal.
|
|
||||||
* Redirect support questions to support@signal.org and the [Signal Support Center](https://support.signal.org/).
|
|
||||||
* Redirect non-bug discussions to the [community forum](https://community.signalusers.org).
|
|
||||||
* Improve documentation in the [wiki](https://github.com/signalapp/Signal-Android/wiki).
|
|
||||||
* Join the community of volunteer translators on Transifex:
|
|
||||||
* [Android](https://www.transifex.com/signalapp/signal-android/)
|
|
||||||
* [iOS](https://www.transifex.com/signalapp/signal-ios/)
|
|
||||||
* [Desktop](https://www.transifex.com/signalapp/signal-desktop/)
|
|
||||||
* Find and mark duplicate issues.
|
|
||||||
* Try to reproduce issues and help with troubleshooting.
|
|
||||||
* Discover solutions to open issues and post any relevant findings.
|
|
||||||
* Test other people's pull requests.
|
|
||||||
* Contribute to Signal via the [Freedom of the Press Foundation's donation page](https://freedom.press/crowdfunding/signal/).
|
|
||||||
* Share Signal with your friends and family.
|
|
||||||
|
|
||||||
Signal is made for you. Thank you for your feedback and support.
|
|
||||||
Loading…
Reference in New Issue
Block a user