企业官网建设流程全解析

手机上如何管理签名证书：WebToApp 密钥库创建、导入（PKCS12/JKS）与指纹查看完整指南

WebToApp 是一款功能最全的 Android 端网页转 APK 工具包，在"构建 APK"与"APK 导出配置"中内置了完整的签名证书管理能力：你可以在手机上直接创建签名密钥库、导入 PKCS12 / JKS / JCEKS / BKS 格式的密钥文件、导出备份，并查看 MD5、SHA-1、SHA-256 指纹——全程无需电脑和 keytool 命令行。下面用 5 个步骤带你完成签名证书的全部管理操作。

一、为什么要在手机上管理签名证书？

导出可安装的 APK 时，每个应用都需要用数字证书签名（V1/V2/V3）。传统流程是：在电脑上用 keytool 生成密钥库 → 拷贝到手机 → 再构建。WebToApp 把这一整套流程搬进了手机：

• 新建签名：本机生成全新证书，说明中明确写着"无需电脑或 keytool"；
• 导入密钥库：支持 PKCS12、PFX、JKS、JCEKS、BKS 五种格式；
• 导出密钥库：一键备份为.p12（PKCS12）文件；
• 查看指纹：MD5 / SHA-1 / SHA-256 三种指纹，点击即复制。

官方文档可参考：构建 APK 与 APK 导出配置。

二、找到签名管理入口：30 秒定位

有两种进入方式，任选其一：

1. 在应用卡片上点⋮ → 构建 APK，打开构建对话框（见 docs/zh/guide/app-actions/build-apk.md）；
2. 打开编辑通用配置，展开APK 导出配置抽屉，进入"签名"区块（见 docs/zh/guide/app-actions/edit-common-config/apk-export.md）。

展开"当前签名状态"区块后，你会看到：

• 当前签名类型（自定义签名 / 自动生成 / Android Keystore）与证书信息；
• 四个操作入口：新建签名、导入密钥库、导出密钥库、查看指纹（已存在自定义证书时，还有红色的移除入口）。

相关界面实现位于 CreateAppApkSection.kt。

三、一键创建密钥库：手机上生成全新证书

点击新建签名，弹出创建对话框，填写以下字段即可：

⚠️ 关键提醒：证书有效期一旦生成不可更改。Google Play 要求新应用证书有效期至少到 2033 年 11 月，所以有效期建议直接填 100 年，密码建议同时保存到你的密码管理器。

创建成功后会提示"证书创建成功"，当前签名状态自动切换为自定义签名。底层由 JarSigner.kt 中的createCustomKeystore完成，证书规格即CertificateSpec。

四、导入已有密钥库：PKCS12 / JKS 文件怎么传？

如果你的证书是在 Android Studio、keytool 或别的工具里生成的，点导入密钥库，系统文件选择器会打开，选择你的.p12/.pfx/.jks文件后，弹出密码对话框：

1. Keystore 密码（必填）：密钥库文件本身的密码；
2. 密钥密码（可选）：仅当私钥密码与库密码不同时填写，留空表示两者一致。

点"确认"开始导入，成功即提示"签名证书导入成功"。导入流程与错误处理见 CreateAppApkSection.kt。

导入失败的 4 种报错，逐条看懂

WebToApp 对导入错误做了精细化提示，遇到报错对号入座：

💡 典型场景：keytool 生成 JKS 时storepass和keypass用了不同密码，很多人只在第一个框输入 storepass，导致"密钥密码被拒绝"。

五、导出密钥库备份：给签名证书上保险

自定义证书丢失 = 无法给已上架应用打增量更新包。点导出密钥库后，应用会以webtoapp_signing.p12为默认文件名让你选择保存位置，再输入一个新的导出密码即可完成备份（见 CreateAppApkSection.kt）。

建议：备份出来的.p12文件与密码分别存到两个地方（云盘 + 密码管理器），这是签名证书管理的最佳实践。

六、查看证书指纹：MD5 / SHA-1 / SHA-256 一键复制

已有自定义证书时，会出现查看指纹入口。点开对话框，三行指纹整齐排列，每行右侧点一下即复制到剪贴板，并提示"指纹已复制"（实现见 CreateAppApkSection.kt，指纹数据来自 JarSigner.kt 的getCertificateFingerprints）。

指纹有什么用？

• 核对身份：发布到渠道后，用keytool -list -v或在 Play Console 对比 SHA-256，确认线上 APK 确实是你的证书签的；
• 配置 Google Play：AAB 导出到 Play 商店前（见 Google Play 文档），指纹是必备核对项。

七、签名方案怎么选：V1 / V2 / V3 独立控制

创建好证书后，在同一区块还能独立勾选签名方案：

• V1：兼容 Android 6 及以下老机型；
• V2 / V3：Android 7+ 的校验块签名，V3 支持吊销；
• 旧证书自动回退，V1 签名者文件名可自定义。

日常构建保持默认即可，WebToApp 会自动处理回退逻辑（详见 构建 APK 文档 的"签名"一节）。

八、常见问题速查

• 忘记密码怎么办？无法找回。用"导出密钥库"做备份；自定义证书也可"移除"后重建，但已用旧证书签过的应用将无法再更新。
• 支持哪些格式？PKCS12、PFX、JKS、JCEKS、BKS（BKS 为 Bouncycastle 格式），错误提示中会列出完整清单。
• 证书信息在哪看？"当前签名状态"区块的副标题直接展示证书摘要，不用进任何对话框。

写在最后

借助 WebToApp 的密钥库管理，签名证书的创建、导入（PKCS12/JKS）、导出备份与指纹查看全部在手机上完成，配合 构建 APK 与 APK 导出配置 文档，你就能独立完成从网页应用到上架签名的完整闭环。