.. -*- coding: utf-8; -*-
==========
Android.
==========
.. contents::
:local:
Official docs
=============
http://developer.android.com/sdk/index.html
Get the Android SDK
http://developer.android.com/guide/index.html
Introduction to Android
https://android.googlesource.com/platform/system/core/+/master/init/readme.txt
init.rd file syntax.
Getting tools
=============
https://developer.android.com/studio/releases/platform-tools.html
SDK Platform Tools (includes adb and fastboot) download and rellease
changelog.
https://developer.android.com/studio/index.html
Android Studio (official IDE for Android) and sdk-tools (includes ``sdkmanager``).
Android emulator
================
Intel provided images and hypervisor to run x86 Android port with acceleration:
https://software.intel.com/en-us/articles/intel-hardware-accelerated-execution-manager-intel-haxm
Intel® Hardware Accelerated Execution Manager (Intel® HAXM). It is available from SDK manager
also.
It starts service. To manage service use::
sc stop intelhaxm
sc start intelhaxm
Android stats
=============
CPU::
$ cat /proc/cpuinfo
$ cat /proc/cpufreq/cpufreq_freq
Memory::
$ cat /proc/meminfo
Android API levels.
===================
http://developer.android.com/guide/topics/manifest/uses-sdk-element.html
"Platform Version / API Level" table.
Package repositories.
=====================
https://play.google.com/
Google package repository.
https://f-droid.org/
Free software repository.
http://www.appbrain.com/
AppBrain, alternative catalog to Google Play. Packages is backed via lisnk
to Google Play.
Link to package description page::
https://play.google.com/store/apps/details?id=com.google.android.talk
See also:
http://android.stackexchange.com/questions/216/what-are-the-alternative-android-app-markets/
What are the alternative Android app markets?
Mods.
=====
http://xda-university.com/
How to mod.
http://www.cyanogenmod.org/about
CyanogenMod
https://www.clockworkmod.com/
ClockworkMod
Connect to Android via USB by adb in Linux
==========================================
Add ``udev`` rule for fix permission issues::
$ cat /etc/udev/rules.d/90-android.rules
# Standard Google device.
SUBSYSTEM=="usb", ATTR{idVendor}=="0bb4", ATTR{idProduct}=="0c03", MODE="0666", GROUP="plugdev"
# China N101 II
SUBSYSTEM=="usb", ATTR{idVendor}=="2207", ATTR{idProduct}=="0010", MODE="0666", GROUP="plugdev"
Reload udev rules and re-plug device via USB::
$ sudo service udev force-reload
See:
http://developer.android.com/tools/device.html
Setting up a Device for Development.
Connect to Android via USB by adb in Windows
============================================
Get latest official Google drivers from:
https://developer.android.com/studio/run/win-usb.html
Get the Google USB Driver.
If your device isn't in official list you can try to find driver in `Windows
update catalog at http://www.catalog.update.microsoft.com`__.
__ http://www.catalog.update.microsoft.com
Use search by vendor or device name, or string ``adb``. Alternatively use
`hardware id`_.
BTW older version of official Google drivers are also in `Windows update
catalog`__.
__ http://www.catalog.update.microsoft.com/Search.aspx?q=google+adb
Most probably you will fail to find drivers for numerous Chinese/noname Android
devices. We can reuse official Google drivers. To do that:
.. _hardware id:
* Find your USB's hardware VID and PID. Locate your device in *Device Manager*,
open Properties => Details => Hardware Ids and copy (by ``Ctrl+C``) string
like::
USB\VID_2A45&PID_201D&MI_01
* Extract official Google's ADB driver package::
unzip latest_usb_driver_windows.zip
* Locate and modify driver's ``.inf`` file (in my case it was
``android_winusb.inf``) by adding lines, like::
; Meizu
%SingleAdbInterface% = USB_Install, USB\VID_2A45&PID_201D
%CompositeAdbInterface% = USB_Install, USB\VID_2A45&PID_201D&MI_01
to all sections that has similar lines setting your own `hardware id`_
that we've extracted.
* Temporary disable driver signing enforcement (run from Administrator, ``Win``,
type ``cmd``, ``Ctrl+Shift+Enter``)::
cmd# bcdedit /set testsigning off
and reboot. You'll see ``Test mode`` sign in right lower corner of desktop.
* Locate your decive, then follow *Properties => Driver => Update => Browse my computer =>
Let me pick => Hard Disk...*. Select *Android Composite ADB interface* driver
and ignore security warning about broken file signature.
* Enable signing checks back::
cmd# bcdedit /set testsigning on
and reboot. Hurrah!
.. note::
As you see Google's adb driver works fine with any Android phone. It's
Microsoft policy to forbid class drivers so each vendor is required to
provide same driver with different hardware ID and to pay money for Windows
Logo® program and signing process.
.. tip::
``bcdedit`` can be run with alternative options::
cmd# bcdedit.exe /set nointegritychecks on
cmd# bcdedit.exe /set nointegritychecks off
Recovery.
=========
To enter phone to recovery mode press ``VolumeDown``+``Power`` button or::
adb reboot recovery
See:
http://teamw.in/project/twrp2
Custom recovery built.
ADB tips.
=========
List available devices::
$ adb devices
Install application from ``.apk`` file::
$ adb install -r /path/to/application.apk
List installed package names (with path to ``.apk`` files!)::
$ adb shell 'pm list packages -f'
$ adb shell 'cmd package list packages -f'
Uninstall application by its package name::
$ adb uninstall PACKAGE_NAME
Disable/enable application::
$ adb shell pm disable PACKAGE_NAME
$ adb shell pm enable PACKAGE_NAME
List of disabled packages::
$ adb shell pm list packages -d
List of application properties (version, permissions, etc)::
$ adb shell dumpsys package $PKG
List currently run activities::
$ adb shell 'dumpsys activity'
Find activities from package::
$ adb shell 'pm list packages -f'
$ adb pull APK_FROM_LIST
$ aapt dump badging APK_FILE
Start an activity::
$ adb shell am start PACKAGE_NAME/ACTIVITY_IN_PACKAGE
$ adb shell am start PACKAGE_NAME/FULLY_QUALIFIED_ACTIVITY
Start an activity with action filter::
android# am start -a com.example.ACTION_NAME -n com.package.name/com.package.name.ActivityName
List of running processes::
$ adb shell ps
or (supported arguments
``user,group,comm,args,pid,ppid,pgid,etime,nice,rgroup,ruser,time,tty,vsz,stat,rss``)::
$ adb shell
% ps -o pid,user,group,rss,vsz,args
To kill process::
$ adb shell ps | grep $REGEX
$ adb shell kill $PID
To stop application::
$ adb shell am kill com.google.android.contacts
$ adb shell am force-stop com.google.android.contacts
Take a screenshort::
$ adb shell screencap -p | perl -pe 's/\x0D\x0A/\x0A/g' > screen.png
Power button::
$ adb shell input keyevent 26
Unlock screen::
$ adb shell input keyevent 82
Show system log::
$ adb logcat
$ adb logcat "*:W"
dumpsys
=======
Info from all services::
$ adb shell dumpsys
List of available services::
$ adb shell service list
Info from concrete service::
$ adb shell dumpsys phone
$ adb shell dumpsys diskstats
$ adb shell dumpsys usb
$ adb shell dumpsys activity
$ adb shell dumpsys package
$ adb shell dumpsys display
$ adb shell dumpsys gfxinfo
$ adb shell dumpsys power
$ adb shell dumpsys battery
$ adb shell dumpsys batteryinfo
$ adb shell dumpsys cpuinfo
$ adb shell dumpsys dbinfo
$ adb shell dumpsys meminfo
$ adb shell dumpsys account
$ adb shell dumpsys netstats
* https://source.android.com/devices/tech/debug/dumpsys.html
* http://stackoverflow.com/questions/11201659/whats-the-android-adb-shell-dumpsys-tool-and-what-are-its-benefits
List partition.
===============
List partitions (with sizes)::
android# cat /proc/partitions
android# cat /proc/mtd
List mounted file systems::
android# mount
android# df
Remount /system as RW
=====================
Usually with::
$ adb remount
If you have root but above command fail::
$ adb shell
android# su
android# mount | grep /system
...
android# mount -o remount,rw /system
Working with apk files
======================
Getting package name, version, API requirements and permissions::
$ aapt dump badging $FILE.apk
Controlling Android from PC.
============================
* http://code.google.com/p/androidscreencast/
* http://code.google.com/p/android-screen-monitor/
* http://androidwebkey.com/
Show screencast from Android.
=============================
http://droid-at-screen.org/
Easily show the screen of an Android device on a computer/laptop (PC, Mac,
Linux, ...) and then project the desktop using a LCD-projector.
http://droid-at-screen.ribomation.com/
Old DNS name.