File: android.md

package info (click to toggle)
wpewebkit 2.50.4-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 438,288 kB
  • sloc: cpp: 3,777,429; javascript: 197,888; ansic: 156,951; python: 49,118; asm: 21,987; ruby: 18,540; perl: 16,722; xml: 4,623; yacc: 2,360; sh: 2,096; java: 2,019; lex: 1,327; pascal: 366; makefile: 92
file content (57 lines) | stat: -rw-r--r-- 2,161 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
Title: Android Support
Slug: android

WPE WebKit supports running on [Android](https://www.android.com), which is
considerably different from other Linux-based systems.

## Building 

Compiling WPE WebKit for Android requires a suitable toolchain configured
to use a “sysroot” which includes the needed dependencies—including
their development files.

Currently, the preferred method to build WPE WebKit for Android is using
[wpe-android-cerbero](https://github.com/Igalia/wpe-android-cerbero/). This is
a fork of the [Cerbero](https://gitlab.freedesktop.org/gstreamer/cerbero/)
build system used to cross-compile the GStreamer multimedia libraries for a
number of targets—Android included—, with the needed changes to compile WPE
WebKit. Note that this produces the *native* libraries that are part of a
WebKit build, and their *native* dependencies.


## View Widget

A web view widget that integrates with the Android
[View](https://developer.android.com/reference/android/view/View)-based GUI
toolkit and may be used as part of an application written in Java™ or Kotlin
is provided by the separate
[WPE Android](https://github.com/Igalia/wpe-android) project.

Prebuilt packages produced by the WPE Android project are readily available
as
[org.wpewebkit.wpeview](https://central.sonatype.com/artifact/org.wpewebkit.wpeview/wpeview)
at the [Maven Central](https://central.sonatype.com/) repository. Using these
package is the recommended way of using WPE WebKit to develop Android
applications that embed WPE WebKit web views.


## Logging

WPE WebKit integrates with the Android `logd` system service, and uses
the `WPEWebKit` tag. This means that logging is configured using system
properties, and `logcat` may be used to read log entries:

```sh
adb shell setprop log.tag.WPEWebKit VERBOSE
adb logcat -s WPEWebKit
```

The `WEBKIT_DEBUG` [environment variable](environment.html) is replaced by the
`debug.log.WPEWebKit` system property to configure logging channels:

```sh
adb shell setprop debug.log.WPEWebKit 'Process,Media=error'
```

Using the `persist.` prefix may be added to system properties to store
settings across device reboots.