readme

J2ME 的手机实例模型

This is a sample J2ME application demonstrating the usage of Game Commerce J2ME API v2.0.

There are three core tasks provided in the ANT script:
- clean: remove class files compiled from the source and the resulting jar file (support both Windows and Unix).
- dist: compile, obfuscate, preverify and package the J2ME app (support both Windows and Unix).
- run: run the J2ME app (current script only supports Windows platform).

Precondition:
- J2SE is installed and configured properly
- ANT is installed and configured properly
- Make sure the access mode of executable files in j2me/bin can be changed ("dist" task needs to change access mode of those files.) 

Additional precondition for "run" task:
- J2ME Wireless Toolkit for Windows is installed and configured properly
- Modify the value of "wtk" property in build.xml to reflect the real location of J2ME Wireless Toolkit

To clean: execute "ant clean" under "W_Build" directory
To dist: execute "ant dist" under "W_Build" directory
To run: execute "ant run" under "W_Build" directory

Postprocess for dist:
After using the "dist" task to generate the jar file, you need to update the corresponding jad file:
- Update the "MIDlet-Jar-Size" property
- Verify the value of "simpleAPIlocation" property is correct.
- Fill in "user" and "pass" properties with values obtained from GC Operator.


Before runing the J2ME app:
- Login to Merchant GUI at, for example, "http://gcommtest.wise.astri.org/g-commerce/merchant" and use "Manage Product List" to add products you want to sell through the J2ME app. (Remark: Selecting too many products will cause large amount of data transmitted to handset during "Get Products" operation.)

MIDLET in this sample J2ME application:
- J2MEGameAPIClientSimpleMidlet: for demonstrating the usage of GC J2ME API v2.0

The MIDLET provides three main functions:
- Get Products: retrieve products selected by merchant, to be sold in this J2ME app (can define selection criteria). 
- Issue Order: place a purchase order. (Remark: The phone number is in international format, e.g., +86... for China.) In real system, customer will receive confirmation message, ringtone or wallpaper will be delivered upon receiving the reply from the customer. In the test system, no message or product will be delivered.
- Check Order Status: check the status of a transaction