openim-sdk-core

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

English • 中文

The "openim-sdk-core" is an IM SDK designed to work in conjunction with the "open-im-server", intended for embedding in client-side applications. It includes local storage, listener callbacks, API wrappers, and connection management, ensuring real-time and completeness of messages. The "openim-sdk-core" is implemented in Golang and utilizes "gomobile" for cross-platform compilation on mobile devices.

🧩 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!