AndroidDebugBridge (Android Tools ddmlib)

java.lang.Object
- com.android.ddmlib.AndroidDebugBridge

```
public class AndroidDebugBridge
extends java.lang.Object
```
A connection to the host-side android debug bridge (adb)
This is the central point to communicate with any devices, emulators, or the applications running on them.
init(boolean) must be called before anything is done.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`AndroidDebugBridge.IClientChangeListener` Classes which implement this interface provide methods that deal with `Client` changes.
`static interface`	`AndroidDebugBridge.IDebugBridgeChangeListener` Classes which implement this interface provide a method that deals with `AndroidDebugBridge` changes (including restarts).
`static interface`	`AndroidDebugBridge.IDeviceChangeListener` Classes which implement this interface provide methods that deal with `IDevice` addition, deletion, and changes.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addClientChangeListener(AndroidDebugBridge.IClientChangeListener listener)` Adds the listener to the collection of listeners who will be notified when a `Client` property changed, by sending it one of the messages defined in the `AndroidDebugBridge.IClientChangeListener` interface.
`static void`	`addDebugBridgeChangeListener(AndroidDebugBridge.IDebugBridgeChangeListener listener)` Adds the listener to the collection of listeners who will be notified when a new `AndroidDebugBridge` is connected, by sending it one of the messages defined in the `AndroidDebugBridge.IDebugBridgeChangeListener` interface.
`static void`	`addDeviceChangeListener(AndroidDebugBridge.IDeviceChangeListener listener)` Adds the listener to the collection of listeners who will be notified when a `IDevice` is connected, disconnected, or when its properties or its `Client` list changed, by sending it one of the messages defined in the `AndroidDebugBridge.IDeviceChangeListener` interface.
`static AndroidDebugBridge`	`createBridge()` Creates a `AndroidDebugBridge` that is not linked to any particular executable.
`static AndroidDebugBridge`	`createBridge(java.lang.String osLocation, boolean forceNewBridge)` Creates a new debug bridge from the location of the command line tool.
`static void`	`disableFakeAdbServerMode()`
`static void`	`disconnectBridge()` Disconnects the current debug bridge, and destroy the object.
`static void`	`enableFakeAdbServerMode(int port)`
`static com.google.common.util.concurrent.ListenableFuture<AdbVersion>`	`getAdbVersion(java.io.File adb)`
`static AndroidDebugBridge`	`getBridge()` Returns the current debug bridge.
`int`	`getConnectionAttemptCount()` Returns the number of times the `AndroidDebugBridge` object attempted to connect to the adb daemon.
`IDevice[]`	`getDevices()` Returns the devices.
`com.google.common.util.concurrent.ListenableFuture<java.util.List<AdbDevice>>`	`getRawDeviceList()` Returns the set of devices reported by the adb command-line.
`int`	`getRestartAttemptCount()` Returns the number of times the `AndroidDebugBridge` object attempted to restart the adb daemon.
`static java.net.InetSocketAddress`	`getSocketAddress()` Returns the socket address of the ADB server on the host.
`boolean`	`hasInitialDeviceList()` Returns whether the bridge has acquired the initial list from adb after being created.
`static void`	`init(boolean clientSupport)` Initializes the `ddm` library.
`static void`	`init(boolean clientSupport, boolean useLibusb, java.util.Map<java.lang.String,java.lang.String> env)`
`static void`	`initIfNeeded(boolean clientSupport)` Initialized the library only if needed.
`boolean`	`isConnected()` Returns whether the `AndroidDebugBridge` object is still connected to the adb daemon.
`static void`	`removeClientChangeListener(AndroidDebugBridge.IClientChangeListener listener)` Removes the listener from the collection of listeners who will be notified when a `Client` property changes.
`static void`	`removeDebugBridgeChangeListener(AndroidDebugBridge.IDebugBridgeChangeListener listener)` Removes the listener from the collection of listeners who will be notified when a new `AndroidDebugBridge` is started.
`static void`	`removeDeviceChangeListener(AndroidDebugBridge.IDeviceChangeListener listener)` Removes the listener from the collection of listeners who will be notified when a `IDevice` is connected, disconnected, or when its properties or its `Client` list changed.
`boolean`	`restart()` Restarts adb, but not the services around it.
`void`	`setSelectedClient(Client selectedClient)` Sets the client to accept debugger connection on the custom "Selected debug port".
`static void`	`terminate()` Terminates the ddm library.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - initIfNeeded
```
public static void initIfNeeded(boolean clientSupport)
```
    Initialized the library only if needed.
    
    Parameters:
    
    clientSupport - Indicates whether the library should enable the monitoring and interaction with applications running on the devices.
    
    See Also:
    
    init(boolean)
  - init
```
public static void init(boolean clientSupport)
```
    Initializes the ddm library.
    This must be called once before any call to createBridge(String, boolean).
    The library can be initialized in 2 ways:
    - Mode 1: clientSupport == true.
      The library monitors the devices and the applications running on them. It will connect to each application, as a debugger of sort, to be able to interact with them through JDWP packets.
    - Mode 2: clientSupport == false.
      The library only monitors devices. The applications are left untouched, letting other tools built on ddmlib to connect a debugger to them.
    Only one tool can run in mode 1 at the same time.
    Note that mode 1 does not prevent debugging of applications running on devices. Mode 1 lets debuggers connect to ddmlib which acts as a proxy between the debuggers and the applications to debug. See Client.getDebuggerListenPort().
    The preferences of ddmlib should also be initialized with whatever default values were changed from the default values.
    When the application quits, terminate() should be called.
    Parameters:
    
    clientSupport - Indicates whether the library should enable the monitoring and interaction with applications running on the devices.
    
    See Also:
    
    createBridge(String, boolean), DdmPreferences
  - init
```
public static void init(boolean clientSupport,
                        boolean useLibusb,
                        @NonNull
                        java.util.Map<java.lang.String,java.lang.String> env)
