mirror of
https://github.com/oxen-io/session-android.git
synced 2024-11-23 18:15:22 +00:00
72 lines
2.5 KiB
Markdown
72 lines
2.5 KiB
Markdown
Building TextSecure
|
|
=====================
|
|
|
|
Basics
|
|
------
|
|
|
|
TextSecure uses [Gradle](http://gradle.org) to build the project and to maintain
|
|
dependencies.
|
|
|
|
Building TextSecure
|
|
-------------------
|
|
|
|
The following steps should help you (re)build TextSecure from the command line.
|
|
|
|
1. Checkout the source somewhere on your filesystem with
|
|
|
|
git clone https://github.com/WhisperSystems/TextSecure.git
|
|
|
|
2. Make sure you have the [Android SDK](https://developer.android.com/sdk/index.html) installed somewhere on your system.
|
|
3. Ensure that the following packages are installed from the Android SDK manager:
|
|
* Android SDK Build Tools
|
|
* SDK Platform
|
|
* 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.
|
|
|
|
sdk.dir=\<path to your sdk installation\>
|
|
|
|
5. Execute Gradle:
|
|
|
|
./gradlew build
|
|
|
|
Re-building native components
|
|
-----------------------------
|
|
|
|
Note: This step is optional; native components are contained as binaries (see [libaxolotl/libs](libaxolotl/libs)).
|
|
|
|
1. Ensure that the Android NDK is installed.
|
|
|
|
Execute ndk-build:
|
|
|
|
cd libaxolotl
|
|
ndk-build
|
|
|
|
Afterwards, execute Gradle as above to re-create the APK.
|
|
|
|
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. Make sure the "Android Support Repository" is installed in the Android Studio SDK.
|
|
3. Make sure the latest "Android SDK build-tools" is installed in the Android Studio SDK.
|
|
4. Create a new Android Studio project. from the Quickstart pannel (use File > Close Project to see it), choose "Checkout from Version Control" then "git".
|
|
5. Paste the URL for the TextSecure project when prompted (https://github.com/WhisperSystems/TextSecure.git).
|
|
6. Android studio should detect the presence of a project file and ask you whether to open it. Click "yes".
|
|
7. Default config options should be good enough.
|
|
8. 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
|