用途:把 Playwright Java 客户端滚动升级到新版本,使 Java 客户端与上游 JavaScript 实现保持一致。
主要能力:通过 ROLLING.md 中的说明与脚本完成版本升级;从上游提交中筛出会影响 Java 公开接口或传输协议的改动(docs/src/api/、packages/playwright-core/src/client/、packages/isomorphic/、matchers.ts、packages/protocol/spec/ 等路径),逐一阅读并移植;为新公开 API 补测试;更新 API 生成器;整理滚动的 PR 内容。
必要用法:先运行 ./scripts/roll_driver.sh 更新版本并生成 API。查找上次发布以来的相关提交可用:cd ~/playwright、PREV_TAG=$(git tag | grep -E '^v1.[0-9]+.[0-9]+$' | sort -V | tail -1)、git log "$PREV_TAG"..HEAD --oneline -- 上述路径。移植时先读对应 JS 文件。生成器改动后重跑:mvn -f tools/api-generator/pom.xml compile -q 与 mvn -f tools/api-generator/pom.xml exec:java -Dexec.mainClass=com.microsoft.playwright.tools.ApiGenerator。若 roll_driver.sh 中途失败,先执行 mvn -f driver-bundle/pom.xml install -DskipTests 重建 driver-bundle 再跑测试。
适用场景:Playwright Java 仓库维护者进行版本滚动与上游同步。
限制:资料未提供收费、价格、平台支持或效果数据;部分命令与路径依赖本地上游仓库结构。不要手改生成文件,需通过重新生成处理,示例命令保持原样。