Friday May 31, 2013

New ADF Mobile Insider video: Adding Charts to Your ADF Mobile Application

A new ADF Mobile Insider video: Adding Charts to Your ADF Mobile Application was recently posted on YouTube.

This demo shows how to build and format bar, pie, and combo charts, including:

  • Creating the charts using data binding
  • Changing series colors and marker types using the seriesStyle tag
  • Formatting the numbers on the Y axis
  • Configuring the chart legend

Please let us know if you have any questions or feedback on charting in ADF Mobile.


Katarina Obradovic-Sarkic

Wednesday May 22, 2013

ADF Mobile tid-bits and updates

If you have recently migrated to ADF Mobile, or have just started ADF Mobile development, you may have seen some issues or puzzling tid-bits for the new version of ADF Mobile.  Here are a few key items worth noting:

  • You may have seen a little red icon on the upper left corner of application, and wondering if the framework somehow detected a bug in the mobile application.  As matter of fact, it simply indicates the application has been deployed in debug mode.  Deployment console window in JDeveloper also provides extra reminder that the application has been deployed in debug mode.

  • Google recently released Revision 22 of the Android SDK Tools.  Along with the update, Google has also made available a new SDK Zip download file containing a new "build-tools" folder.  A few of the utilities necessary for deploying an ADF Mobile application has been moved into this folder, which would cause deployment errors if you are using this new version of the zip file.  This only impact NEW download of the SDK zip file - if you have downloaded the zip file previously and simply updated the tool to Revision 22, deployment is expected to work as before.  This only applies to brand new downloads of the zip.  
    • If you have downloaded the latest SDK Zip and unable to deploy, please see this blog entry for workarounds.
    • This issue is planned to be addressed in one of the upcoming patches.
  • introduced push notification support, and many of you are wondering how to actually leverage this feature.  We are working on publishing further details on this topic - please keep watching this blog site.  In preparation for implementing push notifications, it would also be helpful to understand how Apple Push Notification (APN) and Google Cloud Messaging (GCM) Service work, and their pre-requisites.  APN and GCM both require some setup through the respective developer portals, regardless whether you are developing an app using ADF Mobile or just native tools.
  • One infrastructure change that should not impact most developers is update from PhoneGap 1.0 to Cordova 2.2.  However, if you are using localHTML or remoteURL features, you will have to conform to the Cordova 2.2 JavaScript APIs.  No changes are needed for AMX features using device data controls.
  • In case you have missed it in release notes, the way localHTML pages include framework and Cordova JavaScripts have also been greatly simplified.  You can replace all these references to adf.el.js/phongap/etc JS files with simply this - please note that adf.wwwPath may need to be adjusted according to where you place your HTML files.  The below example has local HTML file in a subfolder within the Web Content folder, i.e. .../public_html/helloWorld/localHTML.html
        <script type="text/javascript">if (!window.adf) window.adf = {}; adf.wwwPath = "../../../../www/";</script>

        <script type="text/javascript" src="../../../../www/js/base.js"></script>

  • Xcode 4.6 has been released.  While it was not fully certified, it is supported.  This is also necessary for Xcode to properly recognize iOS devices running the latest iOS version.
  • Android SDK Tools Revision 22 as referenced above has also been released.  It is known to work although with the workaround required above if you are downloading the SDK Zip rather than just updating the SDK Tools from an existing installation.
  • The ADF Mobile team is planning to release patches for to address some late breaking issues.  They will be released over the next few weeks through the JDeveloper update center.  JDeveloper should notify you of these updates.

Hope this article helps to address some questions.


Joe Huang 

Thursday May 16, 2013

Debugging ADF Mobile Apps on Devices using Native Tools

In-Depth Debugging Using Device Native Tools
In-Depth Debugging Using Native Tools and Devices

Hi, everyone:

As most of you are aware, ADF Mobile can hook into JDeveloper's Remote Debugging to support Java code debugging, such as setting breakpoints and stepping through the code interactively from an emulator or an actual device.  The steps to enable debugging are described in the latest ADF Mobile Developer Guide, and Shay also had a nice entry on how to enable debugging on Android.  The developer guide also contains details on how to enable more refined levels of logging, and view log output using either the Mac Console application or the Android Monitor application.  Let's explore how all this works in a bit more detail. 

