零基础构建即时通讯开源项目OpenIM移动端-Flutter篇

OpenIM 为开发者提供开源即时通讯 SDK,作为 Twilio、Sendbird 等云服务的替代方案。借助 OpenIM,开发者可以构建安全可靠的即时通讯应用,如 WeChat、Zoom、Slack 等。

本仓库基于开源版 OpenIM SDK 开发,提供了一款基于 Flutter 的即时通讯应用。您可以使用此应用程序作为 OpenIM SDK 的参考实现。

开发环境

在开始开发之前,请确保您的系统已安装以下软件:

操作系统:macOS 14.6 或更高版本

Flutter:版本 3.24.5(根据官网步骤进行安装

Git:用于代码版本控制

同时,您需要确保已经部署了最新版本的 OpenIM Server。接下来,您可以编译项目并连接自己的服务端进行测试。

运行环境

本应用支持以下操作系统版本:

操作系统版本状态

iOS13.0 及以上✅

AndroidminSdkVersion 24✅

说明

Flutter:确保您的版本符合要求,以避免依赖问题。

快速开始

按照以下步骤设置本地开发环境:

拉取代码

git clone https://github.com/openimsdk/open-im-flutter-demo.git

  cd open-im-flutter-demo

安装依赖

flutter clean

  flutter pub get

修改配置

如果没有修改过服务端默认端口,则只需要修改_host为您的服务器 ip 即可。

static const _host = "your-server-ip or your-domain";

通过终端执行 flutter run 或者IDE的启动菜单来运行iOS/Android应用程序。

开始开发测试!

音视频通话

开源版支持一对一音视频通话,并且需要先部署并配置服务端。多人音视频通话、视频会议请联系邮箱 contact@openim.io

构建

该项目允许分别构建 iOS 应用程序和 Android 应用程序,但在构建过程中会有一些差异。

iOS:flutter build ipa

Android:flutter build apk

构建结果将位于 build 目录下。

功能列表

说明

功能模块功能项状态

账号功能手机号注册\邮箱注册\验证码登录✅

个人信息查看\修改✅

多语言设置✅

修改密码\忘记密码✅

好友功能查找\申请\搜索\添加\删除好友✅

同意\拒绝好友申请✅

好友备注✅

是否允许添加好友✅

好友列表\好友资料实时同步✅

黑名单功能限制消息✅

黑名单列表实时同步✅

添加\移出黑名单✅

群组功能创建\解散群组✅

申请加群\邀请加群\退出群组\移除群成员✅

群名/群头像更改/群资料变更通知和实时同步✅

群成员邀请进群✅

群主转让✅

群主、管理员同意进群申请✅

搜索群成员✅

消息功能离线消息✅

漫游消息

多端消息✅

历史消息✅

消息删除✅

消息清空✅

消息复制✅

单聊正在输入✅

新消息勿扰✅

清空聊天记录✅

新成员查看群聊历史消息✅

新消息提示✅

文本消息✅

图片消息✅

视频消息✅

表情消息✅

文件消息✅

语音消息✅

名片消息✅

地理位置消息✅

自定义消息✅

会话功能置顶会话✅

会话已读✅

会话免打扰✅

REST API认证管理

用户管理✅

关系链管理✅

群组管理✅

会话管理✅

消息管理✅

Webhook群组回调✅

消息回调✅

推送回调✅

关系链回调✅

用户回调✅

容量和性能1 万好友✅

10 万人大群✅

秒级同步✅

集群部署

互踢策略

在线状态所有平台不互踢✅

每个平台各只能登录一个设备✅

PC 端、移动端、Pad 端、Web 端、小程序端各只能登录一个设备✅

PC 端不互踢,其他平台总计一个设备✅

音视频通话一对一音视频通话✅

文件类对象存储支持私有化部署 minio✅

支持 COS、OSS、Kodo、S3 公有云

推送消息在线实时推送✅

消息离线推送,支持个推,Firebase✅

更多高级功能、音视频通话、视频会议 请联系邮箱 contact@openim.io

加入社区

加入我们的 Slack 社区

加入我们的微信群

常见问题

1. 是否支持多语言?

答:支持,默认跟随系统语言。

2. 支持哪些平台?

答:目前 Demo 支持 Android 和 iOS。

3. Android 安装包的 debug 版本可以运行,但 release 启动是白屏?

答:Flutter 的 release 包默认会进行混淆,可以使用以下命令:

flutter build release --no-shrink

如果此命令无效,可以在 android/app/build.gradle 文件的 release 配置中添加以下代码:

release {

      minifyEnabled false

      useProguard false

      shrinkResources false

  }

4. 如果代码必须混淆该怎么办?

答:在混淆规则中添加以下配置:

-keep class io.openim.**{*;}

  -keep class open_im_sdk.**{*;}

  -keep class open_im_sdk_callback.**{*;}

5. Android 安装包无法安装在模拟器上?

答:由于 Demo 移除了一些 CPU 架构,如果需要在模拟器上运行,请在 android/build.gradle 配置中添加以下内容:

ndk {

      abiFilters "armeabi-v7a",  "x86"

  }

6. iOS 运行/打包 release 包时报错?

答:请将 CPU 架构设置为 arm64,然后按以下步骤操作:

执行 flutter clean

  执行 flutter pub get

  cd ios/

  rm -f Podfile.lock

  rm -rf Pods

  执行 pod install

  连接真机后运行 Archive。

7. iOS 最低运行版本是多少?

答:13.0

关于OpenIM

作为开源即时通讯(IM)领域的先驱,OpenIM 已在 GitHub 获得超过 15,000 star,。随着数据保护和隐私安全日益受到重视,越来越多的组织选择私有部署 IM 解决方案,这与国内软件行业的快速增长相得益彰。OpenIM几乎支持所有SDK,iOS、Android、Flutter、Uniapp、jssdk等。

github: 仓库地址

developer: 开发文档

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,907评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,987评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,298评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,586评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,633评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,488评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,275评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,176评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,619评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,819评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,932评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,655评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,265评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,871评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,994评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,095评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,884评论 2 354

推荐阅读更多精彩内容