Tuesday, January 7, 2014

How to install and configure Oracle ADF Mobile on JDeveloper IDE

In this post I am going to talk about Oracle ADF mobile technology Installation. To install ADF mobile you need to download, install, and configure some technologies to be able to develop using ADF mobile.

This post talks about installing ADF mobile on JDeveloper IDE, though you can use it on your chosen IDE, like eclipse for example.

Downloading and configuring ADF mobile consists of three steps, which will be covered step by step as follows:

   A. Download and install JDeveloper.

The first step to use ADF mobile technology, is downloading your IDE. In this post we will talk about JDeveloper IDE.

For ADF mobile you need to download JDeveloper version; it is the version specialized for ADF mobile development.

You can download it from the following link:

In this post, I am talking about the Generic version, which is suitable for all platforms.

Note: Use a download manager for downloading large files; this will prevent you from losing your download if any connection problems took place. You can use the free download manager.

The downloaded file is jdevstudio11124install.jar

Suppose that you downloaded the file in this C:\Downloads\JDeveloperMobile\

1.       Open the cmd and navigate to the downloaded file location and right the following java command to extract and install the downloaded JDeveloper JAR file.
Java –jar jdevstudio11124install.jar

2.       The Oracle Installer Welcome page will be displayed. Click Next

3.       If you have an already installed Middleware, you can choose its location, alternatively, you can specify a new middleware home by clicking on Browse button, as shown in the figure below, click Next.

4.       For now accept the defaults, and choose typical installation. Click Next

5.       In JDK selection screen, you can either choose the bundled JDK, or specify another JDK by clicking on Browse button to locate your installed JDK home folder. Click Next
Note: ADF Mobile needs jdk 1.6 or later to work.

6.       In the following screen, accept the defaults for installing product directories; these directories will be installed in the chose Middleware home, that you specified before, and contains two directories, one for JDeveloper and the other for the bundled WebLogic Server. Click Next.

7.       The summary screen will display a summary for your previous choices and middleware location, and other information regarding your installation. Click Next to start installation process.

8.       Installation progress Screen.

9.       Congratulation screen telling you that your installation is successful, uncheck the Run Quickstart and click Done.

At this stage you finished downloading and installing JDeveloper IDE, along with its bundled Web Logic Server.  Let us move to the next step.

   B. Download and Install ADF Mobile Extenstion
After downloading JDeveloper, you need to download and install ADF mobile extension for JDeveloper.

To do this, follow the following steps:

1.       From start menu, you must see your installed JDeveloper, or you can navigate to your Middleware home <MIDDLEWARE-HOME>\JDev11124\jdeveloper\jdeveloper.exe

2.       Select the menu Item Help > Check for Updates.

3.       Check for updates welcome screen, click Next.

4.       Choose Search for update Centers radio button, ADF Mobile extension exists under the second choice. Click Next.

Alternatively, you can choose Install from local file; in this case you need to download the ADF Mobile extension zip file.

5.       JDeveloper will search the chosen update centers for available extension and display it for you to choose the desired extension to download, choose ADF Mobile check box and click Next.

6.       Accept the agreement by clicking on I Agree button.

7.       ADF Mobile extension download will start. Wait for the download to finish

8.       After finishing a Summary screen will display the downloaded extension. Click Finish to dismiss the screen.

At this stage you finished downloading ADF Mobile extension for JDeveloper IDE, let us move to the next and last step.

C.      Download and Install Android SDK

To start developing Mobile applications, you need to download mobile emulator for your chosen environment; iOS, or Android.

In this post, we are concerning about Android development using JDeveloper IDE. To download the Android SDK, you need to go to android developer’s web site.

Android SDK provides you with the needed API libraries and packages to build, test, and debug your Android application.

After downloading, extract the downloaded file to a folder of your choice. The extracted folder contains two folders sdk and Eclipse.

Eclipse is the ADT tool for Eclipse IDE users, in our case we will use sdk, because we are using JDeveloper IDE.

1.       Click on SDK Manager.exe to open sdk manager, alternatively, you can click on android.bat file which located under <SDK_HOME> / sdk / tools:

2.       SDK Manager will display Android specific libraries and packages that you will need it to develop Android application.

As shown in the screen below, choose the following items:

From Tools Folder:
-          Android SDK Tools.
-          Android SDK Platform-tools.
-          Android SDK Build-tools.

Choose the android version.
-          Android 4.4 ( API 19 ) ( This is the last version of android, you can choose another version from the list below).
From Extra Folder:
-          Android Support Repository.
-          Android Support Library.

            Click on Install Packages to start downloading the selected packages.

3.       After finishing the download you will be moved to a summary screen, and license agreement, which you need to accept, the click on install.

4.       Your chosen packages and tools will start download, then installed.

  At this stage you, you have finished downloading the needed programs and tools for developing ADF mobile applications on Android using JDeveloper IDE.

One last thing you need to do is to configure and connect the Android SDK with JDeveloper IDE.

1.       Open JDeveloper, and choose Studio Developer (All Features) role. Click OK.

2.       Now, you need to set mobile SDK preferences; select the menu item Tools > Preferences.

3.       In preferences screen choose the ADF Mobile from the left side of the screen. Because we are using ADF Mobile for the first time, Click on Load Extension button.

4.       After that expand the ADF Mobile, and then choose Platforms. Choose Android from the Supporting Platforms box, because we want to use Android SDK, and choose the locations as per your SDK installation location, look at the following figure. Click OK when finished.

By completing the above step, you have downloaded, and configured ADF Mobile for development using JDeveloper IDE.

In the next post I will tell how to build your first Android Application using JDeveloper IDE, and Oracle ADF mobile technology.