Full source and bytecode Eclipse projects of various Android releases suitable for analyzing with Atlas. Additionally some projects have PScout mapping results.
Android releases should be referred to by their official branch names. See https://source.android.com/source/build-numbers.html.
- Set up the build environment according to Google's instructions.
See https://source.android.com/source/building.html.
- Clone Android's repository to the desired tag state
Set up to track the desired branch (replace android-4.4.4_r1 with your desired release)
repo init -u https://android.googlesource.com/platform/manifest -b android-4.4.4_r1
Pull down remote source and any changes for all projects on branch
repo sync
Check out a release tag for all projects (replace android-4.4.4_r1 with your desired release)
repo forall -c 'git checkout tags/android-4.4.4_r1'
- Configure to build for the target environment using production mode
Put important scripts on the path
source build/envsetup.sh
Configure for target device (may be different for your release, but -user option should be used if possible)
lunch aosp_arm-user
-
Create a fake javac binary and put it on the path to spy on the build process. The big picture: look at what sources the build is asking to compile, copy them over into a separate spy directory, then allow the real javac to actually compile source.
-
Build Android with spying enabled
Parallel Build (replace 24 with the number of cores you wish to dedicate to the build) make -j24
-
Utilize Tom's OrganizeJava tool to crawl through the captured source and organize it in a unified folder structure
-
Copy the organized source into an empty Eclipse Java project. Delete the JRE (and any other JARs) from the build path.
-
Iteratively fix compilation errors
- Correct imports using find/replace
- Change method and field visibility where required
- Where duplicates of the same file were found, choose desired version.
- Usually we desire the version with more information, so prefer those with comments.
- Move source which was not correctly organized into correct packages.
- Delete completely unused packages with errors rather than trying to fix them. Utilize Eclipse references feature to determine if used.
- Fix other misc errors like file name not matching top level type name
- Sometimes a clean/build helps for stale build errors
-
Confirm that all source compiles and is free of errors with no JARs on the build path
-
Confirm that all packages/types in the Android API appear to be present
Edit and run the gatherjars.sh or gather_intermediate_jars.pl (for newer builds including ART optimizations) script to gather Android jars. Then create an empty Eclipse project, remove all existing project Jars, and add the gathered Jars to the project.
Use update PScout source at https://github.com/benjholla/pscout.
PScout wants to run over the full-eng build of Android, so you will probably have to make clean, lunch full-eng, and make -j24 again before running PScout.
Follow PScout directions at https://github.com/benjholla/pscout/blob/master/README.txt.
PScout results can be used in the Android Essentials Toolbox project.
| Code name | Version | API Level | Last Release Branch | Build OS | Java Version |
|---|---|---|---|---|---|
| Lollipop | 5.1 | API level 22 | android-5.1.0_r3 | Ubuntu 14.04 | OpenJDK 7 |
| Lollipop | 5.0 | API level 21 | android-5.0.2_r1 | Ubuntu 14.04 | OpenJDK 7 |
| - | - | API level 20 | - | - | - |
| KitKat | 4.4 - 4.4.4 | API level 19 | android-4.4.4_r2 | Ubuntu 14.04 | Oracle 6 |
| Jelly Bean | 4.3.x | API level 18 | android-4.3.1_r1 | Ubuntu 12.04 | Oracle 6 |
| Jelly Bean | 4.2.x | API level 17 | android-4.2.2_r1.2 | Ubuntu 12.04 | Oracle 6 |
| Jelly Bean | 4.1.x | API level 16 | android-4.1.2_r2.1 | ? | Oracle 6 |
| Ice Cream Sandwich | 4.0.3 - 4.0.4 | API level 15, NDK 8 | android-4.0.4_r2.1 | ? | Oracle 6 |
| Ice Cream Sandwich | 4.0.1 - 4.0.2 | API level 14, NDK 7 | android-4.0.2_r1 | ? | Oracle 6 |
| Honeycomb | 3.2.x | API level 13 | android-3.2.6_r1 | ? | Oracle 6 |
| Honeycomb | 3.1 | API level 12, NDK 6 | android-3.1_r1 | ? | Oracle 6 |
| Honeycomb | 3.0 | API level 11 | android-3.0_r1.3 | ? | Oracle 6 |
| Gingerbread | 2.3.3 - 2.3.7 | API level 10 | android-2.3.7_r1 | ? | Oracle 6 |
| Gingerbread | 2.3 - 2.3.2 | API level 9, NDK 5 | android-2.3.2_r1 | ? | Oracle 6 |
| Froyo | 2.2.x | API level 8, NDK 4 | android-2.2.3_r2 | ? | Oracle 5 |
| Eclair | 2.1 | API level 7, NDK 3 | android-2.1_r2.1p2 | ? | Oracle 5 |
| Eclair | 2.0.1 | API level 6 | android-2.0.1_r1 | ? | Oracle 5 |
| Eclair | 2.0 | API level 5 | android-2.0_r1 | ? | Oracle 5 |
| Donut | 1.6 | API level 4, NDK 2 | android-1.6_r1.5 | ? | Oracle 5 |
| Cupcake | 1.5 | API level 3, NDK 1 | ? | ? | Oracle 5 |
| (no code name) | 1.1 | API level 2 | ? | ? | ? |
| (no code name) | 1.0 | API level 1 | ? | ? | ? |