Android/Building: Difference between revisions

Latest revision as of 09:26, 5 August 2015

How to build an Android and OLPC OS dual-boot image for XO-4.

Ingredients

a well connected development system,
about 20 GB of download capability,

Method

set up a build environment, see Initializing a Build Environment,
install Repo, by following only the Installing Repo section of the Downloading the Source guide,
use Repo to download the Android source from OLPC repositories,

$ repo init -u git://dev.laptop.org/users/ben/android_manifest -b android-4.3.1-xo4
$ repo sync

if you would like to include google services, download developer package from here gapps. See also Google Apps

The Google Apps packages are NOT SUPPORTED in any way by OLPC.

$ tar -zxvf gapps.tar.gz
$ mv gapps vendor/olpc/xo4/

start the build:

$ . build/envsetup.sh
$ lunch 14
$ make installclean && make -j8 && make userdatatarball

(the 14 means to build engineer version ... use command "lunch" to list all the build options, Android/Building/Variants)
(the -j8 means to run eight concurrent threads of build ... the number of threads should be chosen according to how many CPU cores your build environment has access to.)

install the android-tools-fsutils package or ensure you have simg2img tools in your /usr/bin/ simg2img
create zd file:

Android only image

$ cd vendor/olpc/xo4/mkzd
$ sudo ./mkzd.sh

Combine Android with Sugar

ensure you have a copy of the OLPC OS Linux, Sugar and Gnome build file, e.g. 32014o4.zd,

$ cd vendor/olpc/xo4/sugar-combiner
$ make
$ sudo ./mkzd.sh

Alternative Method

To merge an already published Android build with an already published OLPC OS derived build:

