Add a CONTRIBUTING guide

2 files changed, 46 insertions, 0 deletions

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..f3f44ae
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,41 @@
+# Contributing
+
+Thanks for contributing :)
+
+## Building the app
+
+The application doesn't use Gradle and it might be hard to use some features of
+Android Studio.
+
+Fortunately, there's not many dependencies:
+- OpenJDK 8
+- Android SDK: build tools `30.0.3`, platform `30`
+- Make sure to have the `$ANDROID_HOME` environment variable set.
+
+For Nix users, there's a `shell.nix` for setting-up the right environment.
+
+Building the debug apk:
+
+```sh
+make
+```
+
+If the build succeed, the debug apk is located in
+`_build/juloo.keyboard2.debug.apk`.
+
+## Debugging on your phone
+
+You need to have *USB debugging* enabled on your phone, see [Android's doc](https://developer.android.com/studio/debug/dev-options#enable).
+
+It is also possible to enable *ADB over network* in the settings and connect
+with `adb connect <ip of the phone>`. Make sure to be connected to a local
+network that you trust.
+
+Install the application with:
+
+```sh
+make installd
+```
+
+The debug version of the application won't be removed, both versions will stay
+installed at the same time.
diff --git a/README.md b/README.md
index 82eaec6..4423cd6 100644
--- a/README.md
+++ b/README.md
@@ -14,3 +14,8 @@ This can be found in the System Settings > System > Languages & Input > Virtual
 [<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
      alt="Get it on F-Droid"
      height="80">](https://f-droid.org/packages/juloo.keyboard2/)
+
+## Contributing
+
+For instructions on building the application, see
+[Contributing](Contributing.md).