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版本也即將推出。也相信從此的日子裏不會讓你失望。