open im uniapp demo

OpenIM Uniapp Demo

OpenIM Docs • OpenIM Server • open-im-sdk-uniapp • openim-sdk-core

OpenIM Uniapp Demo 是一個基於本地插件、OpenIM Server 和Uniapp 的開源即時通訊應用程序。它演示瞭如何使用OpenIM 將即時消息功能快速集成到任何單一應用程序中。

您可以通過以下兩種方式之一，獲得使用源代碼創建非由OpenIM生成的編譯版本的許可：

1. 根據自由軟件基金會的GPL v.3.0許可，受此政策概述的例外情況的限制；或
2. 通過與OpenIM聯繫（[email protected]）獲取商業許可。

技術棧

• 這是一個Uniapp 項目， 依賴於HBuilderX 。開發前請先閱讀文檔。

• 注意：Demo 只是用於演示SDK 的引入與使用，並不是不是一個完整的應用。

• 運行iOS 和Android必須安裝原生插件，中間層openim-uniapp-polyfill結合App 原生插件和JSSDK 能力，兼容一套代碼同時開發APP、H5、小程序（ SDK 和im-server 版本>= 3.8.2 ）。

-	安裝openim-uniapp-polyfill	安裝@openim/client-sdk	安裝App原生插件	製作自定義基座調試
僅開發H5、小程序	直接參考JSSDK 文檔，SDK 調用參考Browser、MiniProgram
僅開發App端	✅		✅	✅
同時開發App端、H5和小程序	✅	✅	✅	✅

本地開發

按照以下步驟設置本地開發環境:

1. 安裝最新的正式版HBuilderX。

2. 運行npm install安裝所有依賴項。

3. 在以下文件中將配置文件修改為您自己的AppID :

   使用Hbuilder 打開manifest.json

   

4. 如果你想使用定位功能，在以下文件中將配置文件修改為您自己的高德地圖appkey :

   使用Hbuilder 打開manifest.json

   

5. 在以下文件中將請求地址修改為您自己的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"

6. 選擇雲插件(必須)

   

   選擇雲插件需要選擇您的項目Appid 和輸入Android 包名稱。

   

7. 雲打包自定義調試基座

• 菜單-> 運行-> 運行到手機或模擬器-> 製作自定義調試基座

8. 在真實的機器或模擬器上運行（ iOS 僅支持在真機調試）

• 菜單-> 運行-> 運行到手機或模擬器-> 運行到Android App基座

打包發布

使用原生App 雲打包

• 菜單-> 發行-> 原生App-雲打包

社區參與

• OpenIM 社區
• ? OpenIM 興趣小組
• 加入我們的Slack社區
• ? 加入我們的微信社區

社區會議?

我們希望任何人都能參與到我們的社區並貢獻代碼，我們提供禮物和獎勵，我們歡迎您每週四晚上加入我們。

我們的會議在OpenIM Slack , 然後你可以搜索Open-IM-Server 頻道加入。

我們把每一次雙週會記錄在GitHub discussions, 我們的歷史會議記錄以及會議回放可以在Google Docs ?。

誰在使用OpenIM ?

查看我們的用戶案例研究頁面以獲取項目用戶列表。 不要猶豫，留下評論並分享您的用例。

授權許可?

本倉庫採用GNU Affero 通用公共許可證第3版(AGPL-3.0) 進行許可，並受以下附加條款的約束。不允許用於商業用途。詳情請參閱此處。