微信小程序配置

巴克励步

概述

Baklib 支持将站点内容发布到微信小程序:可下载标准小程序包(含 uni-app 源码)快速上线,也可通过 API 在自有小程序中拉取站点内容渲染。
入口位于应用后台 小程序集成(路径:/settings/miniprogram),与 应用设置 同级菜单。本篇说明包下载、配置要点与发布流程。

操作步骤

步骤一:进入小程序集成

  1. 进入目标应用 后台管理
  2. 在左侧 管理 分组中点击 小程序集成(若菜单折叠,可能在应用设置附近)。
16-01-小程序配置.png
  1. 阅读页顶说明:通过微信小程序让访客更便捷访问站点内容。
  2. 可扫描 微信扫码体验示例 预览标准包效果(以页面二维码为准)。
预期结果:看到小程序包下载、API 接入说明与接入步骤指引。

步骤二:下载并配置小程序包

下载标准包
  1. 小程序包下载 区域点击 下载,获取最新版 Baklib 标准小程序包(含 uni-app 源码与配置示例)。
  2. 使用微信开发者工具导入项目。
修改配置
按页面指引修改以下文件(路径以下载包内为准):
文件 配置项 说明
src/config/app.config.ts siteUrl 填写当前站点对外可访问域名,如 https://site-xxxx.trial.baklib.site/
src/manifest.json mp-weixin.appid 填写微信小程序 AppID
  1. 保存后本地编译预览,确认能拉取站点首页与文章列表。
提示:若需深度定制 UI 或接入自有业务登录,可联系 Baklib 客服或使用下方 API 方案。
预期结果:开发者工具中可正常预览站点内容。

步骤三:配置合法域名并发布

服务器合法域名
在微信公众平台 → 开发 → 开发管理 → 开发设置中,将以下域名加入 request 合法域名 等配置:
  1. 当前站点域名(或站点实际公开访问的域名)。
  2. 页面内使用 iframe 时所涉及的外部域名。
发布上线
  1. 使用微信开发者工具上传代码。
  2. 登录微信公众平台提交审核并发布。
  3. 站点内容更新后,小程序端通常自动同步;若异常,检查 siteUrl 与缓存。
API 接入(可选)
若已有成型小程序,可点击 查看 API 文档,通过 Baklib API 拉取站点内容并在现有业务中渲染,无需使用标准包。
预期结果:审核通过后,用户可在微信中搜索或扫码进入小程序访问站点内容。

常见问题

Q:试用域名能用于正式小程序吗?
A:微信要求配置已备案且可公网访问的合法域名;正式上线请使用已绑定的自定义域名,见 域名管理
Q:Wiki 与 CMS 应用都支持吗?
A:标准包以当前应用发布的内容为准;Wiki 类需确认知识库内容已发布到该应用。
Q:小程序与 H5 前台数据是否一致?
A:同源拉取同一应用内容,应保持一致;访问控制策略(如授权访问)同样生效,见 访问控制与授权
Q:定制开发找谁?
A:页面提供 联系客服 入口;也可基于下载的 uni-app 源码自行二开。

相关阅读