Azure DevOps AndroidSigning任务未签名APK故障排查咨询

1. 开启流水线诊断日志 #

• 在Azure DevOps流水线运行页面右上角点击「运行新作业」，勾选「启用系统诊断」后重新运行流水线，该模式会输出所有步骤的标准输出、标准错误流，以及工具调用的完整入参和退出码
• 找到AndroidSigning步骤的完整日志，搜索apksigner关键词，确认工具是否真的被触发，以及传递的参数是否符合预期：包括keystore路径、别名、密码参数、输入输出APK路径是否存在权限问题

2. 手动复现签名过程验证 #

• 在同版本的构建Agent上执行以下操作，复现流水线的签名流程：
  1. 下载流水线构建生成的未签名APK原始文件
  2. 用和流水线配置完全一致的keystore文件、签名参数，手动运行apksigner命令：
     apksigner sign --verbose --ks <your-keystore-path> --ks-key-alias <your-alias> --out signed-output.apk unsigned-input.apk
  3. 观察命令运行的输出和退出码，运行echo $?（Linux/macOS）或者echo %errorlevel%（Windows）查看命令退出状态，非0即为执行失败，根据错误提示定位问题：常见原因包括keystore密码错误、别名不存在、APK未对齐、minSdkVersion和apksigner版本不兼容等

3. 检查AndroidSigning任务的配置合理性 #

• 确认你勾选了「对APK签名」选项，而非只勾选了对AAB签名
• 确认apksigner路径配置正确：如果是自定义Agent，需要保证Android SDK build-tools目录已加入系统PATH，或者在任务中手动指定apksigner的完整路径
• 检查输出路径权限：确认AndroidSigning步骤的输出目录有写入权限，避免签名后的APK被静默丢弃，默认使用构建生成的原APK路径覆盖写入即可

4. 增加额外的签名校验步骤 #

• 在AndroidSigning步骤后新增一个命令行步骤，强制校验APK签名状态，避免静默失败后流水线仍然标记成功：

  # 校验APK签名
  apksigner verify --verbose your-output.apk
  # 校验失败直接抛出错误终止流水线
  if [ $? -ne 0 ]; then
    echo "APK签名验证失败"
    exit 1
  fi
  

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