Be sure to complete the installation of all required files before working through the lessons in the book.
There are three phases of the installation:
• Installing Flash Debug Player (if a problem exists)
If you do not have Flash Builder 4 installed, step through the following installation directions:
If you happen to be:
• A student, faculty, or staff of eligible education institution
• A software developer who is currently unemployed
then you are eligible for a free Flash Builder license. Visit https://freeriatools.adobe.com/.
Once again, it is important that all the required files are in place before working through the lessons in the book.
From the CD included with your book, copy the flex4tfs directory to the root of your drive.
In this directory, there is a subdirectory named flexGrocer, in which you will be doing most of your work. Also included are directories for each lesson in the book with starting code and completed code for the work you do in the lesson. Some lessons may also have an intermediate directory, which highlights major steps in the lesson, or an independent directory, which holds projects that are unrelated to the main application but demonstrate an important technique or concept.
At various times in the book, you will be using features of Flash Debug Player. If you receive a notice saying you do not have Flash Debug Player installed, follow these steps to install it:
applicationInstallDirectory/Adobe/Adobe Flash Builder 4/Player/win.
applicationInstallDirectory/Adobe/Adobe Flash Builder 4/Player/mac.
In rare instances, you might run the appropriate installer and still get the message that you don’t have the debug version of the player. In this case, uninstall the version you currently have by using the information you’ll find at
http://kb.adobe.com/selfservice/viewContent.do?externalId=tn_14157
and then follow the steps above to reinstall.
Anytime during the course of this book that your code is no longer working, or you simply wish to jump ahead or revisit a lesson, you can import the appropriate FXP (Flex Project) for that lesson.
The FXP format is an archive file that includes project information, files, and folders. The project includes all assets and dependencies for your Flex project.
Each lesson of the book minimally has start and complete files representing the code for that lesson at its beginning and end if all steps are executed. The FXP files for the lessons have this format:
driveRoot/flex4TFS/LessonXX/start/FlexGrocer.fxp
driveRoot/flex4TFS/LessonXX/complete/FlexGrocer.fxp
Some lessons have intermediate files that represent major steps internal to the lesson. Those follow this format:
driveRoot/flex4TFS/LessonXX/intermediate/FlexGrocer-NameOfStep.fxp
Finally, a few lessons have independent files that represent small applications intended to demonstrate a singular concept but that are not directly related to the code in your FlexGrocer project. Those follow this format:
driveRoot/flex4TFS/LessonXX/independent/projectName.fxp
You import an FXP file by choosing File > Import > Flash Builder Project.
When you attempt to import a project in Flash Builder, the IDE determines whether you already have a project with the same Universally Unique Identifier (UUID). This will occur if you have previously imported any lesson.
In this case, Flash Builder will allow you to overwrite the existing project with a fresh copy. You simply need to choose the Overwrite existing project radio button and choose the FlexGrocer project from the drop-down menu. Then click Finish.
This is the ideal way to import a new lesson as it simply overwrites the older code and leaves you with a single FlexGrocer project.
If you have never imported the FlexGrocer project before, the overwrite option will not be available.
In this case, choose the Import new copy of project radio button and set the Extract new projects to input field to driveRoot/flex4tfs/flexGrocer. Then click Finish.
If you already have a project named FlexGrocer in your workspace, and Flash Builder does not recognize this as the same project identifier, it will not allow you to overwrite that project. In this case simply right-click the FlexGrocer project and choose Delete from the Package Explorer.
A dialog box will appear and ask if you want to delete the FlashBuilder project only or also the files for the project from the file system. Choose the Also delete contents radio button.
After deleting these files, repeat these directions to import the needed project.