Interactive Ink SDK makes it easy to get started. This page helps you set up a development environment, get a certificate and play with provided example applications.
To develop with iink SDK for Android, you will need:
- Android Studio 2.3.3 and higher
- Android SDK API 26 and higher (even if the libraries runs with Android SDK API 21 and higher)
MyScript iink SDK comes with example applications illustrating how to use key APIs.
The code is available on GitHub.
A reference implementation for the platform-specific integration layer can be found alongside the examples. It covers aspects such as rendering that the low-level iink SDK does not provide out-of-the-box for flexibility and portability reasons.
The source code of both the examples and the reference implementation is released under the Apache 2.0 license. You can reuse it into your own projects without any particular restriction.
A certificate is a binary “key” provided by MyScript that is required to enable iink SDK in an application:
- If you have just registered with MyScript Developer Portal, you should have received a certificate by mail that will let you run the provided get started example.
- If not - or to activate iink SDK with your own applications - please follow the on-device license management instructions.
The certificate comes embedded in a source file that you should include in your project:
- MyScript-provided examples expect it to be located at a specific location (see instructions below).
- For your own application, you can place it where you want, provided that it is accessible to instantiate the iink runtime.
More details on certificates and license management can be found in the dedicated support section.
The Get started example is the easiest way for a first contact with iink SDK APIs.
To run it, just follow the following instructions:
Step 1: Clone the MyScript Git repository containing the examples for the Android platform and navigate to the root of the folder containing the applications:
git clone https://github.com/MyScript/interactive-ink-examples-android.git cd interactive-ink-examples-android
Step 2: Replace the
MyCertificate.java file in the
GetStarted/src/main/java/com/myscript/certificate directory with your
Step 3: Open the
interactive-ink-examples-android directory as an existing Android Studio project. The Gradle dependencies should be grabbed and the
project should compile with success.
Step 4: Run the
To guide you through the fundamentals of Interactive Ink SDK, let’s imagine that you want to build a (very) simple handwriting calculator. This guide explains some key concepts and provide you with the code portions that are relevant for a simple iink SDK integration.
For the sake of this example, such an application would provide the end user with:
- a writing area to write computations,
- buttons to undo, redo, and clear the canvas,
- a validation button to convert content to typeset form and do the calculation,
- a history of the past calculations,
- persistence across sessions,
- some custom styling over what iink SDK provides by default.
The guide consists of the following steps:
- Interactive Ink runtime
- Import and export
- Zooming and scrolling
Ready? Let’s start!