Skip to content

Latest commit

 

History

History
133 lines (114 loc) · 7.73 KB

README-zh.md

File metadata and controls

133 lines (114 loc) · 7.73 KB
Raw

公告：由于作者经费不足，没有能力提供该程序的相应服务，作者决定（短期内）不再为该程序提供服务。作者将在2021年7月13日停止发送验证码以及注册的服务，在2021年7月18日全面停止对该程序的服务，您将无法再进行注册、登录、聊天等操作。

MS聊天室（MSCR）

一个使用 MINA 框架（通讯）和 MySQL数据库（账户信息存储）的 Android 聊天软件
如果您要使用本应用程序的旧版本，您需要下载目标版本的源代码 ，并解压，查阅它的README文件。
从版本v1.3开始，您可以直接下载安装包并安装使用 ，不用自行搭建服务器。如果您需要，可转到自行编译运行的准备工作 。

Click me to go to the README in English
点我转到本应用程序的更新日志

版权

MrShiehX 拥有该应用程序的版权。
任何人都可以对此应用程序提出意见和建议。

版本

最新版本：
1.3.1 (2021年5月12日)（对应服务器1.3）
历史版本：
1.3.1 (2021年5月12日)（对应服务器1.3）
1.3 (2021年5月10日)（对应服务器1.3）
1.2.1 (2021年4月15日)（对应服务器1.2）
1.2 (2021年4月14日)（对应服务器1.2）
1.1.1 (2021年4月7日)（对应服务器1.1）
1.1 (2021年4月5日)（对应服务器1.1）
1.0 (2021年1月31日)（对应服务器1.0）
beta-2 (2021年1月26日)
beta-1 (2021年1月21日)
alpha-6 (2020年12月27日)
alpha-5 (2020年12月26日)
alpha-4 (2020年12月20日)
alpha-3 (2020年12月17日)
alpha-2 (2020年12月07日)
alpha-1 (2020年12月05日)

本应用程序需要的软件配置有：

  • Android 4.0及以上

支持的语言

您可在设置中设置语言。

  • 英语（美国）
  • 简体中文（中国）

已发现的漏洞

  • 应用不在后台或前台运行则不会有新消息通知提醒。
  • 如果应用打开了聊天界面或主界面后离开应用（非退出），将不会收到新消息通知。
  • 低版本 Android 可能无法收到消息后进行通知。
  • （已在alpha-6中修复）用户可以用户无需登录即可添加聊天。
  • （已在beta-1中修复）添加聊天时，当前聊天数量>=2，就会替换最后一个，但是它已经添加成功，重启应用即可看到新添加的聊天。
  • （已在beta-1中修复）修改用户信息有几率会闪退，原因未知。
  • （已在alpha-3中修复）在您登录后，打开设置，可能会显示不出用户信息（头像、昵称和个性签名），此问题将会在以后修复。

注意事项

  • 为了避免程序出现问题，请不要通过其他手段绕过加载界面（StartActivity）而直接进入应用程序。

文本加密和解密

使用src/java/com/mrshiehx/mschatroom/utils/EnDeCryptTextUtils.java类的加密或解密算法

工作原理

注册

把邮箱地址、账号和密码加密后，在 MySQL 数据库使用insert命令里新建数据。

登录

把邮箱地址或账号和密码加密后，在 MySQL 数据库使用select命令检测数据是否存在，如果存在，则在 SharedPreference 里存储登录数据。

找回密码

把邮箱地址和密码加密后，检测账户是否存在，如果存在，使用update命令修改密码数据。

使用邮箱地址登录

把邮箱地址加密后，在 MySQL 数据库使用select命令检测数据是否存在，如果存在，则获得密码后，在 SharedPreference 里存储登录数据。

退出登录

在 SharedPreference 里删除邮箱地址或账号和密码数据。

删除账户

把邮箱地址或账号和密码加密后，在 MySQL 数据库使用delete命令删除数据，并退出登录。

修改头像

把邮箱地址或账号和密码加密后，选择要设置成头像的文件，然后使用update命令更新 InputStream。

修改昵称、性别或个性签名

把邮箱地址或账号和密码加密后，从数据库下载 information 里的 InputStream，修改其内容，然后使用update命令更新 InputStream。

清除缓存

删除 /data/data/com.mrshiehx.mschatroom/cache 目录下的所有文件。

清除应用数据

删除 /data/data/com.mrshiehx.mschatroom 目录下的所有文件。

自行编译运行的准备工作

首先，您需要拥有一个服务器（如果您没有，可以使用本地计算机），并且此服务器上需要安装MySQL数据库，这些您都准备好后，需要在MySQL里新建一个数据库，“mscr”是数据库名称，可更改。

create database mscr;

然后我们进入该数据库。

use mscr;

进入后，新建一个格式如下图的表格
表格描述
您可以输入以下命令来新建表格，其中“users”是表格名。

create table `users` (`email` varchar(1000) not null,`account` varchar(1000) not null,`password` varchar(1000) not null,`information` mediumblob not null,`avatar` mediumblob,`messages` text(4294967295));

至此，如果一切顺利无错误，那么，您就可以进行下一步了。

搭建完拥有MySQL的服务器后，修改 src/java/com/mrshiehx/mschatroom 目录里的 Variables.java 文件里的变量内容（下表没有列出来的代表可不用修改）

变量名 含义
SERVER_ADDRESS 默认服务器（或本地计算机）地址（数据库）
SERVER_ADDRESS_COMMUNICATION 默认服务器（或本地计算机）地址（通讯）
SERVER_PORT 默认服务器（或本地计算机）端口（用于通讯）
DATABASE_NAME 默认MySQL数据库名称
DATABASE_USER_NAME 默认MySQL数据库账号
DATABASE_USER_PASSWORD 默认MySQL数据库密码
DATABASE_TABLE_NAME 默认MySQL表格名称
TEXT_ENCRYPTION_KEY 文本加密密钥（不能太长，也不能太短）
CAPTCHA_EMAIL_SMTP_SERVER_ADDRESS 发送验证码邮件的邮箱的SMTP服务器地址（见下文）
CAPTCHA_EMAIL_ADDRESS 发送验证码邮件的邮箱地址（见下文）
AUTHENTICATOR 发送验证码邮件的邮箱的授权码（见下文）

关于发送验证码的电子邮箱，请您自行创建一个电子邮箱，之后要开启邮箱的IMAP/SMTP服务和POP3/SMTP服务，记下邮箱地址、授权码和该邮箱服务的SMTP地址，输入在 Variables.java 中。您还可以选择修改 src/java/com/mrshiehx/mschatroom/utils 目录里的 SendEmailUtils.java 文件里的方法内容

所在的行数 方法名 含义
38 setSubject 验证码邮件标题
42 setContent 验证码邮件内容

要想应用程序能够正常使用聊天通讯功能，您需要 转到MS聊天室服务器的仓库 并仔细阅读它的README文件。

这些工作都做完后，您就可以编译该应用程序并运行了。

关于作者

MrShiehX

如果您在本应用程序发现任何BUG，或者有新的想法，欢迎发送邮件或添加我的QQ。