uni-app uni多商店上传之更新发布实战指南【免费下载链接】uni-appA cross-platform framework using Vue.js项目地址: https://gitcode.com/gh_mirrors/un/uni-app导读本文基于开源仓库 docs/uni-publish/update.md 编写系统讲解 uni-app 生态中「uni多商店上传」的**更新发布应用版本更新**全流程从首次创建渠道配置、上传 APK/IPA 安装包、完善应用发布信息到选择立即发布或定时发布并提交审核。读完本文你将掌握如何用一套 DCloud 开发者账号将新版本 App 一键分发到 App Store、Google Play、华为、荣耀、小米、VIVO、OPPO、应用宝、魅族等多家应用商店并结合仓库源码理解渠道包与版本号在工程中的实际落地方式。一、uni多商店上传与「更新发布」在 uni-app 中的定位「uni多商店上传」是 DCloud 面向 uni-app 开发者提供的应用商店分发服务其核心能力是一键将应用发布到多家应用商店替代以往逐个登录各家开放平台手动传包的低效流程。依据仓库文档 docs/uni-publish/intro.md 的说明该服务当前支持的应用商店包括App Store、Google Play、华为、荣耀、小米、VIVO、OPPO、应用宝、魅族。其主要产品能力包括一键多发一次上传、多处分发大幅提升发版效率安全稳定通过各大应用市场官方 API 上传应用无需手动登录各家平台审核状态实时更新提交后可在 DCloud 开发者中心实时查看在各商店的审核状态渠道包灵活分发可针对不同应用商店分发不同渠道包便于按渠道统计数据来源免 Mac 完成 iOS 全流程上架搭配 HBuilderX 云打包从打包、App Store 应用创建到上架全程无需 Mac 电脑。「更新发布」与「应用首次上架」共同构成该服务的两条主线前者面向已上架应用的版本迭代后者面向新应用首次提交详见 docs/uni-publish/first.md。当你的 App 已上架各应用市场、需要推送新版本时走的就是本文的更新发布流程。二、前置准备创建渠道配置更新发布的第一步是为你的应用在各应用商店建立「渠道配置」。渠道配置的本质是把各家应用市场开放平台分配的 API 传包凭证预先登记到 DCloud 开发者中心后续每次发布时系统据此调用对应商店的官方 API 完成传包与提审。2.1 操作入口使用DCloud 开发者账号登录 开发者中心选择uni多商店上传栏目首次使用时需先创建渠道配置点击进入「渠道配置」页面参考 API 传包相关参数获取说明 获取各家平台参数填写所需参数后点击「保存」。配置命名建议考虑到不同项目可能对应不同的应用市场账号建议配置名称使用项目名或公司名以便区分避免多项目共用账号时无法辨识。2.2 各家应用市场的传包参数获取核心参数速查渠道配置表单中需要填写的参数均来自各应用市场开放平台分配的 API 凭证。以下为各渠道的核心参数与获取要点完整分步图文操作见 docs/uni-publish/config.md渠道需要填写的核心参数获取途径要点小米公钥、私钥、小米账号小米开放平台「管理中心 → 自动发布接口」下载公钥文件读取公钥点击「获取私钥」获得私钥账号为登录开放平台的邮箱OPPOclient_id、client_secretOPPO 开放平台「管理中心 → 产品 → 我的 API」新建 API 客户端应用后平台分配同一个秘钥可支持多个 APP 使用VIVOaccess_key、access_secretVIVO 开放平台「账号 → 账号管理 → API 管理」点击「立即开通」后平台分配荣耀client_id、密钥荣耀开放平台「管理中心 → 凭证 → 申请凭证」申请成功后平台分配应用宝access_secret、UserID、app_id腾讯应用开放平台「账号 → 账号管理 → API 发布接口」申请开通后分配 access_secretUserID 在平台个人中心获取当渠道包含应用宝且勾选「更新发布」时还需填写 app_id华为client_id、密钥、app_idAppGallery Connect「用户与访问 → API 密钥 → Connect API」创建角色选择「APP 管理员」当渠道包含华为且勾选「首次发布」时需填写 app_id苹果App 专用密码、Issuer ID、密钥 ID、密钥文件Apple 账户「登录和安全 → App 专用密码」创建专用密码App Store Connect「用户和访问 → 集成 → App Store Connect API」查看 Issuer ID 并创建密钥Google Playclient_email、private_keyJSON 密钥文件Google Cloud 控制台启用 Google Play Android Developer API创建服务账号并生成 JSON 类型密钥再将服务账号邮箱作为新用户邀请进 Google Play 管理中心并授予发布相关权限魅族Access Key、Access Secret魅族开放平台「API 凭证管理 → 获取凭证」申请成功后平台分配注意请使用各应用市场主账号获取 API 传包相关操作不要使用子账号否则可能出现权限不足或没有操作入口的情况。三、更新发布操作全流程完成渠道配置后即可开始正式的更新发布操作。整个流程分为四步选择应用与发布类型 → 上传安装包 → 完善发布信息 → 发布设置与提交。3.1 进入应用发布页面并选择「更新发布」在 DCloud 开发者中心进入「uni多商店上传 → 应用发布」页面选择要发布的应用在发布类型中选择「更新发布」。与之对应「应用首次上架」用于新应用的第一次提交。若你的应用尚未在任何商店上架应先走首次上架流程详见 docs/uni-publish/first.md。3.2 上传安装包「更新发布」支持 Android 与 iOS 两种安装包形式其中 Android 又支持单 APK 上传多个市场和多 APK渠道包上传多个市场两种模式单 APK 上传一个 APK 同时投递到多个勾选的应用商店多 APK 上传为不同应用商店分别上传对应渠道包各商店展示/分发的包体可以不同IPA 上传iOS 版本通过上传 IPA 安装包投递至 App Store。上传完成后系统会自动解析安装包内的相关信息应用名称、包名、版本号、图标等。若包体较大请耐心等待解析完成。上传校验红线请确保安装包中的应用名称与包名和页面中填写的信息保持一致否则可能导致上传失败或信息校验错误。结合仓库源码渠道包在工程中的真实形态多 APK 渠道包并非随机命名而是有明确的工程配置支撑。在仓库文档 docs/tutorial/app-package.md 中可以看到APK 格式安装包支持配置渠道信息默认提供的渠道配置项恰好与 uni多商店上传支持的 Android 商店一一对应渠道名称渠道标识华为huaweiOPPOoppoVIVOvivo小米xiaomi荣耀honor应用宝yyb默认渠道不够时可在manifest.json的源码视图中通过__hbuilderx.channel_list配置自定义渠道例如{ __hbuilderx: { channel_list: [ { id: lenovo, name: 联想 } ] } }保存后重新打开「App 打包」界面新渠道即会出现在「APK 渠道包」列表中。应用中可通过uni.getAppBaseInfo()返回的channel属性读取当前安装包所属渠道勾选「无」时该属性值为空字符串。这正是「多 APK 上传多个市场」能力在工程侧的来源——每个市场拿到携带自身渠道标识的独立安装包便于后台按渠道统计下载与转化数据。3.3 完善应用发布信息上传安装包并完成解析后需要填写/确认本次发布的应用信息。各家应用商店对发布素材有明确的格式要求以下为通用字段及其填写规范摘自 docs/uni-publish/first.md 的发布信息说明更新发布同样适用参数名称填写规范备注应用分类根据应用实际场景选择分类分类选择不合适可能被驳回—兼容设备根据分发场景选择手机、平板或手机和平板—年龄分级按 3/8/12/16/18 标准选择内容越受限分级越高华为渠道的内容分级无法通过传包 API 完成须在 AppGallery Connect 手动配置一句话简介5 至 13 字不能包含标点符号和空格—应用介绍60 至 500 字—版本说明5 至 200 字的新版本特性—审核留言可向各市场审核人员补充说明若应用需注册账号使用可提供测试账号密码否则可能被驳回隐私政策填写隐私政策完整网址以 http 或 https 开头—应用图标与安装包中图标一致512×512pxPNG小于 1M—应用截图至少 4 张、至多 5 张内容与功能相符且不得重复竖向 1080×1920pxPNG单张不超过 1MB—备案信息填写备案主体名称、统一社会信用代码市场会按信用代码与包名查询备案情况版权证明支持 APP 电子版证书、计算机软件著作权登记证书—应用发布信息中的「版本号」应与安装包内的版本信息一致。仓库 src/manifest.json 中即通过versionName应用版本名称与versionCode应用版本号必须是整数范围 1~2147483647升级时必须高于上一次的值两个字段管理版本打包时会被写入安装包进而被 uni多商店上传解析校验详见 docs/collocation/manifest.md。3.4 发布设置立即发布 or 定时发布完善发布信息后进入「发布设置」在以下两种策略中选择其一并点击「确认提交」审核通过后立即发布人工审核通过后应用立即在对应应用商店上架供用户搜索与下载定时发布指定希望的上线时间点。若实际审核通过时间晚于设定时间则会在审核通过后立即上线即设定时间仅作为最早上线时刻的承诺不会被延误。提交后可在 uni多商店上传的应用列表中实时跟踪各商店的审核状态。四、更新发布常见问题与排查思路结合 docs/uni-publish/faq.md 中记录的实战问题更新发布最常见的失败场景集中在华为与OPPO两个渠道4.1 华为APK 编译超时原因APK 包名存在冲突或无法安装排查登录 AppGallery Connect进入应用的历史版本页面在「软件包管理」中查看具体原因后重新打包上传。4.2 华为内容分级为空错误码 204144660报错信息[cds]submit failed, additional msg is [The history of questionnaire feedback content ratings is empty .]原因应用的内容分级信息未在 AppGallery Connect 中配置而该配置当前无法通过 Publishing API 自动完成解决登录 AppGallery Connect 手动配置内容分级后回到 DCloud 开发者中心重新发布。4.3 华为备案主体信息为空错误码 204144660报错信息[cds]submit failed, additional msg is [registeredEntity and registeredEntityName can not be empty.]原因备案主体名称或备案主体统一社会信用代码信息为空解决确认该应用是否为首次上架。若是首次上架发布类型必须选择「应用首次上架」。4.4 OPPO一句话简介不合规报错提示一句话简介不能为空、不能多于 13 个字符原因OPPO Publishing API 对一句话简介有严格规范。若开发者中心未更新这些信息系统会回退使用 OPPO 开发平台中已有的信息信息不合规即发布失败解决在 DCloud 开发者中心将一句话简介更新为不多于 13 个字符、不含任何标点符号和空格再重新发起发布。五、与 uni-app 工程侧的衔接建议为让「更新发布」一次通过、减少反复建议在开发与打包阶段就做好以下三件事版本号管理每次发版在 manifest.json 中递增versionCode整数1~2147483647并同步更新versionName保证安装包版本高于商店中现有版本渠道包按需分发需要按商店统计数据来源时在「App 打包」界面勾选对应渠道标识huawei/oppo/vivo/xiaomi/honor/yyb 等生成渠道包再走「多 APK 上传多个市场」无此需求时使用单 APK 即可素材提前备齐应用图标512×512 PNG、竖向截图1080×1920 PNG4~5 张、一句话简介5~13 字无标点、隐私政策完整网址等素材在提审前备齐避免因素材不合规被驳回后重新排队。六、关联文档导航uni多商店上传的完整知识体系由四份文档构成建议按需查阅docs/uni-publish/intro.md服务介绍、产品优势与支持渠道总览docs/uni-publish/first.md应用首次上架教程新应用第一版必读docs/uni-publish/update.md应用更新发布教程本文主体docs/uni-publish/config.md各渠道 API 传包相关参数的详细获取说明docs/uni-publish/faq.md常见问题与报错排查。【免费下载链接】uni-appA cross-platform framework using Vue.js项目地址: https://gitcode.com/gh_mirrors/un/uni-app创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
uni-app uni多商店上传之更新发布实战指南
uni-app uni多商店上传之更新发布实战指南【免费下载链接】uni-appA cross-platform framework using Vue.js项目地址: https://gitcode.com/gh_mirrors/un/uni-app导读本文基于开源仓库 docs/uni-publish/update.md 编写系统讲解 uni-app 生态中「uni多商店上传」的**更新发布应用版本更新**全流程从首次创建渠道配置、上传 APK/IPA 安装包、完善应用发布信息到选择立即发布或定时发布并提交审核。读完本文你将掌握如何用一套 DCloud 开发者账号将新版本 App 一键分发到 App Store、Google Play、华为、荣耀、小米、VIVO、OPPO、应用宝、魅族等多家应用商店并结合仓库源码理解渠道包与版本号在工程中的实际落地方式。一、uni多商店上传与「更新发布」在 uni-app 中的定位「uni多商店上传」是 DCloud 面向 uni-app 开发者提供的应用商店分发服务其核心能力是一键将应用发布到多家应用商店替代以往逐个登录各家开放平台手动传包的低效流程。依据仓库文档 docs/uni-publish/intro.md 的说明该服务当前支持的应用商店包括App Store、Google Play、华为、荣耀、小米、VIVO、OPPO、应用宝、魅族。其主要产品能力包括一键多发一次上传、多处分发大幅提升发版效率安全稳定通过各大应用市场官方 API 上传应用无需手动登录各家平台审核状态实时更新提交后可在 DCloud 开发者中心实时查看在各商店的审核状态渠道包灵活分发可针对不同应用商店分发不同渠道包便于按渠道统计数据来源免 Mac 完成 iOS 全流程上架搭配 HBuilderX 云打包从打包、App Store 应用创建到上架全程无需 Mac 电脑。「更新发布」与「应用首次上架」共同构成该服务的两条主线前者面向已上架应用的版本迭代后者面向新应用首次提交详见 docs/uni-publish/first.md。当你的 App 已上架各应用市场、需要推送新版本时走的就是本文的更新发布流程。二、前置准备创建渠道配置更新发布的第一步是为你的应用在各应用商店建立「渠道配置」。渠道配置的本质是把各家应用市场开放平台分配的 API 传包凭证预先登记到 DCloud 开发者中心后续每次发布时系统据此调用对应商店的官方 API 完成传包与提审。2.1 操作入口使用DCloud 开发者账号登录 开发者中心选择uni多商店上传栏目首次使用时需先创建渠道配置点击进入「渠道配置」页面参考 API 传包相关参数获取说明 获取各家平台参数填写所需参数后点击「保存」。配置命名建议考虑到不同项目可能对应不同的应用市场账号建议配置名称使用项目名或公司名以便区分避免多项目共用账号时无法辨识。2.2 各家应用市场的传包参数获取核心参数速查渠道配置表单中需要填写的参数均来自各应用市场开放平台分配的 API 凭证。以下为各渠道的核心参数与获取要点完整分步图文操作见 docs/uni-publish/config.md渠道需要填写的核心参数获取途径要点小米公钥、私钥、小米账号小米开放平台「管理中心 → 自动发布接口」下载公钥文件读取公钥点击「获取私钥」获得私钥账号为登录开放平台的邮箱OPPOclient_id、client_secretOPPO 开放平台「管理中心 → 产品 → 我的 API」新建 API 客户端应用后平台分配同一个秘钥可支持多个 APP 使用VIVOaccess_key、access_secretVIVO 开放平台「账号 → 账号管理 → API 管理」点击「立即开通」后平台分配荣耀client_id、密钥荣耀开放平台「管理中心 → 凭证 → 申请凭证」申请成功后平台分配应用宝access_secret、UserID、app_id腾讯应用开放平台「账号 → 账号管理 → API 发布接口」申请开通后分配 access_secretUserID 在平台个人中心获取当渠道包含应用宝且勾选「更新发布」时还需填写 app_id华为client_id、密钥、app_idAppGallery Connect「用户与访问 → API 密钥 → Connect API」创建角色选择「APP 管理员」当渠道包含华为且勾选「首次发布」时需填写 app_id苹果App 专用密码、Issuer ID、密钥 ID、密钥文件Apple 账户「登录和安全 → App 专用密码」创建专用密码App Store Connect「用户和访问 → 集成 → App Store Connect API」查看 Issuer ID 并创建密钥Google Playclient_email、private_keyJSON 密钥文件Google Cloud 控制台启用 Google Play Android Developer API创建服务账号并生成 JSON 类型密钥再将服务账号邮箱作为新用户邀请进 Google Play 管理中心并授予发布相关权限魅族Access Key、Access Secret魅族开放平台「API 凭证管理 → 获取凭证」申请成功后平台分配注意请使用各应用市场主账号获取 API 传包相关操作不要使用子账号否则可能出现权限不足或没有操作入口的情况。三、更新发布操作全流程完成渠道配置后即可开始正式的更新发布操作。整个流程分为四步选择应用与发布类型 → 上传安装包 → 完善发布信息 → 发布设置与提交。3.1 进入应用发布页面并选择「更新发布」在 DCloud 开发者中心进入「uni多商店上传 → 应用发布」页面选择要发布的应用在发布类型中选择「更新发布」。与之对应「应用首次上架」用于新应用的第一次提交。若你的应用尚未在任何商店上架应先走首次上架流程详见 docs/uni-publish/first.md。3.2 上传安装包「更新发布」支持 Android 与 iOS 两种安装包形式其中 Android 又支持单 APK 上传多个市场和多 APK渠道包上传多个市场两种模式单 APK 上传一个 APK 同时投递到多个勾选的应用商店多 APK 上传为不同应用商店分别上传对应渠道包各商店展示/分发的包体可以不同IPA 上传iOS 版本通过上传 IPA 安装包投递至 App Store。上传完成后系统会自动解析安装包内的相关信息应用名称、包名、版本号、图标等。若包体较大请耐心等待解析完成。上传校验红线请确保安装包中的应用名称与包名和页面中填写的信息保持一致否则可能导致上传失败或信息校验错误。结合仓库源码渠道包在工程中的真实形态多 APK 渠道包并非随机命名而是有明确的工程配置支撑。在仓库文档 docs/tutorial/app-package.md 中可以看到APK 格式安装包支持配置渠道信息默认提供的渠道配置项恰好与 uni多商店上传支持的 Android 商店一一对应渠道名称渠道标识华为huaweiOPPOoppoVIVOvivo小米xiaomi荣耀honor应用宝yyb默认渠道不够时可在manifest.json的源码视图中通过__hbuilderx.channel_list配置自定义渠道例如{ __hbuilderx: { channel_list: [ { id: lenovo, name: 联想 } ] } }保存后重新打开「App 打包」界面新渠道即会出现在「APK 渠道包」列表中。应用中可通过uni.getAppBaseInfo()返回的channel属性读取当前安装包所属渠道勾选「无」时该属性值为空字符串。这正是「多 APK 上传多个市场」能力在工程侧的来源——每个市场拿到携带自身渠道标识的独立安装包便于后台按渠道统计下载与转化数据。3.3 完善应用发布信息上传安装包并完成解析后需要填写/确认本次发布的应用信息。各家应用商店对发布素材有明确的格式要求以下为通用字段及其填写规范摘自 docs/uni-publish/first.md 的发布信息说明更新发布同样适用参数名称填写规范备注应用分类根据应用实际场景选择分类分类选择不合适可能被驳回—兼容设备根据分发场景选择手机、平板或手机和平板—年龄分级按 3/8/12/16/18 标准选择内容越受限分级越高华为渠道的内容分级无法通过传包 API 完成须在 AppGallery Connect 手动配置一句话简介5 至 13 字不能包含标点符号和空格—应用介绍60 至 500 字—版本说明5 至 200 字的新版本特性—审核留言可向各市场审核人员补充说明若应用需注册账号使用可提供测试账号密码否则可能被驳回隐私政策填写隐私政策完整网址以 http 或 https 开头—应用图标与安装包中图标一致512×512pxPNG小于 1M—应用截图至少 4 张、至多 5 张内容与功能相符且不得重复竖向 1080×1920pxPNG单张不超过 1MB—备案信息填写备案主体名称、统一社会信用代码市场会按信用代码与包名查询备案情况版权证明支持 APP 电子版证书、计算机软件著作权登记证书—应用发布信息中的「版本号」应与安装包内的版本信息一致。仓库 src/manifest.json 中即通过versionName应用版本名称与versionCode应用版本号必须是整数范围 1~2147483647升级时必须高于上一次的值两个字段管理版本打包时会被写入安装包进而被 uni多商店上传解析校验详见 docs/collocation/manifest.md。3.4 发布设置立即发布 or 定时发布完善发布信息后进入「发布设置」在以下两种策略中选择其一并点击「确认提交」审核通过后立即发布人工审核通过后应用立即在对应应用商店上架供用户搜索与下载定时发布指定希望的上线时间点。若实际审核通过时间晚于设定时间则会在审核通过后立即上线即设定时间仅作为最早上线时刻的承诺不会被延误。提交后可在 uni多商店上传的应用列表中实时跟踪各商店的审核状态。四、更新发布常见问题与排查思路结合 docs/uni-publish/faq.md 中记录的实战问题更新发布最常见的失败场景集中在华为与OPPO两个渠道4.1 华为APK 编译超时原因APK 包名存在冲突或无法安装排查登录 AppGallery Connect进入应用的历史版本页面在「软件包管理」中查看具体原因后重新打包上传。4.2 华为内容分级为空错误码 204144660报错信息[cds]submit failed, additional msg is [The history of questionnaire feedback content ratings is empty .]原因应用的内容分级信息未在 AppGallery Connect 中配置而该配置当前无法通过 Publishing API 自动完成解决登录 AppGallery Connect 手动配置内容分级后回到 DCloud 开发者中心重新发布。4.3 华为备案主体信息为空错误码 204144660报错信息[cds]submit failed, additional msg is [registeredEntity and registeredEntityName can not be empty.]原因备案主体名称或备案主体统一社会信用代码信息为空解决确认该应用是否为首次上架。若是首次上架发布类型必须选择「应用首次上架」。4.4 OPPO一句话简介不合规报错提示一句话简介不能为空、不能多于 13 个字符原因OPPO Publishing API 对一句话简介有严格规范。若开发者中心未更新这些信息系统会回退使用 OPPO 开发平台中已有的信息信息不合规即发布失败解决在 DCloud 开发者中心将一句话简介更新为不多于 13 个字符、不含任何标点符号和空格再重新发起发布。五、与 uni-app 工程侧的衔接建议为让「更新发布」一次通过、减少反复建议在开发与打包阶段就做好以下三件事版本号管理每次发版在 manifest.json 中递增versionCode整数1~2147483647并同步更新versionName保证安装包版本高于商店中现有版本渠道包按需分发需要按商店统计数据来源时在「App 打包」界面勾选对应渠道标识huawei/oppo/vivo/xiaomi/honor/yyb 等生成渠道包再走「多 APK 上传多个市场」无此需求时使用单 APK 即可素材提前备齐应用图标512×512 PNG、竖向截图1080×1920 PNG4~5 张、一句话简介5~13 字无标点、隐私政策完整网址等素材在提审前备齐避免因素材不合规被驳回后重新排队。六、关联文档导航uni多商店上传的完整知识体系由四份文档构成建议按需查阅docs/uni-publish/intro.md服务介绍、产品优势与支持渠道总览docs/uni-publish/first.md应用首次上架教程新应用第一版必读docs/uni-publish/update.md应用更新发布教程本文主体docs/uni-publish/config.md各渠道 API 传包相关参数的详细获取说明docs/uni-publish/faq.md常见问题与报错排查。【免费下载链接】uni-appA cross-platform framework using Vue.js项目地址: https://gitcode.com/gh_mirrors/un/uni-app创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
