2020.03.18 | 网站相关 | 6799 浏览 | 38 赞 | 33 条评论


请注意,本文编写于 465 天前,最后修改于 449 天前,其中某些信息可能已经过时。

毕竟自己开的项目还是要自己填填文档的坑的,于是简单做了这样一份 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://idealclover.top/archives/613/

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

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

38

已有 33 条评论


  1. 张必过
    张必过 回复

    翠哥,插件启用后提示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

  2. 瞎折腾
    瞎折腾 回复

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

    1. 羊驼哥
      羊驼哥 回复

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

      1. 瞎折腾
        瞎折腾 回复

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

  3. Nover
    Nover 回复

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

  4. 会说话的小猪是佩奇

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

  5. ZR
    ZR 回复

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

  6. Vergil
    Vergil 回复

    作者你好,下午网上冲浪有幸看到这篇赶紧体验了一下,首先感谢开源!有两个样式小问题想反馈一下,一个是文章内markdown解析后无论是xxx还是java xxx 这些代码格式解析出来的样式,每一行的边距略高,多行显示会覆盖上下行的文字,这可能跟我设备屏幕分辨率适配有关,在我这里看您那边的存在同样问题,找了一下是.wxParse .code里面padding为16rpx,我直接改0px好了。另一个就是关于页面下方的footer与下方navbar有一定的重合盖住了(屏幕越长影响越严重),把inputBlur: function inputBlur(e) {里this.tempMargin = "40";改50我设备就ok,也是屏幕适配问题,不太懂前端对样式自适应这些不知道我这样处理是否得当

    1. Vergil
      Vergil 回复

      😅评论也markdown解析了。。。那两个红字就是代码格式

  7. Vergil
    Vergil 回复

    刘明支持

  8. 小白
    小白 回复

    博主的第一个条件就把我拦住了。。域名需要备案。 ̄﹃ ̄

  9. シ假的太真灬
    シ假的太真灬 回复

    支持😘😚😗😙

  10. 阿白
    阿白 回复

    牛逼

🤔关于我
翠翠 idealclover
Product Manager @ByteDance
南京大学 2016 级本科生
了解更多
🏠关于博客
基于 Typecho 博客框架
使用个人的 clover clover 主题
😷疫情地图
💾博客小程序
博客小程序
💸支持我