Skip to content

Latest commit

 

History

History
 
 

android

README.md

Generation of Tonlib libraries for Android OS

Tl;dr Download the latest version of Tonlib libraries for Android from TON release page or check the artifacts from Android JNI GitHub action.

Compile Tonlib for Android manually

Prerequisite: installed Java and set environment variable JAVA_HOME.

git clone --recursive https://github.com/ton-blockchain/ton.git
cd ton
wget https://dl.google.com/android/repository/android-ndk-r25b-linux.zip
unzip android-ndk-r25b-linux.zip
export JAVA_AWT_LIBRARY=NotNeeded
export JAVA_JVM_LIBRARY=NotNeeded
export JAVA_INCLUDE_PATH=${JAVA_HOME}/include
export JAVA_AWT_INCLUDE_PATH=${JAVA_HOME}/include
export JAVA_INCLUDE_PATH2=${JAVA_HOME}/include/linux

export ANDROID_NDK_ROOT=$(pwd)/android-ndk-r25b
export OPENSSL_DIR=$(pwd)/example/android/third_party/crypto

rm -rf example/android/src/drinkless/org/ton/TonApi.java
cd example/android/
cmake -GNinja -DTON_ONLY_TONLIB=ON . 
ninja prepare_cross_compiling
rm CMakeCache.txt
./build-all.sh

Generation of Tonlib libraries for iOS in Xcode

  1. Clone repository https://github.com/labraburn/tonlib-xcframework
  2. Open repository directory in Terminal
  3. Run command:
swift run builder --output ./build --clean
  1. Run command:
echo ./build/TON.xcframework/* | xargs -n 1 cp -R ./Resources/Headers
  1. Import OpenSSL.xcframework and TON.xcframework in XCode in section "Frameworks, Libraries, and Embedded Content"
  2. Now you can start using Tonlib client by importing it in C or Objective-C source files:
#import <tonlib/tonlib_client_json.h>

Generation of Tonlib libraries for Desktop applications

You can use Tonlib compiled in an ordinary way for desktop applications. If you use Java you can load the library using JNA.

The latest Tonlib library can be found among other TON artifacts either on TON release page or inside the appropriate GitHub action.