![BUILD SYSTEM
Set env
# source ./build/envsetup.sh
# lunch
You're building on Linux
Lunch menu... pick a combo:
1. aosp_arm-eng
2. aosp_x86-eng
3. aosp_mips-eng
4. vbox_x86-eng
5. mini_armv7a_neon-userdebug
6. mini_x86-userdebug
7. aosp_hammerhead-userdebug #n5
8. aosp_mako-userdebug #n4
9. aosp_flo-userdebug
10. aosp_manta-userdebug #n10
[...]](https://image.slidesharecdn.com/2015-buildaosp-151217132259/85/Building-aosp-24-320.jpg)
![BUILD SYSTEM
End of coffee time
[...]
#### make completed successfully (04:11:12 (hh:mm:ss)) ####](https://image.slidesharecdn.com/2015-buildaosp-151217132259/85/Building-aosp-29-320.jpg)
![SUMMARY
What did he said?
# repo init ...
# repo sync
# [get binaries]
# source ./build/envsetup.sh
# lunch
# make -j42
# [unlock bootloader]
# fastboot flashall](https://image.slidesharecdn.com/2015-buildaosp-151217132259/85/Building-aosp-44-320.jpg)
Building aosp
- 1. Build AOSP
- 2. AGENDA 01 Fetch sources 02 Building Configuration 03 Build & flash 04 AOSP puzzle
- 4. s.android.com FETCH SOURCES Get materials Sources (git) Doc & tutorials CDD, CTS
- 5. repo FETCH SOURCES Repo them all fetch status cmd
- 6. # repo init -u https://android.googlesource.com/platform/manifest -b android-6.0.0_r3 # repo sync -j8 FETCH SOURCES fetch & coffee
- 7. SOURCES DETAILS Folders 1/5 repo configuration & data.repo Google Android libc implementationbionic Recoverybootable Build Systembuild
- 8. SOURCES DETAILS Folders 2/5 Compatibility Test Suitects Virtual Machinedalvik | art Configuration for each target devicedevice
- 9. SOURCES DETAILS Folders 3/5 source.android.comdocs boringssl, sqlite, bzip2, ...external Android Framework -> APIframeworks Hardware Abstraction Layerhardware
- 10. SOURCES DETAILS Folders 4/5 Java implementation (Apache Harmony)libcore Native Development Kit Sourcesndk Results of YOUR compilationsout base apps/services (sms, photo, Settings, NFC …)packages
- 11. SOURCES DETAILS Folders 5/5 Binaries (toolchain, gdbserver…)prebuilts Standard Development Kit Sourcessdk Base : init, netd, vold, toolbox, logcat...system Vendors directories (libs, apps, overlays)vendor
- 12. LINUX KERNEL Need a pingouin? As binary (default) /vendor | /device As sources (if lucky) /kernel
- 14. HOWTO BUILD 3 basic cmds # source build/envsetup.sh # lunch # make
- 15. # source ./build/envsetup.sh // include all existing vendorsetup.sh in ./device // and define cmds ... - lunch: lunch <product_name>-<build_variant> - croot: Changes directory to the top of the tree. - m: Makes from the top of the tree. - mm* : Builds all of the modules in the current/suplied directory, with, /without their dependencies. - cgrep: Greps on all local C/C++ files. - jgrep: Greps on all local Java files. - resgrep: Greps on all local res/*.xml files. - sepgrep: Greps on all loacal sepolicy files ... PREPARE TO BUILD Set env
- 16. PREPARE TO BUILD Prepare ingredient vendorsetup.sh Lunch entry point in device/manufacturer/device TYPE = eng | userdebug | release AndroidProducts.mk The first makefile add_lunch_combo TARGETNAME-TYPE PRODUCT_MAKEFILES = TARGETNAME.mk
- 17. BUILD BASICS Nexus 9 example # tail -n1 device/htc/flounder/vendorsetup.sh add_lunch_combo aosp_flounder-userdebug # tail -n3 device/htc/flounder/AndroidProducts.mk PRODUCT_MAKEFILES := $(LOCAL_DIR)/aosp_flounder.mk $(LOCAL_DIR)/aosp_flounder64.mk $(LOCAL_DIR)/aosp_flounder32.mk $(LOCAL_DIR)/aosp_flounder_64_only.mk
- 18. BUILD BASICS Reading recipes Define your device software Heavy use of inheritance No specific naming device.mk files family
- 19. BUILD BASICS Reading recipes # cat device/htc/flounder/aosp_flounder.mk | magic_summarize PRODUCT_PACKAGES += rild Launcher3 # Inherit from those products. Most specific first. $(call inherit-product, device/htc/flounder/product.mk) $(call inherit-product, device/htc/flounder/device-lte.mk) $(call inherit-product-if-exists, vendor/htc/flounder_lte/device-vendor.mk) $(call inherit-product, $(SRC_TARGET_DIR)/product/aosp_base.mk) PRODUCT_DEVICE := flounder PRODUCT_MODEL := AOSP on Flounder PRODUCT_MANUFACTURER := HTC
- 20. BUILD BASICS Reading recipes # cat device/htc/flounder/device.mk | magic_summarize LOCAL_KERNEL := $(TARGET_PREBUILT_KERNEL) PRODUCT_COPY_FILES := $(LOCAL_KERNEL):kernel PRODUCT_COPY_FILES += $(LOCAL_PATH)/init.flounder.rc:root/init.flounder.rc PRODUCT_CHARACTERISTICS := tablet, nosdcard PRODUCT_PACKAGES += nfc_nci.bcm2079x.default NfcNci PRODUCT_PROPERTY_OVERRIDES := wifi.interface=wlan0 ro.opengles.version=196609
- 21. BUILD BASICS Reading recipes Define your device hardware Can include other BoardConfig.mk A bunch of specific defines BoardConfig.mk
- 22. BUILD BASICS Reading recipes # cat device/htc/flounder/BoardConfig.mk | magic_summarize TARGET_CPU_ABI := arm64-v8a TARGET_ARCH := arm64 TARGET_ARCH_VARIANT := armv7-a-neon TARGET_CPU_VARIANT := denver TARGET_NO_BOOTLOADER := true BOARD_KERNEL_CMDLINE := androidboot.hardware=flounder BOARD_USES_ALSA_AUDIO := true BOARD_HAVE_BLUETOOTH := true BOARD_HAVE_BLUETOOTH_BCM := true BOARD_SEPOLICY_DIRS += device/htc/flounder/sepolicy
- 23. BUILD03
- 24. BUILD SYSTEM Set env # source ./build/envsetup.sh # lunch You're building on Linux Lunch menu... pick a combo: 1. aosp_arm-eng 2. aosp_x86-eng 3. aosp_mips-eng 4. vbox_x86-eng 5. mini_armv7a_neon-userdebug 6. mini_x86-userdebug 7. aosp_hammerhead-userdebug #n5 8. aosp_mako-userdebug #n4 9. aosp_flo-userdebug 10. aosp_manta-userdebug #n10 [...]
- 25. BUILD SYSTEM May the sources be with you ONLY NEXUS BUILD YOU CAN And maybe Sony ...
- 26. BUILD SYSTEM Let’s compile It’s coffee time ! # make -j42
- 27. BUILD SYSTEM AOSP makefiles Android.mk, Android.mk everywhere Define a component : binary, apk, lib, ... AOSP 6.0 : ~ 2900 Android.mk
- 28. BUILD SYSTEM AOSP makefiles : Settings app LOCAL_PATH:= $(call my-dir) include $(CLEAR_VARS) LOCAL_JAVA_LIBRARIES := bouncycastle conscrypt telephony-common ims-common LOCAL_STATIC_JAVA_LIBRARIES := android-support-v4 android-support-v13 jsr305 LOCAL_SRC_FILES := $(call all-java-files-under, src) LOCAL_RESOURCE_DIR := $(LOCAL_PATH)/res LOCAL_PACKAGE_NAME := Settings LOCAL_CERTIFICATE := platform LOCAL_PRIVILEGED_MODULE := true LOCAL_PROGUARD_FLAG_FILES := proguard.flags include $(BUILD_PACKAGE) learn more in build/core/clear_vars.mk
- 29. BUILD SYSTEM End of coffee time [...] #### make completed successfully (04:11:12 (hh:mm:ss)) ####
- 30. BUILD SYSTEM Output Compilation produce plenty of images One .img for each partition: system, boot, userdata, recovery, ...
- 31. # adb reboot bootloader # fastboot flashall -w FLASH SYSTEM Ready? # make adb fastboot
- 32. # adb reboot bootloader # fastboot oem unlock FLASH SYSTEM Please, let me brick my device May wipe your data
- 33. # fastboot flashall -w or # fastboot flashall ./system.img # fastboot reboot FLASH SYSTEM Last call
- 34. FLASH SYSTEM It’s good to fail Nice try! But fails to boot / radio doesn’t work / there is no sound / ...
- 37. AOSP PUZZLE The full Stack
- 38. AOSP PUZZLE Were are missing blobs? Download them from Google/Sony/... https://developers.google.com/android/nexus/drivers http://developer.sonymobile.com/knowledge-base/open-source/ Or get them from official working image Distributed blobs are sometimes buggy
- 39. AOSP PUZZLE Were are missing blobs? Copy in /vendor + include in build system inherited in device.mk NEW : in vendor partition for some devices
- 40. AOSP PUZZLE Try again Delete ./out Rebuild Reflash
- 41. COMPILATION TIME Tired of coffee break CCACHE Android support
- 42. The Gapps issue NOT Open source - gapps not distributed for everybody - aosp apps != gapps - Google Mobile Services are getting fat AOSP PUZZLE Base apps looks bad!
- 43. ANDROID CERTIFICATION Google approve this build API & function (auto) CTS software & hardware requirerments CDD API & function (manual) CTS verifier final tests Google
- 44. SUMMARY What did he said? # repo init ... # repo sync # [get binaries] # source ./build/envsetup.sh # lunch # make -j42 # [unlock bootloader] # fastboot flashall
- 45. REFERENCES Links https://source.android.com http://elinux.org/Android_Portal Books Embedded Android, K. Yaghmour ISBN: 978-1-4493-0829-2
- 46. COPYRIGHTS # # Copyright (C) 2013 The Android Open-Source Project # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # The following copyright have been stripped from all the examples :
- 47. Thank you ! Vercoutère Guillaume gvercoutere@gmail.com www.genymobile.com