Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(675)

Unified Diff: docs/xcode4_tips.md

Issue 1309473002: WIP: Migrate Wiki content over to src/docs (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Created 5 years, 4 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« docs/windows_visual_studio_macros.md ('K') | « docs/writing_clang_plugins.md ('k') | no next file » | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: docs/xcode4_tips.md
diff --git a/docs/xcode4_tips.md b/docs/xcode4_tips.md
new file mode 100644
index 0000000000000000000000000000000000000000..c1f6bb26cae0b75b7c45718a75d6d83037dfdbb6
--- /dev/null
+++ b/docs/xcode4_tips.md
@@ -0,0 +1,41 @@
+# Introduction
+
+This page has the setup instructions for Xcode4. The setup chosen and recommended by most developers is to not use the Xcode4 GUI, but to instead use [ninja](http://code.google.com/p/chromium/wiki/NinjaBuild) at the command line, with your text editor of choice.
+
+**Note that [NIB/XIB files](http://dev.chromium.org/developers/design-documents/mac-xib-files) _must_ be be saved with the Xcode 4.4.x toolchain on Mac OS X 10.8.x**
+
+# Xcode 4 General
+
+ 1. Install the command-line tools (now a separate install) in Xcode → Preferences → Downloads → Components → **Command Line Tools** This is no longer required with Xcode 5.
+ 1. If you're doing a side-by-side install with Xcode3, make sure you install Xcode4 in a separate directory (like /Xcode4) rather than /Developer so you don't overwrite your current devtools version.
+
+## Lion and Mountain Lion
+
+(This used to tell you to set `GYP_DEFINES=mac_sdk=10.6`. That's now done by default an no longer necessary.)
+
+# Xcode 4.3
+
+Starting with Xcode 4.3, the /Developer directory has moved, along with the entire install, to /Applications. If you install Xcode 4.3, you may have to run:
+
+```
+$ sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
+```
+
+# Xcode 4.4
+
+If you install Xcode 4.4, it does not contain the 10.6 SDK. The build will automatically pick an SDK if no 10.6 SDK can be found. This will work fine and is a good way to work on chrome.
+
+However, the bots build with the 10.6 SDK. If you want to do this too, you can symlink it from somewhere else (or copy it from an earlier Xcode version).
+
+```
+$ ln -s /Volumes/SnowLeopard/Developer/SDKs/MacOSX10.6.sdk /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/
+```
+
+# Tips for Using the GUI
+
+ 1. Don’t. Seriously. Have you tried [ninja](http://code.google.com/p/chromium/wiki/NinjaBuild)?
+ 1. Xcode → Preferences → General → Turn **off** Live Issues (for In Editors and In Issue Navigator)
+ 1. Set Xcode → Preferences → Locations → Advanced to **Place build products in locations specified by their targets**
+ 1. Don’t run `gclient runhooks/sync` with the project open. Close it first and then update project files.
+ 1. Xcode → Product → Edit Scheme → Edit the **chrome** scheme and choose the **Run** step to set any arguments (e.g. `--user-data-dir`)
+ 1. Disable indexing by setting a secret pref: `defaults write com.apple.dt.Xcode IDEIndexDisable 1` . This significantly improves things.
« docs/windows_visual_studio_macros.md ('K') | « docs/writing_clang_plugins.md ('k') | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698