You are on page 1of 3

ITTIA DB SQL for Android

------------------------
Installation
------------
Install the Android SDK and configure Eclipse for Android application
development.
To install ITTIA DB SQL for Android and the example project in Eclipse:
1. From the menu, use File -> Import...
2. Select "Existing Projects into Workspace" in the General category.
3. Choose "Select archive file:" and "Browse...", then locate the ITTIA DB SQL
Android SDK zip archive.
4. With the "ittiadb" and "ittiadb-api-example" projects checked, click Finish.
5. With the ittiadb-api-example project selected, use Project -> Properties
from the menu.
6. In the "Android" section, verify that the ittiadb project is is referenced.
Running the Examples
--------------------
To run the ITTIA Note Pade example, a variation on the Note Pad sample from the
Android SDK:
1. With the IttiaNotesList project selected, use Run -> Debug from the
menu.
2. Choose "Android Application" and click OK.
3. Use the Menu button to add a note.
The ittiadb-api-example is a low-level demonstration of the platform-
independent ITTIA DB SQL API for Java.
To run the default example activity:
1. With the ittiadb-api-example project selected, use Run -> Debug from the
menu.
2. Choose "Android Application" and click OK.
3. Open the Debug perspective, and view the LogCat window for messages tagged
"System.out".
To run another example activity:
1. Run -> Debug Configurations...
2. Under the Android tab, select Launch: and choose an activity from the
drop-down list.
3. Click the Debug button.
Using ITTIA DB SQL
------------------
To add ITTIA DB SQL to an existing Android application:
1. With the application project selected, use Project -> Properties
2. In the Android section, click Add...
3. Select the ittiadb project and click OK.
4. In the application source code, load the ITTIA DB SQL native libary before
using any ITTIA DB functionality:
System.loadLibrary("ittiajni");
The ITTIA DB SQL API for Android is in the android.database.ittiadb package. A
platform-independent ITTIA DB SQL API for Java is in the com.ittia.db package.
Documentation for these APIs is available from index.html in the doc folder of
the ittiadb project.
For SQL syntax, consult the ITTIA DB SQL User's Guide, available from
users-guide.html or users-guide.pdf in the doc folder of the ittiadb project.
ITTIA DB Utilities for Android
------------------------------
The following utility for Android is located in the tools/armeabi folder:
- ittiasql
This utility should be used for development and should not be packaged with an
application.
The adb tool provided in the Android SDK can be used to run the utility, as
follows:
adb push tools/armeabi/ittiasql /data/ittiasql
adb shell chmod 777 /data/ittiasql
adb shell
/data/ittiasql
OpenSSL Plugin
--------------
The OpenSSL Plugin for ITTIA DB SQL is bundled with OpenSSL libraries. Please
read LICENSE.OpenSSL before distributing these libraries. If installed, these
libraries are subject to the following notices:
Copyright (c) 1998-2011 The OpenSSL Project. All rights reserved.
This product includes software developed by the OpenSSL Project for use in the
OpenSSL Toolkit (http://www.openssl.org/)
This product includes cryptographic software written by Eric Young
(eay@cryptsoft.com). This product includes software written by Tim
Hudson (tjh@cryptsoft.com).