Intel AppUpTM Java* SDK Overview1. Java SDK Details:

The Java SDK includes the following:

• Intel AppUpTM SDK API Libraries for Java• Intel AppUpTM Software Debugger V1.1

for testing applications• Packaging utility for integrating required

files into a single runnable JAR file• Validation utility for pre-validating

runnable JAR files that were generated apart of the packaging utility listed above

Resources & Links

• Download the AppUp Java SDK• Java* IDE plug-in• Java Packaging Guidelines• Submission Guidelines• API Reference Guide for Java• Developer Guide for Java• Release Notes Java SDK• Release Notes for Eclipse plug-in

Setup the environments:

A. Install the JDK 1.6.

B. Install the Java SDK

C. Downlaod and extract the Eclipse 3.6* to your working directory.

2. Supported IDE and Runtime Environments:

1. Eclipse version 3.5.2*, tested versions are Eclipse 3.5.2*, and Eclipse 3.6.0.*

2. This SDK supports products for Java SE 1.6* (and later) environments.

3. Intel AppUp Software Debugger:

The SDK includes the Intel AppUp Software Debugger that emulates the Application Services of the Intel AppUpSM center Consumer Client on your system, without requiring the fullclient or access to hardware. The

Intel AppUp Software Debugger allows testing of authorization, error handling, instrumentation, upgrade authorization, and crash reporting.

With the Intel AppUpTM SDK Plug-in for Eclipse software installed and the Intel AppUp SDK code included, you can use the Eclipse debugger and Intel AppUp Software Debugger to debug your application. Intel AppUp Software Debugger trace information is included in the Intel AppUp Software Debugger window.

How to Install the Intel AppUp SDK Plug-in for Eclipse:

A. Copy the installation adp-java-eclipse-plugin-v1.1 to your working directory, say C:\Work\ATOM\Builds\

B. Launch the Eclipse and go to Help->Install new software

C. Click Add to open the “Add site” dialog.

D. Click Archive to select the adp-java-eclipse-plugin-v1.1 as the Location, and type in ADP Plug-in as the Name. Then click Ok to return.

E. Select ADP Plug-in - jar:file:/C:/Work/ATOM/Builds/adp-java-eclipse-plugin-v1.1!/ in “Work with,” then the ADP Plug-in is listed below

F. Select the ADP Plug-in and Click Next and click Finish in the last page.

G. After installation, restart the Eclipse and then ADP Plugin is ready to be used

Note: Once the Intel AppUp Plug-in for Eclipse is installed you can create a New Intel AppUp Project File->New->Project: The Intel AppUp Project file will create a Appup Project with the SDK already integrated and the SDK code implemented automatically. [FIGURE A]

Download the

AppUp Java SDK & SDK Plug-in

for Eclipse* Software

Intel AppUpSM developer program

Provides developers with

everything they need to create and

sell their apps to users of millions of

Intel® Atom™ processor-based devices.

Intel AppUpSM developer programPart of the Intel® Software Network

1

Published also at:http://appdeveloper.intel.com/en-us/article/intel-appup-java-sdk-overview

[FIGURE A] [FIGURE B]

4. However, if you have an existing project, then use the following steps to add the Intel AppUp Java SDK.

Step 1: You must add the SDK library to Java Classpath.

In Eclipse, use the Build Path item on the Project menu to add appupp_sdk_java_v1.1.jar to the project. (Or right click on the selected Project and use Build Path>Configure Build Path to open the Properties. Select the Libraries tab and click on Add External jars to add the library to the Project). Browse to the directory where the SDK is installed.

Or If you have the Intel AppUp SDK Plug-in for Eclipse Installed, right click and click on “Insert Intel AppUp Packages.” [FIGURE B]

Step 2: Insert SDK Authorization Code Using Authorized Debug ID:

Locate the code that initializes the application and insert the SDK authoriza-tion code. Right Click on the Initialization section and click on “Insert Intel AppUp Authorization code.”

Below is the sample code:

Application app = null;

try{

app = new Application(ApplicationId.DEBUG_ID);

}catch (InitializationException e1)

{

// TODO Auto-generated catch block

e1.printStackTrace();

}catch (UnauthorizedException e1)

{

// TODO Auto-generated catch block

e1.printStackTrace();

}catch (AdpRuntimeException e1)

