J2ME Polish
J2ME Polish 2.4 Documentation
Enough Software

FAQ

Installation

Q: If I extract the downloaded jar-file I don't find the described tools. What happened?

A: You are not supposed to extract the jar file - please start the installer by calling java -jar j2mepolish-[version].jar from the command-line (substitute [version] with the actual version-number). On Windows and Mac OS X it is usually sufficient to double-click the downloaded jar-file to start the installer.

Technical

Q: How much memory does J2ME Polish need?

A: J2ME Polish itself is a build-tool with an optional GUI, some helper classes and a MIDP/2.0 compatible game-engine.
If you just use the build-tool, no additional memory is used.
If you want to use the GUI the additional needed memory depends on what GUI features you actually use. The minimum library footprint starts around 15 kb (after obfuscation). For a full fledged application calculate up to 40 kb for the GUI. Modern devices have a maximum jar size of several MBs, so the memory used by the GUI is more or less negligable.
The game-engine uses 5 to 6 kb.

Q: J2ME Polish seems to copy classes into my application - how can I prevent this?

A: J2ME Polish adds its utility classes and all its GUI classes (if the GUI is used) automatically to each application. The obfuscation step is removing all unnecessary and unused classes, so don't worry about this.

Q: What third party software is used by J2ME Polish?

A: J2ME Polish uses following software:

  • Ant is the basis for the build tools and is not included in the distribution.
  • JDom is used for XML processing.
  • ProGuard is the default obfuscator.
  • RetroGuard is another obfuscator which is included in J2ME Polish.
  • IzPack is great tool for creating installers.

Licensing

Q: What happens when J2ME Polish will not be developed anymore?

A: When the development on J2ME Polish will be halted, Enough Software will license the full product under the GNU Lesser General Public License, allowing full commercial usage without limitations. Thus Enough Software offers a very high investment security!

Q: Can I combine several Single Licenses?

A: Yes, Single Licenses can be combined, so if you use J2ME Polish for more than one application, you do not need to upgrade to the Enterprise License or use the Runtime License instead.

Bugs

Q: I think I have found a bug, what should I do?

A: Please tell me about it at j2mepolish@enough.de. You might also want to file a bug-report. J2ME Polish is currently in the "early bird" phase, so there are still some limitations.

Contribute

Q: I like this project, how can I contribute?

A: There are many ways how you can contribute:

  • Finding bugs
  • Translating the documentation
  • Enhancing or extending J2ME Polish
  • Creating a design with J2ME Polish

When you'd like to do anything of it, please get in touch with me at j2mepolish@enough.de.

Q: I fixed some stuff - what now?

A: Gee, cheers! Please send it to me at j2mepolish@enough.de. Be aware that I use J2ME Polish commercially as well, though.

Features

Q: I need a feature, when will you implement it?

A: Please have a look at the roadmap. When you cannot find the needed feature, please tell me about it at j2mepolish@enough.de or at the BerliOS feature tracker.

Help

Q: My screen title is not designed properly, why?

A: You can design the title in following circumstances:

  • you target a MIDP 1.0 phone, or
  • you are activating a fullscreen mode in your <build> element of you build.xml script by specifying fullscreen="yes" or fullscreen="menu", or
  • you are targeting a MIDP 2.0 phone and set the "polish.usePolishTitle" preprocessing variable to "true" in your build.xml script:
    <variable name="polish.usePolishTitle" value="true" />
    

MIDP 2.0 phones support a "native" title. On Nokia phones this title is set above of the actual Canvas area, for example. That's why J2ME Polish is using such native title by default.
You can end up with a native title even when you use the "menu" fullscreen mode and target a device with unknown softkey events. Please refer to the next question for details.

A: This is usually due to one of the following reasons:

  • you are targeting a generic phone (like "Generic/midp2")
  • you are targeting a phone for which the softkey values are unknown

Softkey events are not standardized and also not all phones do trigger key events when a softkey is pressed. Therefore, J2ME Polish uses the "native" menu for best compatibility. The menubar can only be designed when you target a devic that has know softkeys, e.g. all Nokia or Motorola phones. Please refer to the device database for getting to know if your target device has known softkeys. You can also specify the softkeys yourself by setting the "key.LeftSoftKey" and "key.RightSoftKey" capabilites in either devices.xml or custom-devices.xml.

Q: Where are the mailing lists?

A: Here:

  • users: please join the polish-users@lists.berlios.de-list.
    In this list users can discuss their problems. The developers of J2ME Polish will monitor the discussions and help out!
  • announcements: please join the polish-announce@lists.berlios.de-list for retrieving news regarding the polish framework.
    This list anounces new versions and has very low traffic.
  • developers: please join the polish-devel@lists.berlios.de-list.
    This is for the developers of J2ME Polish.

Have a look at the discussion-page for other communication possibilities.

Q: I'm a bit lost - how should I start using J2ME Polish?

A: You should start by reading the introduction first.
I suggest to check out the provided sample-application in the next step. Play a bit around with the design (which is defined in the "resources/polish.css" file) and in the source-code.
Maybe you can find some more ideas in the collection of how-tos.
You should then be ready to check out the full documention.
If you look for specific information, have a look at the A to Z-index.

J2ME Polish

Q: What should the name "J2ME Polish" mean?

A: J2ME Polish should mean "turtle wax", at least that's what slashdot reader tod suggests. The name can be confusing really. It has nothing to do with Poland or the language spoken there, rather it should imply that you can polish up your applications with J2ME Polish.

Software Patents

Q: What about software patents?

A: Software patents are only good for lawyers and major companies. Please help stopping this madness:
http://www.ffii.org.

back to top