Unverified Commit 784a12cf authored by Yang Libin's avatar Yang Libin Committed by GitHub

docs: update readme guideline (#67)

parent 91b43192
......@@ -7,16 +7,20 @@
The Tencent Cloud IM Server SDK for Java enables Java developers to easily work with Tencent Cloud IM.
## Requirements
[中文文档](./README_CN.md)
- Java 8 or later
- Maven
## Documentation
## Installation and Getting Started
- [Documentation Home](https://doocs.github.io/qcloud-im-server-sdk-java)
- [Contributing Code](#Contributing)
### 1. Maven Configuration
## Quick Start
Add the Maven dependency:
### 1. Add Dependency
**Note**: Tencent Cloud IM Server SDK requires JDK 1.8 or later.
If you're using Maven, just add the following dependency in `pom.xml`.
```xml
<dependency>
......@@ -26,9 +30,11 @@ Add the Maven dependency:
</dependency>
```
If not, you can download JAR in [Maven Center Repository](https://repo1.maven.org/maven2/io/github/doocs/im-server-sdk-java/).
### 2. Getting Started
Here is a quick teaser of an application using IM SDK in Java:
Here is a quick teaser of an application using Tencent Cloud IM Server SDK in Java:
```java
// sdk appId
......@@ -55,12 +61,6 @@ try {
}
```
## Authors
- [Yang Libin](https://github.com/yanglbme)
- [Hong Yiheng](https://github.com/hongyiheng)
- [Xie Yu](https://github.com/YXxy1002)
## Contributing
Contributions are always welcomed!
......
# 腾讯云 IM 服务端 Java SDK
<a href="https://search.maven.org/artifact/io.github.doocs/im-server-sdk-java"><img src="https://img.shields.io/maven-metadata/v?color=42b883&metadataUrl=https%3A%2F%2Frepo1.maven.org%2Fmaven2%2Fio%2Fgithub%2Fdoocs%2Fim-server-sdk-java%2Fmaven-metadata.xml&style=flat-square" alt="maven"></a>
<a href="https://github.com/doocs/qcloud-im-server-sdk-java/blob/main/LICENSE"><img src="https://img.shields.io/github/license/doocs/qcloud-im-server-sdk-java?color=42b883&style=flat-square" alt="license"></a>
<a href="https://github.com/doocs/qcloud-im-server-sdk-java/pulls"><img src="https://img.shields.io/badge/prs-welcome-42b883?style=flat-square" alt="prs welcome"></a>
<a href="https://doocs.github.io/#/?id=how-to-join"><img src="https://img.shields.io/badge/organization-join%20us-42b883?style=flat-square" alt="open-source-organization"></a>
腾讯云 IM 服务端 Java SDK 封装了[腾讯云即时通信 IM](https://cloud.tencent.com/document/product/269) 服务端的所有 API 接口,方便服务端开发者进行 REST API 接口的调用以第三方回调的处理。
[English Version](./README.md)
## 文档导航
- [文档站点](https://doocs.github.io/qcloud-im-server-sdk-java)
- [贡献代码](#Contributing)
## 快速上手
### 1. 添加依赖
**注意**: 腾讯云 IM 服务端 Java SDK 依赖 JDK 1.8 及以上版本。
如果你的应用程序属于 Maven 工程,请在 `pom.xml` 文件中引入以下依赖:
```xml
<dependency>
<groupId>io.github.doocs</groupId>
<artifactId>im-server-sdk-java</artifactId>
<version>0.2.10</version>
</dependency>
```
你也可以在 [Maven 中央仓库](https://repo1.maven.org/maven2/io/github/doocs/im-server-sdk-java/)下载 SDK 的 JAR 包,并在项目中引入。
### 2. 编码实现
```java
// sdk appId
long appId = 1400554812;
// 管理员 userId
String userId = "test";
// 应用程序 key
String key = "60c6c5925f3ae52c7325ac5a8ec78e44c056d1dd84d54e12ffa39911267a2a70";
// 创建 IM 客户端实例
ImClient client = ImClient.getInstance(appId, userId, key);
// 导入帐号
AccountImportRequest request = new AccountImportRequest("doocs");
request.setFaceUrl("https://avatars.githubusercontent.com/u/43716716?s=200&v=4");
request.setNick("Doocs Community");
try {
AccountImportResult result = client.account.accountImport(request);
// 结果处理
} catch (IOException e) {
// 异常捕捉处理
}
```
## 参与项目
我们非常欢迎各位开发者参与完善 SDK!
本项目,我们使用 `dev` 作为开发分支,如果你希望参与本项目,请参考以下步骤:
1. 将本项目 fork 到你的个人帐号下
2. 将 fork 后的项目 clone 到你本地项目
3. 创建一个新的分支,并添加你的变更
4. 将你的分支与我们上游最新代码保持同步
5. Commit 提交你的分支,注意 commit msg 的格式保持简洁明了
6. 将你的代码 Push 到你在第一步中 fork 下来的项目中
7. 创建一个 Pull Request,请求将你的代码合并到我们 dev 分支
更多详情,请参考 [CONTRIBUTING](./CONTRIBUTING.md) 文档指南。
## 许可证
Apache-2.0 许可证。
......@@ -20,7 +20,7 @@
implementation group: 'io.github.doocs', name: 'im-server-sdk-java', version: '0.2.10'
```
### 下载 jar
### 下载 JAR
[Maven 中央仓库](https://repo1.maven.org/maven2/io/github/doocs/im-server-sdk-java/)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment