History

levlam 68b2d10fdb Add td_api::phoneNumberAuthenticationSettings and support automatic code retrival from SMS on Android. GitOrigin-RevId: f97bd5bf3eb7449da1b14242fa47537801657b04		2019-05-03 05:44:59 +03:00
..
org/drinkless/tdlib	Add td_api::phoneNumberAuthenticationSettings and support automatic code retrival from SMS on Android.	2019-05-03 05:44:59 +03:00
.gitignore	Add Java example.	2018-01-28 13:58:33 +03:00
CMakeLists.txt	Better CMake variable expansion usage in if.	2019-04-04 22:23:06 +03:00
README.md	Deprecate Log class in Java example.	2019-03-06 22:19:45 +03:00
td_jni.cpp	Update copyright year.	2019-01-01 01:02:34 +03:00

README.md

TDLib Java example

To run this example, you will need installed JDK >= 1.6. For Javadoc documentation generation PHP is needed.

TDLib should be prebuilt for using with Java and installed to local subdirectory td/ as follows:

cd <path to TDLib sources>
mkdir jnibuild
cd jnibuild
cmake -DCMAKE_BUILD_TYPE=Release -DTD_ENABLE_JNI=ON -DCMAKE_INSTALL_PREFIX:PATH=../example/java/td ..
cmake --build . --target install

If you want to compile TDLib for 64-bit Java on Windows using MSVC, you will also need to add -A x64 option to CMake.

In Windows, use Vcpkg toolchain file by adding parameter -DCMAKE_TOOLCHAIN_FILE=<VCPKG_DIR>/scripts/buildsystems/vcpkg.cmake

Then you can build this example:

cd <path to TDLib sources>/example/java
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DTd_DIR=<full path to TDLib sources>/example/java/td/lib/cmake/Td -DCMAKE_INSTALL_PREFIX:PATH=.. ..
cmake --build . --target install

Compiled TDLib shared library and Java example after that will be placed in bin/ and Javadoc documentation in docs/.

Now you can run Java example:

cd <path to TDLib sources>/example/java/bin
java '-Djava.library.path=.' org/drinkless/tdlib/example/Example

If you get "Could NOT find JNI ..." error from CMake, you need to specify to CMake path to the installed JDK, for example, "-DJAVA_HOME=/usr/lib/jvm/java-8-oracle/".

If you get java.lang.UnsatisfiedLinkError with "Can't find dependent libraries", you may also need to copy some dependent shared OpenSSL and zlib libraries to bin/.

In case you compiled the example as 32-bit version, you may need to give -d32 parameter to Java.