{

// TODO Auto-generated catch block

e1.printStackTrace();

}

if (app == null)

return;

Step 3: Test Application with Intel AppUp Software Debugger:

With the Intel AppUp SDK Plug-in 1.1 for Eclipse 3.5.2 installed and the Intel AppUp SDK code included, you can use the Eclipse debugger and Intel AppUp Software De-bugger to debug your application. [FIGURE C]

Intel AppUpSM developer programPart of the Intel® Software Network

2

[FIGURE C]

[FIGURE D]

[FIGURE E]

Click on “Start the Intel AppUp Software Debugger.” You will see the below window:

Debug your application. If the Intel AppUp SDK code is included, you will see the below window

INTEL APPUP DEVELOPER PROGRAM—GETTING STARTED

In the Getting Started Guide you’ll find tools and tips to start developing your apps for the Intel AppUpSM center.

• Developer Guidelines

• Validation Process

• Submitting an Application

• Developer Challenge

• Porting to AppUp – Resources & Guides

3

Intel AppUpSM developer programPart of the Intel® Software Network

Step 4: Get and swap in a Production ID. You can get the Production GUID using the plugin. Right click on the ApplicationId.DEBUG_ID and click on “Get Intel AppUp Application GUID.”

Provide your login details, and the application information and the GUID will be automatically generated. The new application will be automatically created in your dashboard for you to upload this JAR file.

[FIGURE F]

[FIGURE G]

INTEL APPUPSM DEVELOPER PROGRAM INCENTIVES:

INTEL ATOM DEVELOPER MILLION DOLLAR FUND

Through this fund, we support software developers and companies creating new experiences through applications for Intel® Atom™ processor-based netbooks.

INTEL APPUP DEVELOPER CHALLENGE

The contest is designed to encourage breakthrough applications that fundamentally change the user experience on a netbook featuring an Intel Atom processor.

LEGENDS

Want application visibility? The Legends program is a way to share the story behind the applications. Get your app in and submit your story. Become a Legend.

INTEL BLACK BELT DEVELOPER SOFTWARE DEVELOPER

Share your knowledge and earn recognition for your contributions.

Intel AppUpSM developer programPart of the Intel® Software Network

4

Export the Jar File

• Click on the Project name and File->Export• Select “Runnable Jar File” as shown below

[FIGURE H]

[FIGURE I]5

Intel AppUpSM developer programPart of the Intel® Software Network

Verify the “Launch Configuration” and select your application from the drop-down, and Click on Finish to export the JAR file

Step 5: Create an Installation Package:

Create a single JAR file that includes the Intel AppUp SDK library jar file, application jar file(s), and an application manifest file. The Intel AppUpTM SDK Software Packaging Utility can help create these Java runnable jar packages. For a list of packaging requirements and tips on packaging applications for Java, refer to http://appdeveloper.intel.com/en-us/article/intel-appup-java-packaging-u...

Step 6: Pre-Validate the Installation Package:

The Intel AppUp SDK Software Validation Utility can help validate Java runnable jar pack-ages. Please refer to refer to http://appdeveloper.intel.com/en-us/article/intel-appup-java-packaging-u... to get complete information.

Step 7: Submit the Application

Submit your application package by following the steps on the Intel AppUp developer program portal. You can then monitor status of the application via the My Dashboard page on the portal. Alternately, with the Intel AppUp SDK Plug-in for Eclipse software installed, you can use the Dashboard feature to monitor status.

[FIGURE J]

© 2010, Intel Corporation. All rights reserved. Intel, the Intel logo, Intel Atom, and Intel AppUp are trademarks of Intel Corporation in the U.S. and other countries.

*Other names and brands may be claimed as the property of others.

MORE JAVA SDK RESOURCES

• Download the AppUp Java SDK

• Java SDK Technical Overview

• Java Packaging Guidelines

• API Reference Guide for Java

• Java Developer Guide

• Release Notes Java SDK

• Java Forum & Support

• Release Notes for Eclipse plug-in

LEARN MORE ABOUT DEVELOPER TOOLS AND RESOURCES AT:

• Intel® Software Dispatch – Delivering the latest advances in software technologies, developer tools, and resources and best practices.

• Intel® Software Network

• Intel® Software Development Products

Intel AppUpSM developer programPart of the Intel® Software Network