最近花了一周的时间,复习了HTML、CSS、原生JS,并学习了Node.js、CoffeeScript.js、MongoDB,入了下门。
因为准备在Rocket.chat 上做二次开发,所以先下载和安装了Rochet.chat 的环境。由于Rocket.chat在Mac环境下下载和运行非常简单,所以相关的文章非常少,但是还是有一些坑,会让我们怀疑是不是没这么简单,这里记录下Rocket.chat 的下载和运行过程。
Rocket.chat 简介
Rocket.Chat 是特性最丰富的 Slack 开源替代品之一。它的github 地址是https://github.com/RocketChat/Rocket.Chat
主要功能:群组聊天,直接通信,私聊群,桌面通知,媒体嵌入,链接预览,文件上传,语音/视频 聊天,截图等等。
Rocket.Chat 原生支持 Windows,Mac OS X ,Linux,iOS 和 Android 平台。Rocket.Chat 通过 hubot 集成了非常流行的服务,比如 GitHub,GitLab,Confluence,JIRA 等等。
高级的特性包括:OTR 消息,XMPP 多用户聊天,Kerberos 认证,p2p 文件分享等等。
最重要的是它是100%开源,可以快速编译出iOS、Android 安装包。
准备工作
由于Rocket.chat 使用的是Meteor 框架,而Meteor 框架是对Node.js 的封装,源码中又使用到了CoffeeScript.js,使用的数据库是MongoDB,所以要在Rocket.chat 上做二次开发,就需要学习的技术有Meteor、Node.js、CoffeeScript.js、MongoDB、HTML(5)、CSS等。
其他资料:
CoffeeScript中文网:http://coffee-script.org/
Meteor中文教程:http://zh.discovermeteor.com
Rocket.chat 要运行,必须要安装Node.js、NPM、Meteor(包含了MongoDB)。
安装Node.js
Node.js 的安装很简单,只需要从官网下载pkg安装包,然后双击安装即可。Node.js 中包含了NPM,所以当Node.js安装完成后,NPM也安装完成了。
安装完成后可以在终端中测试一下:
使用node -v
和 npm -v
可以查看安装的Node.js 和NPM的版本。
安装Meteor
Mac 下安装Meteor 使用一行命令即可:
curl https://install.meteor.com/ | sh
下载安装过程是这样的:
等下载到100%后,就代表Meteor 已经安装完毕。安装完毕,你会看到如下提示:
一般说来到这里,Meteror环境已经安装好了,我们可以先创建一个小工程,测试一下Meteor的环境,以确保Meteor环境正常(因为后面安装Rocket.chat会出现各种错误,导致你怀疑Metor有问题)。
创建一个小工程的指令,首先进入我们要保存的项目的文件夹,然后依次输入如下三个指令:
$ meteor create my_cool_app
$ cd my_cool_app
$ meteor
这里是终端提示的指令有一点点区别,~/代表是在当前用户根目录。
我依次输入的命令:
在浏览器中输入:http://localhost:3000/ ,然后会看到这样的页面,即代表小项目运行正常:
下载和运行Rocket.chat
下载Rocket.chat 最好使用git 的命令:
git clone https://github.com/RocketChat/Rocket.Chat.git
等工程源码下载完毕后,进入对应文件夹,然后运行:
cd Rocket.Chat
meteor
在执行meteor
命令,运行时可能会遇到如下的错误信息:
=> Started proxy.
=> Started MongoDB.
/Users/yf/.meteor/packages/meteor-tool/.1.4.2.zi1w5b++os.osx.x86_64+web.browser+web.cordova/mt-os.osx.x86_64/dev_bundle/lib/node_modules/meteor-promise/promise_server.js:190
throw error;
^
Error: EBADF: bad file descriptor, read
at Error (native)
=> awaited here:
at Promise.await (/Users/yf/.meteor/packages/meteor-tool/.1.4.2.zi1w5b++os.osx.x86_64+web.browser+web.cordova/mt-os.osx.x86_64/dev_bundle/lib/node_modules/meteor-promise/promise_server.js:39:12)
at Object.wrapper [as readFile] (/tools/fs/files.js:1522:32)
at /tools/isobuild/isopack.js:979:15
at Array.forEach (native)
at Function._.each._.forEach (/Users/yf/.meteor/packages/meteor-tool/.1.4.2.zi1w5b++os.osx.x86_64+web.browser+web.cordova/mt-os.osx.x86_64/dev_bundle/lib/node_modules/underscore/underscore.js:79:11)
这个错误提示,我怀疑是工程未下载完整,或者有文件缺失导致的。
我的做法:删除工程,然后在网络较好的情况下,重新执行
git clone
命令 下载工程。这个错误没有再出现。
如果遇到下面这个错误:
解决办法: 执行
npm cache clean
命令,清除npm 下载的库的缓存,然后再次运行,项目就会正常跑起来。
当项目正常运行,我们会看到如下提示信息:
如果你到了这里,恭喜你!
Rocket.chat 已经正常跑起来了,我们可以在浏览器内输入http://localhost:3000/ ,就会看到Rocket.chat的登录页面。
提示: 第一个注册的用户是管理员,后面注册的都是普通用户。
管理员有管理系统的权限,这个自己去系统里摸索吧。
我登录之后是这样的:
Mac 下安装运行Rocket.chat到这里就OK了,希望能帮助你解决一些问题。