chromium-aw

Chromium based Android WebView engine to be embedded in Ridibooks-Android

Getting started

86.x.x.x-x or later

This library is distributed by GitHub Releases.

You should add de.undercouch.download plugin to build.gradle.kts file of your project.

plugins {
  id("de.undercouch.download") version "4.1.1"
}

Using legacy plugin application:

buildscript {
  repositories {
    maven {
      url = uri("https://plugins.gradle.org/m2/")
    }
  }
  dependencies {
    classpath("de.undercouch:gradle-download-task:4.1.1")
  }
}

apply(plugin = "de.undercouch.download")

Then you can include this library by adding dependency script to build.gradle.kts file of your project.

val version = "93.0.4577.82-1"
val fileName = "chromium-aw-release.aar"
val destPath = "../libs/${fileName}"
val downloadChromiumAwTaskName = "chromium-aw@aar"
tasks.register<de.undercouch.gradle.tasks.download.Download>(downloadChromiumAwTaskName) {
  isEnabled = file(destPath).exists().not()
  src("https://github.com/ridi/chromium-aw/releases/download/${version}/${fileName}")
  dest(destPath)
  overwrite(true)
  onlyIfModified(true)
}
tasks.matching { it.name != downloadChromiumAwTaskName }
  .all { dependsOn(downloadChromiumAwTaskName) }

IMPORTANT : Add following aaptOptions to prevent asset files being compressed.

android {
  ...
  aaptOptions {
    noCompress("bin", "dat", "pak")
  }
  ...
}

Less than 86.x.x.x-x

This library is distributed by jitpack.

You should add jitpack maven repository to build.gradle file of your project.

repositories {
  ...
  maven { url 'https://jitpack.io' }
  ...
}

Then you can include this library by adding dependency script to build.gradle file of your project.

dependencies {
  ...
  compile 'com.github.ridi:chromium-aw:<version>'
  ...
}

IMPORTANT : Add following aaptOptions to prevent asset files being compressed.

android {
  ...
  aaptOptions {
    noCompress 'dat', 'pak'
  }
  ...
}

Usage

See the demo project.

Chromium build information

Current version is based on 93.0.4577.82

Customizing (Patch files are here)

Unix domain socket name prefix for Devtools is changed.
Added snapshot blob for x86/x86_64 arch.

Build instructions

References

Environment install steps

A 64-bit Intel machine running Linux with at least 8GB of RAM. More than 16GB is highly recommended.
At least 100GB of free disk space.
You must have Git and Python installed already.
It takes about 2 hours.

Clone depot_tools.

$ cd ~
$ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git

$ export PATH="$PATH:$HOME/depot_tools"

Clone chromium.

$ mkdir ~/chromium && cd ~/chromium
$ fetch --nohooks android

$ cd src
$ gclient sync

Iinstall additional build dependencies.

$ build/install-build-deps-android.sh

$ gclient runhooks

[Optional] Install ccache.

Improves build speed by ccache when building multiple times.

$ sudo apt install ccache

$ export CCACHE_CPP2=yes
$ export CCACHE_SLOPPINESS=time_macros

$ sed -i -e 's/^max_size = 1.0G/max_size = 10.0G/g' ~/.ccache/ccache.conf

[Optional] Install icecc.

Improves build speed by combine icecc with ccache.

$ sudo apt install icecc

$ mkdir -p /opt/ccache/bin
$ ln -s /usr/bin/ccache /opt/ccache/bin/gcc
$ ln -s /usr/bin/ccache /opt/ccache/bin/g++

$ export CCACHE_PREFIX=icecc
$ export ICECC_CLANG_REMOTE_CPP=1
$ export PATH=$PATH:/opt/ccache/bin

$ sudo sed -i -e 's/^ICECC_MAX_JOBS=""/ICECC_MAX_JOBS="$JOBS"/g' /etc/icecc/icecc.conf # CPU cores * 2 is recommended for $JOBS.
$ sudo service iceccd restart

Build steps

Checkout.

$ cd ~/chromium/src

$ git checkout tags/$VERSION # ex) tags/93.0.4577.82

$ gclient sync

Customizing.

Apply patch files.

Generate target and build.

In this project $TARGET must be one of arm, arm64, x86 and x64.

$ gn gen --args='target_os="android" target_cpu="$TARGET" is_debug=false cc_wrapper="ccache" symbol_level=0 blink_symbol_level=0 enable_nacl=false use_debug_fission=false clang_use_chrome_plugins=false' out/$TARGET

# It takes about 3 hours. (Intel i5-10400, RAM 16GB, WSL2, no-cache, local parallel build, x86 target)
$ ninja -C out/$TARGET webview_instrumentation_apk

Copy build result and sources to chromium-aw.

IMPORTANT : It may be different depending on Chromium version.

$ node ~/chromium-aw/copy.js ~/chromium . # tested on 61 ~ 93.

Build

$ ./gradlew install

Crash dump decoding instructions

References

Decoding Crash Dumps

Environment install steps

$ cd ~
$ mkdir breakpad && cd breakpad
$ fetch breakpad

$ cd src
$ ./configure && make

Decoding steps

Generate symbols file.

$PLATFORM must be one of linux2, darwin, android, and chromeos.

$ cp ~/breakpad/src/src/tools/linux/dump_syms ~/chromium/src/out/$TARGET
$ sudo chmod +x ~/chromium/src/out/$TARGET/dump_syms

$ cd ~/chromium/src
$ components/crash/content/tools/generate_breakpad_symbols.py --build-dir=out/$TARGET --symbols-dir=/tmp/chromium --binary=out/$TARGET/lib.unstripped/libstandalonelibwebviewchromium.so --platform=$PLATFORM --clear --verbose

Decoding minidump file.

$ cp ~/breakpad/src/src/processor/minidump_stackwalk ~/chromium
$ sudo chmod +x ~/chromium/minidump_stackwalk

$ cd ~/chromium
$ ./minidump_stackwalk $DMP_FILE_PATH /tmp/chromium > /tmp/decoded_dmp_file.crash

License

See LICENSE file from Chromium project.

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

ridi / chromium-aw

Programming Languages

Labels

Projects that are alternatives of or similar to chromium-aw

chromium-aw

Getting started

86.x.x.x-x or later

Less than 86.x.x.x-x

Usage

Chromium build information

Customizing (Patch files are here)

Build instructions

References

Environment install steps

Build steps

Crash dump decoding instructions

References

Environment install steps

Decoding steps

License