Awesome

OpenIM Uniapp Demo 💬

<p> <a href="https://doc.rentsoft.cn/">OpenIM Docs</a> • <a href="https://github.com/openimsdk/open-im-server">OpenIM Server</a> • <a href="https://github.com/openimsdk/open-im-sdk-uniapp">open-im-sdk-uniapp</a> • <a href="https://github.com/openimsdk/openim-sdk-core">openim-sdk-core</a> </p> <br>

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

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

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

技术栈 🛠️

这是一个 Uniapp 项目，依赖于 HBuilderX 。开发前请先阅读文档。
注意：Demo 只是用于演示 SDK 的引入与使用，并不是不是一个完整的应用。
运行 iOS 和 Android 必须安装原生插件，中间层 openim-uniapp-polyfill 结合 App 原生插件和 JSSDK 能力，兼容一套代码同时开发 APP、H5、小程序（ SDK 和 im-server 版本 >= 3.8.2 ）。

<table> <tr> <th style="text-align: center;">-</th> <th style="text-align: center;">安装 openim-uniapp-polyfill</th> <th style="text-align: center;">安装 @openim/client-sdk</th> <th style="text-align: center;">安装 App原生插件</th> <th style="text-align: center;">制作自定义基座调试</th> </tr> <tr> <td style="text-align: center;">仅开发H5、小程序</td> <td style="text-align: center;" colspan="5">直接参考 <a href="https://docs.openim.io/zh-Hans/sdks/quickstart/miniProgram">JSSDK 文档<a>，SDK 调用参考 Browser、MiniProgram </td> </tr> <tr> <td style="text-align: center;">仅开发App端</td> <td style="text-align: center;">✅</td> <td style="text-align: center;">❌</td> <td style="text-align: center;">✅</td> <td style="text-align: center;">✅</td> </tr> <tr> <td style="text-align: center;">同时开发App端、H5和小程序</td> <td style="text-align: center;">✅</td> <td style="text-align: center;">✅</td> <td style="text-align: center;">✅</td> <td style="text-align: center;">✅</td> </tr> </table>

本地开发 🛠️

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

安装最新的正式版 HBuilderX。
运行 npm install 安装所有依赖项。
在以下文件中将配置文件修改为您自己的 AppID :

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

使用 Hbuilder 打开 manifest.json
在以下文件中将请求地址修改为您自己的OpenIM Server IP:

注意: 需要先部署 OpenIM Server, OpenIM Server 默认端口为 10001、10002、10008。
- common -> config.js
```
 const wsUrl = "ws://your-server-ip:10001"
 const apiUrl = "http://your-server-ip:10002"
 const registerUrl = "http://your-server-ip:10008"
```
选择云插件 (必须)

选择云插件需要选择您的项目 Appid 和输入 Android 包名称。
云打包自定义调试基座