快速开始

本页串起从注册应用到发布版本的操作顺序。首次接入按步骤阅读；已有应用可从配置或构建步骤开始。

接入前确认

准备一个 UUMS 账号、应用的业务需求，以及用于联调的构建工具和 Android/iOS 宿主版本。

首次新应用： draft 阶段上传包并选为体验版后，有效项目成员和体验成员即可在宿主搜索、运行并登录体验版，无需先正式发布或激活。首包上传前仍可通过可信工具与宿主进行本地调试。体验完成后的首版审核、发布与激活顺序见首次激活。

入口	用途
开发者中心	注册、应用配置、成员、版本和发布
https://miniapp-api.metaeco.top	Test API Origin，供应用后端调用
构建工具	创建或导入项目，生成 .cmpkg
环境与兼容	确认当前方法支持、分发材料和环境条件

文档域名只用于阅读。后文的 APP_ID 使用控制台分配值；PLATFORM_ORIGIN 使用本应用对应的 API 入口。AppSecret、接口 token 和 session_key 只保存在业务后端。

准备应用

1. 登录开发者中心，提交入驻申请和主体证明材料。
2. 主体核验通过后，打开应用并记录 AppID。
3. 添加项目成员，为前端、后端和发布人员分配相应角色。

完成结果： 能在开发者中心看到目标应用，并有权执行下一步配置。具体表单与材料要求见注册与成员。

提交主体证明材料

新应用选择“申请新应用”；已有应用缺少主体关联时选择“现有应用补主体”，保留原 AppID。按材料上传步骤完成上传、核对和提交。

配置应用

1. 在“配置与应用密钥”填写请求域名和图片资源域名。
2. 应用管理员生成 AppSecret，保存到业务后端的受保护配置。
3. 根据真实业务提交个人信息处理声明。

完成结果： 业务域名已保存，后端持有 AppSecret，声明进入审核流程。draft 应用可为有效本地调试登录码兑换会话；普通版本的业务登录和接口 token 仍要求 active。状态异常时按应用状态说明处理。

继续阅读配置与凭据和隐私与功能。

开发并构建

1. 新项目运行第一个小程序；已有项目按构建工具选择导入方式。
2. 将项目 AppID、版本、页面入口和实际权限与控制台应用对应。
3. 预览页面后生成 .cmpkg，保存输出文件与摘要。

完成结果： 得到可上传的运行包。浏览器预览用于检查渲染；接入本地调试上下文的可信工具与宿主可在上传前联调登录，普通版本及设备功能仍须在相应宿主中验证。

准备业务服务

1. 小程序调用 wx.login 取得一次性 code，发送到自己的业务登录接口。
2. 业务后端调用 /sns/jscode2session 换取 openid 和 session_key。
3. 后端签发自己的业务登录态，只将业务结果返回小程序。

完成结果： 小程序与业务后端完成登录，服务端凭据没有进入 JS。可直接参考登录代码示例。

按需继续接入手机号、隐私与原生功能或余额支付。不使用这些功能时无需增加对应配置。

在测试版本联调

1. 在开发者中心创建与包一致的版本，上传 .cmpkg。
2. 选择体验版本。应用管理员和项目成员具有体验资格；其他账号先添加为体验成员。
3. 使用对应账号在宿主进入 trial 体验版，验证页面、登录和实际使用的功能。
4. 记录应用、版本、操作时间和失败请求 ID；按错误诊断处理问题。

完成结果： 体验成员可以进入指定版本，关键业务在实际宿主中得到确认。操作入口及发布条件见体验、审核与发布。

审核并发布

体验测试完成后提交版本审核。个人信息处理声明和版本均须通过独立审核；平台自动签名成功后，由有发布权限的成员重新认证并发布。

完成结果： 控制台显示新的正式基线；重新进入应用时运行该版本。应用停用时先完成整改与恢复。

本轮接入完成条件

检查项	应达到的结果
项目与制品	AppID、版本、入口及权限一致，生成有效 .cmpkg
配置与登录	业务域名生效；真实 code 可兑换；JS 只收到业务登录态
按需功能	手机号、定位、相册或支付的允许、拒绝与失败分支符合业务预期
版本发布	审核、签名、正式基线和实际运行版本一致

常见问题

问题	处理
看不到应用或操作按钮	检查当前账号是否为应用成员，角色是否允许该操作
页面能预览，登录失败	使用宿主体验版取得真实 code；检查应用状态与 AppSecret
上传包被拒绝	核对 AppID、版本、包格式与错误指出的字段
不能提交或发布	核对隐私声明、审核和签名状态，按页面缺项处理

查具体参数时使用API 参考；查工具、SDK 和环境限制时使用环境与兼容。