Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mogoweb/chromium_webview

Android WebView wrapper based on chromium
https://github.com/mogoweb/chromium_webview

Last synced: 2 months ago
JSON representation

Android WebView wrapper based on chromium

Host: GitHub
URL: https://github.com/mogoweb/chromium_webview
Owner: mogoweb
License: bsd-3-clause
Created: 2013-05-28T01:39:48.000Z (over 11 years ago)
Default Branch: master
Last Pushed: 2015-11-24T14:42:13.000Z (about 9 years ago)
Last Synced: 2023-11-07T15:16:57.144Z (about 1 year ago)
Language: Java
Homepage: http://mogoweb.github.com
Size: 224 MB
Stars: 517
Watchers: 57
Forks: 160
Open Issues: 14
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-android-ui - https://github.com/mogoweb/chromium_webview

README

ChromiumWebView
================

Android WebView wrapper based on chromium

## Notice

This is just a experimental project, don't use it in product.

If you have problem when git pull, please re-clone this repository. I updated the commits information in 06/19/2014.

## Why you need

The current performance of Android webview is so poor. ChromiumWebView gives your
application early access to the newest features in Chromium, and removes the
variability due to different WebView implementations in different versions of
Android.

Inspired by [ChromeView project](https://github.com/pwnall/chromeview), our
goal is to provide full Android WebKit compatible API, so the web apps or
hybrid apps can easily immigrate to chromium.

You can use ChromiumWebView as the same as Android WebView except for different
package name.

## TintBrowser

The [TintBrowser](https://github.com/mogoweb/TintBrowser) is forked from [https://github.com/Anasthase/TintBrowser](https://github.com/Anasthase/TintBrowser), but use Chromium WebView as web engine. The TintBrowser is a full functional browser that you can use it as start point.

## Setting Up

This section explains how to set up your Android project to use ChromiumWebView.

### Get the Code

Check out the repository in your Eclipse workspace, and make your project use
ChromiumWebView as a library. In Eclipse, right-click your project directory,
select `Properties`, choose the `Android` category, and click on the `Add` button
in the `Library` section.

### Copy Data

Copy `assets/webviewchromium.pak` to your project's `assets` directory. [Star
this bug](https://code.google.com/p/android/issues/detail?id=35748) if you
agree that this is annoying.

### TestShell

There is a sample project to illustrate the usage of ChromiumWebView
in the test folder. It is only a shell program that can navigate website.

## How to build libchromeview

A [blog](http://mogoweb.github.io/blog/2014/06/19/about-source-management-of-chromium-webview/) describes the source management of chromium which ChromiumWebView based on. It is written in chinese.

### Environment

1. Please set up your build environment by following the instructions on the Chromium wiki:
* [Building on Linux](http://code.google.com/p/chromium/wiki/LinuxBuildInstructionsPrerequisites)
2. You need to install extra pre-requisites to build for Android, covered in [building Chrome for Android](http://code.google.com/p/chromium/wiki/AndroidBuildInstructions#Install_prerequisites).
3. [depot_tools](http://www.chromium.org/developers/how-tos/install-depot-tools) contains the following tools, used to manage and build libchromeview from source:
* *gclient* manages code and dependencies.
* *ninja* is the recommended tool for building libchromeview on Android. Its [website](http://code.google.com/p/chromium/wiki/NinjaBuild) contains detailed usage instructions.

### Download the source

1. Create a source directory:

```
cd
mkdir chromium-src
cd chromium-src
```
2. Auto-generate gclient's configuration file (.gclient):

```
gclient config --name=src/chromeview git://github.com/mogoweb/chromium_webview.git
```
You can replace git:// with ssh://git@ to use your GitHub credentials when checking out the code.
3. From the same directory containing the .gclient file, fetch the source with:

```
gclient sync
```

### Building libchromium_webview

1. Setup build environment

```
cd chromium-src
source ./chromeview/build/envsetup.sh
mogo_gyp
```
2. build libchromeview

```
ninja -C out/Debug libchromeview -j8
```

## Copyright and License

The directories below contain code from the
[The Chromium Project](http://www.chromium.org/), which is subject to the
copyright and license on the project site.

* `assets/`
* `libs/`
* `src/com/googlecode`
* `src/org/chromium`

Some of the source code in `src/com/mogoweb/chrome` has been derived from the
Android source code, and is therefore covered by the
[Android project licenses](http://source.android.com/source/licenses.html).