{"id":15035020,"url":"https://github.com/wildfirechat/android-chat","last_synced_at":"2025-04-10T15:34:11.313Z","repository":{"id":38375011,"uuid":"166355106","full_name":"wildfirechat/android-chat","owner":"wildfirechat","description":"即时通讯，聊天，野火IMAndroid客户端，支持Android 4.x —— 最新","archived":false,"fork":false,"pushed_at":"2024-10-22T07:56:56.000Z","size":2134457,"stargazers_count":2543,"open_issues_count":26,"forks_count":893,"subscribers_count":58,"default_branch":"master","last_synced_at":"2024-10-29T15:37:52.725Z","etag":null,"topics":["chat","im","voip"],"latest_commit_sha":null,"homepage":"http://docs.wildfirechat.cn","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wildfirechat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-18T06:25:11.000Z","updated_at":"2024-10-29T08:23:32.000Z","dependencies_parsed_at":"2023-09-25T10:37:59.049Z","dependency_job_id":"3213f54e-e879-4986-a8c7-764004f88d94","html_url":"https://github.com/wildfirechat/android-chat","commit_stats":null,"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wildfirechat%2Fandroid-chat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wildfirechat%2Fandroid-chat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wildfirechat%2Fandroid-chat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wildfirechat%2Fandroid-chat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wildfirechat","download_url":"https://codeload.github.com/wildfirechat/android-chat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248243472,"owners_count":21071054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chat","im","voip"],"created_at":"2024-09-24T20:27:12.166Z","updated_at":"2025-04-10T15:34:11.304Z","avatar_url":"https://github.com/wildfirechat.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## 野火IM解决方案\n\n野火IM是专业级即时通讯和实时音视频整体解决方案，由北京野火无限网络科技有限公司维护和支持。\n\n主要特性有：私有部署安全可靠，性能强大，功能齐全，全平台支持，开源率高，部署运维简单，二次开发友好，方便与第三方系统对接或者嵌入现有系统中。详细情况请参考[在线文档](https://docs.wildfirechat.cn)。\n\n主要包括一下项目：\n\n| [GitHub仓库地址(主站)](https://github.com/wildfirechat)      | [码云仓库地址(镜像)](https://gitee.com/wfchat)        | 说明                                                                                      | 备注                                           |\n| ------------------------------------------------------------ | ----------------------------------------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------- |\n| [im-server](https://github.com/wildfirechat/im-server)       | [server](https://gitee.com/wfchat/im-server)          | IM Server                                                                                 |                                                |\n| [android-chat](https://github.com/wildfirechat/android-chat) | [android-chat](https://gitee.com/wfchat/android-chat) | 野火IM Android SDK源码和App源码                                                           | 可以很方便地进行二次开发，或集成到现有应用当中 |\n| [ios-chat](https://github.com/wildfirechat/ios-chat)         | [ios-chat](https://gitee.com/wfchat/ios-chat)         | 野火IM iOS SDK源码和App源码                                                               | 可以很方便地进行二次开发，或集成到现有应用当中 |\n| [pc-chat](https://github.com/wildfirechat/vue-pc-chat)       | [pc-chat](https://gitee.com/wfchat/vue-pc-chat)       | 基于[Electron](https://electronjs.org/)开发的PC 端                                        |                                                |\n| [web-chat](https://github.com/wildfirechat/vue-chat)         | [web-chat](https://gitee.com/wfchat/vue-chat)         | 野火IM Web 端, [体验地址](http://web.wildfirechat.cn)                                     |                                                |\n| [wx-chat](https://github.com/wildfirechat/wx-chat)           | [wx-chat](https://gitee.com/wfchat/wx-chat)           | 小程序平台的Demo(支持微信、百度、阿里、字节、QQ 等小程序平台)                             |                                                |\n| [app server](https://github.com/wildfirechat/app_server)     | [app server](https://gitee.com/wfchat/app_server)     | 应用服务端                                                                                |                                                |\n| [robot_server](https://github.com/wildfirechat/robot_server) | [robot_server](https://gitee.com/wfchat/robot_server) | 机器人服务端                                                                              |                                                |\n| [push_server](https://github.com/wildfirechat/push_server)   | [push_server](https://gitee.com/wfchat/push_server)   | 推送服务器                                                                                |                                                |\n| [docs](https://github.com/wildfirechat/docs)                 | [docs](https://gitee.com/wfchat/docs)                 | 野火IM相关文档，包含设计、概念、开发、使用说明，[在线查看](https://docs.wildfirechat.cn/) |                                                |\n\n\n## 说明\n\n本工程为野火IM Android App，开发过程中，充分考虑了二次开发和集成需求，可作为SDK集成到其他应用中，或者直接进行二次开发。\n\n开发一套IM系统真的很艰辛，请路过的朋友们给点个star，支持我们坚持下去🙏🙏🙏🙏🙏\n\n## 关于包名/applicationId\n1. 开发者开发具体产品时，请勿直接使用本 demo 的包名/applicationId，我们会不定期修改包名/applicationId\n2. 禁止将本产品用于非法目的，一经发现，我们将停止任何形式的技术支持\n3. 修改包名时，会导致编译失败，需同步修改`google-services.json`和`agconnect-services.json`文件中的`package_name`字段。对接推送时，需要重新生成对应的`google-services.json`和`agconnect-services.json`文件。\n4. 如果需要修改`client`、`mars-core-release`或`avenginekit.aar`等的包名，请联系我们。\n\n## 开发调试说明\n1. JDK: 17\n2. 我们采用最新稳定版Android Studio及对应的gradle进行开发，对于旧版本的IDE，我们没有测试，编译之类问题，需自行解决。\n\n##  关于 minSdkVersion 设置为 21 时， debug 版 apk 可能不能进行音视频通话的特殊说明\n1. 关闭混淆时，命令行下，通过`./gradlew clean aDebug` 或 Android Studio 里面，通过 `Build App Bundle(s)/APK(s) -\u003e Build APK(s)` 生成的 debug 版本 apk，不支持音视频通话，具体原因请参考[useFullClasspathForDexingTransform](https://issuetracker.google.com/issues/333107832)\n2. 开启混淆，debug 版 apk 一切正常，将`chat/build.gradle#buildTypes#debug#minifyEnabled`置为 true，即为 debug 版也开启混淆\n3. 命令行下，通过`./gradlew clean aR`或 Android Studio 里面，通过`Generate Signed App Bundle/APK...`可生成 release 版 apk，release 版 apk，一切正常\n\n## 二次开发说明\n野火IM采用bugly作为日志手机工具，大家二次开发时，务必将```MyApp.java```中的 ```bugly id``` 替换为你们自己的，否则错误日志都跑我们这儿来了，你们收集不到错误日志，我们也会受到干扰。\n\n## 混淆说明\n1. 确保所依赖的```lifecycle```版本在2.2.0或以上。\n2. 参考```chat/proguard-rules.pro```进行配置。\n\n## 安全说明\n为了方便开发者部署、测试，默认允许`HTTP`进行网络请求，为了提高安全性，上线之前，请进行以下操作：\n1. 为`app-server`配置`HTTPS`支持，并将`APP_SERVER_ADDRESS`配置为`HTTPS`地址\n2. 如果支持开放平台的话，为开发平台配置`HTTPS`支持，并将`WORKSPACE_URL`配置为`HTTPS`地址\n3. 如果支持组织结构的话，为组织结构服务配置`HTTPS`支持，并将`ORG_SERVER_ADDRESS`配置为`HTTPS`地址\n4. 将`AndroidManifest.xml`里面的`usesCleartextTraffic`置为`false`\n\n## 敏感权限说明\n1. `android.permission.PROCESS_OUTGOING_CALLS`，音视频通话时，允许普通电话打断音视频通话\n2. `android.permission.SYSTEM_ALERT_WINDOW`，允许音视频通话窗口最小化，并悬浮在其他窗口之上\n3. `android.permission.BLUETOOTH`、`android.permission.BLUETOOTH_ADMIN`，音视频通话时，允许使用蓝牙耳机\n\n## Android 4.x 说明\n请使用[api-19](https://github.com/wildfirechat/android-chat/tree/api-19)分支，如果编译失败等，可能是4.x版本的协议栈版本没有及时更新所导致，请微信联系 `wfchat` 进行更新。\n\n### 联系我们\n\n\u003e 商务合作请优先采用邮箱和我们联系。技术问题请到[野火IM论坛](http://bbs.wildfirechat.cn/)发帖交流。\n\n1. heavyrain.lee  邮箱: heavyrain.lee@wildfirechat.cn  微信：wildfirechat\n2. imndx  邮箱: imndx@wildfirechat.cn  微信：wfchat\n\n### 问题交流\n\n1. 如果大家发现bug，请在GitHub提issue\n2. 其他问题，请到[野火IM论坛](http://bbs.wildfirechat.cn/)进行交流学习\n3. 微信公众号\n\n\u003cimg src=\"http://static.wildfirechat.cn/wx_wfc_qrcode.jpg\" width = 40% height = 40% /\u003e\n\n\u003e 强烈建议关注我们的公众号。我们有新版本发布或者有重大更新会通过公众号通知大家，另外我们也会不定期的发布一些关于野火IM的技术介绍。\n\n## 体验Demo\n我们提供了体验demo，请使用微信扫码下载安装体验\n\n![野火IM](http://static.wildfirechat.cn/download_qrcode.png)\n\n## 应用截图\n[点击查看 Android Demo 视频演示](https://static.wildfirechat.cn/wf-android-demo-live.mp4)\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-1.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-2.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-3.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-4.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-5.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-6.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-7.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-8.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-9.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-10.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-11.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-12.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-13.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-14.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-15.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-16.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-17.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-18.jpg\" width = 40% height = 40% /\u003e\n\n\u003cimg src=\"https://static.wildfirechat.cn/wf-android-demo-19.jpg\" width = 40% height = 40% /\u003e\n\n\n## 集成\n1. client部分，自行下载代码，并将client module引入你们自己的项目。\n2. uikit部分，自行下载代码，并将uikit module引入你们自己的项目。\n3. push部分，自行下载代码，将push module引入你们自己的项目。\n\n## 推送\n当应用在后台后，不同手机厂家有着不同的后台策略，可能很快或者最终会被冻结和杀掉，此时收到消息需要厂商的推送通知服务。请部署推送服务，推送服务代码可以在[Github](https://github.com/wildfirechat/push_server)和[码云](https://gitee.com/wfchat/push_server)下载。具体使用方式，请参考推送服务项目上的说明。\n\n## 贡献\n欢迎提交pull request，一起打造一个更好的开源IM。\n\n## 鸣谢\n1. [LQRWeChat](https://github.com/GitLqr/LQRWeChat) 本项目中图片选择器、表情基于此开发\n2. [butterKnife](https://github.com/JakeWharton/butterknife)\n3. OKHttp等一些其他优秀的开源项目\n4. 本工程使用的Icon全部来源于[icons8](https://icons8.com)，对他们表示感谢。\n5. Gif动态图来源于网络，对网友的制作表示感谢。\n\n如果有什么地方侵犯了您的权益，请联系我们删除🙏🙏🙏\n\n## License\n\n1. Under the Creative Commons Attribution-NoDerivs 3.0 Unported license. See the [LICENSE](https://github.com/wildfirechat/android-chat/blob/master/LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwildfirechat%2Fandroid-chat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwildfirechat%2Fandroid-chat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwildfirechat%2Fandroid-chat/lists"}