download the system.img, ramdisk.img, and kernel files from the Android build directory,
download the build derived from OLPC OS, e.g. 41008o4.zd or 4_0b125.zd,
download the mkzd.sh tool (from http://dev.laptop.org/git/users/ben/android_vendor_olpc_xo4/ ), and edit it to match file names,
run mkzd.sh

Using an Android build before 2015 on XO-4 produced in 2015 requires a special kernel, contact OLPC for details.

Source code

source code for building Android is a combination of 4 parts.

OLPC Android kernel for XO4 Android/Kernel

You can also download kernel image form latest kernel if you don't want to change kernel

source code from google AOSP project branch "android-4.3.1_r1". "Downloading the Source" guide
OLPC patches for AOSP project.

manifest	git repository
frameworks/av	git repository
frameworks/base	git repository
frameworks/native	git repository
system/core	git repository
hardware/libhardware	git repository
hardware/libhardware_legacy	git repository
hardware/marvell	git repository
build	git repository
bionic	git repository
external/bluetooth/bluedroid	git repository
external/kernel-headers	git repository
external/webkit	git repository
packages/apps/Calendar	git repository
packages/apps/Gallery2	git repository
packages/apps/Launcher2	git repository
packages/providers/CalendarProvider	git repository

source code from vendor, Marvell and OLPC

vendor/marvell/generic	git repository
vendor/marvell/external	git repository
vendor/olpc/xo4	git repository
device/olpc/xo4	git repository
device/olpc/xo4-kernel	git repository

@@ Line 4: / Line 4: @@
 * a well connected development system,
-* about 20 GB of download capability,
+* about 20 GB<!-- observed 14.6 GB on 2014-07-22 --> of download capability,
 == Method ==
-* set up a build environment, see [https://source.android.com/source/initializing.html Initializing a Build Environment],
+* set up a build environment, see [http://source.android.com/source/initializing.html Initializing a Build Environment],
 * install Repo, by following only the [http://source.android.com/source/downloading.html#installing-repo Installing Repo] section of the Downloading the Source guide,
 * use Repo to download the Android source from OLPC repositories,
  $ repo init -u git://dev.laptop.org/users/ben/android_manifest -b android-4.3.1-xo4
  $ repo sync
+* if you would like to include google services, download developer package from here [http://dev.laptop.org/~ben/gapps.tar.gz gapps]. See also [http://wiki.cyanogenmod.org/w/Google_Apps Google Apps]
-* go to [[#Source code]] see what patches are applied to which repository and check source code before start the build.
+:* The Google Apps packages are NOT SUPPORTED in any way by OLPC.
-:* Why? (And therefore, how?) --[[User:Quozl|Quozl]] 05:58, 21 July 2014 (UTC)
+ $ tar -zxvf gapps.tar.gz
+ $ mv gapps vendor/olpc/xo4/
 * start the build:
  $ . build/envsetup.sh
  $ lunch 14
- $ make installclean && make -j8
+ $ make installclean && make -j8 && make userdatatarball
+:*(the 14 means to build engineer version ... use command "lunch" to list all the build options, [[Android/Building/Variants]])
-* ensure you have simg2img tools in your /usr/bin/ [http://dev.laptop.org/~ben/simg2img simg2img]
+:*(the -j8 means to run eight concurrent threads of build ... the number of threads should be chosen according to how many CPU cores your build environment has access to.)
-* start to create zd file:
+* install the {{code|android-tools-fsutils}} package or ensure you have simg2img tools in your /usr/bin/ [http://dev.laptop.org/~ben/simg2img simg2img]
+* create zd file:
 === Android only image ===
  $ cd vendor/olpc/xo4/mkzd
- $ ./mkzd.sh
+ $ sudo ./mkzd.sh
 === Combine Android with Sugar ===
-* ensure you have a copy of the OLPC OS Linux, Sugar and Gnome build file, e.g. 32013o4.zd,
+* ensure you have a copy of the OLPC OS Linux, Sugar and Gnome build file, e.g. 32014o4.zd,
  $ cd vendor/olpc/xo4/sugar-combiner
- $ ./mkzd.sh
+ $ make
+ $ sudo ./mkzd.sh
 == Alternative Method ==
@@ Line 36: / Line 41: @@
 To merge an already published Android build with an already published OLPC OS derived build:
 * download the system.img, ramdisk.img, and kernel files from the Android [http://build.laptop.org/android/latest/ build directory],
-* download the build derived from OLPC OS, e.g. 32013xx4.zd or 4_0b125.zd,
+* download the build derived from OLPC OS, e.g. 41008o4.zd or 4_0b125.zd,
-* download the mkzd.sh tool, and edit it to match file names,
+* download the mkzd.sh tool (from http://dev.laptop.org/git/users/ben/android_vendor_olpc_xo4/ ), and edit it to match file names,
 * run mkzd.sh
+Using an Android build before 2015 on XO-4 produced in 2015 requires a special kernel, contact OLPC for details.
 == Source code ==
@@ Line 45: / Line 52: @@
 * OLPC Android kernel for XO4 [[Android/Kernel]]
-:* You can also download kernel image form [http://dev.laptop.org/git/users/ben/android_device_olpc_xo4-kernel/ device/olpc/xo4-kernel] git repository if you don't want to change kernel
+:* You can also download kernel image form [http://build.laptop.org/android/latest/kernel latest kernel] if you don't want to change kernel
 * source code from google AOSP project branch "android-4.3.1_r1". [http://source.android.com/source/downloading.html "Downloading the Source" guide]
 * OLPC patches for AOSP project.
 {| border="1" align="center" cellpadding="6" textAlign="left"
+|-  align="center"
+|<div style="text-align: left; direction: ltr; margin-left: 1em;">manifest</div>
+|[http://dev.laptop.org/git/users/ben/android_manifest/log/?h=android-4.3.1-xo4 git repository]
 |-  align="center"
 |<div style="text-align: left; direction: ltr; margin-left: 1em;">frameworks/av</div>
@@ Line 103: / Line 113: @@
 {| border="1" align="center" cellpadding="6"
 |<div style="text-align: left; direction: ltr; margin-left: 1em;">vendor/marvell/generic</div>
-|[http://dev.laptop.org/git/users/ben/android_vendor_marvell_generic/ git repository (not available)]
+|[http://dev.laptop.org/git/users/ben/android_vendor_marvell_generic/log/?h=android-4.3.1-xo4 git repository]
 |-
 |<div style="text-align: left; direction: ltr; margin-left: 1em;">vendor/marvell/external</div>
-|[http://dev.laptop.org/git/users/ben/android_vendor_marvell_external/ git repository (not available)]
+|[http://dev.laptop.org/git/users/ben/android_vendor_marvell_external/log/?h=android-4.3.1-xo4 git repository]
 |-  align="center"
 |<div style="text-align: left; direction: ltr; margin-left: 1em;">vendor/olpc/xo4</div>
-|[http://dev.laptop.org/git/users/ben/android_vendor_olpc_xo4/ git repository]
+|[http://dev.laptop.org/git/users/ben/android_vendor_olpc_xo4/log/?h=android-4.3.1-xo4 git repository]
 |-  align="center"
 |<div style="text-align: left; direction: ltr; margin-left: 1em;">device/olpc/xo4</div>
-|[http://dev.laptop.org/git/users/ben/android_device_olpc_xo4/ git repository]
+|[http://dev.laptop.org/git/users/ben/android_device_olpc_xo4/log/?h=android-4.3.1-xo4 git repository]
 |-  align="center"
 |<div style="text-align: left; direction: ltr; margin-left: 1em;">device/olpc/xo4-kernel</div>
-|[http://dev.laptop.org/git/users/ben/android_device_olpc_xo4-kernel/ git repository]
+|[http://dev.laptop.org/git/users/ben/android_device_olpc_xo4-kernel/log/?h=android-4.3.1-xo4 git repository]
 |}
@@ Line 123: / Line 133: @@
 * [[Android]]
 * [[Android/Kernel]]
+* [[Android/Building/Variants]]
+* [[Android/Building/SystemAPPs]]

Android/Building: Difference between revisions

Latest revision as of 09:26, 5 August 2015

Contents

Ingredients

Method

Android only image

Combine Android with Sugar

Alternative Method

Source code

See Also

Navigation menu

Android/Building: Difference between revisions

Latest revision as of 09:26, 5 August 2015

Ingredients

Method

Android only image

Combine Android with Sugar

Alternative Method

Source code

See Also

Navigation menu

Search