README.md

   1 Anbox-halium
   2 ===========
   3
   4 Getting started
   5 ---------------
   6
   7 To get started with Android/LineageOS, you'll need to get
   8 familiar with [Repo](https://source.android.com/source/using-repo.html) and [Version Control with Git](https://source.android.com/source/version-control.html).
   9
  10 To initialize your local repository using the LineageOS trees, use a command like this:
  11 ```
  12 repo init -u git://github.com/LineageOS/android.git -b lineage-17.1
  13 ```
  14 Add anbox manifest:
  15 ```
  16 wget https://raw.githubusercontent.com/Anbox-halium/anbox-halium/lineage-17.1/anbox.xml -P .repo/local_manifests/
  17 ```
  18 Then to sync up:
  19 ```
  20 repo sync
  21 ```
  22 Then to apply anbox patches:
  23 ```
  24 anbox-patches/apply-patches.sh --mb
  25 ```
  26
  27 How to build
  28 ---------------
  29 Please see the [LineageOS Wiki](https://wiki.lineageos.org/) for building environment setup.
  30
  31 To build anbox:
  32 ```
  33 . build/envsetup.sh
  34 lunch lineage_anbox_arm64-userdebug
  35 make systemimage -j$(nproc --all)
  36 make vendorimage -j$(nproc --all)
  37 ```
  38
  39 How to install
  40 ---------------
  41 Execute command blew:
  42 ```
  43 wget -O - https://github.com/Anbox-halium/anbox-halium/raw/lineage-17.1/scripts/install.sh | bash
  44 ```
  45 Note: Run installer on the user you are willing to install anbox on
  46
  47 Patching kernel
  48 ---------------
  49 Running anbox requires:
  50 * Veth for networking
  51 * Ashmem
  52 * Specific binder nodes (anbox-binder anbox-hwbinder anbox-vndbinder)
  53 Checkout defconfig kernel patcher [script](https://github.com/Anbox-halium/anbox-halium/blob/lineage-17.1/scripts/check-kernel-config.sh) for patching halium devices kernel.
  54 ```
  55 check-kernel-config.sh halium_device_defconfig -w
  56 ```
  57 On mainline devices it is highly recommanded to use needed drivers as module. (binder_linux and ashmem_linux)