JavaFX JavaFX 2.2 Istallatio Guide Release 2.2 E20474-06 August 2012 Istallatio istructios by operatig system for JavaFX 2.2
JavaFX/JavaFX 2.2 Istallatio Guide E20474-06 Copyright 2008, 2012, Oracle ad/or its affiliates. All rights reserved. Primary Author: JavaFX Documetatio Team This software ad related documetatio are provided uder a licese agreemet cotaiig restrictios o use ad disclosure ad are protected by itellectual property laws. Except as expressly permitted i your licese agreemet or allowed by law, you may ot use, copy, reproduce, traslate, broadcast, modify, licese, trasmit, distribute, exhibit, perform, publish, or display ay part, i ay form, or by ay meas. Reverse egieerig, disassembly, or decompilatio of this software, uless required by law for iteroperability, is prohibited. The iformatio cotaied herei is subject to chage without otice ad is ot warrated to be error-free. If you fid ay errors, please report them to us i writig. If this is software or related documetatio that is delivered to the U.S. Govermet or ayoe licesig it o behalf of the U.S. Govermet, the followig otice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, ad related documetatio ad techical data delivered to U.S. Govermet customers are "commercial computer software" or "commercial techical data" pursuat to the applicable Federal Acquisitio Regulatio ad agecy-specific supplemetal regulatios. As such, the use, duplicatio, disclosure, modificatio, ad adaptatio shall be subject to the restrictios ad licese terms set forth i the applicable Govermet cotract, ad, to the extet applicable by the terms of the Govermet cotract, the additioal rights set forth i FAR 52.227-19, Commercial Computer Software Licese (December 2007). Oracle America, Ic., 500 Oracle Parkway, Redwood City, CA 94065. This software or hardware is developed for geeral use i a variety of iformatio maagemet applicatios. It is ot developed or iteded for use i ay iheretly dagerous applicatios, icludig applicatios that may create a risk of persoal ijury. If you use this software or hardware i dagerous applicatios, the you shall be resposible to take all appropriate fail-safe, backup, redudacy, ad other measures to esure its safe use. Oracle Corporatio ad its affiliates disclaim ay liability for ay damages caused by use of this software or hardware i dagerous applicatios. Oracle ad Java are registered trademarks of Oracle ad/or its affiliates. Other ames may be trademarks of their respective owers. Itel ad Itel Xeo are trademarks or registered trademarks of Itel Corporatio. All SPARC trademarks are used uder licese ad are trademarks or registered trademarks of SPARC Iteratioal, Ic. AMD, Optero, the AMD logo, ad the AMD Optero logo are trademarks or registered trademarks of Advaced Micro Devices. UNIX is a registered trademark of The Ope Group. This software or hardware ad documetatio may provide access to or iformatio o cotet, products, ad services from third parties. Oracle Corporatio ad its affiliates are ot resposible for ad expressly disclaim all warraties of ay kid with respect to third-party cotet, products, ad services. Oracle Corporatio ad its affiliates will ot be resposible for ay loss, costs, or damages icurred due to your access to or use of third-party cotet, products, or services.
Cotets Part I JavaFX 2.2 Istallatio Guide 1 JavaFX Istallatio for Microsoft Widows Dowload the JavaFX Istaller that Meets Your Needs... 1-1 Istallig JavaFX 2.2 with Java SE 7 Update 6 (Recommeded)...1-1 Istallig JavaFX for Java SE 6...1-2 Stadaloe JavaFX SDK File Structure...1-2 Istallig NetBeas IDE... 1-3 JavaFX Scee Builder... 1-3 Uistallig the Stadaloe JavaFX SDK ad Rutime... 1-3 Troubleshootig... 1-3 2 JavaFX Istallatio for Liux Istallig JavaFX... 2-1 Istallig NetBeas IDE... 2-1 3 JavaFX Istallatio for Mac OS X Istalled JDK/SDK Directory Structure o Mac... 3-1 Istallig NetBeas IDE... 3-1 JavaFX Scee Builder... 3-1 iii
iv
Part I Part I JavaFX 2.2 Istallatio Guide This documet describes istallatio procedures for JavaFX 2.2. Oracle recommeds that you istall JDK 7u6 to upgrade to JavaFX 2.2 SDK. Please refer to JavaFX istallatio istructios i this guide. Choose the istallatio istructios accordig to platform: JavaFX Istallatio for Microsoft Widows JavaFX Istallatio for Liux JavaFX Istallatio for Mac OS X For supported platforms ad browsers, see the JavaFX system requiremets at http://docs.oracle.com/javafx/2/system_requiremets_ 2-2/jfxpub-system_requiremets_2-2.htm Note: Sample JavaFX applicatios are available to dowload as a zip file at http://dowload.oracle.com/ot-pub/java/javafx/2.2.0 -b21/javafx_samples-2_2_0-widows.zip Extract the files to your file system, the ope samples_readme.txt for more iformatio.
1 1JavaFX Istallatio for Microsoft Widows This page provides iformatio about the istallig the JavaFX 2.2 SDK o Microsoft Widows. See the followig topics: "Dowload the JavaFX Istaller that Meets Your Needs" "Istallig NetBeas IDE" "JavaFX Scee Builder" "Uistallig the Stadaloe JavaFX SDK ad Rutime" "Troubleshootig" Dowload the JavaFX Istaller that Meets Your Needs How you istall JavaFX depeds o whether you ca istall Java SE 7 Update 6 (recommeded).or eed to use JDK 6. Note: You must upgrade to Java SE 7 Update 6 to take advatage of some JavaFX 2.2 features, such as the ability to package self-cotaied applicatios, as described i the JavaFX Deploymet Guide. Istallig JavaFX 2.2 with Java SE 7 Update 6 (Recommeded) Java SE 7 Update 6 icludes JavaFX 2.2. Go to the followig locatio for dowload ad istallatio iformatio: http://www.oracle.com/techetwork/java/javase/dowloads/ Note: The Java SE 7u6 istaller does ot uistall previous stadaloe versios of JavaFX. If you wish to uistall previous stadaloe versios, see Uistallig the Stadaloe JavaFX SDK ad Rutime. The JDK 7u6 istaller istalls the followig compoets, i this order: Java Developmet Kit (JDK), icludig the JavaFX SDK Java Rutime Eviromet (JRE), icludig JavaFX After istallatio, the JavaFX SDK ad Rutime are itegrated ito the JDK ad JRE directory structure. This is a chage from previous versios of JavaFX, which were istalled i directories idepedet from the JDK. The Java SE 7u6/JavaFX 2.2 istallatio is a true cobudle. For example, ay file that was formerly i the \bi directory of the JavaFX SDK is JavaFX Istallatio for Microsoft Widows 1-1
Dowload the JavaFX Istaller that Meets Your Needs ow i the \bi directory of the JDK. For more iformatio, see "JDK ad JRE File Structure" at http://docs.oracle.com/javase/7/docs/techotes/tools/widows/jdk files.html Istallig JavaFX for Java SE 6 If you eed to cotiue to use Java SE 6, you ca istall a stadaloe versio of JavaFX 2.2. Note: The stadaloe JavaFX istaller uistalls ay previous versio of JavaFX SDK ad JavaFX Rutime. To dowload the istaller, go to the followig locatio ad follow the lik uder the sectio "JavaFX 2.2 for Java SE 6": http://www.oracle.com/techetwork/java/javafx/dowloads/ Note: There is a 32-bit or 64-bit JavaFX available. Use the bit versio that matches that of your Java SE istallatio. The default istallatio directories for stadaloe JavaFX istallatios are as follows: JavaFX SDK: C:\Program Files\Oracle\JavaFX 2.2 SDK. JavaFX Rutime: C:\Program Files\Oracle\JavaFX 2.2 Rutime Stadaloe JavaFX SDK File Structure The stadaloe JavaFX 2.2 SDK cotais the directories ad cotet show i Figure 1 1. Figure 1 1 File Structure of the Stadaloe JavaFX 2.2 SDK o Widows bi/ Cotais the JavaFX Packager tool for compilig, packagig, sigig, ad deployig JavaFX applicatios. docs/ Cotais the API documetatio. For the olie versio of the API documetatio ad JavaFX tutorials, see http://docs.oracle.com/javafx/ 1-2 JavaFX 2.2 Istallatio Guide
Troubleshootig lib/ Cotais the followig JavaFX utility jar files: at-javafx.jar: At tasks for packagig ad deploymet. javafx-doclet.jar: A doclet for producig customized ad icely formatted documetatio for the users of your JavaFX library. javafx-mx.jar: A file used for debuggig. rt/ Cotais a private, embedded copy of the JavaFX Rutime istallatio, used by JavaFX SDK developmet tools. You would typically poit to the istalled JavaFX Rutime istead, whose default locatio is C:\Program Files\Oracle\JavaFX 2.1 Rutime COPYRIGHT.html Copyright iformatio for the JavaFX software ad documetatio. README.html Provides a lik to the README idex page for the Java SE, JavaFX SDK, JavaFX Rutime. THIRDPARTYLICENSEREADME.txt Licese iformatio for third-party software icluded i the JavaFX SDK. Istallig NetBeas IDE NetBeas IDE 7.2 is recommeded for JavaFX 2.2. Dowload it at http://etbeas.org/dowloads/ For iformatio about cofigurig NetBeas IDE to ru with JavaFX, see "Settig Up NetBeas IDE With JavaFX" at http://etbeas.org/kb/docs/java/javafx-setup.html JavaFX Scee Builder JavaFX Scee Builder is a desig tool for the JavaFX platform. You ca dowload it from the followig locatio: http://www.oracle.com/techetwork/java/javafx/dowloads/idex.ht ml Uistallig the Stadaloe JavaFX SDK ad Rutime Troubleshootig To uistall the curret ad previous versios of the stadaloe JavaFX SDK ad JavaFX Rutime, use the stadard Widows Add/Remove Programs utility i Cotrol Pael. You must uistall the JavaFX SDK ad Rutime separately. Here are some tips for workig aroud problems that are sometimes see durig or followig a istallatio. 1. If you istalled the 64-bit versio, you may have problems with applicatios that ru o 32 bits. Note that the 32-bit versio is compatible with both 32-bit ad 64-bit systems, but the reverse is ot true. See the JavaFX Supported System Cofiguratios at http://www.oracle.com/techetwork/java/javafx/dowloads/suppo rtedcofiguratios-1506746.html JavaFX Istallatio for Microsoft Widows 1-3
Troubleshootig 2. Check the system requiremets to verify that you have a supported eviromet. Cosult the appropriate system requiremets documet: Java SE 7: http://docs.oracle.com/javase/7/docs/webotes/istall/wid ows/widows-system-requiremets.html Stadaloe JavaFX 2.2: http://docs.oracle.com/javafx/2/system_requiremets_ 2-2/jfxpub-system_requiremets_2-2.htm 3. Check the JavaFX release otes for kow issues at http://docs.oracle.com/javafx/2/release_otes_ 2-2/jfxpub-release_otes_2-2.htm 4. Dowload the JavaFX sample zip file ad try ruig oe of the pre-built JAR files. The zip file is available at http://dowload.oracle.com/ot-pub/java/javafx/2.2.0-b21/java fx_samples-2_2_0-widows.zip 5. If you still have uresolved issues, go to the JavaFX Forum at https://forums.oracle.com/forums/forum.jspa?forumid=1385 1-4 JavaFX 2.2 Istallatio Guide
2 2JavaFX Istallatio for Liux This page provides iformatio about the istallatio procedures of the JavaFX 2.2 SDK o Liux platforms. Note: Web Start applicatios ad Web applicatios (plugi) features are curretly ot supported o the Liux platform. 2.1 Istallig JavaFX The JavaFX 2.2 SDK for Liux is istalled as part of JDK 7 update 6 for Liux. See the JDK 7 update 6 platform requiremets ad istallatio istructios, see "JDK 7 Istallatio for Liux" at http://docs.oracle.com/javase/7/docs/webotes/istall/ The JDK 7u6 istaller is available at http://www.oracle.com/techetwork/java/javase/dowloads/ If you wat to use JavaFX 2.2 o a JDK 6 platform, perform the followig: 1. Dowload the JavaFX 2.2 SDK zip file from http://www.oracle.com/techetwork/java/javafx/dowloads/idex.html 2. Extract the SDK files from the zip file to a directory o your local file system. Oce JavaFX SDK is istalled, you should see the followig directory structure o your system: javafx-sdk2.2/ bi/ docs/ rt/... 2.2 Istallig NetBeas IDE NetBeas IDE 7.2 is recommeded for the JavaFX 2.2 SDK. Dowload the NetBeas IDE from the JavaFX Dowloads page. For iformatio about cofigurig NetBeas IDE to ru with JavaFX, see Settig Up NetBeas IDE With JavaFX at http://etbeas.org/kb/docs/java/javafx-setup.html JavaFX Istallatio for Liux 2-1
Istallig NetBeas IDE 2-2 JavaFX 2.2 Istallatio Guide
3 3JavaFX Istallatio for Mac OS X This page provides iformatio about the istallig the JavaFX 2.2 SDK o Mac OS X. The JavaFX 2.2 SDK for Mac is istalled as part of JDK 7 update 6 for Mac. See the JDK 7 update 6 platform requiremets ad istallatio istructios, see "JDK 7 Istallatio for Mac OSX" at http://docs.oracle.com/javase/7/docs/webotes/istall/ The JDK 7u6 istaller is available at http://www.oracle.com/techetwork/java/javase/dowloads/ Istalled JDK/SDK Directory Structure o Mac The JDK is istalled i the followig locatio o Mac: /Library//Java/JavaVirtualMachies/1.7.0.jdk The JavaFX SDK follows the directory structure of the JDK ad is co-located with it, so each JDK subdirectory cotais both JDK ad JavaFX SDK files. as appropriate. For example, i the followig locatio: /Library/Java/JavaVirtualMachies/1.7.0.jdk/Cotets/Home/bi you ca fid JDK utilities, such as java ad javac, as well as javafxpackager from the JavaFX SDK. Istallig NetBeas IDE NetBeas IDE 7.2 is recommeded for the JavaFX 2.2 SDK. Dowload the NetBeas IDE from the JavaFX Dowloads page. For iformatio about cofigurig NetBeas IDE to ru with JavaFX, see Settig Up NetBeas IDE With JavaFX at http://etbeas.org/kb/docs/java/javafx-setup.html JavaFX Scee Builder JavaFX Scee Builder is a desig tool for the JavaFX platform. You ca dowload it from the followig locatio: http://www.oracle.com/techetwork/java/javafx/dowloads/idex.html JavaFX Istallatio for Mac OS X 3-1
JavaFX Scee Builder 3-2 JavaFX 2.2 Istallatio Guide