◆版权声明：本文出自carter_dream的博客，转载必须注明出处。
转载请注明出处：http://www.cnblogs.com/by-dream/p/4651724.html
前言
由于本人精力平有限，所以这里简单的说说ADB源码。
首先根据前面的理解，我们已经知道了ADB是“连接手机和PC的一个桥梁”，我们经常在PC端开发的时候，会用到eclipse这个工具，这里面有一个工具叫DDMS，如下图：
是不是发现通过DDMS在PC端可以看到手机的一些信息，其实呢 它就是通过 “ddmlib.jar” 来建立起ADB的。因此我们今天就通过反编译 “ddmlib.jar” 来分析一下ADB源码。
反编译
首先不得不吐槽一下百度经验的审核人员，我看到里面“反编译jar”的经验没有，于是呢我就写了一个提交了上去，结果提交了很多次，都给我打回了，真不知道这帮审核的人员是怎么想的，这种方便别人参考的内容难道不应该被通过吗？切
好了，说正事吧。
ddmlib.jar 放在 <SDk path>\tools\libs 的文件夹下。
整个反编译的过程如下：
1、下载jd-gui-0.3.3.windows.zip （我的微云链接：http://url.cn/Zz8sOj ）
2、解压之后打开，将要编译的jar导入：
3、展开坐标的树形结构，就是源码啦
上源码
/*
* Copyright (C) 2007 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/ package org.athrun.ddmlib; import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.lang.Thread.State;
import java.net.InetAddress;
import java.net.InetSocketAddress;
import java.net.UnknownHostException;
import java.security.InvalidParameterException;
import java.util.ArrayList;
import java.util.Map;
import java.util.regex.Matcher;
import java.util.regex.Pattern; import org.athrun.ddmlib.Log.LogLevel; /**
* A connection to the host-side android debug bridge (adb)
* <p/>
* This is the central point to communicate with any devices, emulators, or the
* applications running on them.
* <p/>
* <b>{@link #init(boolean)} must be called before anything is done.</b>
*/
public final class AndroidDebugBridge { /*
* Minimum and maximum version of adb supported. This correspond to
* ADB_SERVER_VERSION found in //device/tools/adb/adb.h
*/ private final static int ADB_VERSION_MICRO_MIN = 20;
private final static int ADB_VERSION_MICRO_MAX = -1; private final static Pattern sAdbVersion = Pattern
.compile("^.*(\\d+)\\.(\\d+)\\.(\\d+)$"); //$NON-NLS-1$ private final static String ADB = "adb"; //$NON-NLS-1$
private final static String DDMS = "ddms"; //$NON-NLS-1$
private final static String SERVER_PORT_ENV_VAR = "ANDROID_ADB_SERVER_PORT"; //$NON-NLS-1$ // Where to find the ADB bridge.
final static String ADB_HOST = "127.0.0.1"; //$NON-NLS-1$
final static int ADB_PORT = 5037; private static InetAddress sHostAddr;
private static InetSocketAddress sSocketAddr; private static AndroidDebugBridge sThis;
private static boolean sInitialized = false;
private static boolean sClientSupport; /** Full path to adb. */
private String mAdbOsLocation = null; private boolean mVersionCheck; private boolean mStarted = false; private DeviceMonitor mDeviceMonitor; private final static ArrayList<IDebugBridgeChangeListener> sBridgeListeners = new ArrayList<IDebugBridgeChangeListener>();
private final static ArrayList<IDeviceChangeListener> sDeviceListeners = new ArrayList<IDeviceChangeListener>();
private final static ArrayList<IClientChangeListener> sClientListeners = new ArrayList<IClientChangeListener>(); // lock object for synchronization
private static final Object sLock = sBridgeListeners; /**
* Classes which implement this interface provide a method that deals with
* {@link AndroidDebugBridge} changes.
*/
public interface IDebugBridgeChangeListener {
/**
* Sent when a new {@link AndroidDebugBridge} is connected.
* <p/>
* This is sent from a non UI thread.
*
* @param bridge
* the new {@link AndroidDebugBridge} object.
*/
public void bridgeChanged(AndroidDebugBridge bridge);
} /**
* Classes which implement this interface provide methods that deal with
* {@link IDevice} addition, deletion, and changes.
*/
public interface IDeviceChangeListener {
/**
* Sent when the a device is connected to the {@link AndroidDebugBridge}
* .
* <p/>
* This is sent from a non UI thread.
*
* @param device
* the new device.
*/
public void deviceConnected(IDevice device); /**
* Sent when the a device is connected to the {@link AndroidDebugBridge}
* .
* <p/>
* This is sent from a non UI thread.
*
* @param device
* the new device.
*/
public void deviceDisconnected(IDevice device); /**
* Sent when a device data changed, or when clients are
* started/terminated on the device.
* <p/>
* This is sent from a non UI thread.
*
* @param device
* the device that was updated.
* @param changeMask
* the mask describing what changed. It can contain any of
* the following values: {@link IDevice#CHANGE_BUILD_INFO},
* {@link IDevice#CHANGE_STATE},
* {@link IDevice#CHANGE_CLIENT_LIST}
*/
public void deviceChanged(IDevice device, int changeMask);
} /**
* Classes which implement this interface provide methods that deal with
* {@link Client} changes.
*/
public interface IClientChangeListener {
/**
* Sent when an existing client information changed.
* <p/>
* This is sent from a non UI thread.
*
* @param client
* the updated client.
* @param changeMask
* the bit mask describing the changed properties. It can
* contain any of the following values:
* {@link Client#CHANGE_INFO},
* {@link Client#CHANGE_DEBUGGER_STATUS},
* {@link Client#CHANGE_THREAD_MODE},
* {@link Client#CHANGE_THREAD_DATA},
* {@link Client#CHANGE_HEAP_MODE},
* {@link Client#CHANGE_HEAP_DATA},
* {@link Client#CHANGE_NATIVE_HEAP_DATA}
*/
public void clientChanged(Client client, int changeMask);
} /**
* Initializes the <code>ddm</code> library.
* <p/>
* This must be called once <b>before</b> any call to
* {@link #createBridge(String, boolean)}.
* <p>
* The library can be initialized in 2 ways:
* <ul>
* <li>Mode 1: <var>clientSupport</var> == <code>true</code>.<br>
* 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.</li>
* <li>Mode 2: <var>clientSupport</var> == <code>false</code>.<br>
* The library only monitors devices. The applications are left untouched,
* letting other tools built on <code>ddmlib</code> to connect a debugger to
* them.</li>
* </ul>
* <p/>
* <b>Only one tool can run in mode 1 at the same time.</b>
* <p/>
* Note that mode 1 does not prevent debugging of applications running on
* devices. Mode 1 lets debuggers connect to <code>ddmlib</code> which acts
* as a proxy between the debuggers and the applications to debug. See
* {@link Client#getDebuggerListenPort()}.
* <p/>
* The preferences of <code>ddmlib</code> should also be initialized with
* whatever default values were changed from the default values.
* <p/>
* When the application quits, {@link #terminate()} should be called.
*
* @param clientSupport
* Indicates whether the library should enable the monitoring and
* interaction with applications running on the devices.
* @see AndroidDebugBridge#createBridge(String, boolean)
* @see DdmPreferences
*/
public static synchronized void init(boolean clientSupport) {
if (sInitialized) {
throw new IllegalStateException(
"AndroidDebugBridge.init() has already been called.");
}
sInitialized = true;
sClientSupport = clientSupport; // Determine port and instantiate socket address.
initAdbSocketAddr(); MonitorThread monitorThread = MonitorThread.createInstance();
monitorThread.start(); HandleHello.register(monitorThread);
HandleAppName.register(monitorThread);
HandleTest.register(monitorThread);
HandleThread.register(monitorThread);
HandleHeap.register(monitorThread);
HandleWait.register(monitorThread);
HandleProfiling.register(monitorThread);
HandleNativeHeap.register(monitorThread);
} /**
* Terminates the ddm library. This must be called upon application
* termination.
*/
public static synchronized void terminate() {
// kill the monitoring services
if (sThis != null && sThis.mDeviceMonitor != null) {
sThis.mDeviceMonitor.stop();
sThis.mDeviceMonitor = null;
} MonitorThread monitorThread = MonitorThread.getInstance();
if (monitorThread != null) {
monitorThread.quit();
} sInitialized = false;
} /**
* Returns whether the ddmlib is setup to support monitoring and interacting
* with {@link Client}s running on the {@link IDevice}s.
*/
static boolean getClientSupport() {
return sClientSupport;
} /**
* Returns the socket address of the ADB server on the host.
*/
public static InetSocketAddress getSocketAddress() {
return sSocketAddr;
} /**
* Creates a {@link AndroidDebugBridge} that is not linked to any particular
* executable.
* <p/>
* This bridge will expect adb to be running. It will not be able to
* start/stop/restart adb.
* <p/>
* If a bridge has already been started, it is directly returned with no
* changes (similar to calling {@link #getBridge()}).
*
* @return a connected bridge.
*/
public static AndroidDebugBridge createBridge() {
synchronized (sLock) {
if (sThis != null) {
return sThis;
} try {
sThis = new AndroidDebugBridge();
sThis.start();
} catch (InvalidParameterException e) {
sThis = null;
} // because the listeners could remove themselves from the list while
// processing
// their event callback, we make a copy of the list and iterate on
// it instead of
// the main list.
// This mostly happens when the application quits.
IDebugBridgeChangeListener[] listenersCopy = sBridgeListeners
.toArray(new IDebugBridgeChangeListener[sBridgeListeners
.size()]); // notify the listeners of the change
for (IDebugBridgeChangeListener listener : listenersCopy) {
// we attempt to catch any exception so that a bad listener
// doesn't kill our
// thread
try {
listener.bridgeChanged(sThis);
} catch (Exception e) {
Log.e(DDMS, e);
}
} return sThis;
}
} /**
* Creates a new debug bridge from the location of the command line tool.
* <p/>
* Any existing server will be disconnected, unless the location is the same
* and <code>forceNewBridge</code> is set to false.
*
* @param osLocation
* the location of the command line tool 'adb'
* @param forceNewBridge
* force creation of a new bridge even if one with the same
* location already exists.
* @return a connected bridge.
*/
public static AndroidDebugBridge createBridge(String osLocation,
boolean forceNewBridge) {
synchronized (sLock) {
if (sThis != null) {
if (sThis.mAdbOsLocation != null
&& sThis.mAdbOsLocation.equals(osLocation)
&& forceNewBridge == false) {
return sThis;
} else {
// stop the current server
sThis.stop();
}
} try {
sThis = new AndroidDebugBridge(osLocation);
sThis.start();
} catch (InvalidParameterException e) {
sThis = null;
} // because the listeners could remove themselves from the list while
// processing
// their event callback, we make a copy of the list and iterate on
// it instead of
// the main list.
// This mostly happens when the application quits.
IDebugBridgeChangeListener[] listenersCopy = sBridgeListeners
.toArray(new IDebugBridgeChangeListener[sBridgeListeners
.size()]); // notify the listeners of the change
for (IDebugBridgeChangeListener listener : listenersCopy) {
// we attempt to catch any exception so that a bad listener
// doesn't kill our
// thread
try {
listener.bridgeChanged(sThis);
} catch (Exception e) {
Log.e(DDMS, e);
}
} return sThis;
}
} /**
* Returns the current debug bridge. Can be <code>null</code> if none were
* created.
*/
public static AndroidDebugBridge getBridge() {
return sThis;
} /**
* Disconnects the current debug bridge, and destroy the object.
* <p/>
* This also stops the current adb host server.
* <p/>
* A new object will have to be created with
* {@link #createBridge(String, boolean)}.
*/
public static void disconnectBridge() {
synchronized (sLock) {
if (sThis != null) {
sThis.stop();
sThis = null; // because the listeners could remove themselves from the list
// while processing
// their event callback, we make a copy of the list and iterate
// on it instead of
// the main list.
// This mostly happens when the application quits.
IDebugBridgeChangeListener[] listenersCopy = sBridgeListeners
.toArray(new IDebugBridgeChangeListener[sBridgeListeners
.size()]); // notify the listeners.
for (IDebugBridgeChangeListener listener : listenersCopy) {
// we attempt to catch any exception so that a bad listener
// doesn't kill our
// thread
try {
listener.bridgeChanged(sThis);
} catch (Exception e) {
Log.e(DDMS, e);
}
}
}
}
} /**
* Adds the listener to the collection of listeners who will be notified
* when a new {@link AndroidDebugBridge} is connected, by sending it one of
* the messages defined in the {@link IDebugBridgeChangeListener} interface.
*
* @param listener
* The listener which should be notified.
*/
public static void addDebugBridgeChangeListener(
IDebugBridgeChangeListener listener) {
synchronized (sLock) {
if (sBridgeListeners.contains(listener) == false) {
sBridgeListeners.add(listener);
if (sThis != null) {
// we attempt to catch any exception so that a bad listener
// doesn't kill our
// thread
try {
listener.bridgeChanged(sThis);
} catch (Exception e) {
Log.e(DDMS, e);
}
}
}
}
} /**
* Removes the listener from the collection of listeners who will be
* notified when a new {@link AndroidDebugBridge} is started.
*
* @param listener
* The listener which should no longer be notified.
*/
public static void removeDebugBridgeChangeListener(
IDebugBridgeChangeListener listener) {
synchronized (sLock) {
sBridgeListeners.remove(listener);
}
} /**
* Adds the listener to the collection of listeners who will be notified
* when a {@link IDevice} is connected, disconnected, or when its properties
* or its {@link Client} list changed, by sending it one of the messages
* defined in the {@link IDeviceChangeListener} interface.
*
* @param listener
* The listener which should be notified.
*/
public static void addDeviceChangeListener(IDeviceChangeListener listener) {
synchronized (sLock) {
if (sDeviceListeners.contains(listener) == false) {
sDeviceListeners.add(listener);
}
}
} /**
* Removes the listener from the collection of listeners who will be
* notified when a {@link IDevice} is connected, disconnected, or when its
* properties or its {@link Client} list changed.
*
* @param listener
* The listener which should no longer be notified.
*/
public static void removeDeviceChangeListener(IDeviceChangeListener listener) {
synchronized (sLock) {
sDeviceListeners.remove(listener);
}
} /**
* Adds the listener to the collection of listeners who will be notified
* when a {@link Client} property changed, by sending it one of the messages
* defined in the {@link IClientChangeListener} interface.
*
* @param listener
* The listener which should be notified.
*/
public static void addClientChangeListener(IClientChangeListener listener) {
synchronized (sLock) {
if (sClientListeners.contains(listener) == false) {
sClientListeners.add(listener);
}
}
} /**
* Removes the listener from the collection of listeners who will be
* notified when a {@link Client} property changed.
*
* @param listener
* The listener which should no longer be notified.
*/
public static void removeClientChangeListener(IClientChangeListener listener) {
synchronized (sLock) {
sClientListeners.remove(listener);
}
} /**
* Returns the devices.
*
* @see #hasInitialDeviceList()
*/
public IDevice[] getDevices() {
synchronized (sLock) {
if (mDeviceMonitor != null) {
return mDeviceMonitor.getDevices();
}
} return new IDevice[0];
} /**
* Returns whether the bridge has acquired the initial list from adb after
* being created.
* <p/>
* Calling {@link #getDevices()} right after
* {@link #createBridge(String, boolean)} will generally result in an empty
* list. This is due to the internal asynchronous communication mechanism
* with <code>adb</code> that does not guarantee that the {@link IDevice}
* list has been built before the call to {@link #getDevices()}.
* <p/>
* The recommended way to get the list of {@link IDevice} objects is to
* create a {@link IDeviceChangeListener} object.
*/
public boolean hasInitialDeviceList() {
if (mDeviceMonitor != null) {
return mDeviceMonitor.hasInitialDeviceList();
} return false;
} /**
* Sets the client to accept debugger connection on the custom
* "Selected debug port".
*
* @param selectedClient
* the client. Can be null.
*/
public void setSelectedClient(Client selectedClient) {
MonitorThread monitorThread = MonitorThread.getInstance();
if (monitorThread != null) {
monitorThread.setSelectedClient(selectedClient);
}
} /**
* Returns whether the {@link AndroidDebugBridge} object is still connected
* to the adb daemon.
*/
public boolean isConnected() {
MonitorThread monitorThread = MonitorThread.getInstance();
if (mDeviceMonitor != null && monitorThread != null) {
return mDeviceMonitor.isMonitoring()
&& monitorThread.getState() != State.TERMINATED;
}
return false;
} /**
* Returns the number of times the {@link AndroidDebugBridge} object
* attempted to connect to the adb daemon.
*/
public int getConnectionAttemptCount() {
if (mDeviceMonitor != null) {
return mDeviceMonitor.getConnectionAttemptCount();
}
return -1;
} /**
* Returns the number of times the {@link AndroidDebugBridge} object
* attempted to restart the adb daemon.
*/
public int getRestartAttemptCount() {
if (mDeviceMonitor != null) {
return mDeviceMonitor.getRestartAttemptCount();
}
return -1;
} /**
* Creates a new bridge.
*
* @param osLocation
* the location of the command line tool
* @throws InvalidParameterException
*/
private AndroidDebugBridge(String osLocation)
throws InvalidParameterException {
if (osLocation == null || osLocation.length() == 0) {
throw new InvalidParameterException();
}
mAdbOsLocation = osLocation; checkAdbVersion();
} /**
* Creates a new bridge not linked to any particular adb executable.
*/
private AndroidDebugBridge() {
} /**
* Queries adb for its version number and checks it against
* {@link #MIN_VERSION_NUMBER} and {@link #MAX_VERSION_NUMBER}
*/
private void checkAdbVersion() {
// default is bad check
mVersionCheck = false; if (mAdbOsLocation == null) {
return;
} try {
String[] command = new String[2];
command[0] = mAdbOsLocation;
command[1] = "version"; //$NON-NLS-1$
Log.d(DDMS,
String.format("Checking '%1$s version'", mAdbOsLocation)); //$NON-NLS-1$
Process process = Runtime.getRuntime().exec(command); ArrayList<String> errorOutput = new ArrayList<String>();
ArrayList<String> stdOutput = new ArrayList<String>();
int status = grabProcessOutput(process, errorOutput, stdOutput,
true /* waitForReaders */); if (status != 0) {
StringBuilder builder = new StringBuilder(
"'adb version' failed!"); //$NON-NLS-1$
for (String error : errorOutput) {
builder.append('\n');
builder.append(error);
}
Log.logAndDisplay(LogLevel.ERROR, "adb", builder.toString());
} // check both stdout and stderr
boolean versionFound = false;
for (String line : stdOutput) {
versionFound = scanVersionLine(line);
if (versionFound) {
break;
}
}
if (!versionFound) {
for (String line : errorOutput) {
versionFound = scanVersionLine(line);
if (versionFound) {
break;
}
}
} if (!versionFound) {
// if we get here, we failed to parse the output.
Log.logAndDisplay(LogLevel.ERROR, ADB,
"Failed to parse the output of 'adb version'"); //$NON-NLS-1$
} } catch (IOException e) {
Log.logAndDisplay(LogLevel.ERROR, ADB,
"Failed to get the adb version: " + e.getMessage()); //$NON-NLS-1$
} catch (InterruptedException e) {
} finally { }
} /**
* Scans a line resulting from 'adb version' for a potential version number.
* <p/>
* If a version number is found, it checks the version number against what
* is expected by this version of ddms.
* <p/>
* Returns true when a version number has been found so that we can stop
* scanning, whether the version number is in the acceptable range or not.
*
* @param line
* The line to scan.
* @return True if a version number was found (whether it is acceptable or
* not).
*/
@SuppressWarnings("all")
// With Eclipse 3.6, replace by @SuppressWarnings("unused")
private boolean scanVersionLine(String line) {
if (line != null) {
Matcher matcher = sAdbVersion.matcher(line);
if (matcher.matches()) {
int majorVersion = Integer.parseInt(matcher.group(1));
int minorVersion = Integer.parseInt(matcher.group(2));
int microVersion = Integer.parseInt(matcher.group(3)); // check only the micro version for now.
if (microVersion < ADB_VERSION_MICRO_MIN) {
String message = String.format(
"Required minimum version of adb: %1$d.%2$d.%3$d." //$NON-NLS-1$
+ "Current version is %1$d.%2$d.%4$d", //$NON-NLS-1$
majorVersion, minorVersion, ADB_VERSION_MICRO_MIN,
microVersion);
Log.logAndDisplay(LogLevel.ERROR, ADB, message);
} else if (ADB_VERSION_MICRO_MAX != -1
&& microVersion > ADB_VERSION_MICRO_MAX) {
String message = String.format(
"Required maximum version of adb: %1$d.%2$d.%3$d." //$NON-NLS-1$
+ "Current version is %1$d.%2$d.%4$d", //$NON-NLS-1$
majorVersion, minorVersion, ADB_VERSION_MICRO_MAX,
microVersion);
Log.logAndDisplay(LogLevel.ERROR, ADB, message);
} else {
mVersionCheck = true;
} return true;
}
}
return false;
} /**
* Starts the debug bridge.
*
* @return true if success.
*/
boolean start() {
if (mAdbOsLocation != null
&& (mVersionCheck == false || startAdb() == false)) {
return false;
} mStarted = true; // now that the bridge is connected, we start the underlying services.
mDeviceMonitor = new DeviceMonitor(this);
mDeviceMonitor.start(); return true;
} /**
* Kills the debug bridge, and the adb host server.
*
* @return true if success
*/
boolean stop() {
// if we haven't started we return false;
if (mStarted == false) {
return false;
} // kill the monitoring services
mDeviceMonitor.stop();
mDeviceMonitor = null; if (stopAdb() == false) {
return false;
} mStarted = false;
return true;
} /**
* Restarts adb, but not the services around it.
*
* @return true if success.
*/
public boolean restart() {
if (mAdbOsLocation == null) {
Log.e(ADB,
"Cannot restart adb when AndroidDebugBridge is created without the location of adb."); //$NON-NLS-1$
return false;
} if (mVersionCheck == false) {
Log.logAndDisplay(LogLevel.ERROR, ADB,
"Attempting to restart adb, but version check failed!"); //$NON-NLS-1$
return false;
}
synchronized (this) {
stopAdb(); boolean restart = startAdb(); if (restart && mDeviceMonitor == null) {
mDeviceMonitor = new DeviceMonitor(this);
mDeviceMonitor.start();
} return restart;
}
} /**
* Notify the listener of a new {@link IDevice}.
* <p/>
* The notification of the listeners is done in a synchronized block. It is
* important to expect the listeners to potentially access various methods
* of {@link IDevice} as well as {@link #getDevices()} which use internal
* locks.
* <p/>
* For this reason, any call to this method from a method of
* {@link DeviceMonitor}, {@link IDevice} which is also inside a
* synchronized block, should first synchronize on the
* {@link AndroidDebugBridge} lock. Access to this lock is done through
* {@link #getLock()}.
*
* @param device
* the new <code>IDevice</code>.
* @see #getLock()
*/
void deviceConnected(IDevice device) {
// because the listeners could remove themselves from the list while
// processing
// their event callback, we make a copy of the list and iterate on it
// instead of
// the main list.
// This mostly happens when the application quits.
IDeviceChangeListener[] listenersCopy = null;
synchronized (sLock) {
listenersCopy = sDeviceListeners
.toArray(new IDeviceChangeListener[sDeviceListeners.size()]);
} // Notify the listeners
for (IDeviceChangeListener listener : listenersCopy) {
// we attempt to catch any exception so that a bad listener doesn't
// kill our
// thread
try {
listener.deviceConnected(device);
} catch (Exception e) {
Log.e(DDMS, e);
}
}
} /**
* Notify the listener of a disconnected {@link IDevice}.
* <p/>
* The notification of the listeners is done in a synchronized block. It is
* important to expect the listeners to potentially access various methods
* of {@link IDevice} as well as {@link #getDevices()} which use internal
* locks.
* <p/>
* For this reason, any call to this method from a method of
* {@link DeviceMonitor}, {@link IDevice} which is also inside a
* synchronized block, should first synchronize on the
* {@link AndroidDebugBridge} lock. Access to this lock is done through
* {@link #getLock()}.
*
* @param device
* the disconnected <code>IDevice</code>.
* @see #getLock()
*/
void deviceDisconnected(IDevice device) {
// because the listeners could remove themselves from the list while
// processing
// their event callback, we make a copy of the list and iterate on it
// instead of
// the main list.
// This mostly happens when the application quits.
IDeviceChangeListener[] listenersCopy = null;
synchronized (sLock) {
listenersCopy = sDeviceListeners
.toArray(new IDeviceChangeListener[sDeviceListeners.size()]);
} // Notify the listeners
for (IDeviceChangeListener listener : listenersCopy) {
// we attempt to catch any exception so that a bad listener doesn't
// kill our
// thread
try {
listener.deviceDisconnected(device);
} catch (Exception e) {
Log.e(DDMS, e);
}
}
} /**
* Notify the listener of a modified {@link IDevice}.
* <p/>
* The notification of the listeners is done in a synchronized block. It is
* important to expect the listeners to potentially access various methods
* of {@link IDevice} as well as {@link #getDevices()} which use internal
* locks.
* <p/>
* For this reason, any call to this method from a method of
* {@link DeviceMonitor}, {@link IDevice} which is also inside a
* synchronized block, should first synchronize on the
* {@link AndroidDebugBridge} lock. Access to this lock is done through
* {@link #getLock()}.
*
* @param device
* the modified <code>IDevice</code>.
* @see #getLock()
*/
void deviceChanged(IDevice device, int changeMask) {
// because the listeners could remove themselves from the list while
// processing
// their event callback, we make a copy of the list and iterate on it
// instead of
// the main list.
// This mostly happens when the application quits.
IDeviceChangeListener[] listenersCopy = null;
synchronized (sLock) {
listenersCopy = sDeviceListeners
.toArray(new IDeviceChangeListener[sDeviceListeners.size()]);
} // Notify the listeners
for (IDeviceChangeListener listener : listenersCopy) {
// we attempt to catch any exception so that a bad listener doesn't
// kill our
// thread
try {
listener.deviceChanged(device, changeMask);
} catch (Exception e) {
Log.e(DDMS, e);
}
}
} /**
* Notify the listener of a modified {@link Client}.
* <p/>
* The notification of the listeners is done in a synchronized block. It is
* important to expect the listeners to potentially access various methods
* of {@link IDevice} as well as {@link #getDevices()} which use internal
* locks.
* <p/>
* For this reason, any call to this method from a method of
* {@link DeviceMonitor}, {@link IDevice} which is also inside a
* synchronized block, should first synchronize on the
* {@link AndroidDebugBridge} lock. Access to this lock is done through
* {@link #getLock()}.
*
* @param device
* the modified <code>Client</code>.
* @param changeMask
* the mask indicating what changed in the <code>Client</code>
* @see #getLock()
*/
void clientChanged(Client client, int changeMask) {
// because the listeners could remove themselves from the list while
// processing
// their event callback, we make a copy of the list and iterate on it
// instead of
// the main list.
// This mostly happens when the application quits.
IClientChangeListener[] listenersCopy = null;
synchronized (sLock) {
listenersCopy = sClientListeners
.toArray(new IClientChangeListener[sClientListeners.size()]); } // Notify the listeners
for (IClientChangeListener listener : listenersCopy) {
// we attempt to catch any exception so that a bad listener doesn't
// kill our
// thread
try {
listener.clientChanged(client, changeMask);
} catch (Exception e) {
Log.e(DDMS, e);
}
}
} /**
* Returns the {@link DeviceMonitor} object.
*/
DeviceMonitor getDeviceMonitor() {
return mDeviceMonitor;
} /**
* Starts the adb host side server.
*
* @return true if success
*/
synchronized boolean startAdb() {
if (mAdbOsLocation == null) {
Log.e(ADB,
"Cannot start adb when AndroidDebugBridge is created without the location of adb."); //$NON-NLS-1$
return false;
} Process proc;
int status = -1; try {
String[] command = new String[2];
command[0] = mAdbOsLocation;
command[1] = "start-server"; //$NON-NLS-1$
Log.d(DDMS, String.format(
"Launching '%1$s %2$s' to ensure ADB is running.", //$NON-NLS-1$
mAdbOsLocation, command[1]));
ProcessBuilder processBuilder = new ProcessBuilder(command);
if (DdmPreferences.getUseAdbHost()) {
String adbHostValue = DdmPreferences.getAdbHostValue();
if (adbHostValue != null && adbHostValue.length() > 0) {
// TODO : check that the String is a valid IP address
Map<String, String> env = processBuilder.environment();
env.put("ADBHOST", adbHostValue);
}
}
proc = processBuilder.start(); ArrayList<String> errorOutput = new ArrayList<String>();
ArrayList<String> stdOutput = new ArrayList<String>();
status = grabProcessOutput(proc, errorOutput, stdOutput, false /* waitForReaders */); } catch (IOException ioe) {
Log.d(DDMS, "Unable to run 'adb': " + ioe.getMessage()); //$NON-NLS-1$
// we'll return false;
} catch (InterruptedException ie) {
Log.d(DDMS, "Unable to run 'adb': " + ie.getMessage()); //$NON-NLS-1$
// we'll return false;
} if (status != 0) {
Log.w(DDMS,
"'adb start-server' failed -- run manually if necessary"); //$NON-NLS-1$
return false;
} Log.d(DDMS, "'adb start-server' succeeded"); //$NON-NLS-1$ return true;
} /**
* Stops the adb host side server.
*
* @return true if success
*/
private synchronized boolean stopAdb() {
if (mAdbOsLocation == null) {
Log.e(ADB,
"Cannot stop adb when AndroidDebugBridge is created without the location of adb."); //$NON-NLS-1$
return false;
} Process proc;
int status = -1; try {
String[] command = new String[2];
command[0] = mAdbOsLocation;
command[1] = "kill-server"; //$NON-NLS-1$
proc = Runtime.getRuntime().exec(command);
status = proc.waitFor();
} catch (IOException ioe) {
// we'll return false;
} catch (InterruptedException ie) {
// we'll return false;
} if (status != 0) {
Log.w(DDMS, "'adb kill-server' failed -- run manually if necessary"); //$NON-NLS-1$
return false;
} Log.d(DDMS, "'adb kill-server' succeeded"); //$NON-NLS-1$
return true;
} /**
* Get the stderr/stdout outputs of a process and return when the process is
* done. Both <b>must</b> be read or the process will block on windows.
*
* @param process
* The process to get the ouput from
* @param errorOutput
* The array to store the stderr output. cannot be null.
* @param stdOutput
* The array to store the stdout output. cannot be null.
* @param displayStdOut
* If true this will display stdout as well
* @param waitforReaders
* if true, this will wait for the reader threads.
* @return the process return code.
* @throws InterruptedException
*/
private int grabProcessOutput(final Process process,
final ArrayList<String> errorOutput,
final ArrayList<String> stdOutput, boolean waitforReaders)
throws InterruptedException {
assert errorOutput != null;
assert stdOutput != null;
// read the lines as they come. if null is returned, it's
// because the process finished
Thread t1 = new Thread("") { //$NON-NLS-1$
@Override
public void run() {
// create a buffer to read the stderr output
InputStreamReader is = new InputStreamReader(
process.getErrorStream());
BufferedReader errReader = new BufferedReader(is); try {
while (true) {
String line = errReader.readLine();
if (line != null) {
Log.e(ADB, line);
errorOutput.add(line);
} else {
break;
}
}
} catch (IOException e) {
// do nothing.
}
}
}; Thread t2 = new Thread("") { //$NON-NLS-1$
@Override
public void run() {
InputStreamReader is = new InputStreamReader(
process.getInputStream());
BufferedReader outReader = new BufferedReader(is); try {
while (true) {
String line = outReader.readLine();
if (line != null) {
Log.d(ADB, line);
stdOutput.add(line);
} else {
break;
}
}
} catch (IOException e) {
// do nothing.
}
}
}; t1.start();
t2.start(); // it looks like on windows process#waitFor() can return
// before the thread have filled the arrays, so we wait for both threads
// and the
// process itself.
if (waitforReaders) {
try {
t1.join();
} catch (InterruptedException e) {
}
try {
t2.join();
} catch (InterruptedException e) {
}
} // get the return code from the process
return process.waitFor();
} /**
* Returns the singleton lock used by this class to protect any access to
* the listener.
* <p/>
* This includes adding/removing listeners, but also notifying listeners of
* new bridges, devices, and clients.
*/
static Object getLock() {
return sLock;
} /**
* Instantiates sSocketAddr with the address of the host's adb process.
*/
private static void initAdbSocketAddr() {
try {
int adb_port = determineAndValidateAdbPort();
sHostAddr = InetAddress.getByName(ADB_HOST);
sSocketAddr = new InetSocketAddress(sHostAddr, adb_port);
} catch (UnknownHostException e) {
// localhost should always be known.
}
} /**
* Determines port where ADB is expected by looking at an env variable.
* <p/>
* The value for the environment variable ANDROID_ADB_SERVER_PORT is
* validated, IllegalArgumentException is thrown on illegal values.
* <p/>
*
* @return The port number where the host's adb should be expected or
* started.
* @throws IllegalArgumentException
* if ANDROID_ADB_SERVER_PORT has a non-numeric value.
*/
private static int determineAndValidateAdbPort() {
String adb_env_var;
int result = ADB_PORT;
try {
adb_env_var = System.getenv(SERVER_PORT_ENV_VAR); if (adb_env_var != null) {
adb_env_var = adb_env_var.trim();
} if (adb_env_var != null && adb_env_var.length() > 0) {
// C tools (adb, emulator) accept hex and octal port numbers, so
// need to accept
// them too.
result = Integer.decode(adb_env_var); if (result <= 0) {
String errMsg = "env var " + SERVER_PORT_ENV_VAR //$NON-NLS-1$
+ ": must be >=0, got " //$NON-NLS-1$
+ System.getenv(SERVER_PORT_ENV_VAR);
throw new IllegalArgumentException(errMsg);
}
}
} catch (NumberFormatException nfEx) {
String errMsg = "env var " + SERVER_PORT_ENV_VAR //$NON-NLS-1$
+ ": illegal value '" //$NON-NLS-1$
+ System.getenv(SERVER_PORT_ENV_VAR) + "'"; //$NON-NLS-1$
throw new IllegalArgumentException(errMsg);
} catch (SecurityException secEx) {
// A security manager has been installed that doesn't allow access
// to env vars.
// So an environment variable might have been set, but we can't
// tell.
// Let's log a warning and continue with ADB's default port.
// The issue is that adb would be started (by the forked process
// having access
// to the env vars) on the desired port, but within this process, we
// can't figure out
// what that port is. However, a security manager not granting
// access to env vars
// but allowing to fork is a rare and interesting configuration, so
// the right
// thing seems to be to continue using the default port, as forking
// is likely to
// fail later on in the scenario of the security manager.
Log.w(DDMS,
"No access to env variables allowed by current security manager. " //$NON-NLS-1$
+ "If you've set ANDROID_ADB_SERVER_PORT: it's being ignored."); //$NON-NLS-1$
}
return result;
} }
AndroidDebugBridge
实现
既然ddmlib包含了ADB，因为我们就引入它，来进行一些ADB操作。
1、建立一个普通的Java工程；
2、将ddmlib.jar，包含进来（这里需要主要，还需要引入guava-15.0.jar，否则会提示少 com/geogle/common/*** 的错误，guava和ddmlib存放在同一个目录下）
3、调用AndroidDebugBridge类中的方法，完成要实现的方法（例如下面）
import com.android.ddmlib.AndroidDebugBridge;
import com.android.ddmlib.IDevice; public class test
{
public static void main(String[] args)
{
System.out.println(" begin ");
AndroidDebugBridge.init(false);
//AndroidDebugBridge adb = AndroidDebugBridge.createBridge("E:\\adt-bundle-windows-x86_64-20140702\\sdk\\platform-tools\\adb.exe", true);
AndroidDebugBridge adb = AndroidDebugBridge.createBridge(); WaitDevices(adb); for (IDevice device : adb.getDevices())
{
System.out.println("Device Name: " + device.getName());
System.out.println("Device isOnline: " + device.isOnline() );
System.out.println("Device SerialNumber: : " + device.getSerialNumber());
}
System.out.println(" end ");
} public static void WaitDevices(AndroidDebugBridge adb)
{
int count = 0;
while (adb.hasInitialDeviceList() == false)
{
try
{
Thread.sleep(500);
System.err.println("wait for devices");
count++;
} catch (InterruptedException e)
{
}
if (count > 50)
{
System.err.println("time out\n");
break;
}
}
}
}
运行上面的代码输出结果为：
begin
wait for devices
Device Name: samsung-gt_i9500-4d0019214ab6608f
Device isOnline: true
Device SerialNumber: : 4d0019214ab6608f
end
注意区分，上面代码里的createBridge() 的方法，无参得到代表使用系统当前的ADB，如果指定了参数，且第二个参数为ture，则启动指定的ADB，这些通过源代码都可以看到。另外createBridge() 之前必须要调用 init 的方法。接下来拿到Idevice 对象就可以实现各种各样的功能了，这里只是说一下怎么用这个lib，具体你想通过这个东西来拿到什么信息，还需自己动手去写写。