android-libtdjson

Prebuilt libtdjson for Android

Version tag is same as the version of tdlib

Releases

• libs.tar.gz: .so files without jni
• jniLibs.tar.gz: .so files with jni

Packages

• maven

Supported architectures

Platform	Architecture
Android	armeabi-v7a	✅
	arm64-v8a	✅
Android emulator	x86	✅
	x86_64	✅

Installation

Method 1: Download jniLibs

• Download jniLibs.tar.gz (from Releases) and extract it to your ./app/src/main/jniLibs/
• Copy ./app/src/main/java/io/github/up9cloud/td/JsonClient.java to your repo

TODO: Method 2: Download .jar

• Download .jar file (from Packages) to your ./app/libs/

• Be sure "*.jar" is the part of dependencies in your build.gradle file

  dependencies {
      implementation fileTree(dir: "libs", include: ["*.jar"])
  }

Method 3: Github Maven

• Add those to your build.gradle file

  repositories {
      google()
      ...
      maven {
          name = "GitHubPackages"
          url = uri("https://maven.pkg.github.com/up9cloud/android-libtdjson")
          credentials {
              username = System.getenv("GITHUB_ACTOR")
              password = System.getenv("GITHUB_TOKEN")
          }
      }
  }
  dependencies {
      // Modify the version, see release
      implementation 'io.github.up9cloud:td:<version>'
  }

• Setup ENVs

  export GITHUB_ACTOR=<your github account>
  export GITHUB_TOKEN=<your github personal access token>

Other refs:

• GitHub Docs - Gradle registry
• enefce/AndroidLibraryForGitHubPackagesDemo

Usage

TODO

Example

TODO

Dev memo

Bump the version of tdlib

• Modify the version for git checkout in ./prepare.sh
• Modify the getVersionName function in ./app/build.gradle
• Git commit (message example: bump td to vx.x.x)
• Git add tag (git tag vx.x.x, the tag version should be same as the version of tdlib)
• Push with tags (git push && git push --tags)
• Wait for CI task

Build on local, see .github/workflows/main.yml also

$ docker run --rm -it -v `pwd`:/app sstc/android-ndk /bin/bash

# ./build.sh

Cleanup generated .so files for strip testing

rm -fr \
    ./build/jni/**/*.so \
    ./build/jni/**/td/*.so \
    ./build/td/**/*.so \
    ./jniLibs \
    ./libs

./build.sh

• .travis.yml: Travis CI has build time limitation (1 hour), and building this lib needs much more than it, so can't build on it.

License

MIT

• TDLib license, see td