lin-cms-flask 0.1.0-beta.2 升级指南

简介

新版 dashboard 页

就在前两天，林间有风团队发布了lin-cms-flask 0.1.0-beta.2，这一个版本主要开放了文件上传的API，并且修复了一些bug。详情请查看官方的更新日志
作为lin-cms的flask版本主要维护者之一，这两天收到不少反馈，主要有关之前版本的项目迁移难、升级难的问题。
对于lin-cms这种偏业务型的开源项目，升级起来着实非常费劲，这也是我发表这边文章的原因，希望通过这边文章可以降低使用lin-cms开发者的升级难度。
笔者将在本篇文章介绍升级的步骤和注意事项。

升级老大难？

上面已经说过，偏重业务的性质导致了升级难。但并不是不能解决。只要框架没有发生革命性的重构，并且开发者有一定的技术基础，对照官方更新日志，足够细心，也是可以无痛升级的。
在目前阶段，lin-cms还在做一些框架的基础必备业务的完善，比如前两日刚发布的文件上传，即将发布的系统日志等等。对于今后的业务，我们将更多地以插件的形式推出，这样就可以做到不需要频繁升级主体框架的前提下，只选择安装或卸载你所想要的插件即可愉快的使用官方推出的新功能。

如何升级

好了，经过前两节的唠叨。我们正式开始升级

下载最新的 release

首先我们去官方仓库去下载最新的release，即0.1.0-beta.2

更新核心库版本

下载完成后，打开Pipfile或requirements.txt任意一个文件，你可以看到依赖包 Lin-CMS的版本已经从0.1.1b2 变为了 0.1.1b3，如果你使用pip管理依赖包，在终端执行下面的命令：

pip install Lin-CMS==0.1.1b3

如果你使用pipenv（也是官方推荐的方式）管理依赖包，请执行：

pipenv install Lin-CMS==0.1.1b3

添加字段

由于这个版本我们开放了头像上传功能，所以你需要为 lin_user 表增加 avatar字段
头像上传功能截图

创建文件上传静态目录

打开新版本的框架后，你可以看到应用目录下多了一个 extension 目录，这个文件夹里面存放了我们最新的上传文件的类和配置项等。要使用文件上传，请在应用目录(app)下手动创建 assets目录。

修改静态文件目录名称

在创建好静态文件目录后，我们需要这个目录的资源能被外网所访问，那么就需要更改flask的配置了，你可以在app/app.py的第29行看到，我们通过向Falsk传入构造参数static_folder的方式指定了静态文件目录，如果你的老版框架未指定位置，请手动修改：

app = Flask(__name__, static_folder='./assets')

运行框架

好了，你已完成了本次更新的所有操作，简不简单？那么Make it works吧！
文件上传系统文档请参考官方文档

结语

如果你完整的看完了这边文章，我在此表示感谢，如果你初次听到Lin-CMS框架，一定要去体验一番。线上demo的链接在这里，若是符合你的口味，一定要去下载源码体验一番，别忘了给个star，林间有风团队真的是很认真地在做这件事，目前前端使用vue，后端已经有了flask和koa版本，Java版本也即将推出。也相信今后的日子里不会让你失望。