2020-10-13 10:24:23 +02:00
|
|
|
TDLight Java [![Build Status](https://travis-ci.org/tdlight-team/tdlight-java-natives.svg?branch=master)](https://travis-ci.org/tdlight-team/tdlight-java-natives)
|
2020-08-20 12:18:04 +02:00
|
|
|
====================
|
2020-08-20 12:22:02 +02:00
|
|
|
|
|
|
|
A barebone java wrapper for TDLib (and TDLight)
|
|
|
|
|
2020-08-20 13:46:17 +02:00
|
|
|
This wrapper gives you direct access to TDLib API in Java.
|
2020-08-20 12:18:04 +02:00
|
|
|
|
|
|
|
## Requirements
|
2020-08-23 22:40:10 +02:00
|
|
|
JVM: Oracle JVM or OpenJDK
|
2020-08-20 12:18:04 +02:00
|
|
|
|
2020-08-20 14:52:39 +02:00
|
|
|
Java versions: Java 8, 9, 10, 11, 12, 13, 14, 15
|
2020-08-20 12:18:04 +02:00
|
|
|
|
2020-10-13 10:20:46 +02:00
|
|
|
Operating system: Linux, Windows, macOS
|
2020-08-20 12:18:04 +02:00
|
|
|
|
2020-10-13 10:20:46 +02:00
|
|
|
Supported CPU architectures: amd64 (linux, windows, macos), aarch64 (linux)
|
2020-08-20 12:18:04 +02:00
|
|
|
|
|
|
|
Required libraries for linux: OpenSSL and zlib
|
|
|
|
|
2020-08-20 17:05:50 +02:00
|
|
|
## Including TDLight Java in a project
|
|
|
|
|
|
|
|
There are two packages of TDLight:
|
2020-10-13 10:24:23 +02:00
|
|
|
- [TDLight](#For-TDLight-Java-with-optimized-TDLight), with our optimized fork of TDLib (Reccomended for bots)
|
|
|
|
- [TDLight with official TDLib](#For-TDLight-Java-with-official-TDLib) (Reccomended for GUI clients)
|
2020-08-20 17:05:50 +02:00
|
|
|
|
|
|
|
The two packages are compatible, but while TDLight is focused on long term resources usage and speed, TDLib is more focused on stability.
|
|
|
|
|
|
|
|
Choose one of the two different TDLight packages and then follow the guide below.
|
|
|
|
|
|
|
|
Replace `REPLACE_WITH_LATEST_VERSION` with the latest version of tdlight, you can find it on the **Releases** tab on github.
|
|
|
|
### For TDLight Java with optimized TDLight
|
|
|
|
#### Maven
|
2020-08-23 15:59:19 +02:00
|
|
|
Repository:
|
2020-08-20 12:18:04 +02:00
|
|
|
```xml
|
|
|
|
<repositories>
|
|
|
|
<repository>
|
2020-08-23 15:59:19 +02:00
|
|
|
<id>mchv</id>
|
|
|
|
<name>MCHV Apache Maven Packages</name>
|
|
|
|
<url>https://mvn.mchv.eu/repository/mchv/</url>
|
2020-08-20 12:18:04 +02:00
|
|
|
</repository>
|
|
|
|
</repositories>
|
2020-08-23 15:59:19 +02:00
|
|
|
```
|
|
|
|
Dependency:
|
|
|
|
```xml
|
|
|
|
<dependency>
|
|
|
|
<groupId>it.tdlight</groupId>
|
|
|
|
<artifactId>tdlight-java</artifactId>
|
|
|
|
<version>REPLACE_WITH_LATEST_VERSION</version>
|
|
|
|
</dependency>
|
2020-08-20 12:18:04 +02:00
|
|
|
```
|
2020-08-20 17:05:50 +02:00
|
|
|
#### Gradle
|
2020-08-20 12:18:04 +02:00
|
|
|
```groovy
|
|
|
|
repositories {
|
2020-08-23 15:59:19 +02:00
|
|
|
maven { url "https://mvn.mchv.eu/repository/mchv/" }
|
2020-08-20 12:18:04 +02:00
|
|
|
}
|
|
|
|
dependencies {
|
2020-08-20 12:49:49 +02:00
|
|
|
implementation 'it.tdlight:tdlight-java:REPLACE_WITH_LATEST_VERSION'
|
2020-08-20 12:18:04 +02:00
|
|
|
}
|
|
|
|
```
|
2020-08-20 17:05:50 +02:00
|
|
|
### For TDLight Java with official TDLib
|
|
|
|
#### Maven
|
2020-08-23 15:59:19 +02:00
|
|
|
Repository:
|
2020-08-20 17:05:50 +02:00
|
|
|
```xml
|
|
|
|
<repositories>
|
|
|
|
<repository>
|
2020-08-23 15:59:19 +02:00
|
|
|
<id>mchv</id>
|
|
|
|
<name>MCHV Apache Maven Packages</name>
|
|
|
|
<url>https://mvn.mchv.eu/repository/mchv/</url>
|
2020-08-20 17:05:50 +02:00
|
|
|
</repository>
|
|
|
|
</repositories>
|
2020-08-23 15:59:19 +02:00
|
|
|
```
|
|
|
|
Dependency:
|
|
|
|
```xml
|
|
|
|
<dependency>
|
|
|
|
<groupId>it.tdlight</groupId>
|
|
|
|
<artifactId>tdlib-java</artifactId>
|
|
|
|
<version>REPLACE_WITH_LATEST_VERSION</version>
|
|
|
|
</dependency>
|
2020-08-20 17:05:50 +02:00
|
|
|
```
|
|
|
|
#### Gradle
|
|
|
|
```groovy
|
|
|
|
repositories {
|
2020-08-23 15:59:19 +02:00
|
|
|
maven { url "https://mvn.mchv.eu/repository/mchv/" }
|
2020-08-20 17:05:50 +02:00
|
|
|
}
|
|
|
|
dependencies {
|
2020-08-20 17:10:36 +02:00
|
|
|
implementation 'it.tdlight:tdlib-java:REPLACE_WITH_LATEST_VERSION'
|
2020-08-20 17:05:50 +02:00
|
|
|
}
|
|
|
|
```
|
2020-08-20 12:18:04 +02:00
|
|
|
|
|
|
|
## Usage
|
|
|
|
Simple initialization of a native TDLib client
|
|
|
|
```java
|
2020-10-13 02:02:24 +02:00
|
|
|
package it.tdlight.example;
|
2020-10-11 16:27:57 +02:00
|
|
|
|
2020-10-13 02:02:24 +02:00
|
|
|
import it.tdlight.common.TelegramClient;
|
|
|
|
import it.tdlight.tdlight.ClientManager;
|
2020-10-11 16:27:57 +02:00
|
|
|
import it.tdlight.common.Init;
|
|
|
|
import it.tdlight.common.Log;
|
2020-10-13 02:02:24 +02:00
|
|
|
import it.tdlight.common.TDLibException;
|
|
|
|
|
|
|
|
import it.tdlight.jni.TdApi;
|
2020-08-20 12:18:04 +02:00
|
|
|
|
|
|
|
public class Example {
|
|
|
|
public static void main(String[] args) {
|
|
|
|
// Initialize TDLight native libraries
|
|
|
|
Init.start();
|
|
|
|
|
2020-10-13 02:02:24 +02:00
|
|
|
// Create a client
|
|
|
|
TelegramClient client = ClientManager.create(Example::onUpdate, Example::onUpdateError, Example::onError);
|
|
|
|
|
|
|
|
// Here you can use the client.
|
2020-08-20 12:18:04 +02:00
|
|
|
|
2020-10-13 02:02:24 +02:00
|
|
|
// Documentation of tdlib methods can be found here:
|
|
|
|
// https://tdlight-team.github.io/tdlight-docs
|
|
|
|
|
|
|
|
// A similar example on how to use tdlib can be found here:
|
|
|
|
// https://github.com/tdlib/td/blob/master/example/java/org/drinkless/tdlib/example/Example.java
|
|
|
|
}
|
|
|
|
|
|
|
|
private static void onUpdate(TdApi.Object object) {
|
|
|
|
TdApi.Update update = (TdApi.Update) object;
|
|
|
|
System.out.println("Received update: " + update);
|
|
|
|
}
|
|
|
|
|
|
|
|
private static void onUpdateError(Throwable exception) {
|
|
|
|
if (exception instanceof TDLibException) {
|
|
|
|
String errorMessage = ((TDLibException) exception).getErrorMessage();
|
|
|
|
System.out.println("Received an error from updates: " + errorMessage);
|
|
|
|
} else {
|
|
|
|
System.out.println("Received an error from updates:");
|
|
|
|
exception.printStackTrace();
|
|
|
|
}
|
|
|
|
}
|
2020-08-20 12:18:04 +02:00
|
|
|
|
2020-10-13 02:02:24 +02:00
|
|
|
private static void onError(Throwable exception) {
|
|
|
|
if (exception instanceof TDLibException) {
|
|
|
|
String errorMessage = ((TDLibException) exception).getErrorMessage();
|
|
|
|
System.out.println("Received an error: " + errorMessage);
|
|
|
|
} else {
|
|
|
|
System.out.println("Received an error:");
|
|
|
|
exception.printStackTrace();
|
|
|
|
}
|
2020-08-20 12:18:04 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
2020-08-20 13:46:17 +02:00
|
|
|
### TDLib methods documentation
|
2020-08-20 22:03:59 +02:00
|
|
|
[TdApi class javadoc](https://tdlight-team.github.io/tdlight-docs)
|
2020-08-20 13:46:17 +02:00
|
|
|
|
2020-08-28 21:38:49 +02:00
|
|
|
### TDLight extended features
|
|
|
|
TDLight Java with TDLight has some extended features, that you can see on the [TDLight official repository](https://github.com/tdlight-team/tdlight).
|
|
|
|
|
|
|
|
This features are present only if you use the optimized TDLight package.
|
|
|
|
|
2020-08-20 12:18:04 +02:00
|
|
|
## About
|
2020-08-20 22:03:59 +02:00
|
|
|
### License
|
2020-08-20 13:35:14 +02:00
|
|
|
TDLight is licensed by Andrea Cavalli <andrea@cavallium.it> under the terms of the GNU Lesser General Public License 3
|
2020-08-20 12:18:04 +02:00
|
|
|
|
2020-08-20 13:35:14 +02:00
|
|
|
### Libraries licenses
|
2020-08-20 12:18:04 +02:00
|
|
|
|
2020-08-20 13:35:14 +02:00
|
|
|
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
|
|
|
|
|
2020-08-20 17:10:36 +02:00
|
|
|
Zlib is licensed under the terms of Zlib license
|