Furthermore, log output to the Mac console may not display certain logging messages - for example ones coming from the embedded Java Virtual Machine.  This is due to some compatibility issues between Mac OS (Mountain Lion) and the log output mechanism.  In this article, we will also discuss how to properly output all logging messages and perform more in-depth debugging and analysis using device native tools, with the same capability that native application developers enjoy when debugging an application written in native code such as Objective C.

iOS Debugging Using Xcode Utilities

Unreliable logging from the Java Virtual Machine is a major issue with debugging ADF Mobile application on iOS devices or simulator.  The underlying cause is incompatibility issues with Java Virtual Machine running on the latest Mac OS (Mountain Lion).  Furthermore, it is difficult to debug on an actual device - necessary when debugging issues with invoking device services such as camera or GPS.  However, you can use Xcode and a tethered iOS device to display all logging messages from the device, ADF Mobile container, and the embedded JVM, while running the ADF Mobile application.  To do this, you will need:
  • A Mac running Moutain Lion or Lion
  • Latest version of Xcode - as of May 2013, the latest version is 4.6.2.  Latest version of Xcode is necessary to properly recognize devices running latest version of iOS, as older versions of Xcode cannot properly connect to the most recent version of the iOS.
    • One frequently asked question here is that ADF Mobile does not always officially support the latest version.  In general, officially supported version has been thoroughly tested by Oracle QA, and therefore is recommended for most development purposes.  However, the latest version of Xcode would typically be compatible - please check JDeveloper Forum for any reports of issues. 
    • If indeed ADF Mobile for some reason can't  use the latest Xcode version to deploy an application, you can still follow the steps below.   When you open the temporary Xcode project generated by JDeveloper, you would simply use the latest version of Xcode.  The rest of the instructions would still be valid.
  • Oracle JDeveloper and ADF Mobile
  • An iOS device
  • Obtain and install Apple iOS Developer Certificates and Provisioning Profiles.  When you deploy your ADF Mobile application, you must deploy in Debug Mode, using Developer Certificates and Provisioning Profile. 
Here is a short video of how to modify the temporary Xcode project and use Xcode utilities to display all logging messages from an ADF Mobile application running on a device.

Android Debugging Using Android Debug Monitor

Shay recently published a blog article on viewing logs and debugging on Android devices.    Debugging using an Android device using Android Debug Monitor is much simpler to set up.  There is no need to work with the temporary Android application project.  Instead, you will just need:
  • A PC, Mac, or Linux machine supported by the Android SDK
  • Latest version of Android SDK Tools - this refers to the set of tools and utilities that are part of the Android SDK.  Android Debug Monitor is part of that.
  • Oracle JDeveloper and ADF Mobile
  • An Android-based Device and associated device driver installed (for PC and Linux Machines)
    • Please note that the appropriate drivers on PC and Linux are typically needed for proper connection to the device.  If the machine cannot properly recognize the device, then debugging will not be possible.
In addition to what Shay discussed in his blog article, a couple of additional notes that might be useful if you are looking at logging messages outside the embedded Java Virtual Machine:
  • In the LogCat window, set the filter by application ID.  You would see all logging messages related to the application, which includes events coming from the native part of the application (i.e. container), Cordova, device services, etc. 
  • You can optionally set your application as a "Debugging Application" by going to your device Settings-Developer options-Select debug app, and then select the ADF Mobile application you want to debug.  All applications compiled in "Debug" mode will show up here.  This will allow you to select the ADF Mobile application process in the Android Debug Monitor app, and perform additional debugging - most likely much more info than you will ever want (or care) to know.
Please let us know if there are any issues or questions.


Joe Huang

Friday May 03, 2013

Why should you move to

Hi, everyone:

It's great to see our engineering team has come through and delivered a bunch of new functionality in just a few month, since the release of ADF Mobile in late October of last year.  As Shay blogged about the new features in the previous entry, there are plenty of reasons to move to the new version.  Many of developers in the ADF Mobile community has been looking for ways to push real time notification to ADF Mobile applications, or looking for ways to properly display file content on both iOS and Android devices. now provides these functionality.

One great fact about the new push notification support is that native capabilities are used.  This means you would leverage Apple Push Notification Service or Google Cloud Messaging Service to push notification to ADF Mobile applications.  There is no proprietary or specialized messaging application you would need to implement - you can directly communicate with these push notification services with any backend servers.

