forked from extern/Unexpected-Keyboard
Add a CONTRIBUTING guide
This commit is contained in:
parent
f22d040eda
commit
d4eef00a8a
41
CONTRIBUTING.md
Normal file
41
CONTRIBUTING.md
Normal file
@ -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.
|
@ -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"
|
[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
|
||||||
alt="Get it on F-Droid"
|
alt="Get it on F-Droid"
|
||||||
height="80">](https://f-droid.org/packages/juloo.keyboard2/)
|
height="80">](https://f-droid.org/packages/juloo.keyboard2/)
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
For instructions on building the application, see
|
||||||
|
[Contributing](Contributing.md).
|
||||||
|
Loading…
Reference in New Issue
Block a user