小程序管理
最后更新时间：2025-11-13 15:36:19
小程序列表
功能目的
小程序开发者可以创建小程序项目，平台同时也会提供新版 IDE 下载地址。
具体功能操作
创建小程序：权限持有者可直接创建小程序，并且该类代码资源归属用户所在团队。
筛选：可在顶部筛选框选择所属团队来进一步筛选小程序列表。
编辑：权限持有者可修改小程序基本的说明信息。
上架/下架：变更小程序的上架中和已下架状态，小程序下架后，在 superapp 上将无法获取对应服务，也无法发布新版本，但仍可提交版本审核。
详情：权限持有者可查看小程序的 appid（非常重要，请妥善保管此 ID 信息），以及下载新版的 IDE 工具。
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 | 小程序运营人员 | 小程序发布审核人员 |
小程序列表 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
创建、修改、下架、删除小程序 | 只读 | 只读 | ✓ | ✓ | - | - | - |
超级管理员/平台管理员：拥有小程序列表模块的只读权限，不能创建、修改、下架、删除小程序。
小程序团队管理员/小程序高级开发者：拥有小程序列表模块的权限，拥有创建、修改、下架、删除小程序的权限。
小程序开发者/小程序运营人员/小程序发布审核人员：拥有小程序列表模块的查看权限。
版本管理
功能目的
小程序开发者可以控制每个小程序的版本发版，此处发版会对该小程序绑定的 superapp 生效，请业务人员注意。
具体功能操作
创建小程序：权限持有者可直接创建小程序，并且该类代码资源归属用户所在团队。
筛选：可在顶部筛选框选择所属团队来进一步筛选小程序列表。
版本概览：展示当前小程序的线上版本、版本审核进度、开发版本信息。
审核记录：展示当前小程序过往版本发版的审核记录。
发布上线：当审核流程结束时，可由权限持有者发版。
版本回退：将小程序线上版本回滚至此前已经发布过的历史版本，不支持连续回滚。
新增版本：利用代码包形式，将 IDE 工具打包得出的文件上传于此，用于新版本发布。
提交版本审核：将当前开发版本提交至 superapp 管理员审核。
配置体验版：配置小程序打开页面，采用相对地址配置。
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 | 小程序运营人员 | 小程序发布审核人员 |
提交小程序代码/代码包 | 只读 | 只读 | ✓ | ✓ | ✓ | - | - |
提交版本审核 | 只读 | 只读 | ✓ | ✓ | - | - | ✓ |
小程序体验 | 只读 | 只读 | ✓ | ✓ | ✓ | ✓ | ✓ |
灰度发布 | 只读 | 只读 | ✓ | ✓ | - | - | - |
小程序发布 | 只读 | 只读 | ✓ | ✓ | - | - | ✓ |
删除开发版本 | - | - | ✓ | ✓ | ✓ | - | - |
超级管理员/平台管理员：拥有版本管理模块的只读权限，不能删除开发版本。
小程序团队管理员/小程序高级开发者：拥有版本管理模块的权限，拥有提交小程序代码/代码包、提交版本审核、小程序体验、灰度发布、小程序发布、删除开发版本的权限。
小程序开发者：拥有版本管理模块的权限，拥有提交小程序代码/代码包、小程序体验、删除开发版本的权限。
小程序运营人员：拥有版本管理模块的权限，拥有小程序体验的权限。
小程序发布审核人员：拥有版本管理模块的权限，拥有提交版本审核、小程序体验、小程序发布的权限。
灰度发布
开发者可以在小程序新版本正式上线前，面向部分用户灰度发布小程序。进入控制台，在版本管理 > 灰度发布 中，单击新建灰度任务即可开始灰度发布流程。
灰度任务设置
灰度版本：灰度发布是小程序版本发布上线的一种特殊形式，因此灰度发布的版本必须已通过小程序审核、暂未上线且版本号高于线上版本。
灰度任务名称：填写灰度任务名称以进行区分，不超过20个字。
灰度时间：选择灰度进行的开始和结束时间，灰度的结束时间不能早于确认创建的时间点。
灰度数量：设置灰度投放用户总量的限制。
灰度生效平台：从 Android 和 iOS 平台中进行选择，勾选后可以填写对应操作系统的始末版本号。
灰度对象：通过添加推送对象条件，将灰度版本投放给特定的用户集。当前支持 GUID、自定义设备标识、用户账号三种条件。开发者可以手动输入推送对象信息，也可以通过 txt 批量上传对象白名单。
联网方式：选择是否在特定网络环境下拉取灰度版本。
说明：
多个灰度条件之间取交集，达到其中一个条件限制后就不再投放灰度版本。
灰度任务管理
灰度发布页上，列表中多个灰度任务将按照创建时间从晚到早排序。每个灰度任务都有待投放、投放中、暂停中、已结束等状态，任务在多种状态间的流转方式如下图所示：
单击灰度进展可以查看当前灰度任务的投放情况。
说明：
当开发者将一个小程序版本正式发布上线时，同版本号或者更小版本号的灰度任务将会自动结束，所有用户升级到最新发布的版本。
开发管理
功能目的
为小程序开发者提供域名设置、敏感 API 权限申请、实时日志查询功能。
具体功能
域名设置
新增域名：小程序需要事先设置通讯域名，且小程序只可以跟指定的域名进行网络通信。包括普通 HTTPS 请求（wx.request）、上传文件（wx.uploadFile）、下载文件 (wx.downloadFile) 和 WebSocket 通信（wx.connectSocket），为便于开发者灵活配置小程序，平台支持小程序内嵌网页能力（业务域名）。
跳过域名校验
如果小程序的域名配置不便或者会频繁改动，开发者可以向 superapp 申请“跳过域名校验”，待 superapp 审批通过之后，小程序则无需在控制台配置域名，即可向小程序的服务器发起网络请求。
注意：
小程序需要遵守域名安全规范，服务请求不得包含任何恶意代码、病毒或其他可能危害用户设备或数据的内容。
接口权限
当小程序绑定的 superapp 设置了敏感 API 后，小程序开发者需要向 superapp 申请调用敏感 API 的权限，在 superapp 的管理者或审核权限拥有者审批通过后，小程序才可以正常调用这些敏感 API。
操作：
申请开通：小程序开发者向 superapp 管理者或审核人员申请敏感 API 使用权限。
实时日志
查询条件：查询条件包括 时间、日志等级维度（全部、info 及以上、warn 及以上、error 及以上）、系统类型、GUID、页面链接、filterMsg 内容、基础库版本、客户端版本。
基础配置
AppSecret
AppSecret（小程序密钥）是小程序登录、支付等重要流程中鉴权所需，密钥管理仅小程序团队管理员有权限查看和操作，可在密钥管理处生成、重置、冻结密钥。
操作：
生成
点击“生成”后，小程序团队管理员需要将密钥复制后妥善保存，复制后关闭弹窗则无法再次复制，如果忘记密钥，需要进行重置，平台不会以明文的方式展示或保存密钥。
重置
小程序团队管理员可重置密钥，确认“重置” AppSecret 后，使用原 AppSecret 的小程序功能将无法使用，请及时更新。
冻结
为了保障小程序的业务安全，在小程序密钥泄露或疑似泄露且密钥还未替换前，开发者有必要对小程序密钥进行冻结操作，避免造成安全事故。
小程序团队管理员可点击“冻结”，将密钥进行冻结，冻结后，使用原 AppSecret 的小程序功能将无法正常使用，请及时更新。
OpenServer
OpenServer 时开发者在接入登录、支付和订阅消息等功能时需要访问公共服务域名。
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 |
域名设置 | 只读 | 只读 | ✓ | ✓ | - |
接口权限（敏感API）申请 | 只读 | 只读 | ✓ | ✓ | - |
实时日志 | 只读 | 只读 | ✓ | ✓ | ✓ |
密钥管理 | 只读 | 只读 | ✓ | - | - |
超级管理员/平台管理员：拥有开发管理模块的只读权限。
小程序团队管理员：拥有开发管理模块的权限，拥有域名设置、接口权限（敏感API）申请、查看实时日志、密钥管理的权限。
小程序高级开发者：拥有开发管理模块的权限，拥有域名设置、接口权限（敏感API）申请、查看实时日志的权限。
小程序开发者：拥有开发管理模块的权限，拥有查看实时日志的权限。
订阅消息
前言
消息能力是小程序能力中的重要组成，superapp 通过为小程序开发者提供订阅消息能力，以便实现小程序内的服务闭环，通过消息订阅和通知的能力，及时将小程序内的业务状态变化推送给 superapp 的用户。在使用订阅消息功能时，小程序开发者需要在控制台-小程序管理-订阅消息，从公共模板库中选择适用的消息模板，配置推送的字段后，添加为“我的模板”。
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 |
我的模块-查看 | 只读 | 只读 | ✓ | ✓ | ✓ |
我的模块-删除 | - | - | ✓ | ✓ | - |
公共模板库-查看 | 只读 | 只读 | ✓ | ✓ | ✓ |
公共模板库-选用 | - | - | ✓ | ✓ | - |
超级管理员/平台管理员/小程序开发者：拥有订阅消息模块的只读权限，拥有我的模块、公共模板库的查看权限。
小程序团队管理员/小程序高级开发者：拥有订阅消息模块的权限，拥有我的模块的查看、删除权限，公共模板库的查看、选用权限。
小程序开发者：拥有订阅消息模块的权限，拥有我的模块、公共模板库的查看权限。
控制台操作
公共模板库
开发者可在公共模板库中，根据业务场景选择需要用到的模板类型，通过模板名称搜索适用的模板。
消息类型说明
一次性订阅
一次性订阅消息用于解决用户使用小程序后，后续服务环节的通知问题。
开发者在小程序中调用 requestSubscribeMessage 接口后，将向用户展示弹窗，用户可打开自己想要接收的消息开关。用户订阅后，开发者可不限时间地下发一条对应的服务消息。
长期订阅
通常情况下，一次性订阅消息已经可满足小程序的大部分服务场景需求，但线下公共服务领域存在一次性订阅无法满足的场景，如航班延误，需根据航班实时动态来多次发送消息提醒。为便于服务，我们提供了长期性订阅消息，用户订阅一次后，开发者可长期下发多条消息。长期性订阅消息适用于政务、民生、医疗、交通、金融、教育等线下公共服务。
注意：
使用长期订阅消息可以多次给用户发送消息，但是频繁发送消息可能会对用户造成困扰，因此，平台限制了每个长期订阅模板消息每日最多推送 5 次。
选用模板
在公共模板库中，找到目标模板，单击“选择”，进入模板配置页面。每个公共模板下会有多个关键词，开发者可从关键词列表中选择 1 到 5 个关键词，最终在 superapp 上给用户展示的弹窗内容请参考左侧预览效果，在已选择列表中拖拽右侧的排序按钮可进行关键词顺序排列。
配置完成后，单击提交，即可将模板配置保存至“我的模板”中。
说明：
使用同一个公共模板添加为“我的模板”时，关键词不可与已添加的“个人模板”重复。
我的模板
从公共模板库中选择并完成配置的模板会添加到“我的模板”列表中，开发者可使用“我的模板”中的消息模板来完成订阅消息功能开发。
开发注意事项
一次性模板 ID 和长期订阅模板 ID 不可同时使用。
一次调用最多可订阅 3 条消息。
用户发生点击行为后，才可以调起订阅消息界面。
一次授权调用里，每个 tmplId 对应的模板标题不能存在相同的，若出现相同的，只保留一个。
隐私协议
在设置中配置用户隐私保护协议，使用产品提供的模板，填写小程序收集的个人隐私数据，保存后，可生成小程序的用户隐私保护协议。
1. 点击开始配置。
2. 填写隐私信息。
保存后，用户隐私保护协议可在更多-小程序详情中，查看已生成的协议内容。
离线小程序
功能说明
离线小程序是内置在 superapp 内的小程序，需要将小程序包从控制台下载下来，导入到 superapp 工程中，跟随 superapp 一起打包。在 superapp 使用过程中，用户打开某个内置的小程序，无需从后端拉取下载，即使在没有网络连接的情况下也能打开并运行的小程序。
具体功能操作
1. 从控制台下载需要预置的小程序。
2. 将下载的小程序包拷贝到自定义的 assets 目录，离线小程序需严格遵守命名规则，不能随意修改。
说明：
离线小程序命名规则：{miniAppId}_{miniAppVersion}.apkg
3. 在 SDK 初始化配置中指定上一步放置离线小程序的 asset 目录。
注意事项
离线小程序也需要走正常的小程序发布审批流程，只有上线状态的小程序才可下载离线包。
离线小程序适用新版发布、版本回退、下架等版本管理逻辑，当线上版本与预置版本不一致时，客户端会正常拉取线上版本。
当小程序被下架后，预置在 superapp 中的对应离线小程序也无法正常使用。
文档反馈