JDTF FAQ

Common questions about the JDTF project are answered here.

1. Where can I get the JDTF code?

   A: The JDTF framework, a project on java.net at http://jdtf.java.net/. A binary copy can be downloaded from here. You can browse or download the source code here.

2. What is the relationship between cqME, JDTF framework, ME Framework, and the cq3G test suite?

   A: The JDTF framework is a sub-project of the cqME project. As such, it shares licensing and participation guidelines with other cqME sub-projects such as ME Framework.

3. What are the licensing terms for JDTF?

   A: JDTF source code is licensed under the GNU Public License, version 2, with the Classpath Exception. See the licensing section of the download page for more information. If you have questions about this or any other aspect of the project, please post them on the JDTF forum.

   For information about the commercial version of the product, contact one of the Oracle worldwide sales offices.

4. What is the classpath exception?

   A: The classpath exception was developed by the Free Software Foundation's GNU/Classpath Project (see http://www.gnu.org/software/classpath/license.html). It allows you to link an application available under any license to a library that is part of software licensed under GPL v2, without that application being subject to the GPL's requirement to be itself offered to the public under the GPL.

5. Why do I need the classpath exception?

   A: If the project was distributed under GPL v2, that application could be subject to the requirements of the GPL that all code that is shipped as part of a "work based on the [GPL] program" also be GPL licensed. Accordingly, a GPL license exception is needed that specifically excludes from this licensing requirement any application that links to the GPL implementation. The classpath exception accomplishes this.

6. How can I participate in the JDTF project?

   A: There are a number of ways you can participate in the project. Refer to the cqME Project Participation Handbook for details.

7. How can I submit or suggest changes to the JDTF project?

   A: In accordance with the cqME project governance process, you can submit code to the project leader either as a user, a developer, or as a committer. If your code is accepted to be integrated into the source tree, you will be asked to sign a Contributor's Agreement similar to the one used by the Apache Software Foundation. For more information about the governance process and the various roles for members in the community, please review Mobile & Embedded Community Governance.

8. What documentation is available?

   A: See JDTF Documentation for links to all relevant documentation.

1. How do I install the JDTF framework?

   A: Refer to the Installation chapter of Java Device Test Framework Getting Started Guide [PDF].

2. How do I run the JDTF framework?

   A: Refer to the Launching the Administrator Harness chapter of Java Device Test Framework Getting Started Guide [PDF].

3. Can I use JDTF on Linux?

   A: JDTF was not formally tested with Linux, however experiments have shown it to work on some Linux distributions. There should be no problems running the JDTF framework and the NetBeans IDE on Linux. A problem might occur when running the CLDC preverifier executable (native code) on some Linux platforms. The Java ME SDK 3.0 currently does not support the Linux platform, however the Wireless Toolkit for CLDC version 2.5.2_01 does. Please refer to Wireless Toolkit documentation for more information.

1. How do I create a test pack?

   A: Follow these steps:

   1. Install the NetBeans IDE
   2. Install the JDTF NetBeans IDE plugin. Refer to the Install NetBeans Platform Plugin section of Java Device Test Framework Getting Started Guide [PDF]
   3. For further information refer to the "The Test Pack Development Cycle" chapter in the JDTF NetBeans IDE plugin online help
2. How do I use the JDTF NetBeans IDE plugin to create an installable test pack archive?

   A: In the NetBeans IDE Projects view, right-click on your project and choose the Pack menu item.

3. How do I use the JDTF NetBeans IDE plugin to install a test pack?

   A: In the NetBeans IDE Projects view, right-click on your project and choose the Install menu item.

4. How do I install a packaged test pack?

   A: Refer to Install Basic Test Packs section of Java Device Test Framework Getting Started Guide [PDF]

5. How do I uninstall a test pack?

   A: In the administrator harness, select Configure > Test Packs and follow the on-screen instructions.

6. How do I run tests?

   A: Refer to Running Tests chapter of Java Device Test Framework Getting Started Guide [PDF]

7. How do I run tests in batch mode?

   A: Refer to the JavaTest Command-Line Interface User's Guide available here from the JDTS documentation on java.sun.com.

8. How do I debug my tests?

   A: Refer to the "Debugging Example" chapter in the JDTF NetBeans IDE plugin online help

9. Can I use the command-line interface to build, pack and install a test pack?

   A: Yes. Use the corresponding all, pack and install targets of the Ant build script created by the NetBeans IDE plugin. The generated Ant build script is located at <Your JDTF Test Pack Project>/build/build.xml)