Skip to content

Latest commit

 

History

History
 
 

Android

README.md

Overview

This directory contains the following Android examples:

  • chat

    A client for the ZeroC chat application.

  • hello

    An app that shows how to invoke ordinary (twoway) and oneway operations, as well as how to use datagrams, secure invocations, and batched invocations.

  • library

    A front-end for remotely querying and manipulating a relational database implemented using JDBC.

  • talk

    An app that allows two devices to talk via Bluetooth.

Please review the build instructions below prior to opening the project.

Build Instructions

This Android Studio project uses Gradle for its build system.

Prerequisites

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 1.2.1
  • Android SDK Build-tools 21.1.1

Ice requires at minimum API level 17:

  • Android 4.2.2 (API17)

If you want to target a later version of the Android API level, edit gradle.properties and change the following variables:

ice_compileSdkVersion
ice_minSdkVersion
ice_targetSdkVersion

Ice Development Kit

An Ice Development Kit is also required. Specifically, this project needs the Ice JAR files along with the Slice to Java translator. The Gradle build system will automatically search for your Ice Development Kit in the default installation directories used by our binary distributions. If you've installed Ice into a non-standard directory, or you're using a repository build, edit gradle.properties and set the following variable:

iceHome=<path to your Ice installation>

This path name must only use forward slashes, even on Windows.

Building the Project

Follow these steps to import the project into Android Studio:

  1. Start Android Studio
  2. Select Open Project
  3. Navigate to the "Android" subdirectory
  4. If presented with an "Import Project from Gradle" dialog, select "Use default gradle wrapper" and press OK
  5. Select one of the subprojects from the drop down menu