推聊是一个基于极光推送的Android手机聊天系统。支持群聊与点对点聊天。当前包括Android客户端与Java服务器端。3分钟就可以整套系统跑起来。
http://github.com/good-life/pushtalk
- 频道里群聊
- 与其他用户点对点聊天
- 聊天支持文字、表情、URL等
- 注册用户(不需要密码)
- 创建频道、加入频道
- 我的最近聊天、我的频道
- 聊天记录缓存(在服务器端)
- 客户端选择聊天服务器、添加聊天服务器
- 简单到极致的 http 聊天服务器:一个 jar 包跑起来
- 轻量级客户端:聊天界面使用 Webview 的方式
- 下行消息推送基于 JPush(一个免费的第三方 Android Push 服务),上行消息采用 http 请求的方式实现
推聊的服务器端使用 Java 语言编写,基于最简单实用的开源框架。
- http 服务器使用 Jetty:轻量级的 Java Servlet 容器。
- 数据库使用 H2: 轻量级的 Java 内存/文件数据库。
- 页面模板使用 Freemarker:轻量级的 Java 页面模板引擎。
- 打包时集成为一个整体 jar 包(包含所有的依赖包)
要运行推聊服务器端,请在 github项目界面相关版本下载 dist/ 目录下的 pushtalk-server jar 文件。
要打包 server-java,请在项目该目录下执行 mvn package 命令。
使用如下命令运行服务器:
java -Dfile.encoding=UTF-8 -jar pushtalk-server-with-dependencies.jar
注:实际的文件名后边一般会加上一个版本号。
上述命令运行后:
- 一个 http server 启动了,监听端口为 10010
- 浏览器里输入 http://localhost:10010 则可以访问到界面
- 要正确地运行服务器,需要通过客户端访问
推聊服务器默认使用 10010
端口。可以在上述命令后指定使用另外的端口。比如以下命令指定使用 10011
来启动推聊聊天服务器:
java -Dfile.encoding=UTF-8 -jar pushtalk-server-with-dependencies.jar 10011
客户端运行,请在 github 文件下载页 https://github.com/good-life/PushTalk/downloads/ 下载 Android apk 安装到 Android 手机即可。
你也可以自己编译 /client-android
项目之后安装到手机。
客户端默认内置官方聊天服务器地址。也可以直接在客户端添加新的服务器,选择新的聊天服务器。
如果你有服务器资源,可以长期运行,欢迎你架设推聊聊天服务器,请添加到以下的页面。经过测试没有问题,会被选择预置到客户端代码里:
https://github.com/good-life/PushTalk/wiki/PushTalk-Third-Party-Servers
欢迎广大开发者加入本开源项目,大家一起来不断地丰满、完善推聊。
本人是因为兴趣业余时间来开发推聊,考虑到 IM 占用的时间太多,所以请谅解,不提供任何 IM 的沟通方式。希望大家以如下的方式交流:
- Email: [email protected]
- 项目Wiki: https://github.com/good-life/PushTalk/wiki
- 项目Bug: https://github.com/good-life/PushTalk/issues
- PushTalk频道:
pushtalk
,报告bug
,新功能讨论
等
代码提交方式:请先提交Bug修复,把 diff 以文件方式发邮件给我。合作多次后,我可以把你加入到本项目贡献者里来,你就可以随时自由地提交代码了。
你也可以自由地 fork 本项目,自己去发布新的版本。
推聊使用的开源协议:Apache License 2.0