在Jenkins运行Appium测试的安装包生成与报告共享问题咨询

一、自动生成最新可用于Appium测试的.apk/.ipa安装包 #

核心思路是把App构建步骤直接集成到Jenkins流水线里，测试任务执行前自动拉取最新代码出包，不用人工手动传包，从源头保证测试用的是当前分支最新版本。

• Android端.apk生成配置
  • 前置准备：Jenkins运行节点提前安装配置好匹配项目要求的JDK、Android SDK，将JAVA_HOME、ANDROID_HOME添加到节点系统环境变量，确认adb、gradle等命令可正常调用。
  • 构建命令：拉取对应测试分支的最新源码后，在构建步骤添加Shell/Windows批处理命令，进入项目根目录执行构建：
    • Linux/macOS节点执行：./gradlew assembleDebug
    • Windows节点执行：gradlew.bat assembleDebug
  • 产物路径：Debug测试包默认输出在app/build/outputs/apk/debug/目录下，将该路径配置为Jenkins归档产物，后续Appium测试任务可直接拉取该路径下的最新apk安装到测试设备。如果需要和正式环境签名一致的测试包，可通过Jenkins凭证管理存储签名文件、密钥库密码，构建时传入参数执行assembleRelease命令出包即可，注意测试包要关闭代码混淆、保留调试开关，避免Appium无法定位页面元素。
  • 提效方案：如果开发侧已有独立的App构建流水线，不用测试侧重复维护构建环境，直接在测试流水线前置步骤拉取开发侧归档的最新测试包到工作目录即可。
• iOS端.ipa生成配置
  • 前置准备：iOS构建必须使用macOS节点，提前安装匹配项目版本的Xcode，导入有效的开发调试证书、对应描述文件（不要使用App Store分发证书，否则无法安装到测试设备）。
  • 构建方式：两种可选，第一种直接用Xcode命令行构建，拉取源码后先执行编译命令生成.app文件，再通过xcrun打包成ipa；第二种直接安装Jenkins Xcode插件，可视化配置工作空间、scheme、签名信息、输出路径，不用手写冗长的构建命令。
  • 产物处理：和apk一致，将ipa输出路径配置为Jenkins归档产物，Appium任务执行前自动拉取安装到连接的iOS测试机/模拟器即可。

二、本地部署Jenkins的测试报告团队共享方案 #

都是落地验证过的可行方案，按自己团队的网络情况选择即可：

• 内网访问方案（成本最低）：给部署Jenkins的本地机器分配固定内网IP，修改Jenkins启动配置，将服务监听地址从默认的127.0.0.1改为0.0.0.0，放开本机防火墙对应Jenkins端口（默认8080）的访问规则。同办公网内的团队成员直接在浏览器输入http://<你的机器内网IP>:8080就能访问Jenkins，给团队成员开通只读权限，或者配置匿名用户可查看构建记录，所有测试报告（Allure、ExtentReport、JUnit报告均可）配置为Jenkins构建页的可访问入口，大家点对应构建记录就能直接查看。注意如果用HTML格式报告，要提前在Jenkins脚本命令行执行System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "") 调整CSP安全策略，否则会出现报告样式丢失、交互失效的问题。
• 外网访问方案：如果有成员居家办公需要访问，两种选择：一是通过公司VPN接入内网后，直接访问上面说的内网IP即可，安全性最高；二是用内网穿透工具将本地Jenkins端口映射为公网可访问的地址，注意必须开启强账号密码鉴权，不要裸奔暴露在公网。
• 主动推送方案：不用成员主动登Jenkins查看的话，可以加个构建后步骤，每次测试执行完成后，将导出的HTML/PDF版测试报告、构建结果摘要直接推送到团队的飞书/钉钉/企业微信群，附带上Jenkins构建详情的跳转链接，用例失败时直接@对应负责人，查看效率更高。

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