Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Efxclipse/Tutorials/AddingE(fx)clipse to eclipse"
(→Configure eclipse to use a JDK not a JRE) |
|||
(24 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | |||
= Installing e(fx)clipse IDE.= | = Installing e(fx)clipse IDE.= | ||
− | How to install e(fx)clipse on a Mars 4.5.0 version of eclipse | + | How to install e(fx)clipse on a Mars 4.5.0 version of eclipse. |
These instructions were written and the screen captures taken with a clean install of the Eclipse for RCP and RAP Developers 64 bit package available here (http://www.eclipse.org/downloads/packages/eclipse-rcp-and-rap-developers/marsr). The Operating system used was Windows 7 SP1. These steps do not include the install of eclipse 4.5.0 (Mars). | These instructions were written and the screen captures taken with a clean install of the Eclipse for RCP and RAP Developers 64 bit package available here (http://www.eclipse.org/downloads/packages/eclipse-rcp-and-rap-developers/marsr). The Operating system used was Windows 7 SP1. These steps do not include the install of eclipse 4.5.0 (Mars). | ||
− | [[File:Help_Install_New_Software.png | none | | + | [[File:Help_Install_New_Software.png|none|900px]] |
# Select the '''Help''' menu. | # Select the '''Help''' menu. | ||
# Select the '''Install New Software...''' option. | # Select the '''Install New Software...''' option. | ||
− | [[File:Install_Work_with_All_Available_Sites_Uncheck_Group_items_by_category_Check_e(fx)clipse_-_IDE.png | none | | + | [[File:Install_Work_with_All_Available_Sites_Uncheck_Group_items_by_category_Check_e(fx)clipse_-_IDE.png|none|900px]] |
# Select the '''--All Available Sites --''' option from the '''<u>W</u>ork with:''' drop down list. | # Select the '''--All Available Sites --''' option from the '''<u>W</u>ork with:''' drop down list. | ||
# Uncheck the '''<u>G</u>roup items by category''' check box in the bottom details section. | # Uncheck the '''<u>G</u>roup items by category''' check box in the bottom details section. | ||
# Check only the '''e(fx)clipse - IDE''' Name option. All the other options starting with '''e(fx)clipse - IDE''' are subsets of the full e(fx)clipse IDE. The '''e(fx)clipse - Minimal JavaFX OSGi integration bundles''' option is out of scope for these instructions. | # Check only the '''e(fx)clipse - IDE''' Name option. All the other options starting with '''e(fx)clipse - IDE''' are subsets of the full e(fx)clipse IDE. The '''e(fx)clipse - Minimal JavaFX OSGi integration bundles''' option is out of scope for these instructions. | ||
# Press the '''<u>N</u>ext >''' button. | # Press the '''<u>N</u>ext >''' button. | ||
− | [[File:Install_Install_Details_Next.png | none | | + | [[File:Install_Install_Details_Next.png|none|900px]] |
# Press the '''<u>N</u>ext >''' button. | # Press the '''<u>N</u>ext >''' button. | ||
− | [[File:I_accept_the_terms_of_the_license_agreement.png | none | | + | [[File:I_accept_the_terms_of_the_license_agreement.png|none|900px]] |
# Press the '''I accept the terms of the license agreement''' radio button. | # Press the '''I accept the terms of the license agreement''' radio button. | ||
# Press the '''<u>F</u>inish''' button. | # Press the '''<u>F</u>inish''' button. | ||
− | [[File:Installing_Software.png | none | | + | [[File:Installing_Software.png|none|900px]] |
# Wait about 2 minutes for the install to complete. | # Wait about 2 minutes for the install to complete. | ||
− | [[File:Software_Updates.png | none | | + | [[File:Software_Updates.png|none|900px]] |
# Press the '''Yes''' button. | # Press the '''Yes''' button. | ||
= Setup a target platform for your application development = | = Setup a target platform for your application development = | ||
− | [[File:Preferences_Plug-in_Development_Target_Platform_Add.png | none | | + | [[File:Preferences_Plug-in_Development_Target_Platform_Add.png|none|900px]] |
# Open '''Window''' > '''Preferences''' > '''Plugin-in Development''' > '''Target Platform''' | # Open '''Window''' > '''Preferences''' > '''Plugin-in Development''' > '''Target Platform''' | ||
− | # Click Add ... | + | # Click '''Add ...''' on the right. |
− | [[File:New_Target_Definition_Nothing_Start_with_an_empty_target_definition.png | none | | + | [[File:New_Target_Definition_Nothing_Start_with_an_empty_target_definition.png|none|900px]] |
# Select '''Nothing: Start with an empty target definition'''. | # Select '''Nothing: Start with an empty target definition'''. | ||
− | [[File: | + | # Press the '''<u>N</u>ext >''' button. |
− | # Enter '''e(fx)clipse''' as the target platform | + | [[File:New_Target_Definition_Name_e(fx)eclipse_Add.png|none|900px]] |
+ | # Enter '''e(fx)clipse''' as the target platform '''Name:'''. | ||
# Press the '''Add...''' button. | # Press the '''Add...''' button. | ||
− | [[File:Add_Content_Add_Software_Site_Next.png | none | | + | [[File:Add_Content_Add_Software_Site_Next.png|none|900px]] |
− | # Select Software Site. Then press the '''Next >''' button. | + | # Select '''Software Site'''. Then press the '''Next >''' button. |
− | [[File: | + | [[File:Add_Content_Add_Software_Site_FX_Target_Uncheck_Include_required_software_Finish.png|none|900px]] |
# Enter http://download.eclipse.org/efxclipse/runtime-released/2.0.0/site as the site. Press the enter key while in the '''<u>W</u>ork with:''' text box. | # Enter http://download.eclipse.org/efxclipse/runtime-released/2.0.0/site as the site. Press the enter key while in the '''<u>W</u>ork with:''' text box. | ||
# Expand '''FX Target''' and check '''Target Platform for Eclipse''' | # Expand '''FX Target''' and check '''Target Platform for Eclipse''' | ||
# Uncheck '''Include required software''' check box. | # Uncheck '''Include required software''' check box. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
# Press the '''Finish''' button. | # Press the '''Finish''' button. | ||
− | # | + | [[File:New_Target_Definition_Name_e(fx)eclipse_Resolving.png|none|900px]] |
+ | # The resolving will take less then one minute on most systems. | ||
+ | [[File:New_Target_Definition_Name_e(fx)eclipse_Finish.png|none|900px]] | ||
+ | # Check the '''e(fx)clipse''' check box to make the new target platform the '''(Active)''' platform. | ||
# Press the '''Apply''' button. | # Press the '''Apply''' button. | ||
# Press the '''OK''' button. | # Press the '''OK''' button. | ||
+ | |||
+ | = Configure eclipse to use a JDK not a JRE = | ||
+ | When doing a '''ant build and run''' from the '''FX Build Configuration''' (file: build.fxbuild) the JRE Library must really be a JDK. The following step show how to configure a JRE as a JDK so the '''ant build and run''' will work. | ||
+ | [[File:FX_Build_Config.png|none|900px]] | ||
+ | # Window -> Preferences | ||
+ | [[File:Window_Preferences.png|none]] | ||
+ | # Java -> Installed JREs | ||
+ | # Press the '''Add...''' button. | ||
+ | [[File:Java_Installed_JREs.png|none|900px]] | ||
+ | # Select '''Standard VM''' | ||
+ | # Press the '''Next >''' button. | ||
+ | [[File:StandardVM.png]] | ||
+ | # Don't press the '''Directory...''' button. The '''Directory...''' button will filter out JDKs and only show JREs. | ||
+ | [[File:JRE_Home.png|none|900px]] | ||
+ | # Use the Operating System's file system browser get the full path of the target JDK. | ||
+ | # In this example | ||
+ | # '''C:\Program Files\Java\jdk1.8.0_25''' | ||
+ | # Copy and paste the full path into the '''JRE home:''' text box. | ||
+ | # Press the '''Finish''' button. | ||
+ | [[File:JRE_Definition.png|none|900px]] | ||
+ | # Make the new JDK the default JRE by checking the check box. | ||
+ | # Press the '''OK''' button. | ||
+ | [[File:Installed_JREs.png|none|900px]] | ||
+ | # Navigate to the '''Execution Environments''' dialog. | ||
+ | # Java -> Installed JREs -> Execution Environments. | ||
+ | # Check the check box next the JDK, not the JRE. | ||
+ | # Press the '''OK''' button. | ||
+ | [[File:Execution_Environments.png|none|900px]] | ||
+ | # The steps are now complete. All future new projects will point to a JDK, not a JRE. If you have any existing projects they will still point to the JRE, not the JDK. | ||
= A quick peak at what is now installed = | = A quick peak at what is now installed = | ||
== New Wizards == | == New Wizards == | ||
− | [[File:Package_Explorer_Right_Click_New_Project.png | none | | + | [[File:Package_Explorer_Right_Click_New_Project.png|none|900px]] |
− | + | Package Explorer -> ''(right mouse click)'' -> New -> Project... | |
− | [[File: | + | <br /> |
− | [[File:JavaFX_HTML_Template.png | none | | + | <br /> |
− | [[File:JavaFX_Project_Create_a_Java_Project.png | none | | + | <br /> |
− | [[File:Product_Configuration.png | none | | + | [[File:Project_Explorer_New_Other_JavaFX.png|none|900px]] |
− | [[File:Create_a_Java_Project.png | none | | + | New, Wizard, JavaFX |
− | [[File:FXGraph_File.png | none | | + | <br /> |
− | [[File:FXML_File.png | none | | + | <br /> |
− | [[File:JavaFX_3.x_ViewPart.png | none | | + | <br /> |
− | [[File:JavaFX_Main_Class.png | none | | + | [[File:JavaFX_HTML_Template.png|none|900px]] |
− | [[File:JavaFX_Preloader_Class.png | none | | + | JavaFX -> JavaFX HTML Template |
− | [[File: | + | <br /> |
− | [[File:New_FX-OSGi_Bundle.png | none | | + | <br /> |
− | + | <br /> | |
+ | [[File:JavaFX_Project_Create_a_Java_Project.png|none|900px]] | ||
+ | JavaFX -> JavaFX Library Project | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Product_Configuration.png|none|900px]] | ||
+ | JavaFX -> JavaFX Product Configuration | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Create_a_Java_Project.png|none|900px]] | ||
+ | JavaFX -> JavaFX Create a Java Project | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:FXGraph_File.png|none|900px]] | ||
+ | JavaFX -> JavaFXGraph File | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:FXML_File.png|none|900px]] | ||
+ | JavaFX -> FXML File | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:JavaFX_3.x_ViewPart.png|none|900px]] | ||
+ | JavaFX -> JavaFX 3.x ViewPart | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:JavaFX_Main_Class.png|none|900px]] | ||
+ | JavaFX -> JavaFX Main Class | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:JavaFX_Preloader_Class.png|none|900px]] | ||
+ | JavaFX -> JavaFX Preloader Class | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:New_e4_FX_application.png|none|900px]] | ||
+ | JavaFX -> New e4 FX application | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:New_FX-OSGi_Bundle.png|none|900px]] | ||
+ | JavaFX -> New FX-OSGi Bundle | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
== New Preferences == | == New Preferences == | ||
− | [[File:Preferences_JavaFX.png | none | | + | [[File:Preferences_JavaFX.png|none|900px]] |
− | [[File:Preferences_JavaFX_CSS.png | none | | + | Window -> Preferences -> JavaFX |
− | [[File:Preferences_JavaFX_CSS_Syntax_Coloring.png | none | | + | <br /> |
− | [[File:Preferences_JavaFX_CSS_Template.png | none | | + | <br /> |
− | [[File:Preferences_JavaFX_CSSExtDsl.png | none | | + | <br /> |
− | [[File:Preferences_JavaFX_CSSExtDsl_Compiler.png | none | | + | [[File:Preferences_JavaFX_CSS.png|none|900px]] |
− | [[File: | + | Window -> Preferences -> JavaFX -> CSS |
− | [[File: | + | <br /> |
− | [[File: | + | <br /> |
− | [[File: | + | <br /> |
− | [[File:Preferences_FXGraph_Syntax_Coloring.png | none | | + | [[File:Preferences_JavaFX_CSS_Syntax_Coloring.png|none|900px]] |
− | [[File: | + | Window -> Preferences -> JavaFX -> CSS -> Syntax Coloring |
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Preferences_JavaFX_CSS_Template.png|none|900px]] | ||
+ | Window -> Preferences -> JavaFX -> CSS -> Templates | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Preferences_JavaFX_CSSExtDsl.png|none|900px]] | ||
+ | Window -> Preferences -> JavaFX -> CSSEXTDSL | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Preferences_JavaFX_CSSExtDsl_Compiler.png|none|900px]] | ||
+ | Window -> Preferences -> JavaFX -> CSSEXTDSL -> Syntax Compiler | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Preferences_JavaFX_CSSExtDsl_Syntax_Coloring.png|none|900px]] | ||
+ | Window -> Preferences -> JavaFX -> CSSEXTDSL -> Syntax Coloring | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Preferences_JavaFX_CSSExtDsl_Template.png|none|900px]] | ||
+ | Window -> Preferences -> JavaFX -> CSSEXTDSL -> Templates | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Preferences_FXGraph.png|none|900px]] | ||
+ | Window -> Preferences -> JavaFX -> FXGraph | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Preferences_FXGraph_Compiler.png|none|900px]] | ||
+ | Window -> Preferences -> JavaFX -> FXGraph-> Compiler | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Preferences_FXGraph_Syntax_Coloring.png|none|900px]] | ||
+ | Window -> Preferences -> JavaFX -> FXGraph-> Syntax Coloring | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Preferences_JavaFX_FXGraph_Templates.png|none|900px]] | ||
+ | Window -> Preferences -> JavaFX -> FXGraph-> Templates | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | |||
== New View == | == New View == | ||
− | [[File:Show_View_JavaFX_JavaFX_Preview.png | none | | + | [[File:Show_View_JavaFX_JavaFX_Preview.png|none|900px]] |
+ | [[File:JavaFX_Preview.png|none|900px]] |
Latest revision as of 11:16, 10 September 2015
Contents
Installing e(fx)clipse IDE.
How to install e(fx)clipse on a Mars 4.5.0 version of eclipse. These instructions were written and the screen captures taken with a clean install of the Eclipse for RCP and RAP Developers 64 bit package available here (http://www.eclipse.org/downloads/packages/eclipse-rcp-and-rap-developers/marsr). The Operating system used was Windows 7 SP1. These steps do not include the install of eclipse 4.5.0 (Mars).
- Select the Help menu.
- Select the Install New Software... option.
- Select the --All Available Sites -- option from the Work with: drop down list.
- Uncheck the Group items by category check box in the bottom details section.
- Check only the e(fx)clipse - IDE Name option. All the other options starting with e(fx)clipse - IDE are subsets of the full e(fx)clipse IDE. The e(fx)clipse - Minimal JavaFX OSGi integration bundles option is out of scope for these instructions.
- Press the Next > button.
- Press the Next > button.
- Press the I accept the terms of the license agreement radio button.
- Press the Finish button.
- Wait about 2 minutes for the install to complete.
- Press the Yes button.
Setup a target platform for your application development
- Open Window > Preferences > Plugin-in Development > Target Platform
- Click Add ... on the right.
- Select Nothing: Start with an empty target definition.
- Press the Next > button.
- Enter e(fx)clipse as the target platform Name:.
- Press the Add... button.
- Select Software Site. Then press the Next > button.
- Enter http://download.eclipse.org/efxclipse/runtime-released/2.0.0/site as the site. Press the enter key while in the Work with: text box.
- Expand FX Target and check Target Platform for Eclipse
- Uncheck Include required software check box.
- Press the Finish button.
- The resolving will take less then one minute on most systems.
- Check the e(fx)clipse check box to make the new target platform the (Active) platform.
- Press the Apply button.
- Press the OK button.
Configure eclipse to use a JDK not a JRE
When doing a ant build and run from the FX Build Configuration (file: build.fxbuild) the JRE Library must really be a JDK. The following step show how to configure a JRE as a JDK so the ant build and run will work.
- Window -> Preferences
- Java -> Installed JREs
- Press the Add... button.
- Select Standard VM
- Press the Next > button.
- Don't press the Directory... button. The Directory... button will filter out JDKs and only show JREs.
- Use the Operating System's file system browser get the full path of the target JDK.
- In this example
- C:\Program Files\Java\jdk1.8.0_25
- Copy and paste the full path into the JRE home: text box.
- Press the Finish button.
- Make the new JDK the default JRE by checking the check box.
- Press the OK button.
- Navigate to the Execution Environments dialog.
- Java -> Installed JREs -> Execution Environments.
- Check the check box next the JDK, not the JRE.
- Press the OK button.
- The steps are now complete. All future new projects will point to a JDK, not a JRE. If you have any existing projects they will still point to the JRE, not the JDK.
A quick peak at what is now installed
New Wizards
Package Explorer -> (right mouse click) -> New -> Project...
New, Wizard, JavaFX
JavaFX -> JavaFX HTML Template
JavaFX -> JavaFX Library Project
JavaFX -> JavaFX Product Configuration
JavaFX -> JavaFX Create a Java Project
JavaFX -> JavaFXGraph File
JavaFX -> FXML File
JavaFX -> JavaFX 3.x ViewPart
JavaFX -> JavaFX Main Class
JavaFX -> JavaFX Preloader Class
JavaFX -> New e4 FX application
JavaFX -> New FX-OSGi Bundle
New Preferences
Window -> Preferences -> JavaFX
Window -> Preferences -> JavaFX -> CSS
Window -> Preferences -> JavaFX -> CSS -> Syntax Coloring
Window -> Preferences -> JavaFX -> CSS -> Templates
Window -> Preferences -> JavaFX -> CSSEXTDSL
Window -> Preferences -> JavaFX -> CSSEXTDSL -> Syntax Compiler
Window -> Preferences -> JavaFX -> CSSEXTDSL -> Syntax Coloring
Window -> Preferences -> JavaFX -> CSSEXTDSL -> Templates
Window -> Preferences -> JavaFX -> FXGraph
Window -> Preferences -> JavaFX -> FXGraph-> Compiler
Window -> Preferences -> JavaFX -> FXGraph-> Syntax Coloring
Window -> Preferences -> JavaFX -> FXGraph-> Templates