构建小程序

DevDeck 可以构建微信小程序、生成真机预览码，并在你完成扫码授权后，于 DevDeck 内生成体验版、提交微信审核并正式发布。生产后端也会一并部署。

主路径不再要求你填写 AppID 或上传代码上传密钥。小程序管理员扫码授权后，DevDeck 会绑定该小程序，并代为配置 request 合法域名。

授权开发权限后，不能再在微信公众平台发版

扫码时请勾选小程序开发权限。授权完成后，体验版、提审和正式发布都在 DevDeck 中完成，微信公众平台将不再允许自行上传或发布版本。

开始之前

你需要准备：

• 一个已注册的微信小程序账号。
• 该小程序的管理员微信（只有管理员能完成扫码授权）。
• 根据主体和功能完成微信要求的认证、小程序备案及服务类目配置。

登录、支付等能力不在本页完成。授权后如需收款，请另外连接 微信支付。

第一步：创建项目

1. 在 DevDeck 首页选择小程序，描述要构建的微信小程序并创建项目。
2. 等待初始构建完成。
3. 先使用 H5 预览检查页面和基本交互。

登录、支付、摄像头等微信能力必须以真机测试为准，不能只依赖 H5 预览。

第二步：扫码授权

1. 在项目中打开预览 → 真机预览，或打开配置 → 发布中的微信上架区域。
2. 选择扫码授权。
3. 由小程序管理员用微信扫码，并勾选小程序开发权限。
4. 返回 DevDeck，确认授权状态变为已授权，并显示小程序名称或 AppID。

授权不完整时，请重新扫码并勾选开发权限。授权成功后：

• 小程序 AppID 会自动绑定到当前项目。
• DevDeck 会把 https://mp-api.rocksilicon.com 写入该小程序的 request 合法域名，一般无需再去微信公众平台手动添加。
• 只需填写上述 HTTPS 域名本身，不要附加项目 ID、/api 或其他路径。

第三步：真机预览

授权完成后，在预览 → 真机预览中可以：

• 生成预览版：用于短期真机检查。
• 生成体验版：把当前代码提交为体验版，便于更完整的真机验收。

请使用已加入该小程序的微信扫码。预览码有效时间较短，过期后重新生成即可。

第四步：在 DevDeck 中发布

完成修改并通过真机测试后：

1. 打开配置 → 发布。
2. 查看发布就绪检查，并处理所有阻塞项。
3. 选择发布项目，生成体验版并部署生产后端。
4. 如需确认结果，打开发布日志。

发布成功后，当前代码已成为该小程序的体验版，对应生产后端也已部署。此时尚未对全部微信用户上线。

提审前，DevDeck 可能要求你补齐：

• 小程序备案
• 可用服务类目
• 隐私保护指引（可在发布区填写联系方式、通知方式和接口用途）
• 昵称、头像或简介

备案、类目和账号资料仍需在微信公众平台完成；隐私保护指引可在 DevDeck 中配置。

第五步：提交审核并正式发布

体验版就绪且账号条件满足后，仍在 DevDeck 的发布区操作：

1. 选择提交审核，按提示确认。
2. 等待微信审核。审核中可以撤回审核。
3. 若被拒绝，按拒审原因修改项目，重新发布体验版后再提交。
4. 审核通过后，选择正式发布。

后续代码或后端变更，请再次从 DevDeck 发布并重新提审。只修改 DevDeck 项目不会自动更新微信线上版本。

登录与支付

扫码授权不等于已经接通登录或支付：

• 微信登录 会在授权成功后自动接通，无需再填写 AppSecret。
• 微信支付仍需在连接中填写普通商户凭证。详见 微信支付。

故障排查

授权后无法生成体验版或发布

确认扫码时勾选了小程序开发权限。授权不完整时，请断开后重新授权。

真机页面可以打开，但接口请求失败

授权成功后，request 合法域名应由 DevDeck 自动写入 https://mp-api.rocksilicon.com。若请求仍失败，打开发布区查看是否提示「服务器域名未就绪」，并选择重新检查。不要依赖微信开发者工具中的“忽略域名校验”判断正式版本是否可用。

无法提交审核

查看发布区的阻塞项：备案、类目、隐私保护指引或账号资料。补齐后选择重新检查。

预览码已失效

回到预览 → 真机预览重新生成。预览码失效不会删除已生成的体验版。

DevDeck 不允许发布

打开配置 → 发布查看就绪检查，等待正在运行的构建结束，并处理未完成的前端、后端或运行时配置。

备用路径：代码上传密钥

如果当前环境未启用开放平台扫码授权，DevDeck 仍可能要求你手动绑定 AppID 和代码上传密钥。这是兼容路径，不是推荐的主流程：

1. 在微信公众平台打开管理 → 开发管理 → 开发设置 → 小程序代码上传，下载代码上传私钥，并关闭 IP 白名单。
2. 在 DevDeck 的真机预览 → 配置我的小程序中填写 AppID 并上传私钥。
3. 自行在微信公众平台把 https://mp-api.rocksilicon.com 加到 request 合法域名。
4. DevDeck 此时只会上传开发版本并部署后端；体验版设置、提审和正式发布仍需前往微信公众平台完成。

该路径下的代码上传密钥具有预览和上传权限，请加密保存原始文件，不要通过聊天或公开链接分享。