Added Android device commands

src/main/java/io/appium/java_client/HasDeviceDetails.java

@@ -0,0 +1,22 @@
+package io.appium.java_client;
+
+import static io.appium.java_client.MobileCommand.GET_DISPLAY_DENSITY;
+import static io.appium.java_client.MobileCommand.GET_SYSTEM_BARS;
+
+import java.util.Map;
+
+public interface HasDeviceDetails extends ExecutesMethod {
+    /*
+        Retrieve the display density of the Android device.
+     */
+    default Long getDisplayDensity() {
+        return CommandExecutionHelper.execute(this, GET_DISPLAY_DENSITY);
+    }
+
+    /*
+        Retrieve visibility and bounds information of the status and navigation bars.
+     */
+    default Map<String, String> getSystemBars() {
+        return CommandExecutionHelper.execute(this, GET_SYSTEM_BARS);
+    }
+}

src/main/java/io/appium/java_client/MobileCommand.java

@@ -56,7 +56,10 @@ public class MobileCommand {
     //Android
     protected static final String CURRENT_ACTIVITY = "currentActivity";
     protected static final String END_TEST_COVERAGE = "endTestCoverage";
+    protected static final String GET_DISPLAY_DENSITY = "getDisplayDensity";
     protected static final String GET_NETWORK_CONNECTION = "getNetworkConnection";
+    protected static final String GET_SYSTEM_BARS = "getSystemBars";
+    protected static final String IS_KEYBOARD_SHOWN = "isKeyboardShown";
     protected static final String IS_LOCKED = "isLocked";
     protected static final String LONG_PRESS_KEY_CODE = "longPressKeyCode";
     protected static final String OPEN_NOTIFICATIONS = "openNotifications";
@@ -102,7 +105,10 @@ private static Map<String, CommandInfo> createCommandRepository() {
             getC("/session/:sessionId/appium/device/current_activity"));
         result.put(END_TEST_COVERAGE,
             postC("/session/:sessionId/appium/app/end_test_coverage"));
+        result.put(GET_DISPLAY_DENSITY, getC("/session/:sessionId/appium/device/display_density"));
         result.put(GET_NETWORK_CONNECTION, getC("/session/:sessionId/network_connection"));
+        result.put(GET_SYSTEM_BARS, getC("/session/:sessionId/appium/device/system_bars"));
+        result.put(IS_KEYBOARD_SHOWN, getC("/session/:sessionId/appium/device/is_keyboard_shown"));
         result.put(IS_LOCKED, postC("/session/:sessionId/appium/device/is_locked"));
         result.put(LONG_PRESS_KEY_CODE,
             postC("/session/:sessionId/appium/device/long_press_keycode"));

src/main/java/io/appium/java_client/android/AndroidDriver.java

@@ -23,6 +23,7 @@
 import io.appium.java_client.AppiumDriver;
 import io.appium.java_client.CommandExecutionHelper;
 import io.appium.java_client.FindsByAndroidUIAutomator;
+import io.appium.java_client.HasDeviceDetails;
 import io.appium.java_client.PressesKeyCode;
 import io.appium.java_client.android.internal.JsonToAndroidElementConverter;
 import io.appium.java_client.remote.MobilePlatform;
@@ -48,7 +49,8 @@
 public class AndroidDriver<T extends WebElement>
     extends AppiumDriver<T>
     implements PressesKeyCode, HasNetworkConnection, PushesFiles, StartsActivity,
-    FindsByAndroidUIAutomator<T>, LocksAndroidDevice, HasSettings {
+    FindsByAndroidUIAutomator<T>, LocksAndroidDevice, HasSettings, IsKeyboardShown,
+    HasDeviceDetails {
 
     private static final String ANDROID_PLATFORM = MobilePlatform.ANDROID;
 

src/main/java/io/appium/java_client/android/AndroidMobileCommandHelper.java

@@ -75,6 +75,18 @@ public class AndroidMobileCommandHelper extends MobileCommand {
                 GET_NETWORK_CONNECTION, ImmutableMap.<String, Object>of());
     }
 
+    /**
+     * This method forms a {@link java.util.Map} of parameters for the
+     * checking of the keyboard state (is it shown or not).
+     *
+     * @return a key-value pair. The key is the command name. The value is a
+     * {@link java.util.Map} command arguments.
+     */
+    public static Map.Entry<String, Map<String, ?>> isKeyboardShownCommand() {
+        return new AbstractMap.SimpleEntry<>(
+            IS_KEYBOARD_SHOWN, ImmutableMap.<String, Object>of());
+    }
+
     /**
      * This method forms a {@link java.util.Map} of parameters for the
      * checking of the device state (is it locked or not).

src/main/java/io/appium/java_client/android/IsKeyboardShown.java

@@ -0,0 +1,17 @@
+package io.appium.java_client.android;
+
+import static io.appium.java_client.android.AndroidMobileCommandHelper.isKeyboardShownCommand;
+
+import io.appium.java_client.CommandExecutionHelper;
+import io.appium.java_client.ExecutesMethod;
+
+public interface IsKeyboardShown extends ExecutesMethod {
+    /**
+     * Check if the keyboard is displayed.
+     *
+     * @return true if keyboard is displayed. False otherwise
+     */
+    default boolean isKeyboardShown() {
+        return CommandExecutionHelper.execute(this, isKeyboardShownCommand());
+    }
+}

src/test/java/io/appium/java_client/android/AndroidSearchingTest.java

@@ -17,6 +17,7 @@
 package io.appium.java_client.android;
 
 import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertFalse;
 import static org.junit.Assert.assertNotEquals;
 import static org.junit.Assert.assertNotNull;
 
@@ -25,6 +26,7 @@
 import org.junit.Before;
 import org.junit.Test;
 
+
 public class AndroidSearchingTest extends BaseAndroidTest {
 
     @Before
@@ -63,4 +65,10 @@ public void setup() throws Exception {
                 + "new UiSelector().text(\"Radio Group\"));");
         assertNotNull(radioGroup.getLocation());
     }
+
+    @Test public void deviceDetailsAndKeyboardTest() {
+        assertFalse(driver.isKeyboardShown());
+        assertNotNull(driver.getDisplayDensity());
+        assertNotEquals(0, driver.getSystemBars().size());
+    }
 }

src/test/java/io/appium/java_client/android/BaseAndroidTest.java

@@ -18,6 +18,7 @@
 
 import io.appium.java_client.remote.MobileCapabilityType;
 import io.appium.java_client.service.local.AppiumDriverLocalService;
+import io.appium.java_client.service.local.AppiumServerHasNotBeenStartedLocallyException;
 
 import org.junit.AfterClass;
 import org.junit.BeforeClass;
@@ -38,7 +39,8 @@ public class BaseAndroidTest {
         service.start();
 
         if (service == null || !service.isRunning()) {
-            throw new RuntimeException("An appium server node is not started!");
+            throw new AppiumServerHasNotBeenStartedLocallyException(
+                "An appium server node is not started!");
         }
 
         File appDir = new File("src/test/java/io/appium/java_client");