零基础构建开源项目OpenIM桌面应用和pc web- Electron篇

本文涉及的产品
对象存储 OSS,20GB 3个月
对象存储 OSS,恶意文件检测 1000次 1年
对象存储 OSS,内容安全 1000 次 1年
简介: OpenIM 为开发者提供开源即时通讯 SDK,作为 Twilio、Sendbird 等云服务的替代方案。借助 OpenIM,开发者可以构建安全可靠的即时通讯应用,如 WeChat、Zoom、Slack 等。本仓库基于开源版 OpenIM SDK 开发,提供了一款基于 Electron 的即时通讯应用。您可以使用此应用程序作为 OpenIM SDK 的参考实现。本项目同时引用了 @openim/electron-client-sdk 和 @openim/wasm-client-sdk,分别为 Electron 版本和 Web 版本的 SDK,可以同时构建 PC Web 程序和桌面应用(Wi

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

本仓库基于开源版 OpenIM SDK 开发,提供了一款基于 Electron 的即时通讯应用。您可以使用此应用程序作为 OpenIM SDK 的参考实现。本项目同时引用了 @openim/electron-client-sdk 和 @openim/wasm-client-sdk,分别为 Electron 版本和 Web 版本的 SDK,可以同时构建 PC Web 程序和桌面应用(Windows、macOS、Linux)。

v2-dce84879b203731a5d9ac7ebdf2bfe9c_1440w.jpg

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

操作系统:Windows 10 或更高版本、macOS 10.15 或更高版本
Node.js:版本 ≥ 16.x(手动安装 或使用 nvm 进行版本管理)
npm:版本 ≥ 6.x(随 Node.js 一起安装)
Git:用于代码版本控制
同时,您需要确保已经部署了最新版本的 OpenIM Server。接下来,您可以编译项目并连接自己的服务端进行测试。

运行环境
本应用支持以下浏览器和操作系统版本:

浏览器/操作系统 版本 状态
Chrome 78 及以上 ✅
Windows Windows 10 及以上 ✅
macOS 10.15 及以上 ✅
Linux 18.04 及以上 ✅
说明

Chrome:推荐使用最新版本以获得最佳体验。
操作系统:确保您的系统版本符合要求,以避免兼容性问题。
快速开始
按照以下步骤设置本地开发环境:

拉取代码
git clone https://github.com/openimsdk/openim-electron.git
cd openim-electron
安装依赖
npm install
修改配置
.env
如果没有修改过服务端默认端口,则只需要修改VITE_BASE_HOST为您的服务器 ip 即可,如需配置域名和 https 访问,可以参考nginx 配置,并采用最下方的配置项,并修改VITE_BASE_DOMAIN为您的域名。

VITE_BASE_HOST=your-server-ip
VITE_WS_URL=ws://$VITE_BASE_HOST:10001
VITE_API_URL=http://$VITE_BASE_HOST:10002
VITE_CHAT_URL=http://$VITE_BASE_HOST:10008

VITE_BASE_DOMAIN=your-server-domain

VITE_WS_URL=wss://$VITE_BASE_DOMAIN/msg_gateway

VITE_API_URL=https://$VITE_BASE_DOMAIN/api

VITE_CHAT_URL=https://$VITE_BASE_DOMAIN/chat

运行 npm run dev 来启动开发服务器。访问 http://localhost:5173 查看结果。默认情况下将同时启动 Electron 应用程序。
开始开发测试!
音视频通话
开源版支持一对一音视频通话,并且需要先部署并配置服务端。多人音视频通话、视频会议请联系邮箱 contact@openim.io

构建

该项目允许分别构建 Web 应用程序和 Electron 应用程序,但在构建过程中会有一些差异。
Web 应用程序
运行以下命令来构建 Web 应用程序:npm run build
构建结果将位于 dist 目录。
Electron 应用程序
使用 package_electron.json 替换 package.json 文件的内容,只保留 Electron 运行所需的依赖项,这将显著减小包的大小。同时,修改打包脚本。
在对应系统下运行以下命令之一来构建 Electron 应用程序:
如果需要交叉编译,仅支持在 mac 环境下打包其他系统安装包,windows 或 linux 下仅支持打包对应系统安装包。
macOS:
npm run build:mac
Windows:
npm run build:win
Linux:
npm run build:linux
构建结果将位于 release 目录下。
功能列表
说明

功能模块 功能项 状态
账号功能 手机号注册\邮箱注册\验证码登录 ✅
个人信息查看\修改 ✅
多语言设置 ✅
修改密码\忘记密码 ✅
好友功能 查找\申请\搜索\添加\删除好友 ✅
同意\拒绝好友申请 ✅
好友备注 ✅
是否允许添加好友 ✅
好友列表\好友资料实时同步 ✅
黑名单功能 限制消息 ✅
黑名单列表实时同步 ✅
添加\移出黑名单 ✅
群组功能 创建\解散群组 ✅
申请加群\邀请加群\退出群组\移除群成员 ✅
群名/群头像更改/群资料变更通知和实时同步 ✅
群成员邀请进群 ✅
群主转让 ✅
群主、管理员同意进群申请 ✅
搜索群成员 ✅
消息功能 离线消息 ✅
漫游消息 ✅
多端消息 ✅
历史消息 ✅
消息删除 ✅
消息清空 ✅
消息复制 ✅
单聊正在输入 ✅
新消息勿扰 ✅
清空聊天记录 ✅
新成员查看群聊历史消息 ✅
新消息提示 ✅
文本消息 ✅
图片消息 ✅
视频消息 ✅
表情消息 ✅
文件消息 ✅
语音消息 ✅
名片消息 ✅
地理位置消息 ✅
自定义消息 ✅
会话功能 置顶会话 ✅
会话已读 ✅
会话免打扰 ✅
REST API 认证管理 ✅
用户管理 ✅
关系链管理 ✅
群组管理 ✅
会话管理 ✅
消息管理 ✅
Webhook 群组回调 ✅
消息回调 ✅
推送回调 ✅
关系链回调 ✅
用户回调 ✅
容量和性能 1 万好友 ✅
10 万人大群 ✅
秒级同步 ✅
集群部署 ✅
互踢策略 所有平台不互踢 ✅
每个平台各只能登录一个设备 ✅
PC 端、移动端、Pad 端、Web 端、小程序端各只能登录一个设备 ✅
PC 端不互踢,其他平台总计一个设备 ✅
音视频通话 一对一音视频通话 ✅
文件类对象存储 支持私有化部署 minio ✅
支持 COS、OSS、Kodo、S3 公有云 ✅
推送 消息在线实时推送 ✅
消息离线推送,支持个推,Firebase ✅
更多高级功能、音视频通话、视频会议 请联系邮箱 contact@openim.io

加入社区

加入我们的 Slack 社区
加入我们的微信群
常见问题
发布 web 端时,wasm 加载太慢如何解决?
答:针对 wasm 文件采用 gzip 压缩,压缩后会大大减小体积。同时可以做 cdn 加速,加快加载速度。
CKEditorError: ckeditor-duplicated-modules
答:依赖冲突,执行npm dedupe整理依赖

关于OpenIM
作为开源即时通讯(IM)领域的先驱,OpenIM 已在 GitHub 获得超过 15,000 星标,这一成就归功于全球开发者社区的广泛支持。随着数据保护和隐私安全日益受到重视,越来越多的组织选择私有部署 IM 解决方案,这与国内软件行业的快速增长相得益彰。特别是在政府和企业部门,随着信息技术的快速更新和创新应用的广泛实施,IM 系统的需求正在经历飞速增长。

同时,随着协同办公软件市场的不断扩大,“安全可控”已成为其核心要求。在人工智能生成内容(AIGC)之后的时代,IM 作为主要的人机交互界面,其在通讯、协作和安全方面的作用将更加显著。展望未来,我们相信 OpenIM 将在新的技术时代扮演更加核心的角色,为各种应用场景提供支持,增强效率和安全性,成为一个关键工具。

v2-2b9c31540c88f7c4039d1d125ee6be81_1440w.jpg

github: 仓库地址

developer: 开发文档

作为开源即时通讯(IM)领域的先驱,OpenIM 已在 GitHub 获得超过 15,000 星标,这一成就归功于全球开发者社区的广泛支持。随着数据保护和隐私安全日益受到重视,越来越多的组织选择私有部署 IM 解决方案,这与国内软件行业的快速增长相得益彰。特别是在政府和企业部门,随着信息技术的快速更新和创新应用的广泛实施,IM 系统的需求正在经历飞速增长。

同时,随着协同办公软件市场的不断扩大,“安全可控”已成为其核心要求。在人工智能生成内容(AIGC)之后的时代,IM 作为主要的人机交互界面,其在通讯、协作和安全方面的作用将更加显著。展望未来,我们相信 OpenIM 将在新的技术时代扮演更加核心的角色,为各种应用场景提供支持,增强效率和安全性,成为一个不可缺少的关键工具。

目录
相关文章
|
7天前
|
安全 Java API
Java Web 在线商城项目最新技术实操指南帮助开发者高效完成商城项目开发
本项目基于Spring Boot 3.2与Vue 3构建现代化在线商城,涵盖技术选型、核心功能实现、安全控制与容器化部署,助开发者掌握最新Java Web全栈开发实践。
68 1
|
7天前
|
前端开发 JavaScript 开发者
JavaScript:构建动态Web的核心力量
JavaScript:构建动态Web的核心力量
|
4月前
|
前端开发 算法 API
构建高性能图像处理Web应用:Next.js与TailwindCSS实践
本文分享了构建在线图像黑白转换工具的技术实践,涵盖技术栈选择、架构设计与性能优化。项目采用Next.js提供优秀的SSR性能和SEO支持,TailwindCSS加速UI开发,WebAssembly实现高性能图像处理算法。通过渐进式处理、WebWorker隔离及内存管理等策略,解决大图像处理性能瓶颈,并确保跨浏览器兼容性和移动设备优化。实际应用案例展示了其即时处理、高质量输出和客户端隐私保护等特点。未来计划引入WebGPU加速、AI增强等功能,进一步提升用户体验。此技术栈为Web图像处理应用提供了高效可行的解决方案。
|
1月前
|
JavaScript Java 微服务
现代化 Java Web 在线商城项目技术方案与实战开发流程及核心功能实现详解
本项目基于Spring Boot 3与Vue 3构建现代化在线商城系统,采用微服务架构,整合Spring Cloud、Redis、MySQL等技术,涵盖用户认证、商品管理、购物车功能,并支持Docker容器化部署与Kubernetes编排。提供完整CI/CD流程,助力高效开发与扩展。
302 63
|
2月前
|
安全 JavaScript Java
java Web 项目完整案例实操指南包含从搭建到部署的详细步骤及热门长尾关键词解析的实操指南
本项目为一个完整的JavaWeb应用案例,采用Spring Boot 3、Vue 3、MySQL、Redis等最新技术栈,涵盖前后端分离架构设计、RESTful API开发、JWT安全认证、Docker容器化部署等内容,适合掌握企业级Web项目全流程开发与部署。
144 0
|
3月前
|
开发框架 JSON 中间件
Go语言Web开发框架实践:使用 Gin 快速构建 Web 服务
Gin 是一个高效、轻量级的 Go 语言 Web 框架,支持中间件机制,非常适合开发 RESTful API。本文从安装到进阶技巧全面解析 Gin 的使用:快速入门示例(Hello Gin)、定义 RESTful 用户服务(增删改查接口实现),以及推荐实践如参数校验、中间件和路由分组等。通过对比标准库 `net/http`,Gin 提供更简洁灵活的开发体验。此外,还推荐了 GORM、Viper、Zap 等配合使用的工具库,助力高效开发。
|
4月前
|
人工智能 安全 程序员
用 Colab 和 ngrok 免费部署你的 Web UI 项目,随时随地访问!
用 Colab 和 ngrok 免费部署你的 Web UI 项目,随时随地访问!
|
6月前
|
数据可视化 图形学 UED
从模型托管到交互开发:DataV 如何简化三维 Web 应用构建?
从模型托管到交互开发:DataV 如何简化三维 Web 应用构建?
164 2
|
7月前
|
网络协议 Java Shell
java spring 项目若依框架启动失败,启动不了服务提示端口8080占用escription: Web server failed to start. Port 8080 was already in use. Action: Identify and stop the process that’s listening on port 8080 or configure this application to listen on another port-优雅草卓伊凡解决方案
java spring 项目若依框架启动失败,启动不了服务提示端口8080占用escription: Web server failed to start. Port 8080 was already in use. Action: Identify and stop the process that’s listening on port 8080 or configure this application to listen on another port-优雅草卓伊凡解决方案
386 7
|
4月前
|
Web App开发 前端开发 JavaScript
鸿蒙5开发宝藏案例分享---Web适配一多开发实践
这是一份实用的鸿蒙Web多设备适配开发指南,针对开发者在不同屏幕尺寸下的布局难题提供了解决方案。文章通过三大法宝(相对单位、媒体查询和窗口监听)详细介绍如何实现智能适配,并提供了多个实战案例,如宫格布局、对话框变形和自适应轮播图等。此外,还分享了调试技巧及工具推荐,帮助开发者快速上手并优化性能。最后鼓励读者实践探索,并提示更多官方资源等待发现。