Additional changes of the #473

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

@@ -68,6 +68,7 @@ public class MobileCommand {
     protected static final String IS_KEYBOARD_SHOWN;
     protected static final String IS_LOCKED;
     protected static final String LONG_PRESS_KEY_CODE;
+    protected static final String FINGER_PRINT;
     protected static final String OPEN_NOTIFICATIONS;
     protected static final String PRESS_KEY_CODE;
     protected static final String PUSH_FILE;
@@ -116,6 +117,7 @@ public class MobileCommand {
         IS_KEYBOARD_SHOWN = "isKeyboardShown";
         IS_LOCKED = "isLocked";
         LONG_PRESS_KEY_CODE = "longPressKeyCode";
+        FINGER_PRINT = "fingerPrint";
         OPEN_NOTIFICATIONS = "openNotifications";
         PRESS_KEY_CODE = "pressKeyCode";
         PUSH_FILE = "pushFile";
@@ -170,6 +172,7 @@ public class MobileCommand {
         commandRepository.put(IS_LOCKED, postC("/session/:sessionId/appium/device/is_locked"));
         commandRepository.put(LONG_PRESS_KEY_CODE,
                         postC("/session/:sessionId/appium/device/long_press_keycode"));
+        commandRepository.put(FINGER_PRINT, postC("/session/:sessionId/appium/device/finger_print"));
         commandRepository.put(OPEN_NOTIFICATIONS,
                         postC("/session/:sessionId/appium/device/open_notifications"));
         commandRepository.put(PRESS_KEY_CODE,

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

@@ -47,7 +47,7 @@ public class AndroidDriver<T extends WebElement>
     extends AppiumDriver<T>
     implements PressesKeyCode, HasNetworkConnection, PushesFiles, StartsActivity,
         FindsByAndroidUIAutomator<T>, LocksAndroidDevice, HasAndroidSettings, HasDeviceDetails,
-            HasSupportedPerformanceDataType {
+            HasSupportedPerformanceDataType, AuthenticatesByFinger {
 
     private static final String ANDROID_PLATFORM = MobilePlatform.ANDROID;
 

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

@@ -184,6 +184,19 @@ public class AndroidMobileCommandHelper extends MobileCommand {
                 IS_LOCKED, ImmutableMap.<String, Object>of());
     }
 
+    /**
+     * This method forms a {@link java.util.Map} of parameters for the
+     * finger print authentication invocation.
+     *
+     * @param fingerPrintId finger prints stored in Android Keystore system (from 1 to 10)
+     * @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, ?>> fingerPrintCommand(int fingerPrintId) {
+        return new AbstractMap.SimpleEntry<>(FINGER_PRINT,
+            prepareArguments("fingerprintId", fingerPrintId));
+    }
+
     /**
      * This method forms a {@link java.util.Map} of parameters for the
      * notification opening.

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

@@ -0,0 +1,18 @@
+package io.appium.java_client.android;
+
+import static io.appium.java_client.android.AndroidMobileCommandHelper.fingerPrintCommand;
+
+import io.appium.java_client.CommandExecutionHelper;
+import io.appium.java_client.ExecutesMethod;
+
+public interface AuthenticatesByFinger extends ExecutesMethod {
+
+    /**
+     * Authenticate users by using their finger print scans on supported emulators.
+     *
+     * @param fingerPrintId finger prints stored in Android Keystore system (from 1 to 10)
+     */
+    default void fingerPrint(int fingerPrintId) {
+        CommandExecutionHelper.execute(this, fingerPrintCommand(fingerPrintId));
+    }
+}

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

@@ -0,0 +1,138 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * 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 io.appium.java_client.android;
+
+import static java.util.concurrent.TimeUnit.SECONDS;
+
+import io.appium.java_client.remote.MobileCapabilityType;
+import io.appium.java_client.service.local.AppiumDriverLocalService;
+import org.junit.After;
+import org.junit.AfterClass;
+import org.junit.Assert;
+import org.junit.Before;
+import org.junit.BeforeClass;
+import org.junit.Test;
+import org.openqa.selenium.By;
+import org.openqa.selenium.NoSuchElementException;
+import org.openqa.selenium.remote.DesiredCapabilities;
+
+/**
+ * It is necessary to make this test passing
+ * - emulator API Level 23 Nexus device
+ * - perform 'adb emu finger touch' 1 on Windows
+ */
+public class FingerPrintTest {
+
+    private static final String PASSWORD_INPUT_ID = "com.android.settings:id/password_entry";
+    private static final String FIRST_IN_LIST_XPATH = "//android.widget.ListView[1]/android.widget.LinearLayout[1]";
+    private static AppiumDriverLocalService service;
+
+    /**
+     * initialization.
+     */
+    @BeforeClass public static void beforeClass() {
+        service = AppiumDriverLocalService.buildDefaultService();
+        service.start();
+
+        if (service == null || !service.isRunning()) {
+            throw new ExceptionInInitializerError("An appium server node is not started!");
+        }
+    }
+
+    /**
+     * finishing.
+     */
+    @AfterClass public static void afterClass() {
+        if (service != null) {
+            service.stop();
+        }
+    }
+
+    /**
+     * enable system security which is required for finger print activation.
+     */
+    @Before public void before() throws Exception {
+        final AndroidDriver driver = getAndroidDriver("ChooseLockGeneric");
+        // clicking the pin lock mode
+        driver.findElement(By.xpath("//android.widget.LinearLayout[4]")).click();
+        try {
+            // line below will throw exception if secure startup window is popped up
+            driver.findElementById(PASSWORD_INPUT_ID);
+        } catch (NoSuchElementException e) {
+            // in secure startup window
+            driver.findElementById("com.android.settings:id/encrypt_require_password").click();
+            SECONDS.sleep(2);
+            clickOKInPopup(driver);
+            clickNext(driver);
+        }
+        enterPasswordAndContinue(driver);
+        enterPasswordAndContinue(driver);
+        clickNext(driver);
+        driver.quit();
+    }
+
+    /**
+     * add a new finger print to security.
+     */
+    @Test public void pressKeyCodeTest() throws InterruptedException {
+        final AndroidDriver driver = getAndroidDriver(".fingerprint.FingerprintSettings");
+        enterPasswordAndContinue(driver);
+        // click add fingerprint
+        driver.findElementByXPath(FIRST_IN_LIST_XPATH).click();
+        driver.fingerPrint(2);
+        try {
+            clickNext(driver);
+        } catch (Exception e) {
+            Assert.fail("fingerprint command fail to execute");
+        } finally {
+            driver.quit();
+        }
+    }
+
+    /**
+     * disabling pin lock mode.
+     */
+    @After public void after() throws InterruptedException {
+        final AndroidDriver driver = getAndroidDriver("ChooseLockGeneric");
+        enterPasswordAndContinue(driver);
+        driver.findElementByXPath(FIRST_IN_LIST_XPATH).click();
+        clickOKInPopup(driver);
+        driver.quit();
+    }
+
+    private static AndroidDriver getAndroidDriver(String activity) {
+        DesiredCapabilities capabilities = new DesiredCapabilities();
+        capabilities.setCapability(MobileCapabilityType.DEVICE_NAME, "Android Emulator");
+        capabilities.setCapability("appPackage", "com.android.settings");
+        capabilities.setCapability("appActivity", activity);
+        AndroidDriver<AndroidElement> driver = new AndroidDriver<AndroidElement>(service.getUrl(), capabilities);
+        driver.manage().timeouts().implicitlyWait(15, SECONDS);
+        return driver;
+    }
+
+    private void enterPasswordAndContinue(AndroidDriver driver) throws InterruptedException {
+        driver.findElementById(PASSWORD_INPUT_ID).sendKeys("1234\n");
+    }
+
+    private void clickNext(AndroidDriver driver) throws InterruptedException {
+        driver.findElementById("com.android.settings:id/next_button").click();
+    }
+
+    private void clickOKInPopup(AndroidDriver driver) throws InterruptedException {
+        driver.findElementById("android:id/button1").click();
+    }
+}