2009-12-04 Marc-Antoine Ruel <maruel@chromium.org>
[WebKit-https.git] / WebKitSite / building / tools.html
1 <?php
2 $title = "Installing Developer Tools";
3 include("../header.inc");
4 ?>
5 <h2>Installing the Developer Tools</h2>
6 <div class="mac-instructions">
7 <h4>Mac OS X</h4>
8 <ol>
9 <li><p>Install the Xcode Tools package</p>
10 <p>Install the Xcode Tools package from <a target="installtools" href="http://connect.apple.com/">http://connect.apple.com</a>.  Xcode 2.3 or later is required to build.</p>
11 <li><p>Install a Subversion Client</p>
12 <p>Subversion (svn) is the source code management tool used by the WebKit Open Source Project. A <a target="installtools" href="http://www.collab.net/downloads/community/">Subversion client for Mac OS X 10.4 and later</a> is available.</p>
13 </ol>
14 </div>
15
16 <div class="windows-instructions">
17 <h4>Windows</h4>
18 <ol>
19 <li><p>If you own Visual Studio 2005 (newer versions of Visual Studio are currently unsupported):</p>
20 <p>Install <a target="installtools" href="http://www.microsoft.com/downloads/details.aspx?familyid=BB4A75AB-E2D4-4C96-B39D-37BAF6B5B1DC&displaylang=en">Microsoft Visual Studio 2005 Team Suite Service Pack 1</a>.</p>
21 <p>If you are building from Vista, install <a target="installtools" href="http://www.microsoft.com/downloads/details.aspx?FamilyID=90e2942d-3ad1-4873-a2ee-4acc0aace5b6&displaylang=en">Service Pack 1 Update for Windows Vista</a>.</p>
22 <p>Install <a target="installtools" href="http://www.microsoft.com/downloads/details.aspx?FamilyID=7c8729dc-06a2-4538-a90d-ff9464dc0197&displaylang=en">Visual Studio 2005 Service Pack 1 ATL Security Update</a>.</p>
23 <p>Install the following hotfixes to improve Visual Studio's performance and responsiveness:
24 <ol>
25 <li><a target="installtools" href="http://code.msdn.microsoft.com/KB918559">KB918559</a></li>
26 <li><a target="installtools" href="http://code.msdn.microsoft.com/KB935225">KB935225</a></li>
27 <li><a target="installtools" href="http://code.msdn.microsoft.com/KB943969">KB943969</a></li>
28 <li><a target="installtools" href="http://code.msdn.microsoft.com/KB947315">KB947315</a></li>
29 </ol>
30 </p>
31 <p>Use the default options for these installations.</p>
32 <li><p>If not, you can use Visual C++ Express 2005 (newer versions of Visual C++ Express Edition are currently unsupported):</p>
33 <p>Install <a target="installtools" href="http://go.microsoft.com/fwlink/?LinkId=51410">Visual C++ 2005 Express</a>.</p>
34 <p>Install <a target="installtools" href="http://download.microsoft.com/download/7/7/3/7737290f-98e8-45bf-9075-85cc6ae34bf1/VS80sp1-KB926748-X86-INTL.exe">Microsoft Visual C++ Express 2005 Service Pack 1</a>.</p>
35 <p>If you are building from Vista, install <a target="installtools" href="http://www.microsoft.com/downloads/details.aspx?FamilyID=90e2942d-3ad1-4873-a2ee-4acc0aace5b6&displaylang=en">Service Pack 1 Update for Windows Vista</a>.</p>
36 <p>Install <a target="installtools" href="http://www.microsoft.com/downloads/details.aspx?FamilyID=7c8729dc-06a2-4538-a90d-ff9464dc0197&displaylang=en">Visual Studio 2005 Service Pack 1 ATL Security Update</a>.</p>
37 <p>Install the <a target="installtools" href="http://www.microsoft.com/downloads/details.aspx?familyid=0baf2b35-c656-4969-ace8-e4c0c0716adb&displaylang=en">Windows Server 2003 R2 Platform SDK</a>, then follow steps 2 and 3 of &ldquo;<a target="installtools" href="http://msdn.microsoft.com/en-us/library/ms235626(VS.80).aspx">How to: Use Visual C++ Express Edition with the Microsoft Platform SDK</a>.&rdquo;</p>
38 <p>Use the default options for all installations.</p>
39 <p>In addition to the paths specified in step 3 of the Platform SDK installation instructions, you must also add the following include path. Update the Visual C++ directories in the Projects and Solutions section in the Options dialog box:</p>
40 <p style="font-size:10px">C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Include\mfc</p>
41
42 <li><p>Install Cygwin</p>
43 <p>Cygwin is a collection of utilities for Windows that includes not only a Subversion
44 client, but also additional tools that are required to build the WebKit source.  We
45 have made a downloader available that automatically collects all of the required
46 packages.
47 <p>Download <a
48 href="http://svn.webkit.org/repository/webkit/trunk/WebKitTools/CygwinDownloader/cygwin-downloader.zip">cygwin-downloader.zip</a>.</p>
49 <p>Right-click <tt>cygwin-downloader.zip</tt> and choose <b>Extract All...</b>.
50 Keep all the default options and click <b>Next</b> until the file is extracted and the cygwin-downloader folder opens.</p>
51 <p>Double-click <tt>cygwin-downloader.exe</tt>. This will download all the Cygwin packages you need.</p>
52 <p>When all the packages have finished downloading, the Cygwin installer will launch. Choose <b>Install from Local Directory</b>, then click <b>Next</b> until the install is complete. If you are running Vista, the installer won't be able to launch automatically, so you will have to manually launch Cygwin's Setup.exe.</p>
53 <P>Vista may warn you that Cygwin did not install correctly. Ignore this warning and tell Vista that the install was successful.</p>
54 <p>If you are running Vista, click on the Start menu, enter the following command, and press Enter:</p>
55 <p class="code">C:\cygwin\bin\ash -c /bin/rebaseall</p>
56
57 <li><p>Install QuickTime SDK</p>
58 <p>Download QuickTime SDK for Windows from <a href="http://developer.apple.com/quicktime/download/">http://developer.apple.com/quicktime/download/</a> and install it to the default location (\Program Files\QuickTime SDK). This is needed for media support.
59 </ol>
60 </div>
61
62 <div class="gtk-instructions">
63 <h4>GTK</h4>
64 Follow the instructions on the <a href="http://trac.webkit.org/wiki/BuildingGtk">BuildingGTK</a> wiki page.
65 </div>
66
67 <div class="qt-instructions">
68 <h4>QT</h4>
69 Follow the instructions on the <a href="http://trac.webkit.org/wiki/QtWebKit">QtWebKit</a> wiki page.
70 </div>
71
72 <p>Once you have installed your developer tools, the next step is
73 <a href="checkout.html">getting the code</a>.</p>
74 <?php
75 include("../footer.inc");
76 ?>