jyapayne/anbox
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge branch 'master' of https://github.com/anbox/anbox

Browse source
This commit is contained in:
Scott Edwards 2017-06-09 13:54:11 -07:00
commit ec926d13ae
112 changed files with 2167 additions and 525 deletions
Download patch file Download diff file Expand all files Collapse all files

30
README.md
View file

@ -1,18 +1,23 @@
[![Snap Status](https://build.snapcraft.io/badge/anbox/anbox.svg)](https://build.snapcraft.io/user/anbox/anbox)
[![Build Status](https://travis-ci.org/anbox/anbox.svg?branch=master)](https://travis-ci.org/anbox/anbox)
# Anbox
Anbox is container based approach to boot a full Android system on a
regular GNU Linux system like Ubuntu.
Anbox is a container-based approach to boot a full Android system on a
regular GNU/Linux system like Ubuntu. In other words: Anbox will let
you run Android on your Linux system without the slowness of
virtualization.
## Overview
Anbox uses Linux namespaces (user, pid, uts, net, mount, ipc) to run a
full Android system in a container and provide Android applications on
any GNU Linux based platform.
any GNU/Linux-based platform.
The Android inside the container has no direct access to any hardware.
All hardware access is going through the anbox daemon on the host. We're
reusing what Android implemented within the QEMU based emulator for Open
GL ES accelerated rendering. The Android system inside the container uses
reusing what Android implemented within the QEMU-based emulator for OpenGL
ES accelerated rendering. The Android system inside the container uses
different pipes to communicate with the host system and sends all hardware
access commands through these.
@ -128,8 +133,8 @@ $ sudo apt install build-essential cmake cmake-data debhelper dbus google-mock \
libboost-program-options-dev libboost-system-dev libboost-test-dev \
libboost-thread-dev libcap-dev libdbus-1-dev libdbus-cpp-dev libegl1-mesa-dev \
libgles2-mesa-dev libglib2.0-dev libglm-dev libgtest-dev liblxc1 \
libproperties-cpp-dev libprotobuf-dev libsdl2-dev lxc-dev pkg-config \
protobuf-compiler
libproperties-cpp-dev libprotobuf-dev libsdl2-dev libsdl2-image-dev lxc-dev \
pkg-config protobuf-compiler
```
Afterwards you can build Anbox with
@ -172,14 +177,11 @@ Running Anbox from a local build requires a few more things you need to know
about. Please have a look at the ["Runtime Setup"](docs/runtime-setup.md)
documentation.
An alias will save typing later.
```
$ alias android='anbox launch --package=org.anbox.appmgr --component=org.anbox.appmgr.AppViewActivity'
$ alias android >> ~/.bashrc
$ android
$ anbox launch --package=org.anbox.appmgr --component=org.anbox.appmgr.AppViewActivity'
```
## documentation
## Documentation
You will find additional documentation for Anbox in the *docs* subdirectory
of the project source.
@ -196,7 +198,7 @@ If you have found an issue with Anbox, please [file a bug](https://github.com/an
## Get in Touch
If you want to get in contact with the developers please feel free to join the
*#anbox* IRC channel on [FreeNode](https://freenode.net/).
*#anbox* IRC channel on [Freenode](https://freenode.net/).
## Copyright and Licensing
@ -204,5 +206,5 @@ Anbox reuses code from other projects like the Android QEMU emulator. These
projects are available in the external/ subdirectory with the licensing terms
included.
The anbox source itself, if not stated differently in the relevant source files,
The Anbox source itself, if not stated differently in the relevant source files,
is licensed under the terms of the GPLv3 license.