Karate 升级至 1.2.0 及以上版本后，自定义 Target 实现类必须严格遵循新接口签名：start() 和 stop() 方法参数由 Logger 改为 ScenarioRuntime，否则编译失败。本文详解适配方法与关键注意事项。
karate 升级至 1.2.0 及以上版本后，自定义 `target` 实现类必须严格遵循新接口签名：`start()` 和 `stop()` 方法参数由 `logger` 改为 `scenarioruntime`，否则编译失败。本文详解适配方法与关键注意事项。
在 Karate 1.0 版本重大重构中，com.intuit.karate.driver.Target 接口发生了不兼容变更：其抽象方法签名已统一调整为接收 com.intuit.karate.core.ScenarioRuntime 类型参数，不再接受 Logger。因此，若你沿用旧版（如 0.x）代码实现 Target，编译时将报错：
Class DeviceFarmTarget is not abstract and does not override abstract method stop(ScenarioRuntime) in Target
这是因为 Target 接口现在声明如下（Karate ≥ 1.0）：
public interface Target {
Map<String, Object> start(ScenarioRuntime runtime);
void stop(ScenarioRuntime runtime);
}✅ 正确实现示例（适配 Karate 1.2.0+）：
import com.intuit.karate.core.ScenarioRuntime;
import com.intuit.karate.driver.Target;
import java.util.HashMap;
import java.util.Map;
public class DeviceFarmTarget implements Target {
@Override
public Map<String, Object> start(ScenarioRuntime runtime) {
// ✅ 使用 runtime.getFeature()、runtime.getScenario() 获取上下文
// ✅ 通过 runtime.getLogger() 获取日志实例（替代旧版独立 Logger 参数）
runtime.getLogger().info("Starting AWS Device Farm session...");
// 示例：返回设备会话配置（如 WebDriver URL、capabilities 等）
Map<String, Object> config = new HashMap<>();
config.put("driver", "webdriver");
config.put("webDriverUrl", "https://devicefarm.example/session");
// ... 其他 Device Farm 初始化逻辑
return config;
}
@Override
public void stop(ScenarioRuntime runtime) {
runtime.getLogger().info("Stopping AWS Device Farm session...");
// ✅ 清理资源：关闭远程会话、上报结果、释放设备等
// 注意：务必处理异常，避免因 stop 失败导致测试流程中断
}
}⚠️ 关键注意事项：
- 不可省略 stop() 方法：即使暂无清理逻辑，也需提供空实现（@Override public void stop(ScenarioRuntime r) {}），否则编译失败；
- 日志获取方式变更：使用 runtime.getLogger() 替代原 Logger 参数，确保日志与当前场景绑定，支持多线程/并行执行上下文隔离；
- 依赖一致性：确认项目中所有 Karate 相关依赖（如 karate-core, karate-apache, karate-junit5）版本统一为 ≥ 1.2.0（推荐升级至 1.3.0，含稳定性增强与 Device Farm 兼容性优化）；
- 构建验证：修改后执行 mvn compile 或对应构建命令，确保无编译错误；建议补充单元测试验证 start() 返回结构符合 Karate 驱动预期。
? 总结：该错误本质是接口契约升级导致的编译时契约违约。解决核心在于——严格对齐 Target 接口最新方法签名，并利用 ScenarioRuntime 统一管理生命周期与上下文。持续关注 Karate Release Notes 与 1.0 升级指南，可显著降低迁移成本。
