Capacitor 6.0.0-rc.0 Android签名构建问题解析

问题背景

在Android应用开发中，应用签名是一个关键步骤。使用Capacitor构建Android应用时，开发者可以通过配置capacitor.config.ts文件来指定签名相关的参数。然而，在Capacitor 6.0.0-rc.0版本中，开发者报告了一个关于签名过程的严重问题。

问题现象

当开发者尝试使用Capacitor CLI构建并签名Android应用时，会遇到以下错误信息：

Failed to load signer "signer #1"
java.io.IOException: Unsupported password spec for Key "app" password for signer #1: PASSWORD

这个错误表明apksigner工具无法正确处理密钥库密码的格式。深入分析发现，问题出在Capacitor CLI生成的apksigner命令中，对于--key-pass参数没有正确添加"pass:"前缀。

技术分析

Android的apksigner工具要求密码参数必须指定输入格式，支持三种格式：

1. pass:直接指定密码
2. env:从环境变量获取
3. file:从文件读取

在Capacitor 6.0.0-rc.0的实现中，虽然对--ks-pass参数正确添加了"pass:"前缀，但对--key-pass参数却遗漏了这一处理，导致apksigner无法识别密码格式。

解决方案

临时解决方案

开发者可以通过在capacitor.config.ts中手动为keystoreAliasPassword添加"pass:"前缀来绕过这个问题：

{
  android: {
    buildOptions: {
      keystoreAliasPassword: `pass:${process.env.ANDROID_KS_ALIAS_PASSWORD}`,
    },
  },
}

长期解决方案

Capacitor团队已经确认这是一个bug，并将在后续版本中修复。建议开发者关注Capacitor的更新日志，及时升级到修复后的版本。

最佳实践建议

1. 密码管理：建议使用环境变量或密码文件来管理签名密码，而不是直接在配置文件中硬编码
2. 版本验证：在使用预发布版本(如rc版本)时，应充分测试关键功能
3. 错误排查：遇到签名问题时，可以尝试手动运行Capacitor生成的apksigner命令来验证问题

总结

Capacitor 6.0.0-rc.0版本中的这个签名问题提醒我们，在使用新版本工具链时需要保持谨慎。对于生产环境项目，建议等待稳定版本发布后再进行升级。同时，开发者应该掌握基本的Android签名知识，以便在遇到问题时能够快速定位和解决。