File display support is critical for any application that needs to display file content.  In the version of ADF Mobile, you would leverage a LocalHTML feature to display files on iOS devices, but there is no solution for Android.  If your application needs to display file content such as PDF or Word document, you should migrate to

Another great feature is "Application Archive" support.  This is a great re-usability feature for ISV or SI partners - partners can simply create an application archive that includes all application artifacts and re-use the application in different engagements.  For each individual customer, the SI partner or customer themselves can extend the application archive with new functionality, and deploy it within their enterprise.  This is also needed if the customer needs to sign the application with their own certificates and profiles, as needed by most third party Mobile Application Management packages.

Lastly, there are numerous performance enhancements  - for example enhancements around ListView performance.  

Instruction for migrating an application to is documented in the Migration Section of the ADF Release Note.

However, there are also a few other important reason to move to now - please review these carefully and see if they apply to you:

  • Apple has stated that, as of May 1st, 2013, all apps submitted to the app store must properly support the iPhone 5 form factor.  iPhone 5's screen size is 1136x680 pixels with a 16:9 ratio, where as previous iPhone screen size is 960x680 pixels with 4:3 ratio.  Similar to all apps developed before iPhone 5 was released, ADF Mobile apps developed using would be displayed in letter-boxed format.  This no longer meets the updated Apple UI Guidelines.  Therefore, if you are planning to submit an ADF Mobile application to the Apple AppStore, you must move to, which has proper support for the iPhone 5 form factor.
  • also adds support for iPad mini - allowing you to specify icons and splash screen for iPad Mini.
  • If you wish to test using iOS6 simulators that comes with Xcode 4.5 and above, then you must move to  There is a known issue with application unable to rotate even if the device is rotated.
  • JDeveloper and ADF Mobile have been certified to work with more recent mobile SDKs (i.e. Xcode 4.5/iOS 6 and latest Android development tools/SDK).  Therefore, if you wish to use these new SDKs, you should move to
  • There are many bugs fixed in - if you are currently encountering any bugs in version of ADF Mobile, check out this list of bug fixed.

On behalf of the entire ADF Mobile development team, we would like to THANK YOU for your continued support of ADF Mobile.  We would definitely like to hear from you.

Joe Huang

How to solve "Failed to locate the Google Cloud Messaging" in ADF Mobile deployment

If you are trying to deploy to an Android device with the new Oracle ADF Mobile release there is a good chance that you'll run into a situation where your deployment will fail with the message -

Failed to locate the Google Cloud Messaging for Android Library file named "gcm.jar"

Don't worry this is quite easy to resolve. All you need to do is download and install the "Google Cloud Messaging for Android Library" from the "Extras" section of your Android SDK Manager application.

Your android environment now requires that part because the new Oracle ADF Mobile support notification through the Google Cloud Messaging.

Once you download that addition you should be able to deploy without any problems.

New Oracle ADF Mobile is Available

We are happy to announce the new version of Oracle ADF Mobile - - which is available for download as an extension to the new Oracle JDeveloper from OTN.

For mobile developers this release adds some key new features as well as an update to the underling architecture.

You can catch a quick video about the new features here.

Here are some of the highlights of this release:

Push Notification - Your ADF Mobile application can now register to receive notifications through both the Apple and Google notification services.

Badging - Related to the notification feature for iOS application we now support the little overlay icon on the application icon that indicate new messages received by the application.

Display files - new device feature method let you show files as part of your application - with iOS devices this will open the preview for the files.

Application Archive Packaging - you can now package your application and deliver it to your customer - they can then sign it with their certificate and distribute it through their own channels. Very useful for ISVs building mobile products.

Apache Cordova 2.2. Support - we upgraded from phonegap to the open source Cordova 2.2 solution for device feature integration. This opens more options for device integration with newer interfaces.

Mobile SDKs update - we updated the extension to support the latest Android and iOS SDKs.

We hope you'll find the new features useful in your mobile development projects.

Let us know what you think.


This blog is is dedicated to announcements,tips and tricks and other items related to developing, integrating, securing, and managing mobile applications using Oracle's Mobile Platform. It is created and maintained by the Oracle Mobile product development team.

Archive of past entries

Even More Mobile Development Blogs

Oracle A-Team Site - Mobile Related Entries

Code samples from the Community

Fusion Middleware Blogs


« May 2013 »