```
  - enableFakeAdbServerMode
```
public static void enableFakeAdbServerMode(int port)
```
  - disableFakeAdbServerMode
```
public static void disableFakeAdbServerMode()
```
  - terminate
```
public static void terminate()
```
    Terminates the ddm library. This must be called upon application termination.
  - getSocketAddress
```
public static java.net.InetSocketAddress getSocketAddress()
```
    Returns the socket address of the ADB server on the host.
  - createBridge
```
public static AndroidDebugBridge createBridge()
```
    Creates a AndroidDebugBridge that is not linked to any particular executable.
    This bridge will expect adb to be running. It will not be able to start/stop/restart adb.
    If a bridge has already been started, it is directly returned with no changes (similar to calling getBridge()).
    
    Returns:
    
    a connected bridge.
  - createBridge
```
@Nullable
public static AndroidDebugBridge createBridge(@NonNull
                                                        java.lang.String osLocation,
                                                        boolean forceNewBridge)
```
    Creates a new debug bridge from the location of the command line tool.
    Any existing server will be disconnected, unless the location is the same and forceNewBridge is set to false.
    
    Parameters:
    
    osLocation - the location of the command line tool 'adb'
    
    forceNewBridge - force creation of a new bridge even if one with the same location already exists.
    
    Returns:
    
    a connected bridge, or null if there were errors while creating or connecting to the bridge
  - getBridge
```
@Nullable
public static AndroidDebugBridge getBridge()
```
    Returns the current debug bridge. Can be null if none were created.
  - disconnectBridge
```
public static void disconnectBridge()
```
    Disconnects the current debug bridge, and destroy the object.
    This also stops the current adb host server.
    A new object will have to be created with createBridge(String, boolean).
  - addDebugBridgeChangeListener
```
public static void addDebugBridgeChangeListener(@NonNull
                                                AndroidDebugBridge.IDebugBridgeChangeListener listener)
```
    Adds the listener to the collection of listeners who will be notified when a new AndroidDebugBridge is connected, by sending it one of the messages defined in the AndroidDebugBridge.IDebugBridgeChangeListener interface.
    
    Parameters:
    
    listener - The listener which should be notified.
  - removeDebugBridgeChangeListener
```
public static void removeDebugBridgeChangeListener(AndroidDebugBridge.IDebugBridgeChangeListener listener)
```
    Removes the listener from the collection of listeners who will be notified when a new AndroidDebugBridge is started.
    
    Parameters:
    
    listener - The listener which should no longer be notified.
  - addDeviceChangeListener
```
public static void addDeviceChangeListener(@NonNull
                                           AndroidDebugBridge.IDeviceChangeListener listener)
