2020.03.18 | 网站相关 | 35663 浏览 | 47 赞 | 41 条评论


请注意,本文编写于 1724 天前,最后修改于 1708 天前,其中某些信息可能已经过时。
AI摘要:UniTypecho是一个可以将Typecho博客打包为微信小程序、QQ小程序、移动H5/Android应用等跨平台应用的工具。使用前需准备好Typecho博客站点,并满足微信小程序上线条件。安装过程中需在小程序后台设置合法域名、APPID和APPSecret,并在Typecho插件设置中配置相关信息。之后在HbuilderX中导入UniTypecho项目,配置相关设置并进行调试和打包。UniTypecho还支持自定义头图和微信订阅消息功能。

Powered by AISummary and MoonShot KimiChat.

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

UniTypecho 是一个可以将你的 Typecho 博客打包为微信小程序 / QQ 小程序 / 移动 H5/Android 应用等等的跨平台应用,GitHub 项目地址在 这里,可扫描二维码进入我的博客进行预览:

如安装过程中产生问题可以加入 QQ 群 1059333269 详细咨询沟通。

那么我们开始吧ww

0. 准备工作

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

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

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

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

1. 小程序后台设置

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

在小程序后台中 开发 - 开发设置 中取得 APPIDAPPSecret

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

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

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.examplemanifest.json,配置其中的相关配置;

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

4. 调试与打包

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

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

其他平台流程类似,可参见 uniapp 发布

5. 头图的使用

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

进阶:微信订阅

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

注意事项

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

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

本文链接:https://www.idealclover.top/archives/613/

本作品由 idealclover 采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可,转载请注明出处。

标签: 博客, 文章, 微信, 设置, 服务器, 静态, usr, 域名, 文件, 平台, 公众, 模板, json, 安装, 工具, 页面, 消息, 图片, 目录, 程序, unitypecho

47

已有 41 条评论


  1. 如默
    如默 回复

    大佬,typecho1.2版本用不了,能更新嘛

  2. zimo
    zimo 回复

    跟着大佬做,在校验这一步就出错了,提示 Call to undefined method TypechoResponse::throwJson()

    1. 1
      1 回复

      打开Action.php,第553行,res改成response

  3. ༺浩瀚~向未来༻
    ༺浩瀚~向未来༻ 回复

    博主你好,Typecho1.2版本,API secret error,是不是要更新了?

  4. life97
    life97 回复

    最新1.2版本的typecho适用吗?

    1. life97
      life97 回复

      1.2 版本出错:{"status":200,"data":"API secret error"}

  5. XJ
    XJ 回复

    大佬号,在使用SQLite的Typecho程序开启会出现SQLSTATE[HY000]: General error: 1 near "SHOW": syntax error的问题,这个在WeTypecho也会出现这个问题,希望能修复一下→_→

  6. 张必过
    张必过 回复

    翠哥,插件启用后提示Fatal error: Allowed memory size of 267386880 bytes exhausted (tried to allocate 24576 bytes) in /www/wwwroot/www.88.ml/var/Typecho/Db/Adapter/Pdo.php on line 102

  7. 瞎折腾
    瞎折腾 回复

    大佬,微信开发工具出现app.json未找到嗯么解决啊

    1. 羊驼哥
      羊驼哥 回复

      同样遇到了这个问题
      大佬你解决了吗?

      1. 瞎折腾
        瞎折腾 回复

        这是没有编译,用hbuildx编译就行了,不知道是不是我没写文章的缘故,就一个安装过后的文章,小程序啥都不显示

  8. Nover
    Nover 回复

    博主你好,请问我折腾好了之后,小程序不显示图片啊, 题图和文章里面的图片都没有显示。反盗链关了也没有用。

  9. 会说话的小猪是佩奇

     ̄﹃ ̄ 跟着做了好大一会 硬是不能运行最后才现github分享的源码里没得unpackage这个文件

  10. ZR
    ZR 回复

    订阅消息那填了模板id,但是除了弹窗,作者回复之后,微信不会通知,这是为什么🙏

🤔关于我
翠翠 idealclover
Product Manager @ByteDance
南京大学 2016 级本科生
了解更多
🏠关于博客
基于 Typecho 博客框架
使用个人的 clover clover 主题