Following my detour to Djangoland, the last week or so I have been back in the world of mobile app development. One of the things I’ve been working on is updating an Android app that has two versions built from the same codebase. Part of this update has been to re-skin both versions of the app and to make sure that everything looks reasonable on various devices running versions of Android from 2.2 up to the latest 4.4. When I build a new APK I want to check it on each of the three devices connected to my machine. If I had more spare USB ports I would conceivably be testing with even more devices. In some scenarios I might also have one or more emulators running to test configurations not represented among my devices. Installing the new APK on each of these from the command line is cumbersome. The adb tool will only install on one device/emulator at a time and, if you have more than one connected, you have to specify a long unique device ID to tell it which one to use. You could write a bash script to retrieve the IDs of connected devices and emulators and to run the adb install command for each, but since I’m using Ant I have written a custom task to do the job. For bonus points I’ve made it issue the adb commands in parallel so that the total install time is determined by the slowest device and not the sum of all the devices.
import java.io.BufferedReader; import java.io.File; import java.io.IOException; import java.io.InputStream; import java.io.InputStreamReader; import java.io.PrintStream; import java.util.ArrayList; import java.util.List; import java.util.concurrent.Callable; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.Future; import java.util.concurrent.TimeUnit; import org.apache.tools.ant.BuildException; import org.apache.tools.ant.Task; /** * Custom task that uses the ADB tool to install a specified APK on all * connected devices and emulators. * @author Daniel Dyer */ public class InstallAPK extends Task { private File apkFile; public void setAPK(File apkFile) { this.apkFile = apkFile; } @Override public void execute() throws BuildException { if (apkFile == null) { throw new BuildException("APK file must be specified"); } try { List<String> devices = getDeviceIdentifiers(); System.out.printf("Installing %s on %d device(s)...%n", apkFile, devices.size()); ExecutorService executor = Executors.newFixedThreadPool(devices.size()); List<Future<Void>> futures = new ArrayList<Future<Void>>(devices.size()); for (final String device : devices) { futures.add(executor.submit(new Callable<Void>() { public Void call() throws IOException, InterruptedException { installOnDevice(device); return null; } })); } for (Future<Void> future : futures) { future.get(); } executor.shutdown(); executor.awaitTermination(60, TimeUnit.SECONDS); } catch (Exception ex) { throw new BuildException(ex); } } private void installOnDevice(String device) throws IOException, InterruptedException { String[] command = new String[]{"adb", "-s", device, "install", "-r", apkFile.toString()} Process process = Runtime.getRuntime().exec(command); consumeStream(process.getInputStream(), System.out, device); if (process.waitFor() != 0) { consumeStream(process.getErrorStream(), System.err, device); throw new BuildException(String.format("Installing APK on %s failed.", device)); } } private void consumeStream(InputStream in, PrintStream out, String tag) throws IOException { BufferedReader reader = new BufferedReader(new InputStreamReader(in)); try { for (String line = reader.readLine(); line != null; line = reader.readLine()) { out.println(tag != null ? String.format("[%s] %s", tag, line.trim()) : line); } } finally { reader.close(); } } private List<String> getDeviceIdentifiers() throws IOException, InterruptedException { Process process = Runtime.getRuntime().exec("adb devices"); List devices = new ArrayList<String>(10); BufferedReader reader = new BufferedReader(new InputStreamReader(process.getInputStream())); try { for (String line = reader.readLine(); line != null; line = reader.readLine()) { if (line.endsWith("device")) { devices.add(line.split("s")[0]); } } if (process.waitFor() != 0) { consumeStream(process.getErrorStream(), System.err, null); throw new BuildException("Failed getting list of connected devices/emulators."); } } finally { reader.close(); } return devices; } } |
Once compiled and on your classpath, using it is simple:
<taskdef name="installapk" classname="yourpackage.InstallAPK" /> <installapk apk="path/to/yourapp.apk" /> |