History

levlam 02a096fcbe Update Android command line tools version.		2024-05-13 15:58:03 +03:00
..
.gitignore	Add .gitignore for Android example.	2022-08-12 10:34:14 +03:00
AddIntDef.php	Android example: improve AddIntDef.php.	2022-08-14 16:26:40 +03:00
build-openssl.sh	Update default OpenSSL versions in examples.	2023-03-26 22:36:09 +03:00
build-tdlib.sh	Android example: avoid usage of case, which doesn't seem to work in outdated default bash on macOS.	2022-08-15 10:33:15 +03:00
check-environment.sh	Exit check-environment script if make installation is unsupported.	2023-04-25 19:55:44 +03:00
CMakeLists.txt	Allow to specify custom path for prebuilt Android OpenSSL.	2022-08-13 10:31:41 +03:00
Dockerfile	Update default OpenSSL versions in examples.	2023-03-26 22:36:09 +03:00
fetch-sdk.sh	Update Android command line tools version.	2024-05-13 15:58:03 +03:00
README.md	Improve README wording.	2024-02-27 00:40:47 +03:00

README.md

TDLib Android example

This is an example of building TDLib for Android. You need a Bash shell on Linux, macOS, or Windows with some common tools, a C++ compiler, JDK, PHP, perl, and gperf pre-installed.

Building TDLib for Android

Run the script ./check-environment.sh to check that you have all required Unix tools and Java utilities. If the script exits with an error message, install the missing tool.
Run the script ./fetch-sdk.sh to download Android SDK to a local directory.
Run the script ./build-openssl.sh to download and build OpenSSL for Android.
Run the script ./build-tdlib.sh to build TDLib for Android.
The built libraries are now located in the tdlib/libs directory, corresponding Java code is located in the tdlib/java directory, and standalone Java documentation can be found in the tdlib/javadoc directory. You can also use archives tdlib/tdlib.zip and tdlib/tdlib-debug.zip, which contain all aforementioned data.

If you already have installed Android SDK and NDK, you can skip the second step and specify existing Android SDK root path and Android NDK version as the first and the second parameters to the subsequent scripts. Make sure that the SDK includes android-33 platform and CMake 3.22.1.

If you already have prebuilt OpenSSL, you can skip the third step and specify path to the prebuild OpenSSL as the third parameter to the script ./build-tdlib.sh.

If you want to update TDLib to a newer version, you need to run only the script ./build-tdlib.sh.

You can specify different OpenSSL version as the fourth parameter to the script ./build-openssl.sh. By default OpenSSL 1.1.1 is used because of much smaller binary footprint and better performance than newer OpenSSL versions.

You can build TDLib against shared standard C++ library by specifying "c++_shared" as the fourth parameter to the script ./build-tdlib.sh. This can reduce total application size if you have a lot of other C++ code and want it to use the same shared library.

Alternatively, you can use Docker to build TDLib for Android. Use docker build --output tdlib . to build the latest TDLib commit from Github, or docker build --build-arg COMMIT_HASH=<commit-hash> --output tdlib . to build specific commit. The output archives will be placed in the directory "tdlib" as specified.