Working with Custom Android Devices and AOSP build system

An overview of how to use the AOSP build system for working with custom Android devices, and how to add apps and SDK add-ons.

2. speakerdeck.com/erikhellman
3. Agenda • Working with repo • Lunch targets and variants • Adding a new device • System properties • Resource overlays • Adding new modules • Soong build system • Apps • Library
4. Repo init $ repo init -u <url> -b <branch> -m <manifest>
5. Repo init - with mirror $ cd <path to mirror> $ repo init -u <url> -b <branch> -m <manifest> --mirror $ repo sync -c -j <jobs> $ cd <path to new workspace> $ repo init -u <url> -b <branch> -m <manifest> \ --reference=<path to mirror> $ repo sync -c -j <jobs>
6. Proprietary binaries
7. Lunch targets $ . build/envsetup.sh $ lunch
8. Lunch targets $ lunch You're building on Linux Lunch menu... pick a combo: ... 28. aosp_flame-userdebug 29. aosp_flame_car-userdebug 30. aosp_redfin-userdebug 31. aosp_redfin_car-userdebug ... Which would you like? [aosp_arm-eng]
9. Common lunch targets (AndroidProducts.mk) COMMON_LUNCH_CHOICES := \ aosp_flame-userdebug \ aosp_flame_car-userdebug \
10. Variants
11. Common lunch targets (AndroidProducts.mk) COMMON_LUNCH_CHOICES := \ aosp_flame-userdebug \ aosp_flame_car-eng \ aosp_flame_car-userdebug \
12. Adding a new device to AOSP $ mkdir device/<vendor>/<product> $ vim device/<vendor>/<product>/AndroidProducts.mk
13. AndroidProducts.mk (my_device) PRODUCT_MAKEFILES := $(LOCAL_DIR)/aosp_my_device.mk COMMON_LUNCH_CHOICES := aosp_my_device-userdebug
14. aosp_my_device.mk # Inherit from the common Open Source product configuration $(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit.mk) $(call inherit-product, $(SRC_TARGET_DIR)/product/aosp_base_telephony.mk) PRODUCT_NAME := aosp_my_device PRODUCT_DEVICE := my_device PRODUCT_BRAND := Android PRODUCT_MODEL := Eriks AOSP on Pixel5 PRODUCT_MANUFACTURER := Hellsoft PRODUCT_RESTRICT_VENDOR_FILES := true $(call inherit-product, device/google/redfin/device-redfin.mk) $(call inherit-product-if-exists, vendor/google_devices/redfid/device-vendor-redfin.mk)
15. System properties PRODUCT_SYSTEM_PROPERTIES += \ ro.lockscreen.disable.default=true \ ro.config.low_ram=true \
16. Resource overlays PRODUCT_PACKAGE_OVERLAYS += device/google/redfin/redfin/overlay
17. Resource overlays $ pwd /mnt/aosp/device/google/redfin/redfin/overlay $ ls frameworks packages vendor $ tree -C -d frameworks frameworks └── base ├── core │ └── res │ └── res │ ├── values │ └── xml └── packages └── SystemUI └── res ├── drawable ├── values └── values-land
18. frameworks/base/core/res/res/config.xml <resources> <bool name="config_disableLockscreenByDefault">false</bool> <dimen name="rounded_corner_radius">108px</dimen> <dimen name="status_bar_height">28dp</dimen> </resources>
19. Adding packages to AOSP
20. Soong build system
21. Bazel for AOSP
22. Soong documentation https://ci.android.com/builds/submitted/11094138/linux/ latest/view/soong_build.html
23. Add a new app Android.bp android_app { name: "my_system_app", resource_dirs: ["res"], sdk_version: "current", srcs: [ "src/**/*.kt", "gen/**/*.java", ], product_specific: true, static_libs: [ "androidx.annotation_annotation", "androidx.collection_collection", "androidx.arch.core_core-common", "androidx.lifecycle_lifecycle-common", "com.google.android.material_material", "androidx.lifecycle_lifecycle-runtime", "androidx.core_core", "androidx.recyclerview_recyclerview", ], }
24. Import an APK android_app_import { name: "my_imported_app", apk: "remote_display_manager.apk", certificate: "platform", privileged: true, required: ["privapp_whitelist_se.hellsoft.myapp"] }
25. Grant permissions to preinstalled apps <?xml version="1.0" encoding="utf-8"?> <permissions> <privapp-permissions package="se.hellsoft.myapp"> <permission name="android.permission.START_FOREGROUND_SERVICES_FROM_BACKGROUND" /> <permission name="android.permission.FOREGROUND_SERVICE" /> <permission name="android.permission.INTERNET" /> <permission name="android.permission.INJECT_EVENTS" /> <permission name="android.permission.CAPTURE_VIDEO_OUTPUT" /> <permission name="android.permission.MANAGE_APP_TOKENS" /> <permission name="android.permission.REMOTE_DISPLAY_PROVIDER" /> <permission name="android.permission.RECEIVE_BOOT_COMPLETED" /> <permission name="android.permission.SYSTEM_ALERT_WINDOW" /> <permission name="android.permission.QUERY_ALL_PACKAGES" /> <permission name="android.permission.INTERNAL_SYSTEM_WINDOW" /> <permission name="android.permission.USE_DATA_IN_BACKGROUND" /> </privapp-permissions> </permissions>
26. Including permissions file in AOSP build prebuilt_etc { name: "privapp_whitelist_se.hellsoft.myapp", system_ext_specific: true, sub_dir: "permissions", src: "se.hellsoft.myapp.xml", filename_from_src: true, }
27. Java SDK library java_sdk_library { name: "my_java_sdk_library", public: { enabled: true, }, system: { enabled: true, }, srcs: [ "src/**/*.java", ], api_packages: [ "se.hellsoft.mylib", ], }
28. Include modules in product build AndroidProduct.mk PRODUCT_PACKAGES += \ my_system_app \ my_imported_app \ my_java_sdk_library \
29. Build your new module $ cd packages/apps/my_system_app $ mma
30. Thank you for listening! speakerdeck.com/erikhellman