Skip to main content

Source code file content

Revision: 3

Updated instructions for Twitter API ME version 1.6.
» Project Revision History

» Checkout URL

repository / README.TXT

Size: 5663 bytes, 1 line
-------------------------------------------------------
    "Meet Me For Dinner" Demo
-------------------------------------------------------

Last update: 16-May-2011


1. Introduction

   The project contains the code for the "Meet Me For Dinner" demo 
   application which is the subject of the JavaOne 2010 session S314178:
   "Beyond Smartphones: Rich Applications and Services for the Mobile Masses".
   (search at: http://www.eventreg.com/cc250/main.jsp).

   "Meet Me For Dinner" demo is a social networking and LBS mash-up application
   which features smartphone-like functionality and user interface for
   mass-market phones running Java ME.

   See the talk slides for background information and further details.

   The application code is currently in an alpha state. It implements the core
   functionality but has a number of shortcomings. See the comments at the
   top of DemoApp.java.

   Nevertheless, it is being released now in this state so the developer
   community can get benefit from it.

   Feedback and improvement suggestions (and contributions) are welcome.


2. License and Copyright

   See LICENSE.TXT for license and copyright information.

   For the license of the LWUIT.jar library see: http://lwuit.java.net/

   For the licenses of 3rd party libraries, see the appropriate project
   under 3.

   The images

   - pic-bill.png
   - pic-mary.png
   - pic-mike.png

   are derived from images on www.openclipart.org. For terms and conditions,
   see http://www.openclipart.org/policies


3. Required Libraries

   Included in the project 'lib' directory:
   - From http://lwuit.dev.java.net:
     - LWUIT.jar
   - From the MobileAjax project at
     http://meapplicationdevelopers.java.net/mobileajax.html:
     - json.jar
     - path.jar
     - request.jar

   3rd party libraries which need to be added to the project 'lib' directory:
   - From http://sourceforge.net/projects/kxml/:
     - kxlm-min-2.3.0.jar
   - From http://kenai.com/projects/twitterapime:
     - twitter_api_me-1.4.jar
     - mobile-ju-framework-1.0.jar
     - xauth-encoders.jar

   Note on Twitter API ME version 1.6:

   This version of the sample application was tested using Twitter API ME version
   1.4. As of Twitter API ME version 1.6 the library xauth-encoders.jar is included
   in twitter_api_me.jar and is no longer needed separately. Also, the Mobile JU
   Framework API is no longer supported, that is why mobile-ju-framework-1.0.jar
   is no longer needed.

   For a brief introduction of "Twitter ME API" including a "How-To" look at

     http://terrencebarr.wordpress.com/2010/08/05/need-to-tweet-vexed-by-oauth-check-out-the-new-twitter-api-me/

   Thanks to Ernandes Mourao Junior for the Twitter API ME functionality!


4. Tools

   The project is built using the following tools

   - NetBeans IDE 6.8 or higher plus Mobility plug-in
   OR
   - Java ME SDK 3.0 or higher

   Note: Java SE version 6 is required to run NetBeans and Java ME SDK 3.0


5. App registrations

   This application uses functionality from Yahoo! Business Search and
   Twitter. In order to function the application needs to be registered
   with Yahoo! and Twitter and you need to add the resulting application
   ID and consumer information into the corresponding files. Search for
   "REPLACE" in:

   - POIListModel.java
   - Tweeter.java


6. Setup, Build, and Run

   1. Launch NetBeans or the Java ME SDK

   2. Open the project in the tool.

   3. Ensure the CLDC Java Platform MicroEdition SDK 3.0 is selected as the
      platform.

   4. Copy the mentioned libaries into the project 'lib' directory and then
      add them in the 'Libraries & Resources' section of the project properties.

   5. Select these APIs in the platform:
      - JSR 139 Connected Limited Device Configuration (CLDC) 1.1
      - JSR 118 Mobile Information Device Profile (MIDP) 2.0
      - JSR 179 Location-based APIs 1.0
      - JSR 135 Mobile Media API 1.1
      - JSR 184 Mobile 3D Graphics Optional Package 1.1
      - JSR  75 PIM and File Connection API
      - JSR 226 SVG API 1.0

   6. Resolve any remaining dependencies, if necessary. If the project name is
      in red, resolution is needed. Right-click on the project name and select
      Resolve Reference Problems (towards the bottom of the menu).

      Resolve the location of builtin.ks, if necessary. Click Resolve, navigate
      to the NetBeans user directory and select Open. This directory is usually
      $HOME/.netbeans on Solaris and Linux and something like
      C:\Documents and Settings\<user>\.netbeans on Windows. This should fix the
      reference problem.

   7. Right-click on the project and select 'Run'.

   8. See the JavaOne presentation for information on the functionality of the
      demo application.


7. Troubleshooting

   If the access to Yahoo! search or Twitter fail, please verify:

   - The Mobile Emulator has Internet access (generally, that means the
     computer you are running the Mobile Emulator must have Internet access.
     Try to open a web brower and view http://www.twitter.com).

   - You have entered correct information for the Yahoo! app ID and the
     Twitter xAuth data

   - Try forcing a reload of the Device Manager: Exit the Java ME SDK 3.0
     Device Manager, then restart the demo application.


8. Know Bugs and Limitations

   - Currently, the code has only been tested on the Device Emulator with
     the DefaultCldcPhone1. Therefore, it may not work correctly with other
     screen sizes or real devices. 

   - POI markers are sometimes not unselected correctly. To work around this,
     just select a different POI marker.
 
 
Close
loading
Please Confirm
Close