mozilla

Compare Revisions

Debugging on Mac OS X

Change Revisions

Revision 55316:

Revision 55316 by Bhr on

Revision 55317:

Revision 55317 by Bhr on

Title:
Debugging on Mac OS X
Debugging on Mac OS X
Slug:
Debugging_on_Mac_OS_X
Debugging_on_Mac_OS_X
Tags:
"Developing Mozilla", Debugging
"Developing Mozilla", Debugging
Content:

Revision 55316
Revision 55317
nn17    <h3 name="Creating_the_Project_in_XCode">
18      Creating the Project in XCode
19    </h3>
20    <p>
21      XCode is Apple's new set of developer tools and IDE, shippi
 >ng with MacOS X 10.3 Panther. The instructions for creating a pro
 >ject to debug Mozilla with XCode are slightly different from thos
 >e for ProjectBuilder, and also slightly different than those give
 >n by Apple itself for debugging arbitrary executables!
22    </p>
23    <ol>
24      <li>Open XCode, and create a new Project with **File, New P
 >roject**. Select **Empty Project** as the project type, click Nex
 >t, then name the project and choose a location for it, then click
 > Finish.
25      </li>
26      <li>Now you need to add the executable. Select **Project, A
 >dd Custom Executable** and type a pretty name, then use the **Cho
 >ose** to locate the .app file (Mozilla.app, Firefox.app, DeerPark
 >Debug.app etc) in mozilla/dist. Do not click Finish!
27      </li>
28      <li>**IMPORTANT** - XCode will dim all UI that lets you run
 > the program in the debugger if you just specify the .app file. Y
 >ou must manually locate the Mozilla executable inside the executa
 >ble package and edit the path to point to that location. Thus the
 > value of the Executable Path field might look like this: " ~/bui
 >lds/mozilla/dist/Mozilla.app/Contents/MacOS/Mozilla-bin" (Make su
 >re to select the "-bin" file, the non-"-bin" is just a launch scr
 >ipt.) Now click **Finish** (on xcode 1.2 and higher, just close t
 >he dialog). An entry with the pretty name you entered in the prev
 >ious dialog will appear under the **Executables** branch of the *
 >*Groups &amp; Files** pane in the XCode Project window.
29      </li>
30      <li>I highly recommend you create a separate profile to deb
 >ug with, whatever your task, so that you don't lose precious data
 > like Bookmarks, saved passwords, etc. So that you're not bothere
 >d with the profile manager every time you start to debug, expand 
 >the **Executables** branch of the **Groups &amp; Files** list and
 > double click on the Executable you added for Mozilla. Click the 
 >plus icon under the **Arguments** list and type "-P &lt;profile n
 >ame&gt;" (e.g. "-P MozillaDebug"). Close the window when you're d
 >one.
31      </li>
32      <li>To start the debugger, you have to use **Debug, Debug E
 >xecutable** as for some reason the toolbar debug button will rema
 >in disabled.
33      </li>
34    </ol>
35    <p>
36      Happy XCode debugging! (added by [<a class="external" href=
 >"mailto:ben@mozilla.org|Ben">Goodger</a>] on 10/25/2003)
37    </p>
38    <p>
39      <br>
40    </p>
t40    <h3 name="Creating_the_Project_in_XCode">t
41      Creating the Project in XCode
42    </h3>
43    <p>
44      XCode is Apple's new set of developer tools and IDE, shippi
>ng with MacOS X 10.3 Panther. The instructions for creating a pro 
>ject to debug Mozilla with XCode are slightly different from thos 
>e for ProjectBuilder, and also slightly different than those give 
>n by Apple itself for debugging arbitrary executables! 
45    </p>
46    <ol>
47      <li>Open XCode, and create a new Project with **File, New P
>roject**. Select **Empty Project** as the project type, click Nex 
>t, then name the project and choose a location for it, then click 
> Finish. 
48      </li>
49      <li>Now you need to add the executable. Select **Project, A
>dd Custom Executable** and type a pretty name, then use the **Cho 
>ose** to locate the .app file (Mozilla.app, Firefox.app, DeerPark 
>Debug.app etc) in mozilla/dist. Do not click Finish! 
50      </li>
51      <li>**IMPORTANT** - XCode will dim all UI that lets you run
> the program in the debugger if you just specify the .app file. Y 
>ou must manually locate the Mozilla executable inside the executa 
>ble package and edit the path to point to that location. Thus the 
> value of the Executable Path field might look like this: " ~/bui 
>lds/mozilla/dist/Mozilla.app/Contents/MacOS/Mozilla-bin" (Make su 
>re to select the "-bin" file, the non-"-bin" is just a launch scr 
>ipt.) Now click **Finish** (on xcode 1.2 and higher, just close t 
>he dialog). An entry with the pretty name you entered in the prev 
>ious dialog will appear under the **Executables** branch of the * 
>*Groups &amp; Files** pane in the XCode Project window. 
52      </li>
53      <li>I highly recommend you create a separate profile to deb
>ug with, whatever your task, so that you don't lose precious data 
> like Bookmarks, saved passwords, etc. So that you're not bothere 
>d with the profile manager every time you start to debug, expand  
>the **Executables** branch of the **Groups &amp; Files** list and 
> double click on the Executable you added for Mozilla. Click the  
>plus icon under the **Arguments** list and type "-P &lt;profile n 
>ame&gt;" (e.g. "-P MozillaDebug"). Close the window when you're d 
>one. 
54      </li>
55      <li>To start the debugger, you have to use **Debug, Debug E
>xecutable** as for some reason the toolbar debug button will rema 
>in disabled. 
56      </li>
57    </ol>
58    <p>
59      Happy XCode debugging! (added by [<a class="external" href=
>"mailto:ben@mozilla.org|Ben">Goodger</a>] on 10/25/2003) 
60    </p>

Back to History