• Home
  • History
  • Annotate
Name
Date
Size
#Lines
LOC

..--

sandbox/23-Nov-2023-1,3201,046

Android.bpD23-Nov-20231.2 KiB4340

README.mdD23-Nov-20232.5 KiB7251

TEST_MAPPINGD23-Nov-202394 98

__init__.pyD23-Nov-20230 10

sample_test.pyD23-Nov-2023729

test.pyD23-Nov-2023967 3414

test.shD23-Nov-2023620 213

test.xmlD23-Nov-2023955 227

README.md

1 # Treble build tools
2 
3 Tools for building the Android Platform.
4 
5 [TOC]
6 
7 ## Testing
8 
9 To run all project tests:
10 
11 ```
12 ./test.sh
13 ```
14 
15 ## Filesystem overlays
16 
17 Downstream consumers of the Android platform often create independent Android
18 branches for each device.
19 
20 We can unify the development of all devices on the same Android Platform dessert
21 with the help of filesystem overlays.
22 
23 For example, let's say we had two devices: Device A and Device B.
24 The filesystem overlays would create the following build time views.
25 
26 ```
27 +-------------------------------+ +--------------------------------------------+
28 |         Android repo          | |                Android repo                |
29 |          workspace            | |                 workspace                  |
30 |                               | |                                            |
31 | +--------------+              | | +----------------------------------------+ |
32 | | +----------+ | +----------+ | | | +----------+  +----------+             | |
33 | | | Platform | | | Device B | | | | | Platform |  | Device B |   Device B  | |
34 | | | projects | | | projects | | | | | projects |  | projects |  build view | |
35 | | +----------+ | +----------+ | | | +----------+  +----------+             | |
36 | |              |              | | +----------------------------------------+ |
37 | | +----------+ |              | |   +----------+                             |
38 | | | Device A | |              | |   | Device A |                             |
39 | | | projects | |              | |   | projects |                             |
40 | | +----------+ |              | |   +----------+                             |
41 | |              |              | +--------------------------------------------+
42 | |   Device A   |              |
43 | |  build view  |              |
44 | |              |              |
45 | +--------------+              |
46 +-------------------------------+
47 ```
48 
49 To support filesystem overlays the Android repo workspace is required to the
50 following structure.
51 
52 ### Root directory
53 
54 Location: `${ANDROID_BUILD_TOP}`
55 
56 All projects in the root directory that are not in the overlays
57 directory are shared among all Android targets.
58 
59 ### Overlays directory
60 
61 Location: `${ANDROID_BUILD_TOP}/overlays`
62 
63 Contains target specific projects. Each subdirectory under the overlays
64 directory can be mounted at the root directory to support different targets.
65 
66 ### Build out directory
67 
68 Location: `${ANDROID_BUILD_TOP}/out`
69 
70 Contains all files generated during a build. This includes target files
71 like system.img and host tools like adb.
72