175 lines
5.4 KiB
Markdown
175 lines
5.4 KiB
Markdown
<div style="text-align: center" align="center">
|
|
<a href="https://github.com/tdlight-team/tdlight-java"><img src="./.media/tdlight-logo.png" alt="TDLight logo" style="width: 5rem; height: 5rem"></a>
|
|
<h1>TDLight Java</h1>
|
|
<p>Complete Bot and Userbot Telegram library written in Java, based on <a href="https://github.com/tdlib/td">TDLib</a></p>
|
|
<a href="https://travis-ci.com/tdlight-team/tdlight-java-natives">
|
|
<img alt="Java CI" src="https://img.shields.io/github/workflow/status/tdlight-team/tdlight-java/Maven%20Package?style=flat-square)"></a>
|
|
<a href="https://github.com/tdlight-team/tdlight-java/releases">
|
|
<img alt="Release" src="https://img.shields.io/github/v/release/tdlight-team/tdlight-java.svg?include_prereleases&style=flat-square)">
|
|
</a>
|
|
<a href="https://www.ej-technologies.com/products/jprofiler/overview.html">
|
|
<img alt="JProfiler" src="https://local.cavallium.it/mirrors/jprofiler-logo/jprofiler-logo-badge.svg">
|
|
</a>
|
|
</div>
|
|
<br>
|
|
|
|
## 💻 Supported platforms
|
|
|
|
**Java versions**: from Java 17 to Java 19+ (Legacy Java 8+ support with `tdlight-java-8`)
|
|
|
|
**Operating systems**: Linux, Windows, MacOS
|
|
|
|
**CPU architectures**:
|
|
|
|
- i386/x86 (Linux, Windows)
|
|
- amd64/x86_64 (Linux, Windows, OSX)
|
|
- armhf/armv7 (Linux)
|
|
- aarch64/armv8/arm64 (Linux)
|
|
- s390x (Linux)
|
|
- ppc64el/ppc64le (Linux)
|
|
|
|
## 📚 Required libraries
|
|
- **Linux: OpenSSL, zlib**
|
|
- **MacOS: OpenSSL**
|
|
- **Windows: [Microsoft Visual C++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe)**
|
|
|
|
### Install OpenSSL on macOS
|
|
|
|
You must install `openssl@3` using the <a href="https://brew.sh">brew package manager </a>, then link openssl
|
|
to `/usr/local/opt/openssl`
|
|
|
|
If you don't know how to do this, type the following commands in your terminal:
|
|
|
|
```bash
|
|
brew install openssl@3
|
|
ln -sf /usr/local/Cellar/openssl@3/3.0.0 /usr/local/opt/openssl
|
|
```
|
|
|
|
## 📚 How to use the library
|
|
|
|
### Setting up the library using Maven
|
|
|
|
If you are using Maven, edit your `pom.xml` file as below:
|
|
|
|
```xml
|
|
|
|
<project>
|
|
<repositories>
|
|
|
|
<!-- Add the following repository -->
|
|
<repository>
|
|
<id>mchv</id>
|
|
<name>MCHV Apache Maven Packages</name>
|
|
<url>https://mvn.mchv.eu/repository/mchv/</url>
|
|
</repository>
|
|
|
|
</repositories>
|
|
|
|
<dependencyManagement>
|
|
<dependencies>
|
|
|
|
<!-- Add the following dependency -->
|
|
<dependency>
|
|
<groupId>it.tdlight</groupId>
|
|
<artifactId>tdlight-java-bom</artifactId>
|
|
<version>VERSION</version>
|
|
<type>pom</type>
|
|
<scope>import</scope>
|
|
</dependency>
|
|
</dependencies>
|
|
</dependencyManagement>
|
|
|
|
<dependencies>
|
|
|
|
<!-- Add the following dependencies -->
|
|
<dependency>
|
|
<groupId>it.tdlight</groupId>
|
|
<artifactId>tdlight-java</artifactId> <!-- Use tdlight-java-8 if you are using java 8 to 16 -->
|
|
<!-- don't specify the version here -->
|
|
</dependency>
|
|
<dependency>
|
|
<groupId>it.tdlight</groupId>
|
|
<artifactId>tdlight-natives-linux-amd64</artifactId>
|
|
<!-- don't specify the version here -->
|
|
</dependency>
|
|
<!-- Include other native versions that you want, for example for windows, osx, ... -->
|
|
|
|
</dependencies>
|
|
</project>
|
|
```
|
|
|
|
Replace `VERSION` with the latest release version, you can find
|
|
it [here](https://github.com/tdlight-team/tdlight-java/releases).
|
|
|
|
## Setting up the library using Gradle
|
|
|
|
If you are using Gradle, add the following lines into your `build.gradle` file
|
|
|
|
```groovy
|
|
repositories {
|
|
maven { url "https://mvn.mchv.eu/repository/mchv/" }
|
|
}
|
|
dependencies {
|
|
// import the BOM
|
|
implementation platform('it.tdlight:tdlight-java-bom:VERSION')
|
|
|
|
// do not specify the versions on the dependencies below!
|
|
implementation 'it.tdlight:tdlight-java' // Use tdlight-java-8 if you are using java 8 to 16
|
|
implementation 'it.tdlight:tdlight-natives-linux-amd64'
|
|
// Include other native versions that you want, for example for windows, osx, ...
|
|
}
|
|
```
|
|
|
|
Replace `VERSION` with the latest release version, you can find
|
|
it [here](https://github.com/tdlight-team/tdlight-java/releases).
|
|
|
|
## âš’ Native dependencies
|
|
|
|
To use TDLight Java you need to include one or more native dependencies:
|
|
|
|
- `tdlight-natives-linux-amd64`
|
|
- `tdlight-natives-linux-aarch64`
|
|
- `tdlight-natives-linux-x86`
|
|
- `tdlight-natives-linux-armhf`
|
|
- `tdlight-natives-linux-ppc64le`
|
|
- `tdlight-natives-linux-s390x`
|
|
- `tdlight-natives-windows-amd64`
|
|
- `tdlight-natives-osx-amd64`
|
|
|
|
## Usage
|
|
|
|
An example on how to use TDLight Java can be found
|
|
here: [Example.java](https://github.com/tdlight-team/tdlight-java/blob/master/example/src/main/java/it/tdlight/example/Example.java)
|
|
|
|
### Advanced usage
|
|
|
|
If you want to disable the automatic runtime shutdown hook, you should set the property `it.tdlight.enableShutdownHooks`
|
|
to `false`
|
|
|
|
### TDLight methods documentation
|
|
|
|
[TdApi JavaDoc](https://tdlight-team.github.io/tdlight-docs)
|
|
|
|
### TDLight extended features
|
|
|
|
TDLight has some extended features compared to TDLib, that you can see on
|
|
the [TDLight official repository](https://github.com/tdlight-team/tdlight#tdlight-extra-features).
|
|
|
|
## About
|
|
|
|
### **License**
|
|
|
|
TDLight is licensed by Andrea Cavalli <andrea@cavallium.it> under the terms of the GNU Lesser General Public License 3
|
|
|
|
### **Libraries licenses**
|
|
|
|
JTDLib is licensed by Ernesto Castellotti <erny.castell@gmail.com> under the terms of the GNU Lesser General Public
|
|
License 3
|
|
|
|
TDLib is licensed by Aliaksei Levin <levlam@telegram.org> and Arseny Smirnov <arseny30@gmail.com> under the terms of the
|
|
Boost Software License
|
|
|
|
OpenSSL is licensed under the terms of Apache License v2
|
|
|
|
Zlib is licensed under the terms of Zlib license
|