Comment on page
Android Development

IC4J Agent library can be also used for development of native Android application written in Java or Kotlin. Use Android Studio to start a new Android application or add support for the Internet Computer to your existing application.
To add required IC4J libraries to your Android project open gradle.build file and add dependencies:
implementation 'commons-codec:commons-codec:1.15'
implementation 'org.ic4j:ic4j-candid:0.6.19.5'
// https://mvnrepository.com/artifact/org.bouncycastle/bcprov-jdk15on
implementation 'org.bouncycastle:bcprov-jdk15on:1.70'
// https://mvnrepository.com/artifact/org.bouncycastle/bcpkix-jdk15on
implementation 'org.bouncycastle:bcpkix-jdk15on:1.70'
implementation('org.ic4j:ic4j-agent:0.6.19.6') {
       exclude group: 'org.apache.httpcomponents.client5', module: 'httpclient5'
 }
 implementation 'org.slf4j:slf4j-api:2.0.6'
Android application preferably uses OkHttp HTTP client so Apache HTTP 5 library can be excluded.
To be able to connect to the Internet Computer Canister set uses-permission in project AndroidManifest.xml descriptor.
<uses-permission android:name="android.permission.INTERNET"/>
Use IC4J with Kotlin
​AndroidHelloWord sample application demonstrates use or QueryBuilder and UpdateBuilder in Kotlin Android project. Project properties ic.location and ic.canister are stored in strings.xml file.
​MainActivity.kt has a simple code for QUERY and UPDATE invocation of the Canister code main.mo.
main.mo
actor {
    stable var name = "Me";
​
    public func greet(value : Text) : async Text {
        name := value;
        return "Hello, " # name # "!";
    };
​
    public shared query func peek() : async Text {
        return name;
    };
};
Using QueryBuilder in Kotlin.
MainActivity.kt
val url: String = getString(R.string.url)
val canister: String = getString(R.string.canister)
​
val identity: Identity = AnonymousIdentity()
val transport: ReplicaTransport =
                ReplicaOkHttpTransport.create(url)
​
val agent: Agent = AgentBuilder().identity(identity).transport(transport).build()
val buf = IDLArgs.create(ArrayList<IDLValue>()).toBytes()
val principal = Principal.fromString(canister);
​
val response = QueryBuilder.create(
                        agent,
                        principal,
                        "peek"
           ).arg(buf).call()
​
val output = response.get()
val outArgs = IDLArgs.fromBytes(output)
name = outArgs.args[0].getValue<String>()
Using UpdateBuilder in Kotlin.
MainActivity.kt
val url : String = getString(R.string.url)
val canister : String = getString(R.string.canister)
​
val identity : Identity = AnonymousIdentity()
val transport: ReplicaTransport =
                ReplicaOkHttpTransport.create(url)
val agent: Agent = AgentBuilder().identity(identity).transport(transport).build()
​
val arg : IDLValue = IDLValue.create(message)
var args : ArrayList<IDLValue> = ArrayList<IDLValue>()
args.add(arg)
val buf = IDLArgs.create(args).toBytes()
​
val response = UpdateBuilder.create(
                        agent,
                        Principal.fromString(canister),
                        "greet"
            ).arg(buf).callAndWait(Waiter.create(60, 5))
​
val output = response.get()
val outArgs = IDLArgs.fromBytes(output)
val outputMessage = outArgs.args[0].getValue<String>()
JDBC Serializer
Last modified 2mo ago