Apple WebObjects 3.5 Tools And Techniques - Manual (Page 28)

Chapter 1 Setting Up WebObjects Applications
28
Performing the Conversion
To convert your project, open it in Project Builder. (It’s a good idea to create a
backup of your project before converting.) If your project was created prior to
WebObjects 3.5, Project Builder detects that a conversion needs to be done. It
reassigns the files in your project to new suitcases, as appropriate. It uses the file
extension to determine what action to take; if there are files whose extensions it
doesn’t recognize, it reports these at the end of the conversion, and you must
manually assign those files to the appropriate suitcases.
The following list summarizes the conversions that take place:
• Components (with a .wo extension) are added to the Web Components
suitcase. Note: Only components found in the top level of the project and
each subproject are moved automatically.
• Java code ( .java ) files are moved from the components into the Classes
suitcase and stored at the top level of the project on disk. Note: Keep in mind
that this may affect your source/revision control system.
In addition, you are asked if you want to add two optional subprojects
(ClientSideJava and CommonJava) to your project. You can use these to
divide your Java code into client-side, server-side or common Java. See
“Subprojects” for more information.
• Resources (previously in the Other Resources suitcase) are put into two new
suitcases. Images with known extensions are assigned to the Web Server
Resources suitcase. Other resources are assigned to the Resources suitcase.
Files with unrecognized extensions are left out and you are notified.
• WOProject.plist is no longer used and is deleted if it is in the project.
• Several new makefile variables have been added and are appended to your
existing
Makefile.preamble with default values assigned.
• All existing subprojects are recursively converted in the same manner as the
top-level project.
In the conversion process, you are prompted to confirm each type of operation.
In general, you should accept the default action for each prompt; otherwise, you
will have to perform the action manually.
Once the conversion has begun, there is no way to cancel it. If you choose not
to convert at all, you may not be able to view some of your files, since they are
assigned to suitcases that aren’t visible.