android.rst
author Oleksandr Gavenko <gavenkoa@gmail.com>
Tue, 10 Mar 2015 21:02:47 +0200
changeset 1694 46dd85e3d6c6
parent 1669 12f6f6b95b7c
child 1695 67e3552bd7f6
permissions -rw-r--r--
Move important info higher.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1669
12f6f6b95b7c Add standard header.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1592
diff changeset
     1
.. -*- coding: utf-8; -*-
12f6f6b95b7c Add standard header.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1592
diff changeset
     2
.. include:: HEADER.rst
1565
e59b35de5f28 Controlling Android from PC.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     3
e59b35de5f28 Controlling Android from PC.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     4
==========
e59b35de5f28 Controlling Android from PC.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     5
 Android.
e59b35de5f28 Controlling Android from PC.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     6
==========
e59b35de5f28 Controlling Android from PC.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     7
.. contents::
e59b35de5f28 Controlling Android from PC.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     8
1573
e38409881775 Official docs.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1565
diff changeset
     9
Official docs.
e38409881775 Official docs.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1565
diff changeset
    10
==============
e38409881775 Official docs.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1565
diff changeset
    11
e38409881775 Official docs.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1565
diff changeset
    12
  http://developer.android.com/sdk/index.html
e38409881775 Official docs.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1565
diff changeset
    13
    Get the Android SDK
e38409881775 Official docs.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1565
diff changeset
    14
  http://developer.android.com/guide/index.html
e38409881775 Official docs.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1565
diff changeset
    15
    Introduction to Android
1578
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    16
  https://android.googlesource.com/platform/system/core/+/master/init/readme.txt
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    17
    init.rd file syntax.
1573
e38409881775 Official docs.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1565
diff changeset
    18
1575
440521afe31e CyanogenMod
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1573
diff changeset
    19
Mods.
440521afe31e CyanogenMod
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1573
diff changeset
    20
=====
440521afe31e CyanogenMod
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1573
diff changeset
    21
1576
33d2941a5c73 http://xda-university.com/
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1575
diff changeset
    22
  http://xda-university.com/
33d2941a5c73 http://xda-university.com/
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1575
diff changeset
    23
    How to mod.
1575
440521afe31e CyanogenMod
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1573
diff changeset
    24
  http://www.cyanogenmod.org/about
440521afe31e CyanogenMod
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1573
diff changeset
    25
    CyanogenMod
1578
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    26
  https://www.clockworkmod.com/
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    27
    ClockworkMod
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    28
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    29
Recovery.
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    30
=========
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    31
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    32
To enter phone to recovery mode press ``VolumeDown``+``Power`` button or::
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    33
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    34
  adb reboot recovery
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    35
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    36
See:
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    37
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    38
  http://teamw.in/project/twrp2
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    39
    Custom recovery built.
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    40
1582
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    41
ADB tips.
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    42
=========
1578
c97cd8248a24 init.rd file syntax.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1576
diff changeset
    43
1582
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    44
List available devices::
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    45
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    46
  $ adb devices
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    47
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    48
Install application from ``.apk`` file::
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    49
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    50
  $ adb install -r /path/to/application.apk
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    51
1592
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    52
List installed package names (with path to ``.apk`` files!)::
1582
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    53
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    54
  $ adb shell 'pm list packages -f'
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    55
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    56
Uninstall application by it name::
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    57
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    58
  $ adb uninstall PACKAGE_NAME
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    59
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    60
List currently run activities::
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    61
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    62
  $ adb shell 'dumpsys activity'
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    63
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    64
Find activities from package::
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    65
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    66
  $ adb shell 'pm list packages -f'
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    67
  $ adb pull APK_FROM_LIST
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    68
  $ aapt dump badging APK_FILE
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    69
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    70
Start an activity::
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    71
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    72
  $ adb shell am start PACKAGE_NAME/ACTIVITY_IN_PACKAGE
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    73
  $ adb shell am start PACKAGE_NAME/FULLY_QUALIFIED_ACTIVITY
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    74
1592
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    75
List of running processes::
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    76
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    77
  $ adb shell ps
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    78
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    79
or (supported arguments
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    80
``user,group,comm,args,pid,ppid,pgid,etime,nice,rgroup,ruser,time,tty,vsz,stat,rss``)::
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    81
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    82
  $ adb shell
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    83
  % ps -o pid,user,group,rss,vsz,args
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    84
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    85
To kill process::
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    86
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    87
  $ adb shell ps | grep $REGEX
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    88
  $ adb shell kill $PID
5ebe526dd687 List of running processes.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1582
diff changeset
    89
1582
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    90
Take a screenshort::
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    91
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    92
  $ adb shell screencap -p | perl -pe 's/\x0D\x0A/\x0A/g' > screen.png
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    93
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    94
Power button::
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    95
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    96
  $ adb shell input keyevent 26
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    97
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    98
Unlock screen::
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
    99
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
   100
  $ adb shell input keyevent 82
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
   101
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
   102
Show system log::
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
   103
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
   104
  $ adb logcat
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
   105
  $ adb logcat "*:W"
1551e7edcfa0 ADB tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1578
diff changeset
   106
1694
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   107
Controlling Android from PC.
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   108
============================
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   109
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   110
 * http://code.google.com/p/androidscreencast/
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   111
 * http://code.google.com/p/android-screen-monitor/
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   112
 * http://androidwebkey.com/
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   113
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   114
Show screencast from Android.
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   115
=============================
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   116
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   117
  http://droid-at-screen.ribomation.com/
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   118
                Easily show the screen of an Android device on a computer/laptop
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   119
                (PC, Mac, Linux, ...) and then project the desktop using a
46dd85e3d6c6 Move important info higher.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1669
diff changeset
   120
                LCD-projector.