android chat

野火IM解決方案

野火IM是專業級即時通訊和實時音視頻整體解決方案，由北京野火無限網絡科技有限公司維護和支持。

主要特性有：私有部署安全可靠，性能強大，功能齊全，全平台支持，開源率高，部署運維簡單，二次開發友好，方便與第三方系統對接或者嵌入現有系統中。詳細情況請參考在線文檔。

主要包括一下項目：

GitHub倉庫地址(主站)	碼雲倉庫地址(鏡像)	說明	備註
im-server	server	IM Server
android-chat	android-chat	野火IM Android SDK源碼和App源碼	可以很方便地進行二次開發，或集成到現有應用當中
ios-chat	ios-chat	野火IM iOS SDK源碼和App源碼	可以很方便地進行二次開發，或集成到現有應用當中
pc-chat	pc-chat	基於Electron開發的PC 端
web-chat	web-chat	野火IM Web 端, 體驗地址
wx-chat	wx-chat	小程序平台的Demo(支持微信、百度、阿里、字節、QQ 等小程序平台)
app server	app server	應用服務端
robot_server	robot_server	機器人服務端
push_server	push_server	推送服務器
docs	docs	野火IM相關文檔，包含設計、概念、開發、使用說明，在線查看

說明

本工程為野火IM Android App，開發過程中，充分考慮了二次開發和集成需求，可作為SDK集成到其他應用中，或者直接進行二次開發。

開發一套IM系統真的很艱辛，請路過的朋友們給點個star，支持我們堅持下去

關於包名/applicationId

1. 開發者開發具體產品時，請勿直接使用本demo 的包名/applicationId，我們會不定期修改包名/applicationId
2. 禁止將本產品用於非法目的，一經發現，我們將停止任何形式的技術支持

開發調試說明

1. JDK: 17
2. 我們採用最新穩定版Android Studio及對應的gradle進行開發，對於舊版本的IDE，我們沒有測試，編譯之類問題，需自行解決。

關於debug 版apk 可能不能進行音視頻通話的特殊說明

1. 關閉混淆時，命令行下，通過./gradlew clean aDebug或Android Studio 裡面，通過Build App Bundle(s)/APK(s) -> Build APK(s)生成的debug 版本apk，不支持音視頻通話，具體原因請參考useFullClasspathForDexingTransform
2. 開啟混淆，debug 版apk 一切正常，將chat/build.gradle#buildTypes#debug#minifyEnabled置為true，即為debug 版也開啟混淆
3. 命令行下，通過./gradlew clean aR或Android Studio 裡面，通過Generate Signed App Bundle/APK...可生成release 版apk，release 版apk，一切正常

二次開發說明

野火IM採用bugly作為日誌手機工具，大家二次開發時，務必將MyApp.java中的bugly id替換為你們自己的，否則錯誤日誌都跑我們這兒來了，你們收集不到錯誤日誌，我們也會受到干擾。

混淆說明

1. 確保所依賴的lifecycle版本在2.2.0或以上。
2. 參考chat/proguard-rules.pro進行配置。

安全說明

為了方便開發者部署、測試，默認允許HTTP進行網絡請求，為了提高安全性，上線之前，請進行以下操作：

1. 為app-server配置HTTPS支持，並將APP_SERVER_ADDRESS配置為HTTPS地址
2. 如果支持開放平台的話，為開發平台配置HTTPS支持，並將WORKSPACE_URL配置為HTTPS地址
3. 如果支持組織結構的話，為組織結構服務配置HTTPS支持，並將ORG_SERVER_ADDRESS配置為HTTPS地址
4. 將AndroidManifest.xml裡面的usesCleartextTraffic置為false

敏感權限說明

1. android.permission.PROCESS_OUTGOING_CALLS ，音視頻通話時，允許普通電話打斷音視頻通話
2. android.permission.SYSTEM_ALERT_WINDOW ，允許音視頻通話窗口最小化，並懸浮在其他窗口之上
3. android.permission.BLUETOOTH 、 android.permission.BLUETOOTH_ADMIN ，音視頻通話時，允許使用藍牙耳機

Android 4.x 說明

請使用api-19分支，如果編譯失敗等，可能是4.x版本的協議棧版本沒有及時更新所導致，請微信聯繫wfchat進行更新。

聯繫我們

商務合作請優先採用郵箱和我們聯繫。技術問題請到野火IM論壇發帖交流。

1. heavyrain.lee 郵箱: [email protected] 微信：wildfirechat
2. imndx 郵箱: [email protected] 微信：wfchat

問題交流

1. 如果大家發現bug，請在GitHub提issue
2. 其他問題，請到野火IM論壇進行交流學習
3. 微信公眾號

強烈建議關注我們的公眾號。我們有新版本發布或者有重大更新會通過公眾號通知大家，另外我們也會不定期的發布一些關於野火IM的技術介紹。

體驗Demo

我們提供了體驗demo，請使用微信掃碼下載安裝體驗

應用截圖

點擊查看Android Demo 視頻演示

集成

1. client部分，自行下載代碼，並將client module引入你們自己的項目。
2. uikit部分，自行下載代碼，並將uikit module引入你們自己的項目。
3. push部分，自行下載代碼，將push module引入你們自己的項目。

推送

當應用在後台後，不同手機廠家有著不同的後台策略，可能很快或者最終會被凍結和殺掉，此時收到消息需要廠商的推送通知服務。請部署推送服務，推送服務代碼可以在Github和碼雲下載。具體使用方式，請參考推送服務項目上的說明。

貢獻

歡迎提交pull request，一起打造一個更好的開源IM。

鳴謝

1. LQRWeChat 本項目中圖片選擇器、表情基於此開發
2. butterKnife
3. OKHttp等一些其他優秀的開源項目
4. 本工程使用的Icon全部來源於icons8，對他們表示感謝。
5. Gif動態圖來源於網絡，對網友的製作表示感謝。

如果有什麼地方侵犯了您的權益，請聯繫我們刪除

License

1. Under the Creative Commons Attribution-NoDerivs 3.0 Unported license. See the LICENSE file for details.