FX

The JavaFX Plugin for Eclipse enables you to develop, debug, and deploy JavaFX applications in the Eclipse integrated development environment (IDE). This document provides release information and known issues regarding the plugin.

What's New in Version 1.2.1

The following list describes the changes that were made to the JavaFX Plugin for Eclipse since the 1.2 release in June 2009:

• New JavaFX Project Wizard Modified - You can now create a new JavaFX project by using the New JavaFX Project wizard in one of two ways:
  
  
  • Creating a new empty project - Simple new projects can be created more easily. As soon as a valid project name is provided, you can skip the rest of the wizard by clicking the Finish button.
    
    
  • Creating projects from one of the JavaFX templates provided - The New From Template wizard now has the template selection page as the first page. The wizard has two checkboxes for mobile and desktop profile to enable the list to be filtered. The second page of this wizard will have the name of the new project already pre-populated with the name of the selected template.
    
    
• Importing NetBeans JavaFX projects - A new wizard for importing NetBeans JavaFX projects into Eclipse IDE can be accessed by choosing File menu -> Import -> JavaFX -> NetBeans JavaFX project. After you specify the NetBeans project location by typing it explicitly or browsing to it, the rest of the project information is derived. The project will not be copied into the Eclipse workspace, but the original project location will be used directly. The files created by Eclipse (.classpath and .project files) will be kept separately from the NetBeans project directory, so the project will still work in the NetBeans IDE.
  
  
• Improved Build System - The whole build system for JavaFX Script projects has been overhauled in this release, fixing many reported issues and making the builds faster. Projects that depend on Java libraries in JAR files or on other projects in the workspace can now be built correctly. Larger projects can now be built more successfully.
  
  
• Improved Package Creation - Previously, if you tried to create a JavaFX Script in a nonexistent package, an error was reported. You no longer have to exit the wizard to create the package first and then restart the wizard. The New JavaFX Script wizard can now create packages while creating a new JavaFX Script file.
  
  

System Requirements

Ensure that you meet the system and software requirements for the products that are listed below and are required to use the JavaFX plugin for Eclipse. Also review the Release Notes listed for the these products.

• JavaFX 1.2.1 SDK (refer to the System and software requirements and JavaFX 1.2.1 SDK Release Notes for more information)
• Eclipse IDE 3.5.1 ( see Target Operating Environments in the Eclipse 3.5.1 Project Release Notes for more information) S

The following table lists the system configurations used to test the JavaFX 1.2.1 Plugin for Eclipse. These are the platform configurations in which the JavaFX plugin for Eclipse are currently supported.

 

* The JDK installation includes the Java Runtime Environment (JRE).

Also, a beta version of JavaFX 1.2.1 SDK is currently available for OpenSolaris platforms. The JavaFX 1.2.1 Plugin for Eclipse has not been tested on this platform, but is believed to be functional. A fully tested version of the plugin for this platform might be released in the future.

An Internet connection is required to download the required components and to deploy your application.

Known Bugs, Issues, and Limitations

Mac OS Specific Issues

• Issue: The plugin has been tested on a limited basis using the recently released Snow Leopard operating system on the Mac.
  
  Description: Some preliminary testing of the JavaFX 1.2.1 Plugin using Eclipse IDE 3.5.1 (Galileo 64-bit Cocoa) and Mac Snow Leopard indicates that the plugin is functional in that version of the IDE. A fully tested version of the JavaFX Plugin for the Snow Leopard and Eclipse 3.5 configuration is not yet available and might be released in the future.
  
  Workaround: None.

Mobile Deployment

• Issue: A project might fail to deploy to the JavaFX Mobile Emulator after multiple consecutive executions.
  
  Description: If you run your JavaFX application with the Mobile Emulator Run Configuration Profile, the application might stop working after multiple executions using the mobile profile.
  
  Workaround: Exit the JavaFX 1.2 SDK Device Manager and exit the Eclipse IDE to clear any hung Java and Device Manager processes.
  
  
• Issue: Unable to deploy JavaFX applications using mobile run profile on the Mac platform.
  
  Description: The JavaFX SDK 1.2.1 Mobile Emulator works on the Windows platform only. Also, only applications that use the JavaFX Common API profile can run on the JavaFX Mobile Emulator.
  
  Workaround: Deploy the mobile-ready JavaFX application on the Windows platform.
  

Projects

• Issue: Missing JavaFX SDK error is received.
  
  Description: The JavaFX SDK is not detected on the JAVAFX_HOME location because the JAVAFX_HOME variable is not defined or is pointing to an incorrect location.
  
  Workaround: Set the JAVAFX_HOME variable in the Preferences dialog box by following these steps:
  
  
  1. From the IDE's main menu, select Window > Preferences on the Windows platform, or Eclipse > Preference on the Mac platform.
     
  2. In the Preferences dialog box, select Java > Build Path > Classpath Variables.
     
  3. In the Classpath Variables pane, select the JAVAFX_HOME variable from the list and click Edit.
     
  4. In the Edit Variable Entry dialog box, click File, navigate to the folder in which you installed the JavaFX SDK 1.2, and click OK.
     Note that the default installation folder for the JavaFX 1.2 SDK is as follows:
     
     • On the Windows platform:
          C:\Program Files\JavaFX\javafx-sdk1.2
       
       
     • On the Mac platform:
          /Library/Frameworks/JavaFX.framework/Versions/1.2
       This location cannot be modified.
       
  5. Click OK in the Preferences dialog box to save your changes.

Sample Project Templates

• Issue: The list of sample templates delivered with the plugin do not exactly match what is delivered with the latest available samples bundled with the JavaFX 1.2.1 SDK.
  
  Description: The DisplayShelfMobile and the MediaBox sample templates are missing from the list of templates delivered with the plugin.
  
  Workaround: None. These samples might be provided in a future release.
  


• Issue: When run as an applet, a project that was created using one of the sample JavaFX project templates may be displayed with an incorrectly sized window.
  
  Description: In the previous release of the plugin, a project that was created using one of the sample project templates and ran as an applet may have been displayed with an incorrectly sized window. This was due to an issue with the applet size parameters specified in the sample project templates. This issue has been fixed in this release. However, any projects that were created using the previous release's project templates will not automatically inherit the corrected sizing information that the project templates have in this release.
  
  Workaround: Either delete and recreate the project using the updated sample project templates, or manually adjust the applet size parameters. To adjust the applet size parameters for a project, right click that project's node in the Project/Package Explorer and select Properties, navigate to "JavaFX Defaults" and select the Applet tab. Enter the width and height of the applet.
  

More Information

• JavaFX home page
• JavaFX Technology Downloads
• JavaFX 1.2.1 SDK Release Notes
• JavaFX 1.2 Production Suite Release Notes
• NetBeans IDE 6.8 for JavaFX Release Notes

Do you have comments about this document? We welcome your participation in our community. Please keep your comments civil and on point. You may optionally provide your email address to be notified of replies—your information is not used for any other purpose. By submitting a comment, you agree to these Terms of Use.