打包App之前,为什么总卡在”证书”这一环
很多平台运营者第一次打包商户端或骑手端App时都会遇到同样的问题:教程看到一半,突然冒出一堆陌生名词——安卓证书、证书别名、SHA1、BundleId、UniPush……
这不是系统故意设门槛,而是安卓平台的硬性要求:每个发布到应用市场或安装在手机上的App,都必须用一个数字证书签名,相当于给App盖”公章”,证明安装包出自你家、中途没被篡改。
海狐外卖系统的商户端、骑手端App基于 uni-app(DCloud)框架开发,打包前的证书配置都集中在 DCloud 开发者后台 完成。本文按实际操作顺序完整走一遍:填写安卓证书、下载证书、配置苹果 BundleId,再到配置 UniPush 参数。
先花一分钟,认识安卓签名证书
安卓签名证书本质上是一个 keystore 密钥库文件(后缀通常为 .keystore 或 .jks),里面装着这几样关键信息:
- 证书文件:装着签名私钥的密钥库,相当于保险柜;
- 证书别名(Alias):保险柜里某个格子的名字,一个密钥库可有多个条目,靠别名区分;
- 证书私钥密码:打开格子需要的密码;
- SHA1 / MD5 指纹:证书的唯一特征码,推送等第三方平台登记时会用到。
为什么要这么慎重?因为同一个App,以后每次升级都必须用同一个证书签名。证书丢了、密码忘了,最坏后果是已发布的App无法升级,只能换包名重新发布,老用户全部流失。
第一步:登录DCloud开发者后台,找到对应应用
打开浏览器,访问 DCloud 开发者中心:**https://dev.dcloud.net.cn/**,用注册账号登录。
[登录DCloud开发者中心]
登录后进入应用管理列表,找到你要打包的应用(商户端或骑手端),点进应用详情,选择修改应用各平台信息。接下来填的所有证书信息,都会记在这份”身份档案”里。
第二步:填写安卓证书信息
进入各平台信息页面后,找到 Android 平台设置 区域,按提示逐项填写安卓证书信息:
- 证书别名(Alias):密钥库中该证书条目的别名;
- 证书私钥密码:生成密钥库时设置的密码;
- SHA1 指纹;
- MD5 指纹;
- 证书文件:上传你的 keystore 密钥库文件。
[安卓证书信息填写区域示意]
证书指纹可以从密钥库中提取——如果使用 DCloud 的云证书服务,在证书详情里直接复制即可。填完后仔细核对,SHA1 中不要混入空格或换行,很多平台校验失败都是因为这个细节。
第三步:下载证书,保存好证书详情和密码
安卓证书信息填写完成后,后台支持下载证书文件,同时可以查看证书详情和密码。
这一步务必做好两件事:
- 备份证书文件:把下载到的密钥库文件复制至少两份,分别存在电脑本地和云盘/加密U盘里;
- 记录证书详情:把证书别名、私钥密码、SHA1 一起写进密码管理工具或纸质备忘。三者缺一不可,日后每次打包、配置推送都会用到。
第四步:填写苹果 BundleId
如果你还要打包 iOS 版的商户端或骑手端App,接下来需要填写苹果的 BundleId(应用标识符)。
苹果平台的证书体系比安卓复杂,后续打包还需在苹果开发者后台自行申请App上架证书和推送证书,本文不展开。如果团队里没有熟悉苹果证书流程的人员,可以联系海狐科技客服付费协助申请。
[苹果BundleId填写位置示意]
第五步:配置UniPush推送参数
证书配置的最后一环是 UniPush。商户端、骑手端的”新订单语音提醒""配送状态通知”等功能,都依赖它把消息推送到用户手机。
在 DCloud 后台选择对应应用,进入 UniPush 配置页面,按提示填写:
- 安卓证书信息:即第二步填写的证书别名、私钥密码、SHA1 等,与平台信息保持一致;
- iOS BundleId:即第四步填写的苹果应用标识符。
[UniPush参数配置页面示意]
UniPush 配置成功后,再结合海狐外卖系统后台完成推送参数对接,商户和骑手才能实时收到订单提醒。
常见问题 FAQ
Q1:SHA1 指纹在哪里看?
使用 DCloud 云证书服务的,在证书详情页直接复制;本地生成的 keystore 文件,用 JDK 自带的 keytool 命令查看,或上传到 DCloud 后台由平台解析显示。
Q2:证书密码忘记了怎么办?
密码无法找回。证书还没发布过正式版App的,重新生成一个新证书替换登记即可;已经用它发布了App的,丢失密码意味着该App将无法升级——所以第一次配置时务必备份好。
Q3:商户端和骑手端可以用同一个证书吗?
可以。无论同一密钥库的不同别名,还是两个独立密钥库都行,关键是每个App从首次发布后,每次打包都必须用同一个证书签名,中途更换会导致商店拒绝更新、用户无法覆盖安装。
Q4:配置了证书,为什么还是收不到推送提醒?
证书配置只是推送链路的第一步。推送能否送达,还取决于 UniPush 参数与后台推送配置是否完成、手机是否授予通知权限等,建议对照推送配置教程逐项排查。
Q5:没有苹果开发者账号,可以先只打包安卓版吗?
完全可以。先把安卓版跑起来,苹果证书后续再补,需要协助申请时联系海狐科技客服即可。
相关功能推荐
证书配置完成后,离App正式上线就只差最后几步:
- 商户端/骑手端App推送通知(UniPush)配置教程:接着把推送通知配置完成,让商户和骑手不错过任何新订单。
- uni-app编译微信小程序并上传代码教程:除了App,小程序端也需要编译上传,这篇教你完整流程。
- 如何在系统后台上传最新版小程序代码:系统功能更新后,如何同步发布最新版小程序。
签名证书是App的”出生证明”,一次配置、长期受益。把别名、密码、SHA1 这三样东西保管好,后面的打包、升级、推送都会顺顺利利。