1. Java SDK Details:

The Java SDK provides with the following:

• Intel AppUp SDK API Libraries for Java
• Intel AppUp 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 ECLIPSE 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:

1. Install the JDK 1.6.
2. Install the Java SDK
3. 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 AppUp 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 AppUp 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:

1. Copy the installation adp-java-eclipse-plugin-v1.1 to your working directory, say C:\Work\ATOM\Builds\
2. Launch the Eclipse and go to Help->Install new software...
3. Click Add... to open the "Add site" dialog.
4. Click Archive... to select the adp-java-eclipse-plugin-v1.1as the Location and type in ADP Plug-in as the Name. Then click Ok to return.
5. Select ADP Plug-in - jar:file:/C:/Work/ATOM/Builds/adp-java-eclipse-plugin-v1.1!/ in in "Work with" then the ADP Plug-in is listed below.
6. Select the ADP Plug-in and Click Next and click Finish in the last page.
7. after installation, restart the Eclipse and then ADP Plugin is ready to be used

Note: Once the Intel AppUp Plug-in for Eclispse 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.

Below is the screenshot

4. However if you got an existing project below is the way how you can 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 got the Intel AppUp SDK Plug-in for Eclipse Installed right click and click on "Insert Intel AppUp Packages"

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

Locate the code that initializes the application and insert the SDK authorization 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 Debugger to debug your application. Below is the screenshot.

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

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 with 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

Export the Jar File

Click on the Project name and File->Export

Select "Runnable Jar File" as shown below

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 AppUp SDK Software Packaging Utility can help creating 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-utility

Step 6: Pre-Validate the Installation Package:

The Intel AppUp SDK Software Validation Utility can help validate Java runnable jar packages. Please refer to refer to http://appdeveloper.intel.com/en-us/article/intel-appup-java-packaging-utility 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.