Home

Awesome

<h1 align="center" style="border-bottom: none"> <b> <a href="https://doc.rentsoft.cn/sdks/introduction">openim-sdk-core</a><br> </b> </h1> <h3 align="center" style="border-bottom: none"> ⭐️ Used in IOS, Android, PC and other platforms ⭐️ <br> <h3> <p align=center> <a href="https://goreportcard.com/report/github.com/openimsdk/openim-sdk-core"><img src="https://goreportcard.com/badge/github.com/openimsdk/openim-sdk-core" alt="A+"></a> <a href="https://github.com/openimsdk/openim-sdk-core/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22good+first+issue%22"><img src="https://img.shields.io/github/issues/OpenIMSDK/Open-IM-Server/good%20first%20issue?logo=%22github%22" alt="good first"></a> <a href="https://github.com/openimsdk/openim-sdk-core"><img src="https://img.shields.io/github/stars/OpenIMSDK/openim-sdk-core.svg?style=flat&logo=github&colorB=deeppink&label=stars"></a> <a href="https://join.slack.com/t/openimsdk/shared_invite/zt-1tmoj26uf-_FDy3dowVHBiGvLk9e5Xkg"><img src="https://img.shields.io/badge/Slack-100%2B-blueviolet?logo=slack&amp;logoColor=white"></a> <a href="https://github.com/openimsdk/openim-sdk-core/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-green"></a> <a href="https://golang.org/"><img src="https://img.shields.io/badge/Language-Go-blue.svg"></a> </p> </p> <p align="center"> <a href="./README.md"><b>English</b></a> • <a href="./README_zh-CN.md"><b>中文</b></a> </p> </p>

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

<details> <summary>Work with Makefile</summary>
❯ make help    # show help
❯ make build   # build binary
</details> <details> <summary>Work with actions</summary>

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
</details> <details> <summary>Work with Tools</summary>
❯ make tools
</details> <details> <summary>Work with Docker</summary>
$ make deploy
</details>

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

OpenIM Links

Contains some common parts of the OpenIM community.

SDKs

Demos

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!

<a href="https://github.com/openimsdk/openim-sdk-core/graphs/contributors"> <img src="https://contrib.rocks/image?repo=OpenIMSDK/openim-sdk-core" /> </a>