+
−.. -*- 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.
+
−