Debian Codegraph @

test-apps/android/README

raw
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