扫码体验
Skip to content

在线体验

uni-halo 小程序版本演示

小莫唐尼官方交流群(QQ)

发布小程序 ​

该内容会引导您发布和部署微信小程序。

1. 配置服务器域名 ​

在 微信小程序后台,找到菜单 管理 - 开发管理 - 开发设置 - 服务器域名,分别在 request合法域名、uploadFile合法域名、downloadFile合法域名 中填写你的 Halo 站点域名(必须是 https),点击 保存并提交 即可。

2. 确认正式环境地址 ​

发布前检查 env/.env(或 env/.env.production)中的微信正式版地址:

ini
VITE_SERVER_BASEURL__WEIXIN_RELEASE = 'https://你的域名'

同时确认 VITE_WX_APPID 为你自己的小程序 AppID。

3. 构建生产版本 ​

bash
pnpm build:mp

构建完成后会自动打开微信开发者工具并加载 dist/build/mp-weixin 产物。

4. 预览 ​

在微信开发者工具中,点击上方的 预览 按钮,等待片刻就可以使用微信扫码预览。

5. 上传代码 ​

预览没有问题后,在微信开发者工具中点击右上角的 上传 按钮,填写 版本号 和 项目备注,最后点击 提交 按钮,等待上传成功提示。

命令行上传(可选)

项目内置了 miniprogram-ci 上传脚本,可在 CI 中使用:

bash
pnpm upload:mp

使用前需在微信小程序后台获取上传密钥并配置 IP 白名单。

6. 体验版 ​

上传成功后,打开 微信管理后台,找到菜单 管理 - 版本管理 - 开发版本,点击 体验版 按钮生成体验二维码,扫码即可体验。

7. 提交审核 ​

在微信小程序后台 管理 - 版本管理 - 开发版本 中,点击 提交审核,填写审核信息后提交。

7.1 个人资质用户的提交建议 ​

为什么有这一节

如 部署须知 中所述,uni-halo 属于博客/资讯内容类小程序,而个人主体无法选择资讯类目,直接提交会被判定为「类目与内容不符」而拒绝审核。以下建议的核心思路是:让提交的内容看起来符合个人主体可选的类目(如生活记录、个人分享),以提高首次审核通过率。这是规避审核被拒的参考做法,不是长期合规方案。

具体建议:

  1. 开启插件「审核模式」(推荐):在 Halo 后台插件控制台的**独立菜单「审核模式」**中开启,并挑选审核期间允许展示的文章、分类、图库、瞬间、友链数据,还可勾选需要隐藏的功能入口菜单。开启后小程序端仅展示挑选的内容,同时自动关闭登录、注册、评论与 AI 助手入口,无需逐一手动下架内容;审核通过后再关闭开关即可恢复完整内容。提交审核前开启即可,详见 插件配置 - 审核模式。
  2. 审核描述:将小程序描述写为个人类型内容,如「这里是我的个人日记小程序,用于记录个人的工作和生活。」
  3. 审核截图:不要截取社交功能(如评论区、用户互动)相关页面,截图聚焦文章详情、个人主页等与所选类目一致的内容。
  4. 临时下架分享性内容:提交审核前,将带推广/分享性质的文章设为不可见,保留个人日志类内容;审核通过后再恢复。若已开启审核模式,此条可省略——插件已代为过滤展示内容。

请注意

以上做法仅用于提高首次提交审核的通过率。审核通过后若持续发布资讯类内容,仍存在被平台下架或封禁的风险(详见 部署须知 - 重要提醒)。从根本上解决,请使用企业或个体工商户主体并开通对应类目。

8. 发布上线 ​

等待审核通过后,在 管理 - 版本管理 - 审核版本 中点击 发布 上线即可。

贡献者

The avatar of contributor named as 小莫唐尼 小莫唐尼

页面历史