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.
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.
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.
Q: I think I have found a bug, what should I do?
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 firstname.lastname@example.org.
Q: I fixed some stuff - what now?
A: Gee, cheers! Please send it to me at email@example.com. Be aware that I use J2ME Polish commercially as well, though.
Q: I need a feature, when will you implement it?
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
- 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
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.
Q: My menubar is not designed properly, even though I use the "menu" fullscreen mode. What's wrong?
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?
- users: please join the firstname.lastname@example.org.
In this list users can discuss their problems. The developers of J2ME Polish will monitor the discussions and help out!
- announcements: please join the email@example.com for retrieving news regarding the polish framework.
This list anounces new versions and has very low traffic.
- developers: please join the firstname.lastname@example.org.
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
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.
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.
Q: What about software patents?
A: Software patents are only good for lawyers and major companies.
Please help stopping this madness: