Tools for building the Android Platform.
[TOC]
Testing
To run all project tests:
./test.sh
Filesystem overlays
Downstream consumers of the Android platform often create independent Android
branches for each device.
We can unify the development of all devices on the same Android Platform dessert
with the help of filesystem overlays.
For example, let's say we had two devices: Device A and Device B.
The filesystem overlays would create the following build time views.
+-------------------------------+ +--------------------------------------------+
| Android repo | | Android repo |
| workspace | | workspace |
| | | |
| +--------------+ | | +----------------------------------------+ |
| | +----------+ | +----------+ | | | +----------+ +----------+ | |
| | | Platform | | | Device B | | | | | Platform | | Device B | Device B | |
| | | projects | | | projects | | | | | projects | | projects | build view | |
| | +----------+ | +----------+ | | | +----------+ +----------+ | |
| | | | | +----------------------------------------+ |
| | +----------+ | | | +----------+ |
| | | Device A | | | | | Device A | |
| | | projects | | | | | projects | |
| | +----------+ | | | +----------+ |
| | | | +--------------------------------------------+
| | Device A | |
| | build view | |
| | | |
| +--------------+ |
+-------------------------------+
To support filesystem overlays the Android repo workspace is required to the
following structure.
Root directory
Location: ${ANDROID_BUILD_TOP}
All projects in the root directory that are not in the overlays
directory are shared among all Android targets.
Overlays directory
Location: ${ANDROID_BUILD_TOP}/overlays
Contains target specific projects. Each subdirectory under the overlays
directory can be mounted at the root directory to support different targets.
Build out directory
Location: ${ANDROID_BUILD_TOP}/out
Contains all files generated during a build. This includes target files
like system.img and host tools like adb.