• Send Emulator console commands
    • Start and stop a console session
    • Emulator command reference
      • Fingerprint simulation and validation

    Send Emulator console commands

    Each running virtual device provides a console that lets you query and control the emulateddevice environment. For example, you can use the console to manage port redirection, network characteristics, and telephony events while your app is running on the emulator.

    The following commands require that you already have an emulator running. For more information about running an emulator, see Run Apps on the Android Emulator and Start the Emulator from the Command Line.

    Start and stop a console session

    To access the console and enter commands, from a terminal window, use telnet toconnect to theconsole port and provide your authentication token. Each time the console displaysOK, it's ready to accept commands. It doesn't have a typical prompt.

    To connect to the console of a running virtual device:

    • Open a terminal window and enter the following command:
    1. telnet localhost console-port

    The emulator window title lists the console port number. For example, the window title for an emulator using console port 5554 could be Nexus_5X_API_23:5554. Also, the adb devices command prints a list of running virtual devices and their console port numbers. For more information, see Querying for Emulator/Device Instances.

    Note: The emulator listens for connections on ports 5554 to 5585 and accepts connections from localhost only.

    • After the console displays OK, enter the auth
      auth_token
      command.
      Before you can enter console commands, the emulator console requires authentication. auth_token must match the contents of the .emulator_console_auth_token file in your home directory.

    If that file doesn't exist, the telnet localhost console-port command creates the file, which contains a randomly generated authentication token. To disable authentication, delete the token from the .emulator_console_auth_token file or create an empty file if it doesn't exist.

    • After you're connected to the console, enter console commands.
      Enter help, help command, or help-verbose to see a list of console commands and learn about specific commands.

    • To exit the console session, enter quit or exit.
      Here's an example session:

    1. $ telnet localhost 5554
    2. Trying ::1...
    3. telnet: connect to address ::1: Connection refused
    4. Trying 127.0.0.1...
    5. Connected to localhost.
    6. Escape character is '^]'.
    7. Android Console: Authentication required
    8. Android Console: type 'auth <auth_token>' to authenticate
    9. Android Console: you can find your <auth_token> in
    10. '/Users/me/.emulator_console_auth_token'
    11. OK
    12. auth 123456789ABCdefZ
    13. Android Console: type 'help' for a list of commands
    14. OK
    15. help-verbose
    16. Android console command help:
    17.  
    18. help|h|? print a list of commands
    19. help-verbose print a list of cmmands with descriptions
    20. ping check if the emulator is alive
    21. event simulate hardware events
    22. geo Geo-location commands
    23. gsm GSM related commands
    24. cdma CDMA related commands
    25. crash crash the emulator instance
    26. crash-on-exit simulate crash on exit for the emulator instance
    27. kill kill the emulator instance
    28. network manage network settings
    29. power power related commands
    30. quit|exit quit control session
    31. redir manage port redirections
    32. sms SMS related commands
    33. avd control virtual device execution
    34. sensor manage emulator sensors
    35. finger manage emulator fingerprint
    36. debug control the emulator debug output tags
    37. rotate rotate the screen by 90 degrees
    38.  
    39. try 'help <command>' for command-specific help
    40. OK
    41. exit
    42. Connection closed by foreign host.

    Emulator command reference

    The following table describes the emulator console commands with their parameters and values.

    Table 1. Emulator console commands

    General CommandsDescription
    avd {stop|start|status|name} Query, control, and manage the virtual device, as follows:
    - stop: Stop the execution of the device.
    - start: Start the execution of the device.
    - status: Query the virtual device status, which can be running or stopped.
    - name: Query the virtual device name.
    avd snapshot {list|save name|load name|delete
    name}
    Save and restore the device state in snapshots, as follows:
    - list: List all saved snapshots.
    - save name: Save the snapshot as name.
    - load name: Load the named snapshot.
    - delete name: Delete the named snapshot.
    The following example saves a snapshot with the name firstactivitysnapshot.


    1. avd snapshot save firstactivitysnapshot


    fold Fold the device to display its smaller screen configuration (if the device is foldable and currently unfolded).
    unfold Unfold the device to display its larger screen configuration (if the device is foldable and currently folded).
    kill Terminate the virtual device.
    ping Check whether the virtual device is running.
    rotate Rotate the AVD counterclockwise in 45 degree increments.
    Crash the emulatorDescription
    crash Crash the emulator during app execution.
    crash-on-exitCrash the emulator when the app exits.
    Debug tagsDescription
    debug tags …
    Enable or disable debug messages from specific parts of the emulator. The tags parameter must be a value from the list of debug tags that appears when you execute emulator -help-debug-tags. For more information about the -help-debug-tags option, see Commonly used emulator options.

    The following example enables the radio tag:


    1. debug radio


    Port redirectionDescription
    redir list List the current port redirection.
    redir add protocol:host-port:guest-port Add a new port redirection, as follows:
    - protocol: Must be either tcp or udp.
    - host-port: The port number to open on the host.
    - guest-port: The port number to route data to on the emulator.
    redir del protocol:host-port Delete a port redirection.
    - protocol: Must be either tcp or udp.
    - host-port: The port number to open on the host.
    Geographic locationDescription
    Set the geographic location reported to the apps running inside an emulator by sending a GPS fix to the emulator.
    You can issue the geo command as soon as a virtual device is running. The emulator sets the location you enter by creating a mock location provider. This provider responds to location listeners set by apps, and also supplies the location to the LocationManager. Any app can query the location manager to obtain the current GPS fix for the emulated device by callingLocationManager.getLastKnownLocation("gps")
    geo fix longitude latitude satellites [altitude] Send a simple GPS fix to the emulator. Specify longitude and latitude in decimal degrees. Use a number from 1 to 12 to specify the number of satellites to use to determine the position, and specify altitude in meters.
    geo nmea sentence Send an NMEA 0183 sentence to the emulated device, as if it were sent from an emulated GPS modem. Start sentence with '$GP'. Only '$GPGGA' and '$GPRCM' sentences are currently supported. The following example is a GPGGA (Global Positioning System Fix Data) sentence that gets the time, position, and fix data for a GPS receiver:

    1. geo nmea $GPGGA ,hhmmss.ss,llll.ll,a,yyyyy.yy,a,x,xx,x.x,x.x,M,x.x,M,x.x,xxxx


    Fake hardware eventsDescription
    event types List all fake event types. For events that have codes, the number of codes is listed in parens on the right.
    event send types [types …] Send one or more fake event types.
    event codes type List the event codes for the specified fake event type.
    event send type[:code]:[value] […] Send one or more fake events with optional codes and code values. The following example sends three events where the last two include an event code.

    1. event send EVPWR EV_SW:SW_LID EV_REL:REL_X


    event text message Send a string of characters that simulate keypresses. The message must be a UTF-8 string. Unicode posts are reverse-mapped according to the current device keyboard, and unsupported characters are discarded silently.
    Control the power state reported by the emulator to appsDescription
    power display Display battery and charger state.
    power ac {on|off} Set AC charging state to on or off.
    power status {unknown|charging|discharging|not-charging|full} Change battery status as specified.
    power present {true|false} Set battery presence state.
    power health {unknown|good|overheat|dead|overvoltage|failure} Set battery health state.
    power capacity percent Set remaining battery capacity state as a percent from 0 to 100.
    Network connection statusDescription
    network status Check the network status and current delay and speed characteristics.
    network delay latency Change the emulated network latency.
    The emulator lets you simulate various network latency levels, so that you can test yourapp in an environment more typical of the actual conditions in which it will run. You canset a latency level or range at emulator startup, or you can use theconsole to change the latency while the app is running in the emulator.

    To set latency at emulator startup, use the -netdelay emulator option with a supported latency value, as listed in the Network latency format list below. Here are some examples:


    1. emulator -netdelay gprs
      emulator -netdelay 40,100


    To make changes to network delay while the emulator is running, connect to the console and use the netdelay command with a supported latency value from the Network latency format list below.


    1. network delay gprs
      network delay 40 100



    Network latency format:

    The format of network _latency is one of the following (numbers are milliseconds):

    - gprs: GPRS, which uses a latency range of 150 minimum and 550 maximum.
    - edge: EDGE/EGPRS, which uses a latency range of 80 minimum and 400 maximum.
    - umts: UMTS/3G, which uses a latency range of 35 minimum and 200 maximum.
    - none: No latency.
    - num: Emulate the specified latency in milliseconds.
    - min:max: Emulate the specified latency range.
    network speed speedThe emulator lets you simulate various network transfer rates.
    You can set a transfer rate or range at emulator startup, or you can use the console to change the rate, while the app is running in the emulator.

    To set the network speed at emulator startup, use the -netspeed emulator option with a supported speed value, as listed in the network speed format list below. Here are some examples:


    1. emulator -netspeed gsm @Pixel_API_26
      emulator -netspeed 14.4,80 @Pixel_API_26



    To make changes to network speed while the emulator is running, connect to the console and use the network speed command with a supported speed value from the Network speed format list below.


    1. network speed 14.4 80



    Network speed format:

    The format of network speed is one of the following (numbers are kilobits/sec):

    - gsm: GSM/CSD, which uses a speed of 14.4 up and 14.4 down.
    - hscsd: HSCSD, which uses a speed of 14.4 up and 43.2 down.
    - gprs: GPRS, which uses a speed of 40.0 up and 80.0 down.
    - edge: EDGE/EGPRS, which uses a speed of 118.4 up and 236.8 down.
    - umts: UMTS/3G, which uses a speed of 128.0 up and 1920 down.
    - hsdpa: HSDPA, which uses a speed of 348.0 up and 14400.0 down.
    - lte: LTE, which uses a speed of 58,000 up and 173,000 down.
    - evdo: EVDO, which uses a speed of 75,000 up and 280,000 down.
    - full: Unlimited speed, but depends on the connection speed of your computer.
    - num: Set an exact rate in kilobits/sec used for both upload and download.
    - up:down: Set exact rates in kilobits/sec for upload and download separately.
    network capture {start|stop} fileSend packets to a file. The following list describes the parameters and parameter values:
    - start file: Start sending packets to the specified file.
    - stop file: Stop sending packets to the specified file.
    Telephony emulationDescription
    The Android emulator includes its own GSM and CDMA emulated modems that let you simulate telephonyfunctions in the emulator. For example, with GSM you can simulate inbound phone calls and establishand terminate data connections. With CDMA you provide a subscription source and the preferredroaming list. The Android system handles simulated calls exactly as it would actual calls. Theemulator does not support call audio.
    gsm {call|accept|cancel|busy} phonenumber The gsm parameters are the following:
    - call: Simulate an inbound phone call from phonenumber.
    - accept: Accept an inbound call from phonenumber and change the call state to active. You can change a call state to active only when its current state is waiting or held.
    - cancel: Terminate an inbound or outbound phone call to or from phonenumber.
    - busy: Close an outbound call to phonenumber and change the call state to busy. You can change a call state to busy only when its current state is waiting.
    gsm {data|voice} state The data state command changes the state of the GPRS data connection, and the data voice state changes the state of the GPRS voice connection, as follows:
    - unregistered: No network available.
    - home: On local network, non-roaming.
    - roaming: On roaming network.
    - searching: Searching networks.
    - denied: Emergency calls only.
    - off: Same as unregistered.
    - on: Same as home.
    gsm hold Change the state of a call to hold. You can change a call state to hold only when its current state is active or waiting.
    gsm list List all inbound and outbound calls and their states.
    gsm status Report the current GSM voice/data state. Values are those described for the voice and data commands.
    gsm signal {rssi|ber} Change the reported signal strength (rssi) and bit error rate (ber) on the next 15 seconds of update. The following list describes the parameters and their values:
    - rssi range is 0 through 31 and 99 for unknown.
    - ber range is 0 through 7 and 99 for unknown.
    gsm signal-profile num Set the signal strength profile. Enter a number from 0 through 4.
    cdma ssource source source: Set the current CDMA subscription source where source is a network-based white list that contains the CDMA carrier's subscribers and their values, as follows:
    - nv: Read subscription from non-volatile RAM.
    - ruim: Read subscription from Removable User Identity Module (RUIM).
    cdma prl_version version Dump the current preferred roaming list (PRL) version. The version number is for the PRL database that contains information used during the system selection and acquisition process.
    Manage Sensors on the emulatorDescription
    These commands relate to which sensors are available in the AVD. Besides using the sensor command, you can see and adjust the settings in the emulator in the Virtual sensors screen in the Accelerometer and Additional sensors tabs. For more information, see Working with the extended controls, settings, and help.
    sensor status List all sensors and their status. The following is example output for the sensor status command:
    sensor get sensor-name Get the settings for sensor-name. The following example gets the value for the acceleration sensor:

    1. sensor get acceleration
      acceleration = 2.23517e-07:9.77631:0.812348



    The acceleration values separated by colons(:) refer to the x, y, and z coordinates for the virtual sensors described in Working with the extended controls, settings, and help.
    sensor set sensor-name value-x:value-y:value-z Set the values for sensor-name. The following example sets the acceleration sensor to the following x, y, and z values separated by colons. For more information, see Working with the extended controls, settings, and help.

    1. sensor set acceleration 2.23517e-07:9.77631:0.812348


    SMS emulationDescription
    sms send sender-phone-number textmessage Generate an emulated incoming SMS. The following list describes the parameter and their values:
    - sender-phone-number: Contains an arbitrary numeric string.
    - textmessage: The sms message.
    The following example sends the message "hi there" to the 4085555555 phone number.


    1. sms send 4085555555 hi there



    The console forwards the SMS message to the Android framework, which passes it to an app on the emulator that handles SMS, such as the Messages app. If you pass 10 numbers, the app formats it as a phone number. Longer or shorter numeric strings display the way you sent them.


    Fingerprint simulationDescription
    finger touch fingerprint-id Simulate a finger touching the sensor.
    finger remove Simulate finger removal.
    For instructions about how to use these commands, see Fingerprint simulation and validation.

    Fingerprint simulation and validation

    Send emulator console commands - 图1
    Figure 1. Fingerprint authentication screen.

    Use the finger command to simulate and validate fingerprint authentication for yourapp. You need SDK Tools 24.3 or higher, and Android 6.0 (API level 23) or higher.

    To simulate and validate fingerprint authentication, follow these steps:

    • If you don't yet have a fingerprint ID, enroll a new fingerprint in the emulator by selecting Settings > Security > Fingerprint and following the enrollment instructions.
    • Set up your app to accept fingerprint authentication. After you perform this setup, your device displays the fingerprint authentication screen.
    • While your app displays the fingerprint authentication screen, go to the console and enter the finger touch command and the fingerprint ID you created. This simulates a finger touch.
    • Then, enter the finger remove command to simulate finger removal.
      Your app should respond as if a user touched and then removed their finger from the fingerprint sensor.