Bug 80429 - Working With Code > Installing Developer Tools needs to be updated with OS X Lion & App Store details
Summary: Working With Code > Installing Developer Tools needs to be updated with OS X ...
Status: RESOLVED FIXED
Alias: None
Product: WebKit
Classification: Unclassified
Component: WebKit Website (show other bugs)
Version: 528+ (Nightly build)
Hardware: Unspecified Unspecified
: P2 Normal
Assignee: Nobody
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-03-06 10:42 PST by Rebecca Hauck
Modified: 2012-03-20 00:55 PDT (History)
2 users (show)

See Also:


Attachments
patch with update to XCode installation instructions (1.67 KB, patch)
2012-03-06 11:19 PST, Rebecca Hauck
no flags Details | Formatted Diff | Diff
updated doc with specific XCode version (1.67 KB, patch)
2012-03-06 13:16 PST, Rebecca Hauck
mrowe: review-
Details | Formatted Diff | Diff
changed XCode to Xcode & shortened the Note (1.49 KB, patch)
2012-03-06 14:05 PST, Rebecca Hauck
mitz: review-
Details | Formatted Diff | Diff
closed <p> tag (1.49 KB, application/octet-stream)
2012-03-13 09:58 PDT, Rebecca Hauck
no flags Details
closed <p> tag (1.49 KB, patch)
2012-03-13 09:59 PDT, Rebecca Hauck
mitz: review+
rhauck: commit-queue-
Details | Formatted Diff | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Rebecca Hauck 2012-03-06 10:42:48 PST
With OSX 10.7, the default method for installing XCode now sends you through the App Store.  Installing XCode through the App Store does not install the Command Line tools by default, so this additional step needs to be added to this section of of webkit.org.
Comment 1 Rebecca Hauck 2012-03-06 11:19:17 PST
Created attachment 130417 [details]
patch with update to XCode installation instructions
Comment 2 Rebecca Hauck 2012-03-06 13:16:18 PST
Created attachment 130432 [details]
updated doc with specific XCode version
Comment 3 Mark Rowe (bdash) 2012-03-06 13:44:43 PST
Comment on attachment 130432 [details]
updated doc with specific XCode version

View in context: https://bugs.webkit.org/attachment.cgi?id=130432&action=review

I'd suggest rewording this to look something like:

Install the Xcode Command Line Tools (Xcode 4.3 and newer)
Xcode 4.3 and newer do not install the command line tools by default. You should install them from Xcode's Downloads preference pane.

> Websites/webkit.org/building/tools.html:11
> +<li><p>Install the XCode Command Line Tools (located under XCode Preferences > Downloads)

As you can see in the lines above, it's "Xcode" and not XCode.
Comment 4 Darin Adler 2012-03-06 13:45:19 PST
Comment on attachment 130432 [details]
updated doc with specific XCode version

View in context: https://bugs.webkit.org/attachment.cgi?id=130432&action=review

> Websites/webkit.org/building/tools.html:12
> +<li><p>Install the XCode Command Line Tools (located under XCode Preferences > Downloads)
> +    <p><b>Note:</b> In XCode versions earlier than 4.3, these are already installed by default, so this is not a required step. If installing XCode 4.3 for Lion or higher through the App Store, the command line tools are not be installed by default and this is required.

It’s Xcode, not XCode.

