Using Ice on Android for Ice 3.7.7
This page provides important information for users of the Ice for Java distribution.
On this page:
Overview of Ice on Android
Ice is available for Android through the Ice for Java distribution. To develop an Ice application for Android you will need the following components:
- Binary distribution of Ice for your development platform (Linux, macOS, Windows)
- Android Studio
- Ice Builder for Gradle
You can use either the Java or the Java Compat mapping in your Android project. Note however that the Java mapping uses Java 8 language features and currently requires the Java 8 toolchain provided in Android Studio 3.
Configuring an Android Studio project
Android Studio uses a Gradle-based build system. Using Ice requires modifying your project's build.gradle settings file(s) to include the Ice JAR files. For convenience we recommend using the Ice Builder for Gradle plug-in to help automate the compilation of your Slice files.
The following snippets give an example of configuring the Ice and Ice Builder for Gradle sections for an Android project.
plugins {
id "com.zeroc.gradle.ice-builder.slice" version "1.4.7"
}
apply plugin: 'com.android.application'
android {
...
}
dependencies {
implementation 'com.zeroc:ice:3.7.4'
...
}
Using the Sample Programs
Sample programs are available at the ice-demos GitHub repository. You can browse this repository to see build and usage instructions for all supported programming languages. Simply clone this repository:
git clone -b 3.7 https://github.com/zeroc-ice/ice-demos.git cd ice-demos
You can then import the directory java/android or java-compat/android into Android Studio.
