Installation

This section describes some basic installation procedures.

Downloading the SDK and Sample Apps

Current versions of the SDK are available at http://jabberdeveloper.com. You will need to login with your Cisco credentials to access and download the SDK.

Unpacking the SDK and Sample Apps

The SDK currently comes as a zip archive.  After download, extract the contents of the SDK into its own named directory.  For example, on Windows systems this might be C:\SDK\jabber-guest-sdk-for-android-0.0.95\ while on OS X systems it could be /Developer/SDK/jabber-guest-sdk-for-android-0.0.50/.

Including the SDK and Sample Apps

Pre-requisites

  1. Install the ADT Plugin for Eclipse
  2. Install the Android SDK

Eclipse

To start with the Jabber Guest SDK in Eclipse, it must first be imported as a project library. To import the SDK project and all the sample applications follow these steps:

  1. Select File > Import and then, from the import source dialog, select Android > Existing Android Code into Workspace.
  2. Click Next.
  3. On the Import Projects dialog page, make sure the Select root directory checkbox is checked and click Browse to locate where you have unpacked the SDK.

    Import Projects Dialog


  4. Browse to the root directory of the unpacked SDK and click OK.  If everything is correct, you should see six projects in the Projects section of the Import Projects dialog page.
  5. To install all SDK elements, check all the projects or click Select All. If any are greyed out and cannot be checked, it means you have already imported that project or there is a conflict with the project name.
  6. When all projects are checked for import, click Finish to import.

    Finish Import Projects Dialog


Including the SDK Within Your Own Apps

If you have any existing Android projects open in Eclipse and would like to include the SDK in those projects, follow these steps:

  1. Select your open project in Eclipse and either select Project > Properties from the main menu or alternate-click on the Project itself and select Properties from the context menu. If your project nature is correctly set to Android, your project dialog will contain Android and Android Lint Preferences sections.

    Finish Import Projects Dialog


  2. Within the Android section, click Add from the bottom Library panel and then select “sdk” from the offered library projects.  If “sdk” is not shown, ensure the Jabber SDK project is imported and open.

    Finish Import Projects Dialog Finish Import Projects Dialog Finish Import Projects Dialog


  3. Click OK and the Jabber Guest for Android SDK library should now be referenced by your project.