java

Java Demos

Overview

This directory contains Java sample programs for various Ice components. These examples are provided to get you started on using a particular Ice feature or coding technique.

Most of the subdirectories here correspond directly to Ice components, such as IceGrid, Glacier2, and so on. We've also included the following additional subdirectories:

• android contains examples of Android applications.

• Manual contains complete examples for some of the code snippets in the Ice manual.

• Chat contains a GUI client for the ZeroC Chat Demo.

Refer to the C++11 demos for more examples that use the Ice services (Glacier2, IceGrid, IceStorm).

Build Instructions

The build system for the Java sample programs uses Gradle and includes a wrapper script or batch file that automatically downloads Gradle and all other required components.

Building the Demos on Windows

We recommending installing the Ice MSI, which includes the Slice-to-Java compiler.

To build the demos, open a command window and run:

gradlew build

The default build assumes the Slice-to-Java compiler is installed in a standard location. The build also downloads the Ice JAR files from Maven Central.

If you've built the Slice-to-Java compiler and Ice for Java in a source tree, you'll need to pass some additional options to Gradle:

gradlew -PiceHome=<path to source tree> -PcppConfiguration=<Release|Debug> \
    -PcppPlatform=<Win32|x64> build

Building the Demos on Linux and macOS

We recommending installing the binary distribution for your platform, which includes the Slice-to-Java compiler.

To build the demos, open a command window and run:

gradlew build

The default build assumes the Slice-to-Java compiler is installed in a standard location. The build also downloads the Ice JAR files from Maven Central if your distribution did not include them.

If you've built the Slice-to-Java compiler and Ice for Java in a source tree, you'll need to pass an additional option to Gradle:

gradlew -PiceHome=<path to source tree> build

Building the Demos for Android

This Android Studio project uses Gradle for its build system.

Android Development Tools

Building any Ice application for Android requires Android Studio and the Android SDK build tools. We tested with the following components:

• Android Studio Chipmunk
• Android SDK 30

Ice for Java requires at minimum API level 24:

• Android Nougat 7.0 (API24)

If you want to target a different version of the Android API level, edit the project settings in Android Studio.

Slice-to-Java Compiler and Ice JAR Files

The build assumes the Slice-to-Java compiler is installed in a standard location. The build also downloads the Ice JAR files from Maven Central.

If you've built the Slice-to-Java compiler and Ice for Java in a source tree, you need to edit gradle.properties and make iceHome point to your source tree.

Building the Android Project

Follow these steps to open the project in Android Studio:

1. Start Android Studio
2. Select "Open an existing Android Studio project"
3. Navigate to and select the "android" subdirectory
4. Click OK and wait for the project to open and build
5. Select one of the subprojects from the drop down menu

Running the Demos

Refer to the README.md file in each demo directory for usage instructions.