小程序上手教程一步一步,
一步一步,
做出自己的微信小程序。
已有服务号绑定的租户,可以从第一步继续。每步都说明去哪里、做什么、怎样才算完成;已有工程和连接的部分无需重做。
准备账号和各自的凭证。
- 在 微信公众平台注册自己的小程序,已有账号直接登录;按目标小程序的开发管理 / 开发设置页面,取得 AppID 和 AppSecret。
- 保留当前已绑定万相的服务号。在 万相开发中心 → 开发秘钥创建或选择有相应运营和 XApp 开发权限的密钥,下载 TXT,用于连接开发器。
- 小程序 AppSecret 只由管理员填入万相运营中心;开发密钥供 WorkBuddy 工具使用。两者都不能写入小程序前端代码,短信验证码和运行令牌也不能写进日志。
服务号与小程序是两个微信应用。已绑定服务号不代表已有小程序账号;WorkBuddy 临时试用版不能替代本接入所需的自有小程序凭证。微信当前页面、主体要求和资质以官方提示为准。
先登记你的小程序。
- 打开 运营中心的微信小程序列表,选择已经接入万相的服务号,点击「添加已有小程序」。
- 在「登记凭证」填写名称、AppID 和 AppSecret,点击「验证并登记」。确保这份凭证来自要开发的那个小程序。
- 可以先登记,再继续配置域名和绑定应用;登记完成不代表运行能力已经启用。
把实际用到的域名放行。
- 查看万相向导的「放行域名」,在微信小程序后台找到服务器域名设置。
- 把向导显示的 API 地址加入
request合法域名;生产环境通常为https://x.wanxiangdashi.com。 - 如果使用文件、图片或资料下载,把向导显示的实际下载域名加入
downloadFile。不要猜测 OSS 域名,也不要只放行官网www域名。 - 微信接口要求配置 IP 白名单时,再按向导显示的服务器出口 IP 填写。完成后保存,并在关闭「不校验合法域名」调试选项的情况下验证。
域名放行只允许发起网络请求,不会额外授予数据或私有文件访问权。运行时仍检查当前账号、应用和具体资源的权限。
选择要共用哪一个 XApp 的业务。
- 选择同一服务号下,或同租户尚未挂载且你有权管理的已发布 XApp。没有合适应用时,先按 XApp 教程准备并发布,再回到向导。
- 按需开启逻辑数据、文本智能体、商品与会员、私有文件等能力,启用并保存。
- 确认列表里的 AppID、服务号、绑定 XApp 和启用状态正确。当前保留一个 XApp 对应一个小程序的约束。
绑定的意思是共用业务账号和资源,不是复制 XApp 页面。小程序需要自己的原生前端;普通服务号原有登录可以继续使用,不要求所有服务号补齐 UnionID。
让开发器核对工程,再写页面。
- 在 开发中心 → 微信小程序获取「万相大师微信小程序开发器」ZIP。在 WorkBuddy「专家·技能·连接器 → 技能 → 添加技能 → 上传技能」导入,具体按钮以客户端当前界面为准。
- 把本人开发密钥 TXT 拖入 WorkBuddy,说明「请连接这个万相开发密钥,再继续我的小程序需求」。已有有效万相连接时可复用。固定脚本需要 Node.js 18 或以上,不需要用户另外安装 Python 或 npm 依赖。
- 说明是微信原生小程序,提供目标 AppID 或已有工程。开发器读取
project.config.json,查询真实服务号、XApp、能力和源码版本;有多个项目时先明确选哪一个。 - 让宿主读取最新 SDK 和 XAUI 原生样式模板,接入微信登录、首次手机号关联和已开启业务能力;不能把开发密钥或 AppSecret 放进页面。
请使用万相大师微信小程序开发器,开发一个预约报名小程序。 先核对我选择的工程 AppID、实际绑定 XApp、已启用能力和逻辑表权限。 如果准备不齐,请告诉我具体去哪里补齐,不要假称已经连接成功。 页面包含服务介绍、预约表单和我的预约;使用万相原生 SDK 与 XAUI 样式。 用户主动使用业务功能时登录,首次通过本人万相账号的手机号验证码关联。 业务数据使用绑定 XApp 的逻辑表,不能用本地存储代替数据库。 先给出页面、字段和权限方案,确认后再修改工程或保存云端源码。
MCP 和开发密钥服务于开发阶段;小程序 SDK 使用业务运行会话。指南和工具说明可以从服务器独立更新,更新工程 SDK 前应保留并核对已有修改。
保存源码,再固定准备发布的那一份。
- 确认本次工程目录与上传范围,用开发器保存源码。代码快照进入小程序独立私有工作空间,不覆盖绑定 XApp 的网页代码。
- 核对返回的源码版本、摘要和字节数。保存冲突时先将云端版本拉取到新目录比较,不能直接覆盖别人的改动;网络结果不明时先查历史。
- 准备发布时,明确源码版本与微信版本号,让开发器固定并导出到一个新目录。导出结果必须与这份固定记录一致。
本机是开发工程,万相私有 OSS 保存源码历史,微信保存并分发上传后的编译运行包。保存源码和固定版本都不等于上传微信。不要把密钥、客户私密数据或无关文件放进工程。
真机体验后,再上传、提审和发布。
- 在已登录的微信开发者工具打开导出目录,核对 AppID 与版本号;关闭「不校验合法域名」调试选项,检查页面、登录、权限、数据、智能体和文件下载。
- 首次使用万相能力时,用本人已注册万相账号的手机号完成验证码关联。随后检查同一账号的数据与会员权益,以及无权访问时的提示。
- 确认上传后,可使用微信开发者工具或本机已授权的官方 CLI。若使用 WorkBuddy 的分享面板,按其官方流程绑定自有小程序账号,并另外核对万相接入所需域名。
- 到微信后台「版本管理」完成体验、提审和正式发布。类目、备案、认证、隐私指引及行业要求以微信后台提示为准;分别核对源码已保存、已固定、微信已上传、已提审、已发布。
按真实能力交付,不跳过失败状态。
- 至少核验:首次手机号关联、后续登录、空数据、权限不足、重复点击、分页、断网、写入结果不明和离开页面后的任务清理。
- 当前支持账号、逻辑表记录、文本智能体、商品与会员查询、授权文件下载;原生支付、运行态文件上传和多媒体智能体尚未接通。
- 退出仅结束本地运行会话,页面需要清除私有数据显示;它不会自动解绑微信身份或撤销已经执行的写入。
- 业务凭证或绑定发生变化时重新核对接入;升级指南和 SDK 后,仍需检查现有工程与微信体验版。费用按万相套餐及微信等提供方的实际规则处理。
