Creating the Android Project

Create a new Android SUP101Sample project in Unwired WorkSpace. You add library resources and set other application properties.

Prerequisites

In Unwired WorkSpace Preferences, set the Android SDK Location.
Obtain text files from the SUP_Android_Custom_Dev_Tutorial_code.zip file to help create the project and, in a subsequent topic, build the user interface. In this section you can use a text file to help modify the Android Manifest file.
- If you are viewing this guide online from the Sybase Product Documention Web site, click SUP_Android_Custom_Dev_Tutorial_code.zip to access the ZIP archive containing the text files.
- If you are viewing this guide as a PDF, go to the Sybase Product Documentation Web site at http://sybooks.sybase.com/nav/summary.do?prod=1289. Click the link for the appropriate Sybase Unwired Platform version. Then, navigate to this topic in the tutorial, and click the link for the ZIP file to access the text files.

Task

Start Unwired WorkSpace.
Select File > New > Project.
Select Android > Android Project and Next.
Depending on the Android version you are using, the information you provide in the next several steps may be in one or two screens.
In the New Android Project wizard, use these values and click Next.
- Project Name – enter SUP101Sample.
- Select Create new project in workspace if it is not already selected.
- Select Use default location if it is not already selected with, for example, C:/Documents and Settings/user/workspace/SUP101Sample.
In the Select Build Target window, click an Android version 2.2 or later and Next.
In the Application Info window, use these values and click Finish.
- Application Name – enter SUP101Sample if it does not already appear.
- Package Name – enter com.sybase.sup.samples.objectapi.
- Click Create Activity and enter SUP101SampleActivity if these do not already appear.
Tip: To correct a mispelled Package Name, right-click the package and select Refactor > Rename to change the name and update all references.
In the left pane, you should see the Package Explorer with the SUP101Sample project listed. Also, in the src folder a default Sample Activity class was automatically generated for the project.
In Package Explorer, modify the build path to point to the correct location for the ClientLib.jar, sup-client.jar, and UltraLiteJNI12.jar files for the project:
1. Select the SUP101Sample project.
2. Select Project> Properties > Java Build Path.
3. Select the Libraries tab.
4. Click Add External JARs and browse to C:\Sybase\UnwiredPlatform\MobileSDK\ObjectAPI\Android.
5. Select all the JAR files, then click Open.
6. Click OK.
Add a compiler resource to the root directory of the Android project:
1. In Windows Explorer, browse to C:\Sybase\UnwiredPlatform\MobileSDK\ObjectAPI\Android.
2. Copy the armeabi folder.
3. In Package Explorer, select SUP101Sample and add a libs folder.
4. In the libs folder, paste the armeabi folder.
In Package Explorer, add user permissions to the project:
1. Expand the SUP101Sample project.
2. Double-click the AndroidManifest.xml file.
3. Select the AndroidManifest.xml tab.
4. Add permissions to the AndroidManifest.xml file as a child element of the <manifest> element. You can use the AndroidManifest.xml file from the ZIP archive to cut and paste the following text:
```
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
```
5. Select File > Save.

Configuring Android Application Properties
(Optional) Review the Android Manifest window, where you would define the general Android properties used in an application.
Copying Unwired Platform Files to Sample Project
Copy the generated object API code to the SUP101Sample project. You had created the code previously in the Generate Code wizard.
Modifying the Android Manifest File
Add a Detail Activity class to the AndroidManifest.xml file. This declaration causes the application to launch a customer detail screen where you can make changes when you test the application.

Parent topic: Developing an Android Application

Previous topic: Generating Java Object API Code

Next topic: Creating the User Interface