2008-12-10T14:17:06Z

Spelling and grammar fixes only. No changes to content. 569 GettingStarted 6

3169

= Java FX for Eclipse = __TOC__ == Installation == === Install JavaFX SDK === Download JavaFX SDK for [http://java.sun.com/javafx/downloads Windows] or [http://java.sun.com/javafx/downloads Mac Os X]. Follow the installation instructions. === Install Eclipse === The plugin requires Eclipse 3.4 or newer. We recommend downloading Eclipse IDE for Java EE Developers for [http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/ganymede/SR1/eclipse-jee-ganymede-SR1-win32.zip Windows] or [http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/ganymede/SR1/eclipse-jee-ganymede-SR1-macosx-carbon.tar.gz Mac OS X]. Then follow the installation instructions. === Install Plugin === # Download plugin: # [http://kenai.com/downloads/eplugin/com.sun.javafx.eclipse.feature-win32-win32-x86-1.0.zip com.sun.javafx.eclipse.feature-win32-win32-x86-1.0.zip] for Windows # [http://kenai.com/downloads/eplugin/com.sun.javafx.eclipse.feature-macosx-carbon-x86-1.0.zip com.sun.javafx.eclipse.feature-macosx-carbon-x86-1.0.zip] for Mac OS X # Unzip into the eclipse installation directory # There should be new files in <code>''ECLIPSE_ROOT/''plugins</code> and <code>''ECLIPSE_ROOT/''features</code> # Run Eclipse == Hello World == === Creating JavaFX Project and Configuring JavaFX SDK === # Start eclipse. You will see the basic layout of the workbench. [[image: new_workbench_java.png|New empty workbench]] # In the Package Explorer view right-click and select New > Java Project [[image: create_new_java_project.png|New Java Project menu]] # Create a new JavaTM project. [[image: new_project_wizard_step1.png|New empty workbench]] # Name it MyJavaFXProject and press the Finish button. The new project appears in the Package Explorer. [[image: new_project_wizard_result.png|New project created]] # Right-click on the newly created project and select JavaFX > Add JavaFX Nature. [[image: add_javafx_nature.png|Add JavaFX nature to Java Project]] # The JavaFX perspective is activated. If this is first time you are adding the JavaFX nature to a Java Project you will be asked to set the <code>JAVAFX_HOME</code> property. [[image: missing_javafx_sdk_message.png|Error, JavaFX SDK home not set up.]] To set up the <code>JAVAFX_HOME</code> property, follow these steps: ## Press OK on message dialog. No thanks, I prefer [[#IWantSelectCancel|Cancel]] button. ## You should see the below dialog with <code>JAVAFX_HOME</code> set to (empty) value. [[image: preferences_setup_javafx_sdk_path.png|Preferences: Classpath Variables]] ## Press Edit... button on the right side to bring up the edit window. [[image: edit_variable_entry.png|Edit classpath variable]] ## Press the Folder... button and select the installation folder of the JavaFX SDK. [[image: folder_selection_javafs_sdk_root_folder.png|Select instalation folder of JavaFX SDK]] ## Press OK on Folder Selection dialog, press OK on Edit Variable Entry dialog. [[image: preference_setup_result.png|Result of setting JAVAFX_HOME property]] ## Press OK on Preferences dialog. The <code>JAVAFX_HOME</code> variable has been set. If you decided to select the Cancel button on the error dialog you will skip this setup and the system will never ask you for this again. To set this up later just [[#sorryISelectCancel|follow these instructions]]. # Voila! you have created your first JavaFX Project. [[image: javafx_perspective_overview.png|Opened JavaFX Perspective with Java Project with JavaFX nature]] === Adding Files === # Expand MyJavaFXProject. Left click on src folder. Then select New > Package and type into the Name field the package name com.sun.eclipse.example. [[image: create_new_package.png|Adds new Empty Script file into folder.]] # Left click on src/com.sun.eclipse.example folder. Then select New > Empty Script. [[image: new_file_empty_script_menu.png|Adds new Empty Script file into folder.]] # The New File wizard will appear. Type Main into the Name field. [[image: new_file_wizard.png|New file wizzard]] # Press the Finish button and an empty new JavaFX script will be created. [[image: new_file_result.png|New empty FX script]] # Let's focus on Snippets view. There are a lot of code snippets to help you develop your application. Expand Applications and select Stage. [[image: snippets_applications.png|Snippets View]] # Drag and drop a Stage node into the editor window. The Insert Template: Stage dialog appears. Change the value of the title variable to Hello World!. [[image: drag_stage_into_editor.png|Result after drop]] # Press the Insert button to insert the resulting template into the source code. [[image: result_after_drop_stage.png|Result in editor]] # Mission accomplished, Sir! === Running === Running the application in Eclipse is extremely easy. # Press the Run button on the toolbar to launch the application. [[image: run_file_icon_detail.png|Run icon]] # If you are running for the first time the Edit Configuration dialog appears. [[image: runnig_configuration.png|Configuration]] All options are set to default values. The most interesting part is the Profile - Target option. Here you can set up the execution environment. Possible options are: #* Desktop profile - Run as Application #* Desktop profile - Run as Applet #* Desktop profile - Run with WebStart #* Mobile Profile[[#switchingProfiles|[?]]] - Run in Emulator # Press Run to start the application. The console window will appear notifying you about progress of execution. [[image: running_as_application.png|Running application]] === Building === Building in Eclipse is provided automatically by default. For more building options open the Project menu === Configuration Options === # Right-click the project in the Package Explorer, and select Properties. [[image: project_properties_menu.png|Menu: Project Properties]] # The Properties dialog appears. Select JavaFX Defaults. [[image: javafx_project_properties.png|Properties: JavaFX Defaults]] Here you can edit several default parameters used during the execution and deployment process of JavaFX Projects. For more information about the meaning of available options see the JavaFX Packager Documentation. === JavaFX Help === The plugin provides easy access to the JavaFX SDK documentation. You can invoke help by Help > Java FX > JavaFX Script Documentation or press <code>Ctrl + F1</code> [[image: help_button.png|JavaFX SDK Help]] <div class="footNotes"> === Footnotes: === * At any time you can setup or change the <code>JAVAFX_HOME</code> variable by following these steps: *# Open Window > Preferences *# Expand Java > Build Path and select Classpath Variables *# Edit <code>JAVAFX_HOME</code> * You can switch profiles in SDK by following these steps: *# Right click on project name. Select Properties > Java Build Path > Libraries *# Double click on JavaFX System Library. The Edit Library dialog appears. Here you can set the profile to use. [[image: edit_javafx_system_library.png|Dialog: Edit JavaFX System Library]] </div>

<h1><a name='Java_FX_for_Eclipse'></a> Java FX for Eclipse </h1> <div id='toc' class='toc'> <div id='toctitle' class='toc-title'> Contents </div> <div id='toccontents' class='toc-contents'><ul><li>1 <a href='#Java_FX_for_Eclipse'> Java FX for Eclipse </a></li> <ul><li>1.1 <a href='#Installation'> Installation </a></li> <ul><li>1.1.1 <a href='#Install_JavaFX_SDK'> Install JavaFX SDK </a></li> <li>1.1.2 <a href='#Install_Eclipse'> Install Eclipse </a></li> <li>1.1.3 <a href='#Install_Plugin'> Install Plugin </a></li> </ul><li>1.2 <a href='#Hello_World'> Hello World </a></li> <ul><li>1.2.1 <a href='#Creating_JavaFX_Project_and_Configuring_JavaFX_SDK'> Creating JavaFX Project and Configuring JavaFX SDK </a></li> <li>1.2.2 <a href='#Adding_Files'> Adding Files </a></li> <li>1.2.3 <a href='#Running'> Running </a></li> <li>1.2.4 <a href='#Building'> Building </a></li> <li>1.2.5 <a href='#Configuration_Options'> Configuration Options </a></li> <li>1.2.6 <a href='#JavaFX_Help'> JavaFX Help </a></li> </ul></ul></ul></div> </div> <h2><a name='Installation'></a> Installation </h2> <h3><a name='Install_JavaFX_SDK'></a> Install JavaFX SDK </h3> Download JavaFX SDK for <a class='external' href="http://java.sun.com/javafx/downloads">Windows</a> or <a class='external' href="http://java.sun.com/javafx/downloads">Mac Os X</a>. Follow the installation instructions. <h3><a name='Install_Eclipse'></a> Install Eclipse </h3> The plugin requires Eclipse 3.4 or newer. We recommend downloading Eclipse IDE for Java EE Developers for <a class='external' href="http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/ganymede/SR1/eclipse-jee-ganymede-SR1-win32.zip">Windows</a> or <a class='external' href="http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/ganymede/SR1/eclipse-jee-ganymede-SR1-macosx-carbon.tar.gz">Mac OS X</a>. Then follow the installation instructions. <h3><a name='Install_Plugin'></a> Install Plugin </h3> <ol><li> Download plugin: </li><li> <a class='external' href="http://kenai.com/downloads/eplugin/com.sun.javafx.eclipse.feature-win32-win32-x86-1.0.zip">com.sun.javafx.eclipse.feature-win32-win32-x86-1.0.zip</a> for Windows </li><li> <a class='external' href="http://kenai.com/downloads/eplugin/com.sun.javafx.eclipse.feature-macosx-carbon-x86-1.0.zip">com.sun.javafx.eclipse.feature-macosx-carbon-x86-1.0.zip</a> for Mac OS X </li><li> Unzip into the eclipse installation directory </li><li> There should be new files in <code>ECLIPSE_ROOT/plugins</code> and <code>ECLIPSE_ROOT/features</code></li><li> Run Eclipse </li></ol><h2><a name='Hello_World'></a> Hello World </h2> <h3><a name='Creating_JavaFX_Project_and_Configuring_JavaFX_SDK'></a> Creating JavaFX Project and Configuring JavaFX SDK </h3> <ol><li> Start eclipse. You will see the basic layout of the workbench. <?link_for_image new_workbench_java.png|New empty workbench?></li><li> In the Package Explorer view right-click and select New > Java Project <?link_for_image create_new_java_project.png|New Java Project menu?></li><li> Create a new JavaTM project. <?link_for_image new_project_wizard_step1.png|New empty workbench?></li><li> Name it MyJavaFXProject and press the Finish button. The new project appears in the Package Explorer. <?link_for_image new_project_wizard_result.png|New project created?></li><li> Right-click on the newly created project and select JavaFX > Add JavaFX Nature. <?link_for_image add_javafx_nature.png|Add JavaFX nature to Java Project?></li><li> The JavaFX perspective is activated. If this is first time you are adding the JavaFX nature to a Java Project you will be asked to set the <code>JAVAFX_HOME</code> property. <?link_for_image missing_javafx_sdk_message.png|Error, JavaFX SDK home not set up.?> To set up the <code>JAVAFX_HOME</code> property, follow these steps: <ol><li> Press OK on message dialog. No thanks, I prefer <a href='#IWantSelectCancel' class='internal'>Cancel</a> button. </li><li> You should see the below dialog with <code>JAVAFX_HOME</code> set to (empty) value. <?link_for_image preferences_setup_javafx_sdk_path.png|Preferences: Classpath Variables?></li><li> Press Edit... button on the right side to bring up the edit window. <?link_for_image edit_variable_entry.png|Edit classpath variable?></li><li> Press the Folder... button and select the installation folder of the JavaFX SDK. <?link_for_image folder_selection_javafs_sdk_root_folder.png|Select instalation folder of JavaFX SDK?></li><li> Press OK on Folder Selection dialog, press OK on Edit Variable Entry dialog. <?link_for_image preference_setup_result.png|Result of setting JAVAFX_HOME property?></li><li> Press OK on Preferences dialog. The <code>JAVAFX_HOME</code> variable has been set. If you decided to select the Cancel button on the error dialog you will skip this setup and the system will never ask you for this again. To set this up later just <a href='#sorryISelectCancel' class='internal'>follow these instructions</a>. </li></ol></li><li> Voila! you have created your first JavaFX Project. <?link_for_image javafx_perspective_overview.png|Opened JavaFX Perspective with Java Project with JavaFX nature?></li></ol><h3><a name='Adding_Files'></a> Adding Files </h3> <ol><li> Expand MyJavaFXProject. Left click on src folder. Then select New > Package and type into the Name field the package name com.sun.eclipse.example. <?link_for_image create_new_package.png|Adds new Empty Script file into folder.?></li><li> Left click on src/com.sun.eclipse.example folder. Then select New > Empty Script. <?link_for_image new_file_empty_script_menu.png|Adds new Empty Script file into folder.?></li><li> The New File wizard will appear. Type Main into the Name field. <?link_for_image new_file_wizard.png|New file wizzard?></li><li> Press the Finish button and an empty new JavaFX script will be created. <?link_for_image new_file_result.png|New empty FX script?></li><li> Let's focus on Snippets view. There are a lot of code snippets to help you develop your application. Expand Applications and select Stage. <?link_for_image snippets_applications.png|Snippets View?></li><li> Drag and drop a Stage node into the editor window. The Insert Template: Stage dialog appears. Change the value of the title variable to Hello World!. <?link_for_image drag_stage_into_editor.png|Result after drop?></li><li> Press the Insert button to insert the resulting template into the source code. <?link_for_image result_after_drop_stage.png|Result in editor?></li><li> Mission accomplished, Sir!</li></ol><h3><a name='Running'></a> Running </h3> Running the application in Eclipse is extremely easy. <ol><li> Press the Run button on the toolbar to launch the application. <?link_for_image run_file_icon_detail.png|Run icon?></li><li> If you are running for the first time the Edit Configuration dialog appears. <?link_for_image runnig_configuration.png|Configuration?> All options are set to default values. The most interesting part is the Profile - Target option. Here you can set up the execution environment. Possible options are: <ul><li> Desktop profile - Run as Application </li><li> Desktop profile - Run as Applet </li><li> Desktop profile - Run with WebStart </li><li> Mobile Profile<a href='#switchingProfiles' class='internal'>[?</a>] - Run in Emulator </li></ul></li><li> Press Run to start the application. The console window will appear notifying you about progress of execution. <?link_for_image running_as_application.png|Running application?></li></ol><h3><a name='Building'></a> Building </h3> Building in Eclipse is provided automatically by default. For more building options open the Project menu <h3><a name='Configuration_Options'></a> Configuration Options </h3> <ol><li> Right-click the project in the Package Explorer, and select Properties. <?link_for_image project_properties_menu.png|Menu: Project Properties?></li><li> The Properties dialog appears. Select JavaFX Defaults. <?link_for_image javafx_project_properties.png|Properties: JavaFX Defaults?> Here you can edit several default parameters used during the execution and deployment process of JavaFX Projects. For more information about the meaning of available options see the JavaFX Packager Documentation. </li></ol><h3><a name='JavaFX_Help'></a> JavaFX Help </h3> The plugin provides easy access to the JavaFX SDK documentation. You can invoke help by Help > Java FX > JavaFX Script Documentation or press <code>Ctrl + F1</code> <?link_for_image help_button.png|JavaFX SDK Help?> <div class="footNotes"> <h3><a name='Footnotes:'></a> Footnotes: </h3> <ul><li> At any time you can setup or change the <code>JAVAFX_HOME</code> variable by following these steps: <ol><li> Open Window > Preferences</li><li> Expand Java > Build Path and select Classpath Variables</li><li> Edit <code>JAVAFX_HOME</code></li></ol></li><li> You can switch profiles in SDK by following these steps: <ol><li> Right click on project name. Select Properties > Java Build Path > Libraries</li><li> Double click on JavaFX System Library. The Edit Library dialog appears. Here you can set the profile to use. <?link_for_image edit_javafx_system_library.png|Dialog: Edit JavaFX System Library?></li></ol></li></ul></div>

2008-12-12T00:56:19Z

2206