Embedded Android Workshop with Nougat

1
Embedded Android
Workshop
with Nougat
AnDevCon Washington D.C. 2017
Karim Yaghmour
@karimyaghmour

2
These slides are made available to you under a Creative Commons
Share-Alike 3.0 license. The full terms of this license are here:
https://creativecommons.org/licenses/by-sa/3.0/
Attribution requirements and misc., PLEASE READ:
●
This slide must remain as-is in this specific location (slide #2),
everything else you are free to change; including the logo :-)
●
Use of figures in other documents must feature the below
“Originals at” URL immediately under that figure and the below
copyright notice where appropriate.
●
You are free to fill in the “Delivered and/or customized by” space
on the right as you see fit.
●
You are FORBIDEN from using the default “About” slide as-is or
any of its contents.
(C) Copyright 2010-2017, Opersys inc.
These slides created by: Karim Yaghmour
Originals at: www.opersys.com/community/docs
Delivered and/or customized by

3
About
● Author of:
● Introduced Linux Trace Toolkit in 1999
● Originated Adeos and relayfs (kernel/relay.c)
● Training, Custom Dev, Consulting, ...

4
About Android
● Huge
● Fast moving
● Stealthy

5
Introduction to Embedded Android
● Features
● History
● Ecosystem
● Legal framework
● Platform and hardware requirements
● Development tools

6
1. Features (old snapshot)
●
Application framework enabling reuse and replacement of components
●
Dalvik virtual machine optimized for mobile devices
●
Integrated browser based on the open source WebKit engine
● Optimized graphics powered by a custom 2D graphics library; 3D graphics
based on the OpenGL ES 1.0 specification (hardware acceleration optional)
● SQLite for structured data storage
● Media support for common audio, video, and still image formats (MPEG4,
H.264, MP3, AAC, AMR, JPG, PNG, GIF)
●
GSM Telephony (hardware dependent)
●
Bluetooth, EDGE, 3G, and WiFi (hardware dependent)
● Camera, GPS, compass, and accelerometer (hardware dependent)
●
Rich development environment including a device emulator, tools for
debugging, memory and performance profiling, and a plugin for the Eclipse
IDE

7
2. History
● 2002:
● Sergey Brin and Larry Page started using Sidekick smartphone
● Sidekick one of 1st smartphones integrating web, IM, mail, etc.
● Sidekick was made by Danger inc., co-founded by Andy Rubin (CEO)
● Brin/Page met Rubin at Stanford talk he gave on Sidekick’s development
● Google was default search engine on Sidekick
● 2004:
● Despite cult following, Sidekick wasn’t making $
● Danger inc. board decided to replace Rubin
● Rubin left. Got seed $. Started Android inc. Started looking for VCs.
● Goal: Open mobile hand-set platform
● 2005 - July:
● Got bought by Google for undisclosed sum :)
● 2007 - November:
● Open Handset Alliance announced along with Android

8
●
2008 - Sept: Android 1.0 is released
●
2009 - Feb.: Android 1.1
●
2009 - Apr: Android 1.5 / Cupcake
●
2009 - Sept.: Android 1.6 / Donut
●
2009 - Oct: Android 2.0/2.1 / Eclair
●
2010 - May: Android 2.2 / Froyo
●
2010 - Dec: Android 2.3 / Gingerbread
●
2011 - Jan : Android 3.0 / Honeycomb – Tablet-optimized
● 2011 – May: Android 3.1 – USB host support
●
2011 – Nov: Android 4.0 / Ice-Cream Sandwich – merge Gingerbread and Honeycomb
●
2012 – Jun: Android 4.1 / Jelly Bean – Platform Optimization
●
2012 – Nov: Android 4.2 / Jelly Bean - Multi-user support
● 2013 -- July: Android 4.3 / Jelly Bean - GL ES 3.0
●
2013 -- Oct: Android 4.4 / Kit Kat - Low-memory support
●
2014 -- Nov: Android 5.0 / Lollipop - ART and other pixie dust
●
2015 -- Mar: Android 5.1 / Lollipop - Multi-SIM card
●
2015 -- Oct: Android 6.0 / Marshmallow - New permission model
●
2016 – Aug: Android 7.0 / Nougat – Multi-window
●
2016 – Oct: Android 7.1 / Nougat – A/B updates
●
TBD – Android O – PIP

9
3. “Flavors”
● Phone
● Tablet
● Wear (watches)
● TV
● Car:
● “Auto”
● “Automotive”
● Things (IoT)

10
3.1. Specifics
● Sources for new “flavors” not typically available at launch:
● Closed launches
● Gradual release once APIs/functionality stable
● Differences:
● Specific HALs
● Specific System Services
● Specific “system apps” -- tailored launcher, etc.
● Tailored/trimmed build
● Special attention to certain parts of the stack – benefits other
form-factors as well.