```
    Adds the listener to the collection of listeners who will be notified when a IDevice is connected, disconnected, or when its properties or its Client list changed, by sending it one of the messages defined in the AndroidDebugBridge.IDeviceChangeListener interface.
    
    Parameters:
    
    listener - The listener which should be notified.
  - removeDeviceChangeListener
```
public static void removeDeviceChangeListener(AndroidDebugBridge.IDeviceChangeListener listener)
```
    Removes the listener from the collection of listeners who will be notified when a IDevice is connected, disconnected, or when its properties or its Client list changed.
    
    Parameters:
    
    listener - The listener which should no longer be notified.
  - addClientChangeListener
```
public static void addClientChangeListener(AndroidDebugBridge.IClientChangeListener listener)
```
    Adds the listener to the collection of listeners who will be notified when a Client property changed, by sending it one of the messages defined in the AndroidDebugBridge.IClientChangeListener interface.
    
    Parameters:
    
    listener - The listener which should be notified.
  - removeClientChangeListener
```
public static void removeClientChangeListener(AndroidDebugBridge.IClientChangeListener listener)
```
    Removes the listener from the collection of listeners who will be notified when a Client property changes.
    
    Parameters:
    
    listener - The listener which should no longer be notified.
  - getDevices
```
@NonNull
public IDevice[] getDevices()
```
    Returns the devices.
    
    See Also:
    
    hasInitialDeviceList()
  - hasInitialDeviceList
```
public boolean hasInitialDeviceList()
```
    Returns whether the bridge has acquired the initial list from adb after being created.
    Calling getDevices() right after createBridge(String, boolean) will generally result in an empty list. This is due to the internal asynchronous communication mechanism with adb that does not guarantee that the IDevice list has been built before the call to getDevices().
    The recommended way to get the list of IDevice objects is to create a AndroidDebugBridge.IDeviceChangeListener object.
  - setSelectedClient
```
public void setSelectedClient(Client selectedClient)
```
    Sets the client to accept debugger connection on the custom "Selected debug port".
    
    Parameters:
    
    selectedClient - the client. Can be null.
  - isConnected
```
public boolean isConnected()
```
    Returns whether the AndroidDebugBridge object is still connected to the adb daemon.
  - getConnectionAttemptCount
```
public int getConnectionAttemptCount()
```
    Returns the number of times the AndroidDebugBridge object attempted to connect to the adb daemon.
  - getRestartAttemptCount
```
public int getRestartAttemptCount()
```
    Returns the number of times the AndroidDebugBridge object attempted to restart the adb daemon.
  - getAdbVersion
```
public static com.google.common.util.concurrent.ListenableFuture<AdbVersion> getAdbVersion(@NonNull
                                                                                           java.io.File adb)
```
  - getRawDeviceList
```
public com.google.common.util.concurrent.ListenableFuture<java.util.List<AdbDevice>> getRawDeviceList()
```
    Returns the set of devices reported by the adb command-line. This is mainly intended for the Connection Assistant or other diagnostic tools that need to validate the state of the getDevices() list via another channel. Code that just needs to access the list of devices should call getDevices() instead.
  - restart
```
public boolean restart()
```
    Restarts adb, but not the services around it.
    
    Returns:
    
    true if success.

Class AndroidDebugBridge

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

initIfNeeded

init

init

enableFakeAdbServerMode

disableFakeAdbServerMode

terminate

getSocketAddress

createBridge

createBridge

getBridge

disconnectBridge

addDebugBridgeChangeListener

removeDebugBridgeChangeListener

addDeviceChangeListener

removeDeviceChangeListener

addClientChangeListener

removeClientChangeListener

getDevices

hasInitialDeviceList

setSelectedClient

isConnected

getConnectionAttemptCount

getRestartAttemptCount

getAdbVersion

getRawDeviceList

restart