Appium Java中@IOSFindBy已废弃，如何跨平台定位元素无需两套测试用例

针对@IOSFindBy注解废弃的问题，目前有几种成熟方案可以实现单套测试代码兼容安卓和iOS平台，无需拆分两套测试套件：

1. 用@FindBy原生支持多平台定位（首推） #

新版Appium Java Client已在@FindBy注解中集成了安卓和iOS专属定位属性，完全可以替代废弃的@IOSFindBy和@AndroidFindBy。只需在同一个@FindBy注解里同时指定安卓和iOS的定位器，PageFactory初始化时会自动根据当前驱动的平台选择对应定位策略。

示例代码：

import org.openqa.selenium.support.FindBy;
import io.appium.java_client.MobileElement;

public class LoginPage {
    // ID定位示例
    @FindBy(android = "id:com.myapp:id/login_btn", ios = "id:loginButton")
    private MobileElement loginButton;

    // XPath定位示例
    @FindBy(android = "xpath://android.widget.EditText[@hint='用户名']", 
            ios = "xpath://XCUIElementTypeTextField[@name='usernameInput']")
    private MobileElement usernameInput;
}

初始化PageFactory时无需额外处理：

LoginPage loginPage = PageFactory.initElements(driver, LoginPage.class);

不管当前是AndroidDriver还是IOSDriver，都会自动匹配对应平台的定位器。

2. 用MobileBy动态生成定位器（适配复杂场景） #

如果需要更灵活的逻辑（比如根据平台版本调整定位器），可以在页面类中通过判断当前平台，动态生成对应的定位器。

示例代码：

import io.appium.java_client.MobileBy;
import io.appium.java_client.MobileElement;
import io.appium.java_client.AppiumDriver;

public class HomePage {
    private AppiumDriver<MobileElement> driver;

    public HomePage(AppiumDriver<MobileElement> driver) {
        this.driver = driver;
    }

    public MobileElement getSettingsIcon() {
        String platform = driver.getPlatformName();
        if (platform.equalsIgnoreCase("iOS")) {
            return driver.findElement(MobileBy.accessibilityId("settingsIcon"));
        } else {
            return driver.findElement(MobileBy.id("com.myapp:id/settings_icon"));
        }
    }
}

这种方式适合需要动态调整定位策略的场景，比如部分元素在不同平台的定位逻辑差异较大。

3. 自定义多平台注解（大型项目进阶方案） #

如果项目中有大量元素需要适配，可以自定义注解结合ElementLocatorFactory实现自动适配。比如自定义@MultiPlatformFindBy注解，包含安卓和iOS的定位参数，再实现一个工厂类，根据当前平台选择对应定位器。该方案相对复杂，适合需要统一管理多平台定位逻辑的大型项目。

注意事项 #

• 确保使用的Appium Java Client版本在7.0及以上，旧版本可能不支持@FindBy的多平台属性
• 尽量保持不同平台的定位策略一致（比如优先用ID或Accessibility ID），降低维护成本
• 测试代码无需区分平台，只需根据测试环境传入对应的驱动即可

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