openim-sdk-core

⭐️ Used in IOS, Android, PC and other platforms ⭐️

English • 中文

⚠️ Announcement

Dear users of the OpenIM repository, we are pleased to announce that we are currently undergoing a major overhaul to improve our service quality and user experience. We will be using the ws_test branch to make extensive updates and improvements to the main branch, ensuring that our code repository is in optimal condition.

During this time, we will need to pause PR and issue handling on the main branch. We understand that this may cause some inconvenience for you, but we believe it will provide us with better service and a more reliable code repository. If you need to submit code during this period, please submit it to the ws_test branch, and we will process your request as soon as possible.

We appreciate your support and trust, as well as your patience and understanding throughout this process. We value your contributions and suggestions, which are the driving force behind our continuous improvement and growth.

We anticipate that this work will be completed soon, and we will do our utmost to minimize any impact on you. Once again, we express our heartfelt thanks and apologies to you.

---

🧩 Awesome features

OpenIM-SDK-core is a core SDK of OpenIM.

1. Manage WebSocket long connections, responsible for creating, closing and reconnecting connections.
2. Encoding and decoding. Encode and decode messages in binary format to achieve cross-language compatibility.
3. Implement basic protocols of OpenIM, such as login, push, etc.
4. Provide an event handling mechanism to convert received messages into corresponding events and pass them to upper layer applications for processing.
5. Cache management. Manage user, group, blacklists, and other cache information.
6. Provide basic IM function APIs such as sending messages, creating groups, etc. Hide the underlying implementation details from the upper layer application.

Quickstart

Note: You can get started quickly with openim-sdk-core.

Work with Makefile

❯ make help    # show help
❯ make build   # build binary

Work with actions

Actions provide handling of PR and issue. We used the bot @kubbot, It can detect issues in Chinese and translate them to English, and you can interact with it using the command /comment.

Comment in an issue:

❯ /intive

Work with Tools

❯ make tools

Work with Docker

$ make deploy

Contributing & Development

OpenIM Our goal is to build a top-level open source community. We have a set of standards, in the Community repository.

If you'd like to contribute to this openim-sdk-core repository, please read our contributor documentation.

community meeting

We welcome everyone to join us and contribute to openim-sdk-core, whether you are new to open source or professional. We are committed to promoting an open source culture, so we offer community members neighborhood prizes and reward money in recognition of their contributions. We believe that by working together, we can build a strong community and make valuable open source tools and resources available to more people. So if you are interested in openim-sdk-core, please join our community and start contributing your ideas and skills!

We take notes of each biweekly meeting in GitHub discussions, and our minutes are written in Google Docs.

openim-sdk-core maintains a public roadmap. It gives a a high-level view of the main priorities for the project, the maturity of different features and projects, and how to influence the project direction.

about OpenIM

common

• https://github.com/OpenIMSDK/automation: OpenIM Automation, cicd, and actions, Robotics.
• https://github.com/OpenIMSDK/community: Community Management for OpenIM

OpenIM Links

Contains some common parts of the OpenIM community.

• https://github.com/OpenIMSDK/automation: OpenIM Automation, cicd, and actions, Robotics.
• https://github.com/OpenIMSDK/openim-sdk-core: The IMSDK implemented by golang can be used in IOS, Android, PC and other platforms.
• https://github.com/OpenIMSDK/openim-sdk-core: Instant messaging IM server.
• https://github.com/OpenIMSDK/community: Community Management for OpenIM.

SDKs

• openim-sdk-core: A cross-platform SDK implemented in golang that can be used in IOS, Android, PC, and other platforms.
• Open-IM-SDK-iOS: An iOS SDK generated based on openim-sdk-core, available for developers to reference.
• Open-IM-SDK-Android: An Android SDK generated based on openim-sdk-core, available for developers to reference.
• Open-IM-SDK-Flutter: A Flutter SDK generated based on Open-IM-SDK-iOS and Open-IM-SDK-Android, available for developers to reference.
• Open-IM-SDK-Uniapp: A uni-app SDK generated based on Open-IM-SDK-iOS and Open-IM-SDK-Android, available for developers to reference.

Demos

• Open-IM-iOS-Demo: An iOS demo based on Open-IM-SDK-iOS, available for developers to reference.
• Open-IM-Android-Demo: An Android demo based on Open-IM-SDK-Android, available for developers to reference.
• Open-IM-Flutter-Demo: A Flutter demo based on Open-IM-SDK-Flutter, available for developers to reference.

Used By

OpenIM is used by the following companies ,let's write it down in ADOPTER.

Please leave your use cases in the comments here.

License

openim-sdk-core is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.

Thanks to our contributors!