11
● Similarities:
● Generally same codebase (Brillo was a bit different,
but it wasn't called “Android”).
● Same architecture
● Same internal mechanisms
● Same build system
● Same C library
● Etc.

12
4. Ecosystem
● >2B monthly active devices worldwide
● 2.7M apps (vs. 2.2M for Apple's app store)
● 88% global smartphone marketshare (iOS is 12%)
100%
90%
80%
70%
60%
50%
40%
30%
20%
10%
0%
D
ec
2009
Feb
2010
Apr 2010
Jun
2010
Aug
2010
O
ct 2010
D
ec
2010
Feb
2011
Apr 2011
Jun
2011
Aug
2011
O
ct 2011
D
ec
2011
Feb
2012
Apr 2012
Jun
2012
Aug
2012
O
ct 2012
D
ec
2012
Feb
2013
Apr 2013
Jun
2013
Aug
2013
D
ec
2013
Feb
2014
Apr 2014
O
ct 2013
Jun
2014
Aug
2014
D
ec
2014
Feb
2015
O
ct 2014*
*nodata
100%
90%
80%
70%
60%
50%
40%
30%
20%
10%
0%
Apr 2015
Jun
2015
Aug
2015
*nodata
Jul 2015*
O
ct 2015
D
ec
2015
Feb
2016
Apr 2016
Jun
2016
Aug
2016
O
ct 2016*
D
ec
2016
*nodata
Android version
1.1
1.5
1.6
2.0
2.0.1
2.1
2.2
2.3-2.3.2
2.3.3-2.3.7
3.0
3.1
3.2
4.0-4.0.2
4.0.3-4.0.4
4.1
4.2
4.3
4.4
Cupcake
Donut
Eclair
Froyo
Gingerbread
Honeycomb
Ice Cream
Sandwich
Jelly Bean
KitKat
Gingerbread
Eclair
Eclair
Honeycomb
Honeycomb
Jelly Bean
Jelly Bean
5.0 Lollipop
Ice Cream
Sandwich
5.1 Lollipop
6.0 Marshmallow
7.0-7.1 Nougat

13
4.1. Who's playing?
E
V
E
R
Y
B
O
D
Y

14
4.2. Open Handset Alliance
●
“... a group of 80 technology and mobile companies who have come together
to accelerate innovation in mobile and offer consumers a richer, less
expensive, and better mobile experience. Together we have developed
Android™, the first complete, open, and free mobile platform.”
● Unclear what OHA does or what benefits, if any, members derive
● Not an organization with board members, staff, etc. ... just an “Alliance”
●
Google's Android team are the lead on all bleeding edge dev, all else tag along
●
OHA is largely inactive / absent
●
Comprised of:
● Mobile Operators: Sprint, T-Mobile, Vodafone, NTT Docomo, ...
● Handset Manufacturers: HTC, Motorola, LG, Samsung, Sony Ericsson, ...
●
Semiconductor Companies: ARM, Freescale, Intel, NVIDIA, Qualcomm, TI, ...
● Software Companies: Google, ...
● Commercialization Companies: ...

15
5. Legal Framework
● Code access
● Code licenses
● Branding use
● Google's own Android Apps
● Alternative App stores
● Oracle v. Google

16
5.1. Code Access
● Parts:
● Kernel
● Android Open Source Project (AOSP)
● Kernel:
● Should have access to latest shipped version => GPL requirement
● Google-maintained forks at android.googlesource.com
● AOSP:
● Usually Code-drops every 6 months
● Official AOSP branches at android.googlesource.com
● Managed by “repo” tool, an overlay to “git”

17
5.2. Code Licenses
● Kernel:
● GNU General Public License (a.k.a. GPL)
● AOSP:
● Mostly Apache License 2.0 (a.k.a. ASL)
● Having GPL-free user-space was a design goal
● Even BlueZ (GPL) is now gone -- starting 4.2
● Some key components in BSD: Bionic and Toolbox
● “external/” directory contains a mixed bag of licenses
● May be desirable to add GPL/LGPL components:
● BusyBox
● glibc

18
5.3. Branding Use
● Android Robot:
● Very much like the Linux penguin
● Android Logo (A-N-D-R-O-I-D w/ typeface):
● Cannot be used
● Android Custom Typeface:
● Cannot be used
● Android in Official Names:
● As descriptor only: “for Android”
● Most other uses require approval
● Android in Messaging:
● Allowed if followed by a generic: “Android Application”
● Compliance through CDD/CTS involved in “approval”

19
5.4. Google's own Android Apps
● The non-AOSP apps:
● Google Mobile Services (GMS)
● Play Store
●
YouTube
● Maps
● Gmail
● Photos
● ...
● Require:
● CTS/CDD Compliance
● Signed agreement w/ Google
● Inquiries: android-partnerships@google.com

20
5.5. Alternative “App Stores”
● Many app stores out there:
● Amazon App Store
● GetJar
● Slide Me
●
Yandex
● AppBrain
●
Samsung Galaxy Apps
●
F-Droid
● ...
● Nothing precluding you from having your own

21
5.6. Oracle v. Google
● Filed August 2010
● Patent infringement:
● 6,125,447; 6,192,476; 5,966,702; 7,426,720; RE38,104; 6,910,205; and 6,061,520
● Copyright infringement:
● Android does not use any Oracle Java libraries or JVM in the final product.
● Android relies on Apache Harmony and Dalvik instead.
● In October 2010, IBM left Apache Harmony to join work on Oracle's
OpenJDK, leaving the project practically orphaned.
● ...
● In Spring of 2012 Oracle lost both on Copyright and Patent fronts
● ...
● Oracle appealed
● ...

22
6. Platform and Hardware requirements
● In principle:
● Android runs on top of Linux
● Therefore: if it runs Linux, it can run Android
● Known to have been made to work on:
● ARM
● x86
● MIPS
● SuperH
● Put in all sort of devices:
● Washers, micro-wave ovens, car systems, etc.

23
6.1. Compliance Definition Document
● Software: MUST conform to AOSP
● Application Packaging Compatibility: support “.apk” files
● Multimedia Compatibility: decoders, encoders, recording, ...
●
Developer Tool Compatibility: adb, ddms, Monkey
●
Hardware compatibility:
●
Display and Graphics
●
Input Devices
● Data Connectivity
●
Cameras
● Memory and Storage
● USB
● Performance Compatibility
● Security Model Compatibility
● Software Compatibility Testing
●
Updatable Software: MUST include mechanism to update

24
6.2. Compatibility Test Suite

25
1. Linux Concepts
2. Android Concepts
3. Overall Architecture
4. System startup
5. Linux Kernel
6. Hardware Support
7. Native User-Space
8. Android's Java
9. JNI
10.System Server
11.Calling on Services
12.Activity Manager
13.Binder
14.HAL
15.Stock AOSP Apps
Concepts and Internals

26
1. Linux Concepts
●
Processes (fork() and his friends)
●
Signals (kill() ... or be killed)
●
Sockets / Pipes / Fifos / SysV IPC
●
Hardware devices as files (/dev)
●
Daemons
●
Shell / scripts
●
Users (root vs. everyone else -- # vs. $)
●
ELF files
● GNU toolchain
●
... 40 years of Unix

27
2. Android Concepts
● Components
● Intents
● Manifest file
● Component lifecycle
● Processes and threads
● Remote procedure calls
● Permissions
● Storage
● Native development

28
2.1. Components
● 1 App = N Components
● Apps can use components of other applications
● App processes are automagically started whenever any
part is needed
● Ergo: N entry points, !1, and !main()
● Components:
● Activities
● Services
● Broadcast Receivers
● Content Providers

29
2.2. Intents
● Intent = asynchronous message w/ or w/o
designated target
● Like a polymorphic Unix signal, but w/o
required target
● Intents “payload” held in Intent Object
● Intent Filters specified in Manifest file

30
2.3. Manifest file
● Informs system about app’s components
● XML format
● Always called AndroidManifest.xml
● Activity = <activity> ... static
● Service = <service> ... static
● Broadcast Receiver:
● Static = <receiver>
● Dynamic = Context.registerReceiver()
● Content Provider = <provider> ... static

31
2.4. Component lifecycle
● System automagically starts/stops/kills
processes:
● Entire system behaviour predicated on low memory
● System triggers Lifecycle callbacks when
relevant
● Ergo: Must manage Component Lifecycle
● Some Components are more complex to
manage than others

33
2.5. Processes and threads
● Processes
● Default: all callbacks to any app Component are issued to the main process thread
● <activity>—<service>—<recipient>—<provider> have process attribute to override
default
● Do NOT perform blocking/long operations in main process thread:
– Spawn threads instead
● Process termination/restart is at system’s discretion
● Therefore:
– Must manage Component Lifecycle
● Threads:
● Create using the regular Java Thread Object
● Android API provides thread helper classes:
– Looper: for running a message loop with a thread
– Handler: for processing messages
– HandlerThread: for setting up a thread with a message loop

34
2.6. Remote procedure calls
● Android RPCs = Binder mechanism
● No Sys V IPC due to in-kernel resource leakage
● Binder is a low-level functionality, not used as-is
● Instead: must define interface using Interface
Definition Language (IDL)
● IDL fed to aidl Tool to generate Java interface
definitions

35
2.7. Security/Permissions
● Most security enforced at process level: UID, GID
● Permissions enforce restrictions on:
● Per-process operations
● Per-URI access
● Applications are sandboxed
● Specific permissions required to “exit” sandbox
● Decision to grant access based on:
● Certificates
● User prompts
● All permissions must be declared statically

36
2.8. Data storage
● Shared preferences
● Private primitive key-pair values
● Internal storage
● Private data on device memory
● External storage
● Public data on shared external device (SD) -- emulated
● SQLite DB
● Private DB
● Network connection
● Web-based storage (REST)

37
2.9. Native development
● Useful for:
● Porting existing body of code to Android
● Developing optimized native apps, especially for gaming
● Provides:
● Tools and build files to generate native code libraries from C/C++
● Way to embed native libs into .apk
● Set of stable (forward-compatible) native libs
● Documentation, samples and tutorials
● Enables:
● Calling native code from Java using JNI
●
Implementing fully native apps (since 2.3)
● Doesn't allow you to:
● Compile traditional Linux/Unix apps as-is

38
3. Architecture
● Embedded Linux
● Modern phone/tablet
● System-on-Chip (SoC)
● Android

43
4. System Startup
● Bootloader
● Kernel
● Init
● Zygote
● System Server
● Activity Manager
● Launcher (Home)

45
4.1. Bootloader
● “Reference” bootloader:
● https://github.com/travisg/lk
● https://www.codeaurora.org/blogs/little-kernel-based-
android-bootloader
● aosp/bootable/bootloader
● Gone ...
● aosp/bootable/recovery
● UI-based recovery boot program
●
Accessed through magic key sequence at boot
●
Usually manufacturer specific variant

46
● Storage layout:
● Bootloader
● “boot” image -- Kernel + RAM disk
● “system” partition -- /system
● “data” partition -- /data
● “cache” partition -- /cache
● “vendor” partition -- /vendor
● “recovery” partition -- Alternate boot image

47
4.2. Kernel
● Early startup code is very hardware dependent
● Initializes environment for the running of C code
● Jumps to the architecture-independent
start_kernel() function.
● Initializes high-level kernel subsystems
● Mounts root filesystem
● Starts the init process

48
4.3. Android Init
● Open, parses, and runs /init.rc:
● Create mountpoints and mount filesystems
● Set up filesystem permissions
●
Set OOM adjustments properties
● Start daemons:
– adbd
– servicemanager (binder context manager)
– vold
– netd
– rild
– app_process -Xzygote (Zygote)
– mediaserver
– ...

49
4.4. Zygote, etc.
● Init:
● app_process -Xzygote (Zygote)
● frameworks/base/cmds/app_process/app_main.cpp:
● runtime.start(“com.android.internal.os.Zygote”, ...
● frameworks/base/core/jni/AndroidRuntime.cpp:
● startVM()
● Call Zygote's main()
● frameworks/base/core/java/com/android/internal/os/Zyg
oteInit.java:
● ...

50
● preloadClasses()
● startSystemServer()
● ... magic ...
● Call SystemServer's run()
● frameworks/base/services/java/com/android/server
/SystemServer.java:
● Start all system services/managers
● Start ActivityManager:
– Send Intent.CATEGORY_HOME
– Launcher2 kicks in

52
6. Hardware Support
● Activity Recognition
● Audio
● Bluetooth
● Camera
● ConsumerIr
● Framebuffer
● Fingerprint
● Fused Location
●
GPS
●
Gralloc
● HWcomposer
● Keymaster
●
Lights
●
NFS
●
Power
● Sensors
● Not accessed directly
● Use of HALs
● One HAL for each hardware type
● HAL “modules” are .so files

53
7. Native User-Space
● Mainly
● /data => User data
● /system => System components
● /cache => Cache (& OTA update)
● Also found:
● /dev
● /proc
● /sys
● /sbin
● /mnt
● Etc.

54
8. Android's Java
● Oracle (Sun) Java =
Java language + JVM + JDK libs
● Android Java =
Java language + ART + Apache Harmony

55
8.1. ART
● “Android RunTime”
● 64 bit
● Multi-core
● AOT instead of JIT
● Better debugging capabilities
(profiling/stack/crashes)
● Introduced as alternative to Dalvik
● Has now (largely) replaced Dalvik

56
9. JNI – Java Native Interface
● Call gate for other languages, such as C, C++
● If you know C#: Equivalent to .NET's pinvoke
● Usage: include and call native code from App
● Tools = NDK ... samples included
● Check out “JNI Programmer's Guide and
Specification” -- no longer “freely available”

57
10. System Services
● The Android OS
● >95 or so on a modern Marshmallow
● 5 or 6 new at every major release
● Use “service list” to see current list

59
11. Calling on System Services
● Use getSystemService
● Ex: NotificationManager Object reference:
String ns = Context.NOTIFICATION_SERVICE;
NotificationManager mNotificationManager = (NotificationManager)
getSystemService(ns);
● Prepare your content
● Call on the object:
mNotificationManager.notify(HELLO_ID, notification);

60
12. ActivityManager
● Start new Activities, Services
● Fetch Content Providers
● Intent broadcasting
● OOM adj. maintenance
● Application Not Responding
● Permissions
● Task management
● Lifecycle management

61
● Ex. starting new app from Launcher:
● onClick(Launcher)
● startActivity(Activity.java)
● <Binder>
● ActivityManagerService
● startViaZygote(Process.java)
● <Socket>
● Zygote

62
13. Binder
● CORBA/COM-like IPC
● Data sent through “parcels” in “transactions”
● Kernel-supported mechanism
● /dev/binder
● Check /sys/kerne/debug/binder/*
● android.* API connected to System Server
through binder.

64
14. Hardware Abstraction Layer
/frameworks/base/services/java/...
/frameworks/base/services/jni/
/hardware/libhardware/
/device/[MANUF.]/[DEVICE]
/sdk/emulator/
Kernel or module
/frameworks/base/core/...
AOSP-provided
ASL
Manuf.-provided
Manuf. license
Manuf.-provided
GPL-license

65
15. Stock AOSP Apps
/packages/apps /packages/providers
Launcher2
Music
Browser
Calculator
Calendar Provision
Camera
Settings
Contacts
Email
Gallery
/packages/inputmethods
AccountsAndSettings ApplicationProvider LatinIME
AlarmClock Mms CalendarProvider OpenWnn
Bluetooth ContactsProvider PinyinIME
PackageInstaller DownloadProvider
Protips DrmProvider
GoogleContactsProvider
QuickSearchBox MediaProvider
CertInstaller TelephonyProvider
SoundRecorder UserDictionaryProvider
DeskClock SpeechRecorder
Stk
VoiceDialer
HTMLViewer

66
Working with the
Android Open Source Project
● Tools and location
● Content
● Building
● Build tricks
● Build system architecture
● Output images
● Using adb
● Custom toolchains and dev kits
● Compatibility Test Suite
● Basic hacks

67
1. Tools and location
● Location:
● http://android.googlesource.com/
● Get “repo”:
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo
● Fetch the AOSP:
● Make sure you fetch a tagged release
● Nougat:
$ repo init -u https://android.googlesource.com/platform/manifest
-b android-7.1.2_r11
$ repo sync

68
2. Content
art
bionic C library replacement
build Build system
Compatibility Test Suite
development Development tools
device Device-specific files and components
external Copy of external projects used by AOSP
frameworks
hardware
Apache Harmony
The NDK
packages Stock Android apps, providers, etc.
The SDK
system
Android Runtime
bootable Reference bootloader
cts
dalvik Dalvik VM
System services, android.*, Android-related cmds, etc.
Hardware support libs
libcore
ndk
prebuilt Prebuilt binaries
sdk
pieces of the world that are the core of the embedded linux platform at
the heart of Android.

70
3. Building
● Requires Ubuntu -- works with 16.04, 14.04, and
12.04
● See
https://source.android.com/source/initializing.html
● Required packages
● Possible fixes
● Building on Mac

71
● Set up build environment:
$ .⌴build/envsetup.sh
$ lunch
● Launch build and go watch tonight's hockey game:
$ make -j8
● ... though you should check your screen at breaks ...
● Flash:
$ adb reboot bootloader
$ fastboot oem unlock
$ fasboot flashall
● Need to reuse envsetup.sh and lunch on every new shell

72
4. Build Tricks
● Commands (from build/envsetup.sh):
● godir
● croot
● mm
● m
● Remember:
● hmm
● make help
● Speeding up the Build:
● CPU
● RAM
● SSD
● CCACHE
– $ export USE_CCACHE=1
● Seed out with pre-built binaries from your local repo

73
5. Build System Architecture
● Non-Recursive
● “Modules” build predicated on Android.mk

74
6. Output Images
● All output and build in [aosp]/out/
● Images at [aosp]/out/target/product/generic/:
● ramdisk.img
● system.img
● userdata-qemu.img
● Kernel is in:
● prebuilt/android-arm/kernel/kernel-qemu
● Emulator overrides:
● -kernel
● -initrd

75
7. Using adb
● Can use to control/interface w/ running AOSP,
including emulator.
● Shell:
$ adb shell
#
● Dumping the log:
$ adb logcat
● Copying files to/from target:
$ adb push foo /data/local
$ adb pull /proc/config.gz
Host
Target

76
8. Custom Toolchains and Dev Kits
● Rationale
● SDK generation
● NDK generation

77
8.1. Rationale
● SDK:
● Providing other internal teams or external developers
access to your modified/custom Android APIs.
● NDK:
● Same as SDK rationale
● Custom cross-dev toolchain:
● To avoid having to use a binary toolchain from 3rd party.
● To control the build parameters used to create the
toolchain. Ex.: use uClibc instead of glibc.

78
8.2. SDK generation
● Building the SDK:
$ . build/envsetup.sh
$ lunch sdk-eng
$ make sdk
● If API modified, do this before make:
$ make update-api
● Location: [aosp]/out/host/linux-x86/sdk/
● Reconfigure Android Studio to use new SDK

79
8.3. NDK generation
● Build
$ cd ndk/build/tools
$ export ANDROID_NDK_ROOT=[aosp]/ndk
$ ./make-release --help
$ ./make-release
IMPORTANT WARNING !!
This script is used to generate an NDK release package from scratch
for the following host platforms: linux-x86
This process is EXTREMELY LONG and may take SEVERAL HOURS on a dual-core
machine. If you plan to do that often, please read docs/DEVELOPMENT.TXT
that provides instructions on how to do that more easily.
Are you sure you want to do that [y/N]

80
9. Compatibility Test Suite
● Android Compatibility Program:
● Source code to Android stack
● Compatibility Definition Document (CDD) – Policy
●
Compatibility Test Suite (CTS) – Mechanism
● Each Android version has own CDD & CTS
● CTS:
● Part of AOSP
● Run from host using USB over to attached device
●
Based on JUnit
● Runs various test apps on target
● Relies on ADB
●
Provides report to be be analyzed and/or sent back to Google

82
● Report:
● .zip file containing XML files and screen-shots
● Sent to: cts@android.com
● Building the CTS:
$ . build/envsetup.sh
$ make cts
● Launching the CTS:
$ cd out/host/linux-x86/bin/
$ ./cts
$ cts_host >
$ cts_host > help
...

83
● Using the CTS:
$ cts_host > ls --plan
List of plans (8 in total):
Signature
RefApp
VM
Performance
AppSecurity
Android
Java
CTS
$ ./cts start --plan CTS

84
● Areas covered:
● Signature tests
● Platform API tests
● Dalvik VM tests
● Platform Data Model
● Platform Intents
● Platform Permissions
● Platform Resources

85
10. Basic Hacks
● Add device
● Add app
● Add app overlay
● Add native tool or daemon
● Add native library

86
10.1. Adding a new device
● Create directory in device/:
● device/acme/coyotepad/
● Makefile checklist:
● AndroidProducts.mk
● full_coyotepad.mk
● BoardConfig.mk
● Android.mk
● Menu integration:
● vendorsetup.sh

87
PRODUCT_MAKEFILES :=
$(LOCAL_DIR)/full_coyotepad.mk
10.1.1. AndroidProducts.mk

88
$(call inheritproduct, $
(SRC_TARGET_DIR)/product/languages_full.mk)
# If you're using 4.2/Jelly Bean, use full_base.mk instead of
full.mk
$(call inheritproduct, $(SRC_TARGET_DIR)/product/full.mk)
DEVICE_PACKAGE_OVERLAYS :=
PRODUCT_PACKAGES +=
PRODUCT_COPY_FILES +=
PRODUCT_NAME := full_coyotepad
PRODUCT_DEVICE := coyotepad
PRODUCT_MODEL := Full Android on CoyotePad, meepmeep
10.1.2. full_coyotepad.mk

89
TARGET_NO_KERNEL := true
TARGET_NO_BOOTLOADER := true
TARGET_CPU_ABI := armeabi
BOARD_USES_GENERIC_AUDIO := true
USE_CAMERA_STUB := true
10.1.3. BoardConfig.mk

90
LOCAL_PATH := $(call mydir)
include $(CLEAR_VARS)
ifneq ($(filter coyotepad,$(TARGET_DEVICE)),)
include $(call allmakefilesunder,$(LOCAL_PATH))
endif
10.1.4. Android.mk

91
add_lunch_combo full_coyotepadeng
10.1.5. vendorsetup.sh

92
LOCAL_PATH := $(call mydir)
ifneq ($(filter coyotepad,$(TARGET_DEVICE)),)
include $(call allmakefilesunder,$(LOCAL_PATH))
endif
10.1.4. Android.mk

93
10.2. Adding new applications
● Can't really use Studio to create initial version, unlike
older versions of Eclipse.
● Local:
● Add app to device/acme/coyotepad/
● Add Android.mk to app
● Add to PRODUCT_PACKAGES in full_coyotepad.mk
● Global:
● Add application in [aosp]/packages/apps
● Add an appropriate Android.mk file to project
● Add project to PRODUCT_PACKAGES in
[aosp]/build/target/product/core.mk

94
LOCAL_PATH:= $(call mydir)
LOCAL_MODULE_TAGS := optional
LOCAL_SRC_FILES := $(call alljavafilesunder, src)
LOCAL_PACKAGE_NAME := HelloWorld
include $(BUILD_PACKAGE)

95
10.3. Adding an app overlay
● device/acme/coyotepad/overlay/
● full_coyotepad.mk:
● DEVICE_PACKAGE_OVERLAYS :=
device/acme/coyotepad/overlay

96
10.4. Adding a native tool or daemon
● Local:
device/acme/coyotepad/
● Global:
● system/core/
● system/
● frameworks/base/cmds/
● frameworks/native/cmds/
● external/

97
LOCAL_MODULE := helloworld
LOCAL_SRC_FILES := helloworld.cpp
LOCAL_SHARED_LIBRARIES := liblog
include $(BUILD_EXECUTABLE)

98
● Local:
device/acme/coyotepad/
● Global:
● system/core/
● frameworks/base/libs/
● frameworks/native/libs/
● external/
● In <= 2.3:
● See build/core/prelink-linux-arm.map
10.5. Add a native library

99
LOCAL_MODULE := libmylib
LOCAL_PRELINK_MODULE := false
LOCAL_SRC_FILES := $(call allcfilesunder,.)
include $(BUILD_SHARED_LIBRARY)

100
Kernel Selection
● Google:
● http://android.googlesource.com
● Vanilla:
● http://www.kernel.org
● Either way ... you're screwed:
● Android kernel is a fork
● No resolution in sight
● Cannot use vanilla kernel as-is ... androidisms
● Recent kernel have most Androidisms
● Android team continues to add stuff in their fork
● Talk to your SoC vendor

101
Native Android User-Space
● Filesystem layout
● Architecture vs. filesystem
● Build system and filesystem
● adb
● Command line
● Init
● ueventd

103
● /acct => Control Group mount point (Documentation/cgroups.txt)
● /cache => cache flash partition
● /d => Symlink to /sys/kernel/debug
● /data => Android's “/data” filesystem
● /dev => Device nodes
● /etc => Symlink to /system/etc
● /mnt => Temporary mount point
● /proc => procfs
● /root => unused
● /sbin => eventd and adbd
● /sdcard => SD card mountpoint
● /sys => sysfs
● /system => Android's “/system” filesystem
● /vendor => Symlink to /system/vendor
1.1. Root directory

104
1.1. /system
● /app => Stock apps installed
● /bin => Native binaries and daemons
● /etc => Configuration files
● /fonts => TTFs
● /framework => Android framework .jar files
● /lib => Native libraries
● /usr => Miniature “/usr”
● /xbin => Optional/Extra binaries

105
1.2. /data
● /anr => ANR traces
● /app => App install location
● /app-private => Protected apps
● /backup => For Backup Manager
● /dalvik-cache => Dalvik DEX cache
● /data => App data
● /dontpanic => Last panic output (console + threads) for “dumpstate”
● /local => Shell-writable space
● /misc => Misc. data (wifi, vpn, bluetooth, ...)
● /property => Persistent system properties (country, lang., ...)
● /secure => Secure Android data available
● /system => System data

106
2. Architecture vs. filesystem

107
3. Build system and filesystem
● Build templates
● BUILD_EXECUTABLE = /system/bin
● BUILD_SHARED_LIBRARY = /system/lib
● BUILD_PACKAGE = /system/app
● Default rights and ownership
● system/core/include/private/android_filesystem_config.h
– User IDs / names
● system/core/libcutils/fs_config.c
– android_dirs struct
– android_files struct

109
4.1. What adb can do
● See online help for full details
● Managing device connections
● Remote commands:
● shell
● log dumping
● bug reports
● port forwarding (both ways)
● dalvik debugging

110
● Filesystem commands
● push
● pull
● sync
● install / uninstall
● State-altering commands
● reboot
● run as root
● switching connection type
● controlling the emulator
● Tunneling PPP

111
5. Command line
● Shell:
● NetBSD shell up to 2.3/GB
● MirBSD Korn shell since 4.0/ICS
● Toybox / Toolbox:
● Traditional Linux commands
● Global properties
● Input events
● Services control
● Logging
● ioctl
● Device wiping
● etc.

112
● In aosp:
● /external/toybox
● /system/core/toolbox
● In filesystem:
● /system/bin/toybox
● /system/bin/toolbox
● Provides
alarm date getevent insmod ls mv powerd renice schedtop smd
top dd getprop ioctl lsmod nandread printenv rm sendevent start
umount cat hd ionice lsof netstat ps rmdir setconsole stop uptime
chmod df id kill mkdir newfs_msdos r rmmod setkey sync vmstat
chown dmesg ifconfig ln readtty rotatefb setprop syren watchprops
cmp exists iftop log mount notify reboot route sleep wipe

113
● logcat
● netcfg
● debuggerd

115
6.1. Config files
● Location:
● /init.rc
● /init.[board].rc
● Semantics:
● actions
– Property triggers
– Commands
● services (not related to system services or apps)
– Parameters

116
6.2. Global properties
● /dev/socket/property_service
● /dev/__properties__
● foo.bar.property
● ro.*
● persist.* => /data/property
● ctl.*
● net.change

117
● Std files:
● /system/build.prop
● /default.prop
● Other files:
● /system/default.prop
● /data/local.prop
● Code:
– property_get("dalvik.vm.heapsize", heapsizeOptsBuf+4, "16m");

119
7.1. /ueventd.rc
/dev/null 0666 root root
/dev/zero 0666 root root
/dev/full 0666 root root
/dev/ptmx 0666 root root
/dev/tty 0666 root root

120
System Services and Framework
Internals
1. Kickstarting the Framework
2. Utilities and Commands
3. Native Daemons
4. System Services Internals
6. Android Framework

121
1. Kickstarting the Framework
● Core building blocks
● System services
● Boot animation
● Dex optimization
● Apps startup

122
1.1. Core building blocks
● Service manager
● Zygote:
● ART
● Preloaded classes
● libandroid_runtime.so

124
1.3. Boot animation
● Default boot animation
● bootanimation.zip
● setprop debug.sf.nobootanimation 1

125
1.4. Dex optimization
● Files:
● .jar
● .apk
● Directories:
● BOOTCLASSPATH
● /system/etc/permission/platform.xml
● /system/framework
● /system/app
● /vendor/app
● /data/app
● /data/app-private

126
1.5. Apps startup
● Input methods
● Persistent apps
● Home screen
● BOOT_COMPLETED intent
● APPWIDGET_UPDATE intent

127
2. Utilities and Commands
● General-purpose commands
● service
● dumpsys
● dumpstate
● rawbu
● Service-specific utilities
● am
● pm
● wm
● svc

128
● ime
● input
● monkey
● bmgr
● stagefright
● Dalvik utilities
● dalvikvm
● dvz
● dexdump

129
3. Native daemons
● servicemanager
● logd
● lmkd
● installd
● vold
● netd
● rild
● keystore

130
3.1. servicemanager
● In aosp:
● /frameworks/base/cmds/servicemanager/
● In filesystem:
● /system/bin/
● Provides:
● Context management for binder
● Service index for entire system

131
3.2. logd
● In AOSP
● /system/core/logd
● In filesystem:
● /system/bin/logd
● Provides:
● Logging services
● Manages multiple buffers

132
3.3. lmkd
● In AOSP
● /system/core/lmkd
● In filesystem:
● /system/bin/lmkd
● Provides:
● Low-memory kernel handler

133
3.4. installd
● In aosp:
● /frameworks/base/cmds/installd
● In filesystem:
● /system/bin/
● Provides:
● Package install/uninstall
● Sanity checks and verifications
● Interfaces with Package Manager service

134
3.5. vold
● In aosp:
● /system/vold/
● In filesystem:
● /system/bin/
● Provides:
● Volume mounter
● Auto-mount
● Auto-format mounted devices

135
3.6. netd
● In aosp:
● /system/netd/
● In filesystem:
● /system/bin/
● Provides:
● Management of aspects of networking
● Interfaces with Network Management service

136
3.7. rild
● In aosp:
● /hardware/ril/mock-ril/
● In filesystem:
● /system/bin/
● Provides:
● “Radio Interface Layer” to phone hardware

137
3.8. keystore
● In aosp:
● frameworks/base/cmds/keystore/
● In filesystem:
● /system/bin
● Provides:
● Store key-value pairs
● Security keys for connecting to network infrastructure

138
4. System Services Internals
● Services run by System Server
● Observing the System Server
● Calling on system services
● Inside a few system services
● Creating your own system service

139
4.1. Services run by the System
Server
Entropy Service Device Policy Audio Service
Power Manager Status Bar Headset Observer
Activity Manager Clipboard Service Dock Observer
Telephone Registry Input Method Service UI Mode Manager Service
Package Manager Backup Service
Account Manager
Content Manager Connectivity Service Recognition Service
System Content Providers Throttle Service Status Bar Icons
Battery Service Accessibility Manager
Lights Service Mount Service ADB Settings Observer
Vibrator Service Notification Manager
Alarm Manager Device Storage Monitor
Location Manager
Sensor Service Search Service
Window Manager
Wallpaper Service
NetStat Service
NetworkManagement Service AppWidget Service
DiskStats Service
Init Watchdog
DropBox Service
Bluetooth Service

140
4.1.1. Some stats
● frameworks/base/services/core/java/com/androi
d/server:
● 15 M
● ~550 files
● 326 kloc
● Activity manager:
● 2.6M
● 60+ files
● 58 kloc

141
4.2. Observing the System Server
● Logcat
● dumpsys

142
4.2.1. logcat
● Find the System Server's PID
$ adb shell ps | grep system_server
system 63 32 120160 35408 ffffffff afd0c738 S system_server
● Look for its output:
$ adb logcat | grep “63)”
...
D/PowerManagerService( 63): bootCompleted
I/TelephonyRegistry( 63): notifyServiceState: 0 home Android Android 310260 UMTS CSS not supp...
I/TelephonyRegistry( 63): notifyDataConnection: state=0 isDataConnectivityPossible=false reason=null
interfaceName=null networkType=3
I/SearchManagerService( 63): Building list of searchable activities
I/WifiService( 63): WifiService trying to setNumAllowed to 11 with persist set to true
I/ActivityManager( 63): Config changed: { scale=1.0 imsi=310/260 loc=en_US touch=3 keys=2/1/2 nav=3/1 ...
I/TelephonyRegistry( 63): notifyMessageWaitingChanged: false
I/TelephonyRegistry( 63): notifyCallForwardingChanged: false
I/TelephonyRegistry( 63): notifyDataConnection: state=1 isDataConnectivityPossible=true reason=simL...
I/TelephonyRegistry( 63): notifyDataConnection: state=2 isDataConnectivityPossible=true reason=simL...
D/Tethering( 63): MasterInitialState.processMessage what=3
I/ActivityManager( 63): Start proc android.process.media for broadcast
com.android.providers.downloads/.DownloadReceiver: pid=223 uid=10002 gids={1015, 2001, 3003}
I/RecoverySystem( 63): No recovery log file
W/WindowManager( 63): App freeze timeout expired.
...

143
4.2.2. dumpsys
Currently running services:
SurfaceFlinger
accessibility
account
activity
alarm
appwidget
audio
backup
...
wifi
window
-------------------------------------------------------------------------------
DUMP OF SERVICE SurfaceFlinger:
+ Layer 0x396b90
z= 21000, pos=( 0, 0), size=( 480, 800), needsBlending=1, needsDithering=1, invalidat ...
0]
name=com.android.launcher/com.android.launcher2.Launcher
client=0x391e48, identity=6
[ head= 1, available= 2, queued= 0 ] reallocMask=00000000, inUse=-1, identity=6, status=0
format= 1, [480x800:480] [480x800:480], freezeLock=0x0, dq-q-time=53756 us
...

144
4.3. Calling on System Services
● Use getSystemService
● Ex: NotificationManager Object reference:
String ns = Context.NOTIFICATION_SERVICE;
NotificationManager mNotificationManager = (NotificationManager)
getSystemService(ns);
● Prepare your content
● Call on the object:
mNotificationManager.notify(HELLO_ID, notification);

145
4.4. Inside a few System Services
● Get the AOSP ... repo, etc.
● Tricks:
● Import into Eclipse and collapse methods
● Use reverse-engineering tools:
– Imagix
– Rationale
– Lattix
– Scitools
– ...
● Be patient, this isn't documented anywhere ...

146
4.4.1. ActivityManager
● Start new Activities, Services
● Fetch Content Providers
● Intent broadcasting
● OOM adj. maintenance
● Application Not Responding
● Permissions
● Task management
● Lifecycle management

147
● Ex. starting new app from Launcher:
● onClick(Launcher)
● startActivity(Activity.java)
● <Binder>
● ActivityManagerService
● startViaZygote(Process.java)
● <Socket>
● Zygote

148
4.4.2. Package Manager
● 48 kloc
● 2.0 M
● Installation / removal
● Permissions
● Intent resolution (also IntentResolver.java)
● Called by Activity Manager

149
4.4.3. Window Manager
● Main thread
● Window manipulation
● Wallpaper handling
● Orientation
● Focus
● Layering
● Input event management

150
4.4.4. Notification Manager
● Toasts
● Notifications
● Sound playback (see NotificationPlayer.java)

151
4.4.5. Power Manager
● Wakelocks
● Sleep
● Brightness
● Lock

152
4.4.6. Network Management Service
● Talks to “netd” /system/netd
● Interface configuration
● Tethering
● DNS

153
4.4.7. Mount Service
● Mount / Unmount
● Format
● USB mass storage
● OBB

154
4.4.8. Location Manager
● Manage location providers
● getBestProvider()
● Proximity alerts
● Last known location

155
4.4.9. Status Bar Manager
● Expand / collapse
● Icon visibility
● Reveal callbacks
● Callbacks for notification manager

156
4.4.10. Backup Manager
● Enable / disable
● Transport management
● backupNow()
● ...

157
4.5. Creating your own System
Service
● Add your code to:
frameworks/base/services/java/com/android/server/
● Have the SystemServer.java init+reg. your service
● Define hardware API for apps
● Expose through:
● frameworks/base/core/java/android/os/[server].aidl
● Call on native “driver” code through JNI
● Implement or connect to appropriate driver
● Create an app that calls on service
● May need to create new SDK ...

159
4.5.1. OpersysService.java
package com.android.server;
import android.content.Context;
import android.os.Handler;
import android.os.IOpersysService;
import android.os.Looper;
import android.os.Message;
import android.os.Process;
import android.util.Log;
public class OpersysService extends IOpersysService.Stub {
    private static final String TAG = "OpersysService";
    private OpersysWorkerThread mWorker;
    private OpersysWorkerHandler mHandler;
    private Context mContext;
    public OpersysService(Context context) {
super();
mContext = context;
mWorker = new OpersysWorkerThread("OpersysServiceWorker");
mWorker.start();
Log.i(TAG, "Spawned worker thread");
    }
    public void setValue(int val) {
Log.i(TAG, "setValue " + val);
Message msg = Message.obtain();
msg.what = OpersysWorkerHandler.MESSAGE_SET;
msg.arg1 = val;
mHandler.sendMessage(msg);
    }

160
    private class OpersysWorkerThread extends Thread{
public OpersysWorkerThread(String name) {
    super(name);
}
public void run() {
    Looper.prepare();
    mHandler = new OpersysWorkerHandler();
    Looper.loop();
}
    }
    private class OpersysWorkerHandler extends Handler {
private static final int MESSAGE_SET = 0;
@Override
public void handleMessage(Message msg) {
    try {
if (msg.what == MESSAGE_SET) {
    Log.i(TAG, "set message received: " + msg.arg1);
}
    }
    catch (Exception e) {
// Log, don't crash!
Log.e(TAG, "Exception in OpersysWorkerHandler.handleMessage:", e);
     }
}
    }
}

161
4.5.2. IOpersysService.aidl
package android.os;
/**
* {@hide}
*/
interface IOpersysService {
String read(int maxLength);
int write(String mString);
void setValue(int val);
}

162
4.5.3. frameworks/base/Android.mk
...
core/java/android/os/IPowerManager.aidl
core/java/android/os/IOpersysService.aidl
core/java/android/os/IRemoteCallback.aidl
...

163
4.5.4. SystemServer.java
...
   try {
                Slog.i(TAG, "Opersys Service");
                ServiceManager.addService(“opersys”, new OpersysService(context));
            } catch (Throwable e) {
                Slog.e(TAG, "Failure starting OpersysService Service", e);
            }
...
Should eventually be Context.OPERSYS_SERVICE

164
4.5.5. HelloServer.java
package com.opersys.helloserver;
import android.app.Activity;
import android.os.Bundle;
import android.os.ServiceManager;
import android.util.Log;
public class HelloServer extends Activity {
    private static final String DTAG = "HelloServer";
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        IOpersysService om =
IOpersysService.Stub.asInterface(ServiceManager.getService("opersys"));
        try {
    Log.d(DTAG, "Going to call service");
    om.setValue(20);
    Log.d(DTAG, "Service called succesfully");
        }
        catch (Exception e) {
    Log.d(DTAG, "FAILED to call service");
    e.printStackTrace();
        }
    }
}

165
/frameworks/base/services/java/...
/frameworks/base/services/jni/
/hardware/libhardware/
/device/[MANUF.]/[DEVICE]
/sdk/emulator/
Kernel or module
/frameworks/base/core/...
AOSP-provided
ASL
Manuf.-provided
Manuf. license
Manuf.-provided
GPL-license

166
● [aosp]/hardware/libhardware/include/hardware
● gps.h
● lights.h
● sensors.h
● [aosp]/hardware/ril/include/telephony/
● ril.h
● Examples in [aosp]/device/samsung/crespo/
● libaudio
● libcamera
● liblight
● libsensors
● Using JNI to call C functions

167
6. Android Framework
● Location and components
● android.*
● Customization

168
6.1. Location and components
●
[aosp]/frameworks/base
● /cmds => native cmds and daemons
● /core => android.* and com.android.*
● /data => Fonts and sounds
● /graphics => 2D & Renderscript
●
/include => “C” includes
● /keystore => security key store
●
/libs => “C” libraries
●
/location => Location provider
●
/media => Stagefright, codecs, etc.
●
/native => Native code for some frameworks components
●
/obex => Bluetooth obex
● /opengl => GL library and java code
●
/packages => A few core packages (Status Bar)
● /services => System server
● /telephony => Phone related functionality
● /tools => A few core tools (aapt, aidl, ...)
● /voip => RTP & SIP interfaces
●
/vpn => VPN functionality
● /wifi => Wifi manager, monitor, etc.

169
6.2. android.*
accessibilityservice  content   hardware            pim         speech
accounts              database  inputmethodservice  preference  test
annotation            ddm       net                 provider    text
app                   debug     nfc                 security    util
appwidget             emoji     os                  server      view
bluetooth             gesture   service             webkit      widget

170
6.3. Customization
● Extending API
● Status bar

171
6.3.1. Extending API – System service
● frameworks/base/core/java/android/
● app/ContextImpl.java
● content/Context.java
● os/OpersysManager.java

172
6.3.1.1. app/ContextImpl.java
...
import android.os.OpersysManager;
...
     registerService(OPERSYS_SERVICE, new ServiceFetcher() {
             public Object createService(ContextImpl ctx) {
                 IBinder b =
                   ServiceManager.getService(OPERSYS_SERVICE);
                 IOpersysService service =
                   IOpersysService.Stub.asInterface(b);
                 return new OpersysManager(service);
             }});
...

173
6.3.1.2. content/Context.java
...
    /**
     * Use with {@link #getSystemService} to retrieve a
     * {@link android.nfc.NfcManager} for using NFC.
     *
     * @see #getSystemService
     */
    public static final String NFC_SERVICE = "nfc";
    /** The Opersys service **/
    public static final String OPERSYS_SERVICE = "opersys";
...

174
6.3.1.3. os/OpersysManager.java
package android.os;
import android.os.IOpersysService
public class OpersysManager
{
    public void setValue(int value)
    {
        try {
            mService.setValue(value);
        } catch (RemoteException e) {
        }
    }
    public OpersysManager(IOpersysService service)
    {
        mService = service;
    }
    IOpersysService mService;
}

175
6.3.2. Status bar
● Location:
● frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar
● Disable phone signal - SignalClusterView.java:
        if (mMobileVisible && !mIsAirplaneMode) {
            /* DISABLE
            mMobileGroup.setVisibility(View.VISIBLE);
            mMobile.setImageResource(mMobileStrengthId);
            mMobileActivity.setImageResource(mMobileActivityId);
            mMobileType.setImageResource(mMobileTypeId);
            mMobileGroup.setContentDescription(mMobileTypeDescription + ...
            */

176
● Disable battery meter -
policy/BatteryController.java:
            /* DISABLE
            for (int i=0; i<N; i++) {
                ImageView v = mIconViews.get(i);
                v.setImageResource(icon);
                v.setImageLevel(level);
                v.setContentDescription(mContext.getString(R.string.acces...
            }
            */

177
Thank you ...
karim.yaghmour@opersys.com

178
Acknowledgements:
● Some figures and snippets taken from Google's
Android “Dev Guide” at developer.android.com
distributed under the Apache 2.0 license.

Embedded Android Workshop with Nougat

More Related Content

What's hot (20)

Similar to Embedded Android Workshop with Nougat (20)

More from Opersys inc. (11)

Recently uploaded (20)

Embedded Android Workshop with Nougat