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

up9cloud/android-libtdjson