Using Ice on Android
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.
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.5.0" } apply plugin: 'com.android.application' android { ... } dependencies { implementation 'com.zeroc:ice:3.7.10' ... }
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.