uni-app 应用首次上架全流程指南:使用 uni 多商店上传一键发布多家应用商店

uni-app 应用首次上架全流程指南:使用 uni 多商店上传一键发布多家应用商店 示例工程前端移动开发跨平台【免费下载链接】uni-appA cross-platform framework using Vue.js项目地址https://gitcode.com/gh_mirrors/un/uni-app点击查看免费下载导读对于基于 Vue.js 跨平台框架 uni-app 开发的 App应用开发完成后还面临向小米、华为、荣耀、VIVO、苹果 App Store 等多家应用商店逐一申请账号、上传安装包、填写审核信息的繁琐流程。本指南以 uni-app 官方开源仓库中的「uni 多商店上传」文档docs/uni-publish/first.md为核心完整讲解应用首次上架到各应用商店的全流程从前置备案与软著准备、各渠道应用创建到 DCloud 开发者中心的渠道配置、安装包上传、发布信息填写与审核提交。读完本文你将掌握一套可复制的「一次操作、多店同步」上架方案并了解上架过程中常见的失败原因与排查思路。uni 多商店上传功能定位与产品优势「uni 多商店上传」是 uni-app 生态提供的应用商店分发服务核心能力是一键将应用发布到多家应用商店高效助力 App 发版。根据仓库中的产品说明docs/uni-publish/intro.md其产品优势可归纳为一键多发支持一键将应用发布到多家应用商店大幅提升发版效率安全稳定通过各大应用市场官方 API 上传应用无需手动登录各平台安全、稳定、快捷审核状态实时更新App 提交成功后可实时查看在各大应用商店的审核状态渠道包灵活分发提交应用商店时如需对每个应用商店统计不同的数据来源可选择分发不同的渠道包免 Mac 完成 iOS 全流程上架搭配 HBuilderX 云打包使用从打包、App Store 应用创建到最终上架全流程无需 Mac 电脑降低 iOS 上架硬件门槛。支持的渠道与首次发布能力当前支持的应用商店包括App Store、Google Play、华为、荣耀、小米、VIVO、OPPO、应用宝、魅族。但并非所有渠道都支持通过「uni 多商店上传」完成新应用的首次发布各渠道能力对比如下渠道名称是否支持新应用发布备注说明App Store、小米、华为、荣耀是先在各自开放平台创建应用再回DCloud 开发者中心进行后续的新应用发布VIVO是无需提前创建应用可直接在DCloud 开发者中心完成新应用发布OPPO、应用宝、Google Play否需在各自开放平台创建和发布应用这一差异是规划上架路径的第一步先确认目标渠道是否支持首次发布再决定是「开放平台创建 开发者中心完善」还是「开放平台全手动发布」。首次上架整体流程「应用首次上架」的完整流程分为五个阶段docs/uni-publish/first.md前置准备提前完成 APP 备案、申请软件著作权登记证书软著注册开发者账号并实名认证前往各家开放平台注册开发者账号并完成实名认证创建应用由于小米、华为、荣耀的传包 API 暂不提供创建应用接口需在各家开放平台提前手动创建应用VIVO 渠道除外开发应用在本地开发环境中完成应用开发并进行打包发布应用使用 DCloud 开发者账号登录开发者中心进入「uni多商店上传 - 应用发布」页面上传应用安装包、完善发布信息后点击「提交审核」。前置准备备案与软著APP 备案国内应用市场上架普遍要求完成 APP 备案具体政策与接入指引需以各平台如腾讯开放平台备案指引、华为 APP 备案指引等发布的最新要求为准软件著作权登记证书软著多数渠道要求提交软著作为版权证明开发者需提前申请取得。提示关于各渠道更细化的资质与审核要求可参考仓库中的上架注意事项文档 docs/tutorial/app-market.md其中整理了华为、小米、OPPO、VIVO、荣耀、苹果等平台的应用审核指南、资质审核要求、行业资质要求与 APP 备案指引的入口。注册开发者账号首次上架前需要在目标渠道的开放平台完成开发者注册与实名认证涉及平台包括腾讯应用开放平台应用宝小米开放平台华为开放平台荣耀开放平台OPPO 开放平台VIVO 开放平台App Store Connect苹果重要提醒获取 API 传包相关参数时请使用应用市场的主账号操作不要使用子账号否则可能出现权限不足或没有操作入口的问题详见 docs/uni-publish/config.md。各渠道创建应用详解不同渠道对「应用创建」的支持程度不同操作路径也不同。以下按渠道逐一说明均摘自 docs/uni-publish/first.md。小米渠道前往小米开放平台点击「管理中心」未登录则先跳转至登录页面点击「创建应用」按钮开始应用的首次创建应用创建成功后会自动跳转至完善资料页面。由于小米传包 API 不支持补充备案信息、资质信息、联系人信息需先在小米开放平台手动填写点击「保存草稿」按钮其余信息使用 DCloud 开发者账号登录开发者中心进入「uni多商店上传 - 应用发布」页面完善。华为渠道前往 AppGallery Connect未登录则先登录点击「APP」选择「Android」页签点击应用列表右侧的「新建发布」填写应用信息完成后点击「确认」应用的内容分级信息当前无法通过传包 API 完成必须在 AppGallery Connect 网站中手动配置内容分级在已发布版本的国家或地区配置中确保未勾选「新国家或地区」选项点击「保存草稿」按钮其余信息使用 DCloud 开发者账号登录开发者中心完善。荣耀渠道前往荣耀开放平台点击「管理中心」未登录则先跳转至登录页面点击「生态服务 应用服务 应用分发」卡片点击页面「新建」按钮创建应用其余信息使用 DCloud 开发者账号登录开发者中心完善。VIVO 渠道无需提前创建应用后续直接使用 DCloud 开发者账号登录开发者中心进入「uni多商店上传 - 应用发布」即可完成新应用的首次发布。OPPO 渠道暂不支持通过传包 API 进行首次发布请前往 OPPO 开放平台手动完成新应用的创建与发布。应用宝渠道暂不支持通过传包 API 进行首次发布请前往腾讯应用开放平台手动完成新应用的创建与发布。苹果 App Store 渠道前往 App Store Connect点击 App 旁边的「」号添加 App如还没有添加 Bundle ID请先通过「证书、标识符和描述文件」链接进行添加uni 多商店上传暂只支持「简体中文」介绍如应用需要其它语言介绍请在 App Store Connect 中添加点击左侧「App 信息」菜单在「综合信息」中完成「内容版权」「年龄分级」信息填写点击左侧「App 隐私」菜单填写「数据收集」其余信息使用 DCloud 开发者账号登录开发者中心完善。在 DCloud 开发者中心发布应用完成各渠道的应用创建后回到 DCloud 开发者中心进行统一的发布操作这是「uni 多商店上传」的核心环节。创建渠道配置使用 DCloud 开发者账号登录开发者中心选择「uni多商店上传」栏目首次使用时需创建渠道配置参考 API 传包相关参数获取说明 获取相关参数然后填写所需参数并点击「保存」。建议考虑到不同项目可能对应不同的应用市场账号配置名称建议使用项目名或公司名以便区分。各渠道所需的 API 传包参数获取方式详见 docs/uni-publish/config.md概览如下渠道所需参数获取路径要点小米公钥、私钥、小米账号开放平台「自动发布接口」下载公钥文件、点击「获取私钥」账号为登录邮箱OPPOclient_id、client_secret管理中心「产品 我的 API」新建客户端应用后分配同一秘钥可支持多个 APP 使用VIVOaccess_key、access_secret账号管理 API 管理点击「立即开通」后分配荣耀client_id、密钥管理中心「凭证」处点击「申请凭证」后分配应用宝access_secret、UserID、app_id账号管理 API 发布接口申请开通勾选「更新发布」且渠道包含应用宝时需填写 app_id华为client_id、密钥、app_id「用户与访问 API 密钥 Connect API」创建角色选择 APP 管理员勾选「首次发布」且渠道包含华为时需填写 app_id苹果App 专用密码、Issuer ID、密钥 ID、密钥文件Apple 账户「登录和安全」创建 App 专用密码App Store Connect「用户和访问 - 集成 - App Store Connect API」查看 Issuer ID 并创建密钥Google Play服务账号 JSON 密钥client_email、private_keyGoogle Cloud 控制台启用 Google Play Android Developer API、创建服务账号并生成 JSON 密钥再在 Google Play 管理中心邀请服务账号并授予发布权限魅族Access Key、Access Secret开放平台「API 凭证管理」点击「获取凭证」后分配应用首次上架上传安装包进入应用发布页面选择要发布的应用发布类型选择「应用首次上架」上传包Android 支持两种方式——单个 APK 上传多个市场一个通用包同时提交到多个 Android 渠道多个 APK渠道包上传多个市场为不同市场分发不同渠道包便于分渠道统计数据iOS 则上传IPA文件。上传完成后系统会自动解析安装包内的相关信息若包体较大请耐心等待解析完成。请确保安装包中的应用名称与包名和页面中填写的信息保持一致否则可能导致上传失败或信息校验错误。关于渠道包uni-app 工程可通过 manifest.json 中的app-plus配置进行 Android 打包设置如minSdkVersion、abiFilters等并在云端打包时通过channel_list配置自定义渠道信息该字段说明见 docs/collocation/manifest.md 中「channel_list | array | Android: 4.31 | 云端打包时配置的自定义渠道信息」。渠道包可用于应用商店的数据来源统计与「uni 多商店上传」的渠道分发能力配合使用。完善应用发布信息在完善应用发布信息部分需按顺序填写基本信息、图标素材、适配信息、资质证明、APP 备案信息、隐私政策。各字段的填写规范与注意事项如下完整参数表继承自 docs/uni-publish/first.md参数名称填写规范备注应用分类根据应用的实际场景选择分类分类选择如果不合适可能会被驳回兼容设备根据应用的实际分发场景填写可选择手机、平板、手机和平板三项年龄分级参考以下标准选择3 周岁内容不包含暴力、惊吓、粗俗用语等任何受限制内容适合所有年龄段用户。8 周岁内容健康可能包含少量卡通暴力或极少的不良用语但不得含有现实暴力或惊吓场景。12 周岁内容可能包含轻微现实暴力或轻度粗俗用语不含性相关粗口但不得含有粗俗幽默或性暗示内容。16 周岁内容可能包含少量现实暴力、粗俗内容不含性粗口但不得含有性暗示、恐怖或惊悚题材内容。18 周岁内容仅适用于成年人须合法合规并符合社会道德规范。不得含有色情、赌博、吸毒或过度暴力等内容。华为渠道应用的内容分级信息无法通过传包 API 完成必须在 AppGallery Connect 网站手动配置一句话简介填写 5 至 13 字的一句话简介不能包含标点符号和空格应用介绍填写 60 至 500 字的应用介绍让用户更了解您的应用版本说明填写 5 至 200 字的新版本特性审核留言可向各应用市场审核人员补充说明信息如果应用需要注册账号才能使用可提供用于测试的账号和密码若没有测试账号且应用无法正常使用可能会被驳回隐私政策填写应用中的隐私政策完整网址以 http 或 https 开头应用图标要求与安装包中图标一致。尺寸512 × 512px图片格式PNG小于 1M应用截图① 上传至少 4 张截图、至多 5 张截图并确保截图内容与实际应用功能相符且不能使用重复图片② 竖向截图分辨率 1080 × 1920pxpng 格式文件大小不超过 1MB备案信息请正确填写备案主体名称、社会信用代码应用市场会根据填写的统一社会信用代码和 APP 包名查询备案情况需提前完成 APP 备案版权证明支持 APP 电子版证书、计算机软件著作权登记证书需提前办理软著发布设置完成发布信息后进入发布设置可选择以下两种方式之一并点击「确认提交」审核通过后立即发布在人工审核通过后应用会在应用商店立即上架供用户搜索与下载定时发布指定希望的上线时间点若实际审核通过时间晚于设定时间则会在审核通过后立即上线。与 uni-app 工程打包的衔接「uni 多商店上传」面向的是已打包完成的产物因此在开发阶段需要保证工程的打包配置正确。以仓库中的示例工程 examples/hello-uts/manifest.json 为例工程的name应用名称、appid、versionName版本名、versionCode版本号等基础信息在打包后写入安装包并会被上传时系统自动解析因此必须与发布页面填写的信息保持一致app-plus.distribute下的android、ios配置如minSdkVersion、abiFilters、permissions等决定云打包产物的形态若需要按渠道分发不同渠道包可在云端打包时配置channel_list自定义渠道信息详见 docs/collocation/manifest.md。对于 iOS 上架场景使用 HBuilderX 云打包 uni 多商店上传即可完成从打包、App Store 应用创建到最终上架的全流程全程无需 Mac 电脑docs/uni-publish/intro.md。常见问题与失败排查在首次上架过程中不同渠道有各自的审核约束以下为仓库 FAQdocs/uni-publish/faq.md中记录的高频问题与解决方案。华为渠道问题 1应用发布失败提示「APK编译超时」原因APK 包名存在冲突或无法安装解决登录 AppGallery Connect进入应用的历史版本页面在软件包管理页面查看具体原因。问题 2发布失败提示[cds]submit failed, additional msg is [The history of questionnaire feedback content ratings is empty.]错误码 204144660原因应用的内容分级信息未在 AppGallery Connect 中配置该配置当前无法通过 Publishing API 自动完成解决必须在 AppGallery Connect 网站中手动配置内容分级完整设置后前往 DCloud 开发者中心重新发布应用版本。问题 3发布失败提示[cds]submit failed, additional msg is [registeredEntity and registeredEntityName can not be empty.]错误码 204144660原因备案主体名称或备案主体统一社会信用代码信息为空解决确认该应用是否为首次上架。如果是首次上架请确保已选择「应用首次上架」为发布类型。OPPO 渠道问题提交审核时提示「一句话简介不能为空」「一句话简介不能多于13个字符」原因OPPO Publishing API 对一句话简介等信息有特定规范要求。如果在 DCloud 开发者中心未更新这些信息系统会使用 OPPO 开放平台中已有的信息当这些信息不符合接口规范时即导致发布失败解决按照参数规范在 DCloud 开发者中心更新应用信息——一句话简介summary不多于 13 个字符不能包含任何标点符号和空格完成更新后重新为 OPPO 渠道发起应用发布。上架合规注意事项应用上架至应用市场时市场会根据 APP 的行业分类以及所涉及的具体功能和服务要求 APP 提供者提交相应的资质、许可、备案、授权等文件docs/tutorial/app-market.md。开发者应重点关注将应用提交到应用市场之前先查阅相应应用市场的 APP 审核规则特别是与行业资质相关的审核要求检查 APP 涉及的所有功能和服务包括集成的第三方服务判断所需的经营许可并提前准备相关文件登录应用市场官方平台查看审核规则变更、审核通知等并根据应用市场要求及时提交相关文件。不同渠道的审核规范存在差异例如华为要求手动配置内容分级、OPPO 对一句话简介有字符数限制、小米要求手动补充备案与资质信息等这些细节正是「uni 多商店上传」需要搭配各开放平台人工操作的原因。建议在正式提交前按渠道逐一核对本文所列的填写规范与 FAQ 中的失败场景可显著降低被驳回的概率。相关文档速查uni 多商店上传简介应用首次上架使用教程应用更新发布使用教程API 传包相关参数获取说明常见问题应用市场上架注意事项manifest.json 配置说明含 channel_list赞分享示例工程前端移动开发跨平台【免费下载链接】uni-appA cross-platform framework using Vue.js项目地址https://gitcode.com/gh_mirrors/un/uni-app点击查看免费下载相关推荐uni-app打包发布终极指南10个步骤完成多端应用商店上架uni app打包发布终极指南10个步骤完成多端应用商店上架 uni app作为一款使用Vue.js的跨平台框架能够帮助开发者快速构建多端应用并发布到各大应示例工程前端移动开发跨平台终极指南如何使用MAA明日方舟自动化助手一键解放双手终极指南如何使用MAA明日方舟自动化助手一键解放双手 还在为《明日方舟》中繁琐的日常任务而烦恼吗MAA明日方舟自动化助手正是你的救星这款基于图像识别技术的计算机视觉GUI自动化RPAuni-app uni多商店上传发布失败排查华为与 OPPO 渠道常见错误码与解决指南uni app uni多商店上传发布失败排查华为与 OPPO 渠道常见错误码与解决指南 本文基于 uni app 仓库内 docs/uni publish/f示例工程前端移动开发跨平台创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考