为什么要升级

使用 homeland 3.2.5 已经有 1 年了，最近发现ruby-china做了重大更新，办法迭代到了 3.7.0 了，并且带来了跟随潮流的 UI 体验：暗黑模式。

升级的原因，其一就是要跟随 ruby-china 的最新版本，不要被甩太远，如果太远可能导致以后都无法升级，这是个隐患。

第二就是，目前版本的 API 一直无法使用，后续我打算利用 API 来做一些定制化的功能，做一些新的系统，但仍旧使用现有独立开发者社区网站的用户，所以也不得不升级。

第三呢就是从来没有升级过，这个能力必须得学会了。

第四呢，最新版本体验更好，那就更加要升级了！

然而升级过程并非一帆风顺，差点以为 IH 社区就此关站了！

艰难的升级历程

还是要记录一下，不然以后再次升级也不知道怎么处理。

我们的 homeland 的官方文档已经很久没更新了，所以无法指望通过它来完成升级。

也并非仅仅就一个命令 update 就可以了。

最重要的就是去看官方源代码的 release的说明！

例如本次升级（从 3.2.5 -> 3.7.0）

$ make update
$ make stop-all
$ make start

如果不是 docker 部署的，还要拉一下代码：git pull origin master

升级完成以后，请检查用户个人扩展联系信息，比如 Facebook、Instagram，奖励的支付宝、微信二维码等信息是否正确，如无问题，可以手动执行下面的流程清理老的废旧数据。

执行 make console 进入 Rails Console（做一下动作之前，建议先备份数据库）

irb> Setting.where(thing_type: "User")
irb> Setting.where(thing_type: "User").delete_all

升级后发现网站无法打开？

那是因为最新版本的 app_name 不支持中文了，这点是个官方 bug，请在 app.local.env 中去掉中文

参考资料可以看：

https://ruby-china.org/topics/40160#reply23

https://ruby-china.org/topics/40315

升级后发现酷站、wiki、头条都不见了，并且也打不开了？

那是以为 3.7.0 的版本，将这些插件剥离出去了，不是内置的，可以在网站后台去上传插件

插件项目地址是：https://github.com/topics/homeland-plugin

新版本带来哪些改变？

首先：网站最突出的就是暗黑模式

这个特性主要针对 mac 和 iPhone 的，根据手机/电脑的设置来自动切换主题

其次：评论支持代码

再次：网站的 API 服务正常了！这是最重要的

提醒

未修改默认头像的老用户，请更新自己的头像