1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
# Bitmask Android App
This repository contains the source code for the [Bitmask](https://bitmask.net/) Android app.
Please see the [issues](https://github.com/leapcode/bitmask_android/issues) section to
report any bugs or feature requests and to see the list of known issues.
## License
* [See LICENSE file](https://github.com/leapcode/bitmask_android/blob/master/LICENSE.txt)
## Build Requirements
Install from developer.android.com:
* Android SDK, API 17: http://developer.android.com/sdk/index.html
* Android NDK, r9d: http://developer.android.com/tools/sdk/ndk/index.html
Make sure add the necessary android tools to your bin path. For example, assuming you installed
the SDK and NDK to `~/dev` on a linux machine, you would add this to your path:
~/dev/android-sdk-linux/tools
~/dev/android-sdk-linux/platform-tools
~/dev/android-ndk-r9d
Installable via `android` command (SDK Manager):
* Android SDK Build-tools, 19.0.3
* Android Support Repository, 4+
We need Mercurial:
* Mercurial: http://mercurial.selenic.com/downloads
Finally, install a java compiler. For example:
sudo apt-get install default-jdk
### Build native sources
To build NDK sources, you need to issue these commands:
cd app
./build-native.sh
cd .. (to get back to the project directory)
### Compiling from the command line
#### Signed APK
If you want to release a signed APK, you'll have to create a gradle.properties file in the project root with the following structure:
storeFileProperty=fullPath
storePasswordProperty=store password without quotation marks
keyAliasProperty=key alias without quotation marks
keyPasswordProperty=key password without quotation marks
#### Actual command
./gradlew build
The resulting apk(s) will be in `app/build/apk`.
### Using Android Studio
* `Import project` => select bitmask_android top folder
## Acknowledgements
This project bases its work in [ics-openvpn project](https://code.google.com/p/ics-openvpn/).
## Contributing
Please fork this repository and contribute back using
[pull requests](https://github.com/leapcode/leap_android/pulls).
Our preferred method for receiving translations is our [Transifex project](https://www.transifex.com/projects/p/bitmask-android).
Any contributions, large or small, major features, bug fixes, additional
language translations, unit/integration tests are welcomed and appreciated
but will be thoroughly reviewed and discussed.
|
