逍遥橙子的Blog

最近在摸鱼时看到了一些博客园API文章，就想着摸鱼时写个APP练练手。

现阶段实现了以下功能模块：

博问暂时只支持浏览，不支持回答提问等操作。

支持iOS、Android平台。

浅色模式：

深色模式：

开发前需要先到https://api.cnblogs.com/申请API KEY，申请通过才能使用博客园的API。

输入一下个人信息跟应用信息，提交后等待博客园的审核。通过审核后会收到一封包含ClientId和ClientSecret的邮件。

博客园API文档上的API不全，有些API需要到Github中查询。

API申请完成就可以愉快的进行开发了。Flutter版本这次选择了最新的3.3，基于GetX框架+Dio来开发，不得不说GetX一把梭的感觉是真的爽。

目录结构跟GetX框架差不多，按我自己的习惯进行了一些改动：

个人练手项目就加上了一些以前没用过包跟特性体验一下(如lottie、getx国际化)。

这个项目比较简单，技术上没什么好说的，主要说下博文的展示：

博文由于是HTML富文本且有一些复杂样式，把文章内容转为Flutter Widget显示的体验挺差，所以还是使用WebView来展示。

在这里我选择了flutter_inappwebview包，这个包会比官方的webview_flutter功能更加丰富，更新也更频繁。

HTML加载流程如下：

具体实现可以看源代码。实现效果：

由于项目依赖WebView(文章、登录)，所以只支持iOS、Android平台。要支持其他平台也不难，只需要把文章内容转为Flutter Widget显示再更改下登录逻辑即可。

使用Github Actions可以很简单的自动完成打包发布的步骤。

关于Github Actions的介绍，可以看下官方文档。

在项目创建根目录创建一个.github/workflows，然后创建一个xxxx.yml，写入以下代码。

运行脚本前，需要先到Github项目设置-Secrets-Actions中添加以下字段

CLIENT_ID 博客园API ClientIdCLIENT_SECRET 博客园API ClientSecretKEYSTORE_BASE64 APK签名文件，转为BASE64KEY_ALIAS APK签名keyAliasKEY_PASSWORD APK签名keyPasswordSTORE_PASSWORD APK签名storePasswordTOKEN Github Token

Github Token点这里添加，注意需要权限的设置。

设置完成后，当想要打包一个新版本时，只需要提交代码并打上Tag推送至Github，即可自动打包。

这个项目没啥难度且博客园API文档还是比较全面，基本对着API做个UI就行了。

天冷变懒了，有些功能还没有写完，过段时间再慢慢完善了。

项目开源地址:https://github.com/xiaoyaocz/flutter_cnblogs,有兴趣可以到Release中下载安装包体验一下。