Also, the Note is too long! It should just say “This step is not required for versions of Xcode older than 4.3.”
Comment 5 Rebecca Hauck 2012-03-06 14:05:53 PST
Created attachment 130440 [details]
changed XCode to Xcode & shortened the Note
Comment 6 mitz 2012-03-06 18:49:39 PST
(In reply to comment #0)
> With OSX 10.7, the default method for installing XCode now sends you through the App Store.  Installing XCode through the App Store does not install the Command Line tools by default, so this additional step needs to be added to this section of of webkit.org.

It’s good to document this, but it would be even better to change the various WebKit tools that currently depend on the Command Line Tools component to not do so.
Comment 7 Rebecca Hauck 2012-03-07 09:09:09 PST
(In reply to comment #6)
> (In reply to comment #0)
> > With OSX 10.7, the default method for installing XCode now sends you through the App Store.  Installing XCode through the App Store does not install the Command Line tools by default, so this additional step needs to be added to this section of of webkit.org.
> 
> It’s good to document this, but it would be even better to change the various WebKit tools that currently depend on the Command Line Tools component to not do so.


Thanks for the comment.  What do you mean by that? Is it possible to build WebKit without the Xcode command line tools?
Comment 8 mitz 2012-03-07 12:06:14 PST
(In reply to comment #7)
> (In reply to comment #6)
> > (In reply to comment #0)
> > > With OSX 10.7, the default method for installing XCode now sends you through the App Store.  Installing XCode through the App Store does not install the Command Line tools by default, so this additional step needs to be added to this section of of webkit.org.
> > 
> > It’s good to document this, but it would be even better to change the various WebKit tools that currently depend on the Command Line Tools component to not do so.
> 
> 
> Thanks for the comment.  What do you mean by that? Is it possible to build WebKit without the Xcode command line tools?

I believe you when you say that it is currently not possible to do so. Without knowing exactly what issues you run into I can’t tell for sure how they can be resolved, but I believe it would mostly involve using xcrun(1) to invoke certain tools where the scripts currently don’t, and perhaps running xcode-select(1) once.
Comment 9 mitz 2012-03-07 18:06:23 PST
(In reply to comment #8)

> Without knowing exactly what issues you run into I can’t tell for sure how they can be resolved, but I believe it would mostly involve using xcrun(1) to invoke certain tools where the scripts currently don’t, and perhaps running xcode-select(1) once.

Starting from a fresh install of OS X 10.7.3, after installing Xcode 4.3.1 from the Mac App Store and the Java for Mac OS X 10.7 Update 1 Developer Package from <http://connect.apple.com/>, I was able to syaty building WebKit with this command (the build hasn’t finished yet):
    Tools/Scripts/build-webkit --debug SDKROOT=/Applications/Xcode.appl/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.7.sdk

I did get a couple of errors about not being able to find ranlib, when build-webkit tried to copy WebKitSystemInterface to the built products directory. The script needs to be changes to invoke ranlib via xcrun.
Comment 10 mitz 2012-03-07 18:06:54 PST
s/syaty/start/
Comment 11 mitz 2012-03-07 18:15:47 PST
It occurs to me that installing the Java package was unnecessary, since it is included in the Mac OS X 10.7 SDK. It only served to bypass build-webkit’s check for its presence in /.
Comment 12 Rebecca Hauck 2012-03-12 17:42:06 PDT
(In reply to comment #9)
> (In reply to comment #8)
> 
> > Without knowing exactly what issues you run into I can’t tell for sure how they can be resolved, but I believe it would mostly involve using xcrun(1) to invoke certain tools where the scripts currently don’t, and perhaps running xcode-select(1) once.
> 
> Starting from a fresh install of OS X 10.7.3, after installing Xcode 4.3.1 from the Mac App Store and the Java for Mac OS X 10.7 Update 1 Developer Package from <http://connect.apple.com/>, I was able to syaty building WebKit with this command (the build hasn’t finished yet):
>     Tools/Scripts/build-webkit --debug SDKROOT=/Applications/Xcode.appl/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.7.sdk
> 
> I did get a couple of errors about not being able to find ranlib, when build-webkit tried to copy WebKitSystemInterface to the built products directory. The script needs to be changes to invoke ranlib via xcrun.

Do you think modifying the script is a better way to go than updating webkit.org? If so, shouldn't that be a separate bug?  As is is now with installing 4.3 or higher, there are definitely 2 additional steps: 1) installing the command line tools and 2) running xcode-select -switch to point to /Applications/Xcode.app/Contents/Developer .   The build-webkit script does inform you of these two things, but it might be nice to have it documented up front as well.
Comment 13 Mark Rowe (bdash) 2012-03-12 17:44:08 PDT
Dan's point is that it shouldn't be necessary to install the command line tools package.  If it's not necessary to install that package then there's no need to update the instructions.  I'd suggest that we file a new bug about fixing things to not require the CLI tools, fix it, and then close this bug without doing anything.
Comment 14 mitz 2012-03-12 18:00:04 PDT
(In reply to comment #13)
> Dan's point is that it shouldn't be necessary to install the command line tools package.  If it's not necessary to install that package then there's no need to update the instructions.

That was my point. However, there is another issue with building without the Command Line Tools, which I don’t know immediately how to solve.

> I'd suggest that we file a new bug about fixing things to not require the CLI tools, fix it, and then close this bug without doing anything.

I filed bug 80915. In the meantime, I think it’s fine to change the instructions.
Comment 15 mitz 2012-03-12 18:01:44 PDT
Comment on attachment 130440 [details]
changed XCode to Xcode & shortened the Note

View in context: https://bugs.webkit.org/attachment.cgi?id=130440&action=review

> Websites/webkit.org/building/tools.html:11
> +<li><p>Install the Xcode Command Line Tools (located under Xcode Preferences > Downloads)    <p><b>Note:</b> This step is not required for versions of Xcode older than 4.3.

Please close the <p> tags.
Comment 16 Rebecca Hauck 2012-03-13 09:58:11 PDT
Created attachment 131645 [details]
closed <p> tag

Fixed  <p> tag per Dan's comment.
Comment 17 Rebecca Hauck 2012-03-13 09:59:30 PDT
Created attachment 131646 [details]
closed <p> tag

Fixed <p> tag per Dan's comment.
Comment 18 mitz 2012-03-13 10:54:10 PDT
Comment on attachment 131646 [details]
closed <p> tag

You closed one <p> but not the other. I will fix this when committing the patch.
Comment 19 mitz 2012-03-13 10:57:49 PDT
Landed in <http://trac.webkit.org/r110579>.
Comment 20 Eric Seidel (no email) 2012-03-20 00:55:13 PDT
Comment on attachment 131645 [details]
closed <p> tag

Cleared review? from attachment 131645 [details] so that this bug does not appear in http://webkit.org/pending-review.  If you would like this patch reviewed, please attach it to a new bug (or re-open this bug before marking it for review again).