| 1 |
/* |
| 2 |
* libwebsockets Android client - libwebsockets test application for Android |
| 3 |
* |
| 4 |
* Copyright (C) 2016 Alexander Bruines <[email protected]> |
| 5 |
* |
| 6 |
* This file is made available under the Creative Commons CC0 1.0 |
| 7 |
* Universal Public Domain Dedication. |
| 8 |
* |
| 9 |
* The person who associated a work with this deed has dedicated |
| 10 |
* the work to the public domain by waiving all of his or her rights |
| 11 |
* to the work worldwide under copyright law, including all related |
| 12 |
* and neighboring rights, to the extent allowed by law. You can copy, |
| 13 |
* modify, distribute and perform the work, even for commercial purposes, |
| 14 |
* all without asking permission. |
| 15 |
* |
| 16 |
* The test apps are intended to be adapted for use in your code, which |
| 17 |
* may be proprietary. So unlike the library itself, they are licensed |
| 18 |
* Public Domain. |
| 19 |
*/ |
| 20 |
|
| 21 |
This directory contains an Android Studio (2.1.1) project that builds |
| 22 |
libwebsockets (+ openssl + zlib) and an Android application that is able |
| 23 |
to connect to the 'dumb-increment-protocol' of the libwebsockets test server. |
| 24 |
|
| 25 |
Building the native libraries requires the Android NDK which can be |
| 26 |
installed using the SDK manager. |
| 27 |
|
| 28 |
The app/src/main/jni/NativeLibs.mk is fully integraded with Gradle but will |
| 29 |
only work on Linux and requires the following applications to be available |
| 30 |
in addition to the NDK: |
| 31 |
|
| 32 |
awk cmake egrep git tar wget makedepend |
| 33 |
|
| 34 |
(makedepend can be installed from (Debian) xutils-dev) |
| 35 |
|
| 36 |
To build the project: |
| 37 |
|
| 38 |
- Open an 'existing project' with Android Studio and select this directory. |
| 39 |
(answer yes/ok to the question to integrate with Gradle). |
| 40 |
|
| 41 |
- Open the file app/src/main/jni/Application.mk and make sure NDK_ROOT |
| 42 |
is set correctly and that APP_PLATFORM is set to the appropriate API level. |
| 43 |
|
| 44 |
- Build the project with CTRL+F9 |
| 45 |
(open the gradle console to follow the build progress). |
| 46 |
|
| 47 |
- Install APK to device and run. |
| 48 |
|
| 49 |
- Connect to libwebsockets test server. |
| 50 |
|
| 51 |
|