WebObjects 5: How to Rename a Project with Project Builder in Mac OS X

When renaming a WebObjects or Cocoa project using the Rename command from the Project menu in Project Builder, the resulting executable file may retain the original name of the project.

Solution

When renaming a WebObjects or Cocoa project with Project Builder in Mac OS X, the name must be changed in other places in addition to choosing Rename from the Project menu.

The developer document "Discovering WebObjects for HTML" outlines the initial steps in the renaming process. All the steps are listed below.

Assume you are starting with a project named "MyWOProject" and that you want to change its name to "MyNewWOProject".

1. Duplicate the "MyWOProject" directory and name it "MyNewWOProject".

2. Rename the MyWOProject.pbproj file inside the MyNewWOProject directory to MyNewWOProject.pbproj.

3. Open the MyNewWOProject project in Project Builder.

4. Rename the MyWOProject target MyNewWOProject
a) Click the Targets tab.
b) Select the MyWOProject target in the Targets list.
c) Choose Project->Rename.
d) Replace MyWOProject with MyNewWOProject.
e) Click the Files tab.

5. Choose Clean from the Build menu.
At this point, if you build the project, the file still has the name MyWOProject, as does the .woa directory and the URL for connecting to the application. A few more steps are necessary to complete the process.

6. Close the MyNewWOProject project in Project Builder or quit Project Builder, so that Project Builder will not attempt to prevent changes to the project files.

7. Open the MyNewWOProject/MyNewWOProject.pbproj/project.pbxproj file with a text editor.
This file is not immediately visible in the Finder, so choose from one of the following methods to open the project.pbxproj file:
a) From the Finder while pressing the CONTROL key, click on the MyNewWOProject.pbproj and select 'Show Package Contents' from the contextual menu.
b) Open project.pbxproj in a text editor.
c) Open a Terminal shell.
d) change directories (cd) to the MyNewWOProject.pbproj to get to the project.pbxproj file
e) Open project.pbxproj with a command-line text editor such as vi or emacs.

8. Replace all occurrences of MyWOProject in the project.pbxproj file with MyNewWOProject.
This updates CFBundleExecutable key, the NSExecutable key, the .woa directory, several intermediate build directories, some PRODUCT_NAME keys, and the application's jar files.
Important: Do not modify names of .java files.

9. Open MyNewWOProject in Project Builder.

10. Build and run the application.