Skip to content

openimsdk/open-im-uniapp-demo

Repository files navigation

OpenIM Uniapp Demo 💬

OpenIM DocsOpenIM Serveropen-im-sdk-uniappopenim-sdk-core


OpenIM Uniapp Demo 是一个基于本地插件、OpenIM Server 和 Uniapp 的开源即时通讯应用程序。它演示了如何使用 OpenIM 将即时消息功能快速集成到任何单一应用程序中。

注意:demo 只是用于演示 SDK 的引入与使用,并不是不是一个完整的应用。

您可以通过以下两种方式之一,获得使用源代码创建非由OpenIM生成的编译版本的许可:

  1. 根据自由软件基金会的GPL v.3.0许可,受此政策概述的例外情况的限制;或
  2. 通过与OpenIM联系(contact@openim.io)获取商业许可。

技术栈 🛠️

  • 这是一个 Uniapp 项目, 依赖于 HBuilderX

  • 新版本 SDK 已经支持同时打包 APP、H5、小程序,请使用 npm 安装最新的依赖。如果开发 H5 和小程序需要后端额外部署 OIMWS

  • 新版本支持 H5、小程序的 SDK 在使用上会有所差异,开发前请参考 文档

在线体验 🌐

前往 下载 APP 并体验。

本地开发 🛠️

推荐使用Hbuilder X 3.8.12.20230817

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

  1. 运行 npm install 安装所有依赖项。

  2. 在以下文件中将配置文件修改为您自己的 AppID :

    使用Hbuilder打开manifest.json

  3. 如果你想使用定位功能,在以下文件中将配置文件修改为您自己的高德地图 appkey :

    使用Hbuilder打开manifest.json

  4. 在以下文件中将请求地址修改为您自己的OpenIM Server IP:

    注意: 需要先 部署 OpenIM Server, OpenIM Server 默认端口为 10001、10002、10008。

    如果是 H5、小程序平台 websocket 地址端口为 10003。

    • common -> config.js

       const wsUrl = "ws://your-server-ip:10001" // or "ws://your-server-ip:10003"
       const apiUrl = "http://your-server-ip:10002"
       const registerUrl = "http://your-server-ip:10008"
  5. 选择云插件或本地插件

    由于是基于原生插件开发的,所以只支持 Android 和 iOS。

    选择云插件需要选择您的项目 Appid 和输入 Android 包名称。

  6. 云打包自定义调试基座

  • 菜单 -> 运行 -> 运行到手机或模拟器 -> 制作自定义调试基座

  1. 在真实的机器或模拟器上运行

建议优先使用真实的机器进行开发。

  • 菜单 -> 运行 -> 运行到手机或模拟器 -> 运行到Android App基座

打包发布 🚀

使用原生App 云打包

  • 菜单 -> 发行 -> 原生App-云打包

社区参与 👥

社区会议 📆

我们希望任何人都能参与到我们的社区并贡献代码,我们提供礼物和奖励,我们欢迎您每周四晚上加入我们。

我们的会议在 OpenIM Slack 🎯, 然后你可以搜索 Open-IM-Server 频道加入。

我们把每一次 双周会 记录在 GitHub discussions, 我们的历史会议记录以及会议回放可以在 Google Docs 📑

谁在使用OpenIM 👀

查看我们的 用户案例研究 页面以获取项目用户列表。 不要犹豫,留下 评论 并分享您的用例。

授权许可 📄

OpenIM 是在 Apache 2.0 许可下授权的. 查看 LICENSE 获取完整的许可文本。