如何使用Java结合Appium 4.1.0判断屏幕键盘是否打开

嘿，针对你想要判断屏幕软键盘状态并切换显示/隐藏的需求，在Appium Java Client 4.1.0版本下，我整理了一套可行的实现方案，一起来看看：

核心思路 #

• 先用isKeyboardShown()方法检测当前软键盘的显示状态
• 根据检测结果执行对应操作：已显示则隐藏，未显示则唤起

完整代码实现 #

import io.appium.java_client.AppiumDriver;
import io.appium.java_client.MobileElement;
import org.openqa.selenium.remote.DesiredCapabilities;

import java.net.URL;

public class KeyboardToggleHandler {
    public static void main(String[] args) throws Exception {
        // 配置设备与应用的DesiredCapabilities（请根据你的实际环境修改）
        DesiredCapabilities caps = new DesiredCapabilities();
        caps.setCapability("platformName", "Android"); // 若为iOS则改为"iOS"
        caps.setCapability("deviceName", "你的设备名称");
        caps.setCapability("appPackage", "目标应用包名");
        caps.setCapability("appActivity", "目标应用启动页");

        // 初始化Appium驱动
        AppiumDriver<MobileElement> driver = new AppiumDriver<>(new URL("http://127.0.0.1:4723/wd/hub"), caps);

        try {
            // 1. 检测软键盘是否处于打开状态
            boolean keyboardIsOpen = driver.isKeyboardShown();

            if (keyboardIsOpen) {
                // 2. 若键盘已打开，执行隐藏操作
                System.out.println("软键盘已打开，正在隐藏...");
                driver.hideKeyboard();
            } else {
                // 3. 若键盘未打开，唤起键盘（需先定位可输入元素）
                System.out.println("软键盘未打开，正在唤起...");
                // 替换为你应用中实际的可输入元素定位方式（id/xpath等）
                MobileElement inputField = driver.findElementById("com.example.app:id/input_box");
                inputField.click(); // 点击输入框唤起键盘
                // 也可以用sendKeys触发：inputField.sendKeys("");
            }
        } catch (Exception e) {
            System.err.println("操作过程中出现异常：" + e.getMessage());
            e.printStackTrace();
        } finally {
            // 最后关闭驱动
            if (driver != null) {
                driver.quit();
            }
        }
    }
}

关键方法说明 #

• driver.isKeyboardShown(): 返回布尔值，true代表键盘已显示，false代表未显示，在4.1.0版本中是稳定可用的检测方法。
• driver.hideKeyboard(): 用于隐藏当前显示的软键盘。Android环境下直接调用即可；iOS环境可能需要指定隐藏策略，比如driver.hideKeyboard(HideKeyboardStrategy.PRESS_KEY, "Done")，根据键盘上的按钮文本调整。
• 唤起键盘: Appium没有直接唤起键盘的通用API，必须通过与可输入元素交互（点击/输入内容）来触发系统唤起软键盘，所以要确保测试页面存在可输入元素。

注意事项 #

• 测试前请确保应用处于包含可输入元素的页面，否则唤起键盘的操作会失败。
• 若测试iOS设备，需注意hideKeyboard()的参数适配，不同键盘的确认按钮文本可能不同（比如"Done"、"完成"等）。

内容的提问来源于stack exchange，提问作者yogesh