上篇《发布准备工作》讲了打包前要自检哪些项，本文介绍第一步------把软件包上传到 AGC 。上传后 AGC 会做两层检测：合法性检测 和上架自检。
一、上传软件包的作用
需要先上传待发布的正式版本，以便在发布时能选择到对应的版本。上传时，AppGallery Connect 会对上传的包进行合法性检测 ，同时还提供了上架自检功能来助您提高应用审核通过率。
二、提交软件包
入口路径
-
登录 AppGallery Connect，点击 "APP与元服务"
-
选择要发布的应用
-
左侧导航选择 "应用上架 > 软件包管理"
-
点击页面右上角的 "上传"
上传包窗口
在"上传包"窗口：
-
先选择 "使用场景"
-
然后点击 "+" 上传软件包
使用场景选项：
| 使用场景 | 说明 |
|---|---|
| 仅测试 | 若上传的软件包只用于测试发布，可以选择"仅测试" |
| 测试和正式上架 | 若软件包需要在全网正式发布，请选择"测试和正式上架" |
说明：支持 APP 格式 ，大小在 4GB 以内。
三、页面字段
上传完成后，软件包管理页面会生成一条记录，展示软件包基本信息。各字段含义：
| 字段 | 说明 |
|---|---|
| 文件名 | 软件包文件名 |
| 包名 | 应用包名，对应包内的 bundleName 字段 |
| 版本（版本号） | 版本名称与版本号，分别对应包内的 versionNumber 和 versionCode 字段 |
| 构建版本 | 构建版本号，用于区分同一主版本下的不同测试子版本，对应包内的 buildVersion 字段。如包内无 buildVersion 字段，则显示"- -" |
| 设备类型 | 支持的设备类型，对应包内的 deviceTypes 字段 |
| 使用场景 | 传包时选择的使用场景 |
| 上传时间 | 上传包的时间 |
| 合法性 | 合法性检测结果，具体请参见合法性检测 |
| 上架自检 | 上架自检结果，具体请参见上架自检 |
四、合法性检测（必过项）
AppGallery Connect 会对每个上传的包进行合法性检测 ，检测不通过的软件包不允许发布。可以在软件包记录中查看合法性检测结果。
查看路径
-
登录 AppGallery Connect，点击"APP与元服务"
-
选择要发布的应用
-
左侧导航选择"应用上架 > 软件包管理"，查看软件包对应的 "合法性" 栏
三种检测结果
| 结果 | 说明 | 后续操作 |
|---|---|---|
| 已达标 | 表示软件包完全满足鸿蒙生态规范要求，可以提交上架 | 点击"报告"，可查看检测结果详情。已达标的软件包各个检查项结果均为"通过" |
| 待优化 | 表示软件包允许提交上架 ，但仍存在一些问题可能导致后续被审核驳回，或者影响应用体验，建议进一步优化软件包 | 点击"报告"，可查看检测结果详情。"结果"列显示 "告警" 的检查项即为可优化项，"修改意见"列提供了解决措施 |
| 不通过 | 表示软件包不满足上架基本要求，不允许上架 | • 若"不通过"后显示错误码 （如"993"），可点击错误码链接查看相关 FAQ，根据 FAQ 提供的原因与建议进行修改 • 若"不通过"后显示 "报告" ，可点击"报告"打开检测结果详情页，"结果"列显示 "不通过" 的检查项即为必改问题，请根据"修改意见"列修改包 |
报告页面
-
报告页顶部展示：文件名、包名、版本、大小、结果
-
报告页中部展示一个分数环（如 100 表示已达标，60 表示待优化，50 表示不通过）
-
报告页下方是检查项列表，包含列：序号、检测类别、检查项、说明、结果、修改意见、操作
五、（推荐）上架自检
为提高应用审核通过率，建议使用上架自检功能 。该功能使用热门移动终端设备，按照华为应用市场上架标准对应用进行兼容性、稳定性、性能、功耗、UX、隐私等测试，可提前发现和解决问题。
启动路径
-
登录 AppGallery Connect，点击"APP与元服务"
-
选择要发布的应用
-
左侧导航选择"应用上架 > 软件包管理"
-
点击软件包 "操作" 列 "启动自检"
说明
每个应用同时只能进行 2 个上架自检任务 （包含状态为"终止中"和"检测中"的任务）。自检启动后，可随时点击 "终止自检" 结束任务。
若在启动自检后删除了软件包 ，自检任务将继续执行，需等待自检任务结束才可以执行新的自检任务。
查看进度与结果
在 "上架自检" 栏查看检测进度与结果。检测完成后，AGC 将发送邮件通知，可以点击邮件中的"软件包管理"链接前往"软件包管理"页面查看检测结果。
上架自检的六种状态
| 状态 | 说明 | 后续操作 |
|---|---|---|
| 检测中 | 表示正在检测软件包。检测时长可能受终端设备数量和排队情况影响，请耐心等待 | --- |
| 通过 | 表示检测通过，可以提交上架 | 点击"报告"可查看详细的检测报告 |
| 待优化 | 表示检测未通过 | 点击"报告"可查看详细的异常信息与日志等。若合法性检测通过、但上架自检未通过，不影响应用提交上架申请，但存在被审核驳回的风险，推荐您基于报告定位和修改问题 |
| 系统异常 | 表示系统发生错误 | 点击"报告"可查看详细原因。如不展示"报告"，请点击"启动自检"重试。若还有疑问，请联系客服 |
| 终止中 | 表示正在终止上架自检任务，请稍作等待 | --- |
| 已终止 | 表示上架自检任务已终止，已终止任务无法恢复启动 | --- |
六、合法性检测 vs 上架自检
| 对比项 | 合法性检测 | 上架自检 |
|---|---|---|
| 是否必须 | 必须，不通过不允许发布 | 推荐，不影响提交上架申请，但存在被审核驳回的风险 |
| 检测内容 | 鸿蒙生态规范要求（如 HAP 包检测、调试信息、provision 支持设备、ACL 权限声明等） | 兼容性、稳定性、性能、功耗、UX、隐私等测试 |
| 检测设备 | 无需真机，AGC 解析检测 | 使用热门移动终端设备 |
| 结果状态 | 已达标 / 待优化 / 不通过 | 检测中 / 通过 / 待优化 / 系统异常 / 终止中 / 已终止 |
| 通过后 | 可以提交上架 | 可以提交上架，但仅为推荐项 |
| 并发限制 | 每个应用同时只能进行 2 个上架自检任务 |
整体来看，上传软件包是发布流程的第一道关卡，核心是先过合法性检测，再尽量过上架自检。建议上传后先看合法性结果，不通过就按报告改；合法性过了之后再启动上架自检，提前发现兼容性、稳定性等问题，降低审核被驳回的风险。