You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
72 lines
2.5 KiB
72 lines
2.5 KiB
4 months ago
|
# Treble build tools
|
||
|
|
|
||
|
|
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.
|