UniTypecho 安装使用全攻略

毕竟自己开的项目还是要自己填填文档的坑的,于是简单做了这样一份 UniTypecho 的使用攻略,希望能帮到对这个小程序有兴趣的人

UniTypecho 是一个可以将你的 Typecho 博客打包为微信小程序 / QQ 小程序 / 移动 H5/Android 应用等等的跨平台应用,GitHub 项目地址在 这里

那么我们开始吧ww

0. 准备工作

启用这个项目需要您已经有一个搭好了的 Typecho 博客站点,并建议开启静态化。

微信官方规定必须满足以下两个条件才能上线小程序:

  1. 域名已备案
  2. 域名开启 Https

如您符合上述条件,则需下载 微信开发者工具 及 HbuilderX

1. 小程序后台设置

首先在 微信公众平台 注册小程序(其他平台同理);

在小程序后台中 开发 - 开发设置 中取得 APPID 与 APPSecret;

在 服务器域名 中添加如下合法域名:

注:理论上图床和图片地址不需要,只需要接口和域名即可,但我懒得改了。

2. 插件设置

下载 UniTypecho,如果可以的话还请顺手点个 star,开发不易,炖翠翠出气;

将项目目录下的 UniTypecho-Plugin 文件夹上传至 Typecho 目录 /usr/plugins 目录下,并 ** 重命名 ** 为 UniTypecho,** 注意大小写,否则可能不能使用 **;

进入 Typecho 后台插件管理 控制台 -> 插件,启用 UniTypecho 插件,然后进入设置,配置 API 密钥、APPID、APPSecret 等:

注 1:API 密钥,由你自己设置,用于防止恶意请求。需要与小程序代码端的设置一致,否则将无法访问,这个后面会提到。
注 2:关于页面的 cid:需要关于页面为独立页面,查看独立页面的 cid 可在编辑对应页面的 url 中看到。

校验:尝试访问域名 域名 /uniapi/getconfig?apisec=API 密钥,若访问成功,则插件端设置正常。

注:若未开启静态化并出现错误,则将 域名 替换为 域名 /index.php 进行尝试。

3. 小程序设置

打开 HbuilderX,文件 - 导入 - 从本地目录导入 ,选择将上一步下载项目目录下的 UniTypecho 文件夹;

复制目录中的 manifest.json.example 为 manifest.json,配置其中的相关配置;

复制目录中的 static/config.js.example 为 static/config.js,并进行配置:

4. 调试与打包

调试:运行 - 运行到小程序模拟器 - 微信开发者工具 ,如果运行顺利,会自动打开微信小程序开发工具并打开项目;若未打开项目,项目目录为 目录 /unpackage/dev

打包:发行 - 小程序 - 微信 ,如果运行顺利,会自动打开微信小程序开发工具并打开项目;若未打开项目,项目目录为 目录 /unpackage/build,测试完成后即可上传发布审核。

其他平台流程类似,可参见 uniapp 发布(uniapp.dcloud.io/quickstart?... e5%8f%91% e5% b8%83uni-app)

5. 头图的使用

在希望自定义头图的文章中添加自定义字段 thumb,指向图片的 URL。

进阶:微信订阅

  1. 微信小程序后台 功能 - 订阅消息 ,添加 留言回复通知
  2. 将添加成功后的模板 ID 填入插件后台中

注意事项

QQ 小程序由于存在问题,导致图标无法正常显示

解决方案:对项目进行调试、打包,并复制 /unpackage/dist/dev/mp-qq/common 替换掉 /unpackage/dist/build/mp-qq/common

相关推荐
阿砾1 天前
微信群消息处理:回调乱序、自己发的消息、群内真实发送者
微信
承渊政道1 天前
飞牛NAS部署Hermes AI Agent:接入DeepSeek、微信与公网访问完整教程
人工智能·微信·nas·deepseek·hermes
高晶2 天前
微信小程序实战:iOS 降级查询工具从零开发
微信·程序员
软擎3 天前
花店节日布置怎么留记录?用轻虾导出助手把花材替换、现场尺寸与撤场清点钉在一起
微信
jaysee-sjc3 天前
【苍穹外卖】Day12:工作台数据看板与 Excel 报表导出
java·开发语言·数据库·spring boot·spring·微信·excel
极客互动API4 天前
【极客互动】企业微信外部群聊机器人开发实战与效果验证
微信·机器人·企业微信·企微scrm·企业微信api·企微外部联系人
特视界说5 天前
多规格产品动画怎么规划?把“一个型号一条片”改成可管理的内容架构
人工智能·安全·微信·新浪微博
悟空码字6 天前
视频号直播变了
微信·视频号
随性而行3607 天前
企业微信 Webhook 接收不到消息?网络连通性、URL 签名验签与 API 返回错误码排查指南
java·网络·人工智能·后端·微信·企业微信
未秃头的程序猿8 天前
同一个商户号,V2 免密代扣和 V3 分账的证书怎么共存?
java·后端·微信