986b7517b6a2eceb505290888b3d8ad4070e48d1
[WebKit-https.git] / Tools / Scripts / webkitdirs.pm
1 # Copyright (C) 2005, 2006, 2007, 2010, 2011, 2012, 2013 Apple Inc. All rights reserved.
2 # Copyright (C) 2009 Google Inc. All rights reserved.
3 # Copyright (C) 2011 Research In Motion Limited. All rights reserved.
4 #
5 # Redistribution and use in source and binary forms, with or without
6 # modification, are permitted provided that the following conditions
7 # are met:
8 #
9 # 1.  Redistributions of source code must retain the above copyright
10 #     notice, this list of conditions and the following disclaimer. 
11 # 2.  Redistributions in binary form must reproduce the above copyright
12 #     notice, this list of conditions and the following disclaimer in the
13 #     documentation and/or other materials provided with the distribution. 
14 # 3.  Neither the name of Apple Computer, Inc. ("Apple") nor the names of
15 #     its contributors may be used to endorse or promote products derived
16 #     from this software without specific prior written permission. 
17 #
18 # THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
19 # EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
20 # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21 # DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
22 # DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
23 # (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
24 # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
25 # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 # THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28
29 # Module to share code to get to WebKit directories.
30
31 use strict;
32 use version;
33 use warnings;
34 use Config;
35 use Digest::MD5 qw(md5_hex);
36 use FindBin;
37 use File::Basename;
38 use File::Path qw(mkpath rmtree);
39 use File::Spec;
40 use File::stat;
41 use POSIX;
42 use VCSUtils;
43
44 BEGIN {
45    use Exporter   ();
46    our ($VERSION, @ISA, @EXPORT, @EXPORT_OK, %EXPORT_TAGS);
47    $VERSION     = 1.00;
48    @ISA         = qw(Exporter);
49    @EXPORT      = qw(
50        &XcodeOptionString
51        &XcodeOptionStringNoConfig
52        &XcodeOptions
53        &baseProductDir
54        &chdirWebKit
55        &checkFrameworks
56        &cmakeBasedPortArguments
57        &cmakeBasedPortName
58        &currentSVNRevision
59        &debugSafari
60        &nmPath
61        &passedConfiguration
62        &printHelpAndExitForRunAndDebugWebKitAppIfNeeded
63        &productDir
64        &runMacWebKitApp
65        &safariPath
66        &setConfiguration
67        USE_OPEN_COMMAND
68    );
69    %EXPORT_TAGS = ( );
70    @EXPORT_OK   = ();
71 }
72
73 use constant USE_OPEN_COMMAND => 1; # Used in runMacWebKitApp().
74 use constant INCLUDE_OPTIONS_FOR_DEBUGGING => 1;
75
76 our @EXPORT_OK;
77
78 my $architecture;
79 my $numberOfCPUs;
80 my $baseProductDir;
81 my @baseProductDirOption;
82 my $configuration;
83 my $xcodeSDK;
84 my $configurationForVisualStudio;
85 my $configurationProductDir;
86 my $sourceDir;
87 my $currentSVNRevision;
88 my $debugger;
89 my $nmPath;
90 my $osXVersion;
91 my $generateDsym;
92 my $isGtk;
93 my $isWinCE;
94 my $isWinCairo;
95 my $isWin64;
96 my $isEfl;
97 my $isBlackBerry;
98 my $isInspectorFrontend;
99 my $isWK2;
100 my $shouldTargetWebProcess;
101 my $shouldUseXPCServiceForWebProcess;
102 my $shouldUseGuardMalloc;
103 my $xcodeVersion;
104
105 # Variables for Win32 support
106 my $programFilesPath;
107 my $vcBuildPath;
108 my $vsInstallDir;
109 my $vsVersion;
110 my $windowsSourceDir;
111 my $winVersion;
112 my $willUseVCExpressWhenBuilding = 0;
113
114 # Defined in VCSUtils.
115 sub exitStatus($);
116
117 sub findMatchingArguments($$);
118 sub hasArgument($$);
119
120 sub determineSourceDir
121 {
122     return if $sourceDir;
123     $sourceDir = $FindBin::Bin;
124     $sourceDir =~ s|/+$||; # Remove trailing '/' as we would die later
125
126     # walks up path checking each directory to see if it is the main WebKit project dir, 
127     # defined by containing Sources, WebCore, and WebKit
128     until ((-d "$sourceDir/Source" && -d "$sourceDir/Source/WebCore" && -d "$sourceDir/Source/WebKit") || (-d "$sourceDir/Internal" && -d "$sourceDir/OpenSource"))
129     {
130         if ($sourceDir !~ s|/[^/]+$||) {
131             die "Could not find top level webkit directory above source directory using FindBin.\n";
132         }
133     }
134
135     $sourceDir = "$sourceDir/OpenSource" if -d "$sourceDir/OpenSource";
136 }
137
138 sub currentPerlPath()
139 {
140     my $thisPerl = $^X;
141     if ($^O ne 'VMS') {
142         $thisPerl .= $Config{_exe} unless $thisPerl =~ m/$Config{_exe}$/i;
143     }
144     return $thisPerl;
145 }
146
147 # used for scripts which are stored in a non-standard location
148 sub setSourceDir($)
149 {
150     ($sourceDir) = @_;
151 }
152
153 sub determineXcodeVersion
154 {
155     return if defined $xcodeVersion;
156     my $xcodebuildVersionOutput = `xcodebuild -version`;
157     $xcodeVersion = ($xcodebuildVersionOutput =~ /Xcode ([0-9](\.[0-9]+)*)/) ? $1 : "3.0";
158 }
159
160 sub readXcodeUserDefault($)
161 {
162     my ($unprefixedKey) = @_;
163
164     determineXcodeVersion();
165
166     my $xcodeDefaultsDomain = (eval "v$xcodeVersion" lt v4) ? "com.apple.Xcode" : "com.apple.dt.Xcode";
167     my $xcodeDefaultsPrefix = (eval "v$xcodeVersion" lt v4) ? "PBX" : "IDE";
168     my $devnull = File::Spec->devnull();
169
170     my $value = `defaults read $xcodeDefaultsDomain ${xcodeDefaultsPrefix}${unprefixedKey} 2> ${devnull}`;
171     return if $?;
172
173     chomp $value;
174     return $value;
175 }
176
177 sub determineBaseProductDir
178 {
179     return if defined $baseProductDir;
180     determineSourceDir();
181
182     my $setSharedPrecompsDir;
183     $baseProductDir = $ENV{"WEBKIT_OUTPUTDIR"};
184
185     if (!defined($baseProductDir) and isAppleMacWebKit()) {
186         # Silently remove ~/Library/Preferences/xcodebuild.plist which can
187         # cause build failure. The presence of
188         # ~/Library/Preferences/xcodebuild.plist can prevent xcodebuild from
189         # respecting global settings such as a custom build products directory
190         # (<rdar://problem/5585899>).
191         my $personalPlistFile = $ENV{HOME} . "/Library/Preferences/xcodebuild.plist";
192         if (-e $personalPlistFile) {
193             unlink($personalPlistFile) || die "Could not delete $personalPlistFile: $!";
194         }
195
196         determineXcodeVersion();
197
198         if (eval "v$xcodeVersion" ge v4) {
199             my $buildLocationStyle = join '', readXcodeUserDefault("BuildLocationStyle");
200             if ($buildLocationStyle eq "Custom") {
201                 my $buildLocationType = join '', readXcodeUserDefault("CustomBuildLocationType");
202                 # FIXME: Read CustomBuildIntermediatesPath and set OBJROOT accordingly.
203                 $baseProductDir = readXcodeUserDefault("CustomBuildProductsPath") if $buildLocationType eq "Absolute";
204             }
205
206             # DeterminedByTargets corresponds to a setting of "Legacy" in Xcode.
207             # It is the only build location style for which SHARED_PRECOMPS_DIR is not
208             # overridden when building from within Xcode.
209             $setSharedPrecompsDir = 1 if $buildLocationStyle ne "DeterminedByTargets";
210         }
211
212         if (!defined($baseProductDir)) {
213             $baseProductDir = join '', readXcodeUserDefault("ApplicationwideBuildSettings");
214             $baseProductDir = $1 if $baseProductDir =~ /SYMROOT\s*=\s*\"(.*?)\";/s;
215         }
216
217         undef $baseProductDir unless $baseProductDir =~ /^\//;
218     }
219
220     if (!defined($baseProductDir)) { # Port-specific checks failed, use default
221         $baseProductDir = "$sourceDir/WebKitBuild";
222     }
223
224     if (isBlackBerry()) {
225         my %archInfo = blackberryTargetArchitecture();
226         $baseProductDir = "$baseProductDir/" . $archInfo{"cpuDir"};
227     }
228
229     if (isGit() && isGitBranchBuild()) {
230         my $branch = gitBranch();
231         $baseProductDir = "$baseProductDir/$branch";
232     }
233
234     if (isAppleMacWebKit()) {
235         $baseProductDir =~ s|^\Q$(SRCROOT)/..\E$|$sourceDir|;
236         $baseProductDir =~ s|^\Q$(SRCROOT)/../|$sourceDir/|;
237         $baseProductDir =~ s|^~/|$ENV{HOME}/|;
238         die "Can't handle Xcode product directory with a ~ in it.\n" if $baseProductDir =~ /~/;
239         die "Can't handle Xcode product directory with a variable in it.\n" if $baseProductDir =~ /\$/;
240         @baseProductDirOption = ("SYMROOT=$baseProductDir", "OBJROOT=$baseProductDir");
241         push(@baseProductDirOption, "SHARED_PRECOMPS_DIR=${baseProductDir}/PrecompiledHeaders") if $setSharedPrecompsDir;
242     }
243
244     if (isCygwin()) {
245         my $dosBuildPath = `cygpath --windows \"$baseProductDir\"`;
246         chomp $dosBuildPath;
247         $ENV{"WEBKIT_OUTPUTDIR"} = $dosBuildPath;
248         my $unixBuildPath = `cygpath --unix \"$baseProductDir\"`;
249         chomp $unixBuildPath;
250         $baseProductDir = $unixBuildPath;
251     }
252 }
253
254 sub setBaseProductDir($)
255 {
256     ($baseProductDir) = @_;
257 }
258
259 sub determineConfiguration
260 {
261     return if defined $configuration;
262     determineBaseProductDir();
263     if (open CONFIGURATION, "$baseProductDir/Configuration") {
264         $configuration = <CONFIGURATION>;
265         close CONFIGURATION;
266     }
267     if ($configuration) {
268         chomp $configuration;
269         # compatibility for people who have old Configuration files
270         $configuration = "Release" if $configuration eq "Deployment";
271         $configuration = "Debug" if $configuration eq "Development";
272     } else {
273         $configuration = "Release";
274     }
275
276     if ($configuration && isWinCairo()) {
277         unless ($configuration =~ /_WinCairo$/) {
278             $configuration .= "_WinCairo";
279         }
280     }
281 }
282
283 sub determineArchitecture
284 {
285     return if defined $architecture;
286     # make sure $architecture is defined in all cases
287     $architecture = "";
288
289     determineBaseProductDir();
290     determineXcodeSDK();
291
292     if (isGtk()) {
293         determineConfigurationProductDir();
294         my $host_triple = `grep -E '^host = ' $configurationProductDir/GNUmakefile 2> /dev/null`;
295         if ($host_triple =~ m/^host = ([^-]+)-/) {
296             # We have a configured build tree; use it.
297             $architecture = $1;
298         }
299     } elsif (isAppleMacWebKit()) {
300         if (open ARCHITECTURE, "$baseProductDir/Architecture") {
301             $architecture = <ARCHITECTURE>;
302             close ARCHITECTURE;
303         }
304         if ($architecture) {
305             chomp $architecture;
306         } else {
307             if (not defined $xcodeSDK or $xcodeSDK =~ /^(\/$|macosx)/) {
308                 my $supports64Bit = `sysctl -n hw.optional.x86_64`;
309                 chomp $supports64Bit;
310                 $architecture = 'x86_64' if $supports64Bit;
311             } elsif ($xcodeSDK =~ /^iphonesimulator/) {
312                 $architecture = 'i386';
313             } elsif ($xcodeSDK =~ /^iphoneos/) {
314                 $architecture = 'armv7';
315             }
316         }
317     } elsif (isEfl()) {
318         my $host_processor = "";
319         $host_processor = `cmake --system-information | grep CMAKE_SYSTEM_PROCESSOR`;
320         if ($host_processor =~ m/^CMAKE_SYSTEM_PROCESSOR \"([^"]+)\"/) {
321             # We have a configured build tree; use it.
322             $architecture = $1;
323             $architecture = 'x86_64' if $architecture eq 'amd64';
324         }
325     }
326
327     if (!$architecture && (isGtk() || isAppleMacWebKit() || isEfl())) {
328         # Fall back to output of `arch', if it is present.
329         $architecture = `arch`;
330         chomp $architecture;
331     }
332
333     if (!$architecture && (isGtk() || isAppleMacWebKit() || isEfl())) {
334         # Fall back to output of `uname -m', if it is present.
335         $architecture = `uname -m`;
336         chomp $architecture;
337     }
338 }
339
340 sub determineNumberOfCPUs
341 {
342     return if defined $numberOfCPUs;
343     if (defined($ENV{NUMBER_OF_PROCESSORS})) {
344         $numberOfCPUs = $ENV{NUMBER_OF_PROCESSORS};
345     } elsif (isLinux()) {
346         # First try the nproc utility, if it exists. If we get no
347         # results fall back to just interpretting /proc directly.
348         chomp($numberOfCPUs = `nproc --all 2> /dev/null`);
349         if ($numberOfCPUs eq "") {
350             $numberOfCPUs = (grep /processor/, `cat /proc/cpuinfo`);
351         }
352     } elsif (isWindows() || isCygwin()) {
353         # Assumes cygwin
354         $numberOfCPUs = `ls /proc/registry/HKEY_LOCAL_MACHINE/HARDWARE/DESCRIPTION/System/CentralProcessor | wc -w`;
355     } elsif (isDarwin() || isFreeBSD()) {
356         chomp($numberOfCPUs = `sysctl -n hw.ncpu`);
357     }
358 }
359
360 sub jscPath($)
361 {
362     my ($productDir) = @_;
363     my $jscName = "jsc";
364     $jscName .= "_debug"  if configurationForVisualStudio() eq "Debug_All";
365     $jscName .= ".exe" if (isWindows() || isCygwin());
366     return "$productDir/$jscName" if -e "$productDir/$jscName";
367     return "$productDir/JavaScriptCore.framework/Resources/$jscName";
368 }
369
370 sub argumentsForConfiguration()
371 {
372     determineConfiguration();
373     determineArchitecture();
374
375     my @args = ();
376     push(@args, '--debug') if $configuration eq "Debug";
377     push(@args, '--release') if $configuration eq "Release";
378     push(@args, '--32-bit') if ($architecture ne "x86_64" and !hasArgument('--64-bit', \@ARGV));
379     push(@args, '--gtk') if isGtk();
380     push(@args, '--efl') if isEfl();
381     push(@args, '--wincairo') if isWinCairo();
382     push(@args, '--wince') if isWinCE();
383     push(@args, '--blackberry') if isBlackBerry();
384     push(@args, '--inspector-frontend') if isInspectorFrontend();
385     return @args;
386 }
387
388 sub determineXcodeSDK
389 {
390     return if defined $xcodeSDK;
391     for (my $i = 0; $i <= $#ARGV; $i++) {
392         my $opt = $ARGV[$i];
393         if ($opt =~ /^--sdk$/i) {
394             splice(@ARGV, $i, 1);
395             $xcodeSDK = splice(@ARGV, $i, 1);
396         } elsif ($opt =~ /^--device$/i) {
397             splice(@ARGV, $i, 1);
398             $xcodeSDK = 'iphoneos.internal';
399         } elsif ($opt =~ /^--sim(ulator)?/i) {
400             splice(@ARGV, $i, 1);
401             $xcodeSDK = 'iphonesimulator';
402         }
403     }
404 }
405
406 sub xcodeSDK
407 {
408     determineXcodeSDK();
409     return $xcodeSDK;
410 }
411
412 sub xcodeSDKPlatformName()
413 {
414     determineXcodeSDK();
415     return "" if !defined $xcodeSDK;
416     return "iphoneos" if $xcodeSDK =~ /iphoneos/i;
417     return "iphonesimulator" if $xcodeSDK =~ /iphonesimulator/i;
418     return "macosx" if $xcodeSDK =~ /macosx/i;
419     die "Couldn't determine platform name from Xcode SDK";
420 }
421
422 sub programFilesPath
423 {
424     return $programFilesPath if defined $programFilesPath;
425
426     $programFilesPath = $ENV{'PROGRAMFILES(X86)'} || $ENV{'PROGRAMFILES'} || "C:\\Program Files";
427
428     return $programFilesPath;
429 }
430
431 sub visualStudioInstallDir
432 {
433     return $vsInstallDir if defined $vsInstallDir;
434
435     if ($ENV{'VSINSTALLDIR'}) {
436         $vsInstallDir = $ENV{'VSINSTALLDIR'};
437         $vsInstallDir =~ s|[\\/]$||;
438     } else {
439         $vsInstallDir = File::Spec->catdir(programFilesPath(), "Microsoft Visual Studio 10.0");
440     }
441     chomp($vsInstallDir = `cygpath "$vsInstallDir"`) if isCygwin();
442
443     return $vsInstallDir;
444 }
445
446 sub visualStudioVersion
447 {
448     return $vsVersion if defined $vsVersion;
449
450     my $installDir = visualStudioInstallDir();
451
452     $vsVersion = ($installDir =~ /Microsoft Visual Studio ([0-9]+\.[0-9]*)/) ? $1 : "8";
453
454     return $vsVersion;
455 }
456
457 sub determineConfigurationForVisualStudio
458 {
459     return if defined $configurationForVisualStudio;
460     determineConfiguration();
461     # FIXME: We should detect when Debug_All or Production has been chosen.
462     $configurationForVisualStudio = $configuration;
463 }
464
465 sub usesPerConfigurationBuildDirectory
466 {
467     # [Gtk] We don't have Release/Debug configurations in straight
468     # autotool builds (non build-webkit). In this case and if
469     # WEBKIT_OUTPUTDIR exist, use that as our configuration dir. This will
470     # allows us to run run-webkit-tests without using build-webkit.
471     return ($ENV{"WEBKIT_OUTPUTDIR"} && isGtk()) || isAppleWinWebKit();
472 }
473
474 sub determineConfigurationProductDir
475 {
476     return if defined $configurationProductDir;
477     determineBaseProductDir();
478     determineConfiguration();
479     if (isAppleWinWebKit()) {
480         my $binDir = "bin32";
481         $configurationProductDir = File::Spec->catdir($baseProductDir, configurationForVisualStudio(), $binDir);
482     } else {
483         if (usesPerConfigurationBuildDirectory()) {
484             $configurationProductDir = "$baseProductDir";
485         } else {
486             $configurationProductDir = "$baseProductDir/$configuration";
487             $configurationProductDir .= "-" . xcodeSDKPlatformName() if isIOSWebKit();
488         }
489     }
490 }
491
492 sub setConfigurationProductDir($)
493 {
494     ($configurationProductDir) = @_;
495 }
496
497 sub determineCurrentSVNRevision
498 {
499     # We always update the current SVN revision here, and leave the caching
500     # to currentSVNRevision(), so that changes to the SVN revision while the
501     # script is running can be picked up by calling this function again.
502     determineSourceDir();
503     $currentSVNRevision = svnRevisionForDirectory($sourceDir);
504     return $currentSVNRevision;
505 }
506
507
508 sub chdirWebKit
509 {
510     determineSourceDir();
511     chdir $sourceDir or die;
512 }
513
514 sub baseProductDir
515 {
516     determineBaseProductDir();
517     return $baseProductDir;
518 }
519
520 sub sourceDir
521 {
522     determineSourceDir();
523     return $sourceDir;
524 }
525
526 sub productDir
527 {
528     determineConfigurationProductDir();
529     return $configurationProductDir;
530 }
531
532 sub jscProductDir
533 {
534     my $productDir = productDir();
535     $productDir .= "/bin" if isEfl();
536     $productDir .= "/Programs" if isGtk();
537
538     return $productDir;
539 }
540
541 sub configuration()
542 {
543     determineConfiguration();
544     return $configuration;
545 }
546
547 sub configurationForVisualStudio()
548 {
549     determineConfigurationForVisualStudio();
550     return $configurationForVisualStudio;
551 }
552
553 sub currentSVNRevision
554 {
555     determineCurrentSVNRevision() if not defined $currentSVNRevision;
556     return $currentSVNRevision;
557 }
558
559 sub generateDsym()
560 {
561     determineGenerateDsym();
562     return $generateDsym;
563 }
564
565 sub determineGenerateDsym()
566 {
567     return if defined($generateDsym);
568     $generateDsym = checkForArgumentAndRemoveFromARGV("--dsym");
569 }
570
571 sub argumentsForXcode()
572 {
573     my @args = ();
574     push @args, "DEBUG_INFORMATION_FORMAT=dwarf-with-dsym" if generateDsym();
575     return @args;
576 }
577
578 sub XcodeOptions
579 {
580     determineBaseProductDir();
581     determineConfiguration();
582     determineArchitecture();
583     determineXcodeSDK();
584
585     my @sdkOption = ($xcodeSDK ? "SDKROOT=$xcodeSDK" : ());
586     my @architectureOption = ($architecture ? "ARCHS=$architecture" : ());
587
588     return (@baseProductDirOption, "-configuration", $configuration, @architectureOption, @sdkOption, argumentsForXcode());
589 }
590
591 sub XcodeOptionString
592 {
593     return join " ", XcodeOptions();
594 }
595
596 sub XcodeOptionStringNoConfig
597 {
598     return join " ", @baseProductDirOption;
599 }
600
601 sub XcodeCoverageSupportOptions()
602 {
603     my @coverageSupportOptions = ();
604     push @coverageSupportOptions, "GCC_GENERATE_TEST_COVERAGE_FILES=YES";
605     push @coverageSupportOptions, "GCC_INSTRUMENT_PROGRAM_FLOW_ARCS=YES";
606     return @coverageSupportOptions;
607 }
608
609 my $passedConfiguration;
610 my $searchedForPassedConfiguration;
611 sub determinePassedConfiguration
612 {
613     return if $searchedForPassedConfiguration;
614     $searchedForPassedConfiguration = 1;
615
616     for my $i (0 .. $#ARGV) {
617         my $opt = $ARGV[$i];
618         if ($opt =~ /^--debug$/i) {
619             splice(@ARGV, $i, 1);
620             $passedConfiguration = "Debug";
621             $passedConfiguration .= "_WinCairo" if (isWinCairo() && isCygwin());
622             $passedConfiguration .= "|x64" if isWin64();
623             return;
624         }
625         if ($opt =~ /^--release$/i) {
626             splice(@ARGV, $i, 1);
627             $passedConfiguration = "Release";
628             $passedConfiguration .= "_WinCairo" if (isWinCairo() && isCygwin());
629             $passedConfiguration .= "|x64" if isWin64();
630             return;
631         }
632         if ($opt =~ /^--profil(e|ing)$/i) {
633             splice(@ARGV, $i, 1);
634             $passedConfiguration = "Profiling";
635             $passedConfiguration .= "_WinCairo" if (isWinCairo() && isCygwin());
636             $passedConfiguration .= "|x64" if isWin64();
637             return;
638         }
639     }
640     $passedConfiguration = undef;
641 }
642
643 sub passedConfiguration
644 {
645     determinePassedConfiguration();
646     return $passedConfiguration;
647 }
648
649 sub setConfiguration
650 {
651     setArchitecture();
652
653     if (my $config = shift @_) {
654         $configuration = $config;
655         return;
656     }
657
658     determinePassedConfiguration();
659     $configuration = $passedConfiguration if $passedConfiguration;
660 }
661
662
663 my $passedArchitecture;
664 my $searchedForPassedArchitecture;
665 sub determinePassedArchitecture
666 {
667     return if $searchedForPassedArchitecture;
668     $searchedForPassedArchitecture = 1;
669
670     for my $i (0 .. $#ARGV) {
671         my $opt = $ARGV[$i];
672         if ($opt =~ /^--32-bit$/i) {
673             splice(@ARGV, $i, 1);
674             if (isAppleMacWebKit()) {
675                 $passedArchitecture = `arch`;
676                 chomp $passedArchitecture;
677             }
678             return;
679         }
680     }
681     $passedArchitecture = undef;
682 }
683
684 sub passedArchitecture
685 {
686     determinePassedArchitecture();
687     return $passedArchitecture;
688 }
689
690 sub architecture()
691 {
692     determineArchitecture();
693     return $architecture;
694 }
695
696 sub numberOfCPUs()
697 {
698     determineNumberOfCPUs();
699     return $numberOfCPUs;
700 }
701
702 sub setArchitecture
703 {
704     if (my $arch = shift @_) {
705         $architecture = $arch;
706         return;
707     }
708
709     determinePassedArchitecture();
710     $architecture = $passedArchitecture if $passedArchitecture;
711 }
712
713 sub skipSafariExecutableEntitlementChecks
714 {
715     return `defaults read /Library/Preferences/org.webkit.BuildConfiguration SkipSafariExecutableEntitlementChecks 2>/dev/null` eq "1\n";
716 }
717
718 sub executableHasEntitlements
719 {
720     my $executablePath = shift;
721     return (`codesign -d --entitlements - $executablePath 2>&1` =~ /<key>/);
722 }
723
724 sub safariPathFromSafariBundle
725 {
726     my ($safariBundle) = @_;
727
728     if (isAppleMacWebKit()) {
729         my $safariPath = "$safariBundle/Contents/MacOS/Safari";
730         return $safariPath if skipSafariExecutableEntitlementChecks();
731
732         my $safariForWebKitDevelopmentPath = "$safariBundle/Contents/MacOS/SafariForWebKitDevelopment";
733         return $safariForWebKitDevelopmentPath if -f $safariForWebKitDevelopmentPath && executableHasEntitlements($safariPath);
734
735         return $safariPath;
736     }
737     return $safariBundle if isAppleWinWebKit();
738 }
739
740 sub installedSafariPath
741 {
742     my $safariBundle;
743
744     if (isAppleMacWebKit()) {
745         $safariBundle = "/Applications/Safari.app";
746     } elsif (isAppleWinWebKit()) {
747         $safariBundle = readRegistryString("/HKLM/SOFTWARE/Apple Computer, Inc./Safari/InstallDir");
748         $safariBundle =~ s/[\r\n]+$//;
749         $safariBundle = `cygpath -u '$safariBundle'` if isCygwin();
750         $safariBundle =~ s/[\r\n]+$//;
751         $safariBundle .= "Safari.exe";
752     }
753
754     return safariPathFromSafariBundle($safariBundle);
755 }
756
757 # Locate Safari.
758 sub safariPath
759 {
760     # Use WEBKIT_SAFARI environment variable if present.
761     my $safariBundle = $ENV{WEBKIT_SAFARI};
762     if (!$safariBundle) {
763         determineConfigurationProductDir();
764         # Use Safari.app in product directory if present (good for Safari development team).
765         if (isAppleMacWebKit() && -d "$configurationProductDir/Safari.app") {
766             $safariBundle = "$configurationProductDir/Safari.app";
767         } elsif (isAppleWinWebKit()) {
768             my $path = "$configurationProductDir/Safari.exe";
769             my $debugPath = "$configurationProductDir/Safari_debug.exe";
770
771             if (configurationForVisualStudio() eq "Debug_All" && -x $debugPath) {
772                 $safariBundle = $debugPath;
773             } elsif (-x $path) {
774                 $safariBundle = $path;
775             }
776         }
777         if (!$safariBundle) {
778             return installedSafariPath();
779         }
780     }
781     my $safariPath = safariPathFromSafariBundle($safariBundle);
782     die "Can't find executable at $safariPath.\n" if isAppleMacWebKit() && !-x $safariPath;
783     return $safariPath;
784 }
785
786 sub builtDylibPathForName
787 {
788     my $libraryName = shift;
789     determineConfigurationProductDir();
790
791     if (isBlackBerry()) {
792         my $libraryExtension = $libraryName =~ /^WebKit$/i ? ".so" : ".a";
793         return "$configurationProductDir/$libraryName/lib" . lc($libraryName) . $libraryExtension;
794     }
795     if (isGtk()) {
796         # WebKitGTK+ for GTK2, WebKitGTK+ for GTK3, and WebKit2 respectively.
797         my @libraries = ("libwebkitgtk-1.0", "libwebkitgtk-3.0", "libwebkit2gtk-3.0");
798         my $extension = isDarwin() ? ".dylib" : ".so";
799
800         foreach $libraryName (@libraries) {
801             my $libraryPath = "$configurationProductDir/.libs/" . $libraryName . $extension;
802             return $libraryPath if -e $libraryPath;
803         }
804         return "NotFound";
805     }
806     if (isEfl()) {
807         if (isWK2()) {
808             return "$configurationProductDir/lib/libewebkit2.so";
809         }
810         return "$configurationProductDir/lib/libewebkit.so";
811     }
812     if (isWinCE()) {
813         return "$configurationProductDir/$libraryName";
814     }
815     if (isIOSWebKit()) {
816         return "$configurationProductDir/$libraryName.framework/$libraryName";
817     }
818     if (isAppleMacWebKit()) {
819         return "$configurationProductDir/$libraryName.framework/Versions/A/$libraryName";
820     }
821     if (isAppleWinWebKit()) {
822         if ($libraryName eq "JavaScriptCore") {
823             return "$baseProductDir/lib/$libraryName.lib";
824         } else {
825             return "$baseProductDir/$libraryName.intermediate/$configuration/$libraryName.intermediate/$libraryName.lib";
826         }
827     }
828
829     die "Unsupported platform, can't determine built library locations.\nTry `build-webkit --help` for more information.\n";
830 }
831
832 # Check to see that all the frameworks are built.
833 sub checkFrameworks # FIXME: This is a poor name since only the Mac calls built WebCore a Framework.
834 {
835     return if isCygwin() || isWindows();
836     my @frameworks = ("JavaScriptCore", "WebCore");
837     push(@frameworks, "WebKit") if isAppleMacWebKit(); # FIXME: This seems wrong, all ports should have a WebKit these days.
838     for my $framework (@frameworks) {
839         my $path = builtDylibPathForName($framework);
840         die "Can't find built framework at \"$path\".\n" unless -e $path;
841     }
842 }
843
844 sub isInspectorFrontend()
845 {
846     determineIsInspectorFrontend();
847     return $isInspectorFrontend;
848 }
849
850 sub determineIsInspectorFrontend()
851 {
852     return if defined($isInspectorFrontend);
853     $isInspectorFrontend = checkForArgumentAndRemoveFromARGV("--inspector-frontend");
854 }
855
856 sub commandExists($)
857 {
858     my $command = shift;
859     my $devnull = File::Spec->devnull();
860     return `$command --version 2> $devnull`;
861 }
862
863 sub checkForArgumentAndRemoveFromARGV
864 {
865     my $argToCheck = shift;
866     return checkForArgumentAndRemoveFromArrayRef($argToCheck, \@ARGV);
867 }
868
869 sub findMatchingArguments($$)
870 {
871     my ($argToCheck, $arrayRef) = @_;
872     my @matchingIndices;
873     foreach my $index (0 .. $#$arrayRef) {
874         my $opt = $$arrayRef[$index];
875         if ($opt =~ /^$argToCheck$/i ) {
876             push(@matchingIndices, $index);
877         }
878     }
879     return @matchingIndices; 
880 }
881
882 sub hasArgument($$)
883 {
884     my ($argToCheck, $arrayRef) = @_;
885     my @matchingIndices = findMatchingArguments($argToCheck, $arrayRef);
886     my $far = scalar @matchingIndices;
887     return scalar @matchingIndices > 0;
888 }
889
890 sub checkForArgumentAndRemoveFromArrayRef
891 {
892     my ($argToCheck, $arrayRef) = @_;
893     my @indicesToRemove = findMatchingArguments($argToCheck, $arrayRef);
894     foreach my $index (@indicesToRemove) {
895         splice(@$arrayRef, $index, 1);
896     }
897     return scalar @indicesToRemove > 0;
898 }
899
900 sub isWK2()
901 {
902     if (defined($isWK2)) {
903         return $isWK2;
904     }
905     if (checkForArgumentAndRemoveFromARGV("-2")) {
906         $isWK2 = 1;
907     } else {
908         $isWK2 = 0;
909     }
910     return $isWK2;
911 }
912
913 sub isBlackBerry()
914 {
915     determineIsBlackBerry();
916     return $isBlackBerry;
917 }
918
919 sub determineIsBlackBerry()
920 {
921     return if defined($isBlackBerry);
922     $isBlackBerry = checkForArgumentAndRemoveFromARGV("--blackberry");
923 }
924
925 sub blackberryTargetArchitecture()
926 {
927     my $arch = $ENV{"BLACKBERRY_ARCH_TYPE"} ? $ENV{"BLACKBERRY_ARCH_TYPE"} : "arm";
928     my $cpu = $ENV{"BLACKBERRY_ARCH_CPU"} ? $ENV{"BLACKBERRY_ARCH_CPU"} : "";
929     my $cpuDir;
930     my $buSuffix;
931     if (($cpu eq "v7le") || ($cpu eq "a9")) {
932         $cpuDir = $arch . "le-v7";
933         $buSuffix = $arch . "v7";
934     } else {
935         $cpu = $arch;
936         $cpuDir = $arch;
937         $buSuffix = $arch;
938     }
939     return ("arch" => $arch,
940             "cpu" => $cpu,
941             "cpuDir" => $cpuDir,
942             "buSuffix" => $buSuffix);
943 }
944
945 sub blackberryCMakeArguments()
946 {
947     my %archInfo = blackberryTargetArchitecture();
948     my $arch = $archInfo{"arch"};
949     my $cpu = $archInfo{"cpu"};
950     my $cpuDir = $archInfo{"cpuDir"};
951     my $buSuffix = $archInfo{"buSuffix"};
952
953     my @cmakeExtraOptions;
954     if ($cpu eq "a9") {
955         $cpu = $arch . "v7le";
956         push @cmakeExtraOptions, '-DTARGETING_PLAYBOOK=1';
957     }
958
959     my $stageDir = $ENV{"STAGE_DIR"};
960     my $stageLib = File::Spec->catdir($stageDir, $cpuDir, "lib");
961     my $stageUsrLib = File::Spec->catdir($stageDir, $cpuDir, "usr", "lib");
962     my $stageInc = File::Spec->catdir($stageDir, "usr", "include");
963
964     my $qnxHost = $ENV{"QNX_HOST"};
965     my $ccCommand;
966     my $cxxCommand;
967     if ($ENV{"USE_ICECC"}) {
968         chomp($ccCommand = `which icecc`);
969         $cxxCommand = $ccCommand;
970     } else {
971         $ccCommand = File::Spec->catfile($qnxHost, "usr", "bin", "qcc");
972         $cxxCommand = $ccCommand;
973     }
974
975     if ($ENV{"CCWRAP"}) {
976         $ccCommand = $ENV{"CCWRAP"};
977         push @cmakeExtraOptions, "-DCMAKE_C_COMPILER_ARG1=qcc";
978         push @cmakeExtraOptions, "-DCMAKE_CXX_COMPILER_ARG1=qcc";
979     }
980
981     push @cmakeExtraOptions, "-DCMAKE_SKIP_RPATH='ON'" if isDarwin();
982     push @cmakeExtraOptions, "-DPUBLIC_BUILD=1" if $ENV{"PUBLIC_BUILD"};
983     push @cmakeExtraOptions, "-DENABLE_GLES2=1" unless $ENV{"DISABLE_GLES2"};
984
985     my @includeSystemDirectories;
986     push @includeSystemDirectories, File::Spec->catdir($stageInc, "harfbuzzng");
987     push @includeSystemDirectories, File::Spec->catdir($stageInc, "imf");
988     # We only use jpeg-turbo for device build
989     push @includeSystemDirectories, File::Spec->catdir($stageInc, "jpeg-turbo") if $arch=~/arm/;
990     push @includeSystemDirectories, $stageInc;
991     push @includeSystemDirectories, File::Spec->catdir($stageInc, "browser", "platform");
992     push @includeSystemDirectories, File::Spec->catdir($stageInc, "browser", "platform", "graphics");
993     push @includeSystemDirectories, File::Spec->catdir($stageInc, "browser", "qsk");
994     push @includeSystemDirectories, File::Spec->catdir($stageInc, "ots");
995     push @includeSystemDirectories, File::Spec->catdir($stageInc, "iType", "common");
996     push @includeSystemDirectories, File::Spec->catdir($stageInc, "iType", "port", "nto");
997
998     my @cxxFlags;
999     push @cxxFlags, "-Wl,-rpath-link,$stageLib";
1000     push @cxxFlags, "-Wl,-rpath-link," . File::Spec->catfile($stageUsrLib, "torch-webkit");
1001     push @cxxFlags, "-Wl,-rpath-link,$stageUsrLib";
1002     push @cxxFlags, "-L$stageLib";
1003     push @cxxFlags, "-L$stageUsrLib";
1004
1005     if ($ENV{"PROFILE"}) {
1006         push @cmakeExtraOptions, "-DPROFILING=1";
1007         push @cxxFlags, "-p";
1008     }
1009
1010     my @cmakeArgs;
1011     push @cmakeArgs, '-DCMAKE_SYSTEM_NAME="QNX"';
1012     push @cmakeArgs, "-DCMAKE_SYSTEM_PROCESSOR=\"$cpuDir\"";
1013     push @cmakeArgs, '-DCMAKE_SYSTEM_VERSION="1"';
1014     push @cmakeArgs, "-DCMAKE_C_COMPILER=\"$ccCommand\"";
1015     push @cmakeArgs, "-DCMAKE_CXX_COMPILER=\"$cxxCommand\"";
1016     push @cmakeArgs, "-DCMAKE_C_FLAGS=\"-Vgcc_nto${cpu} -g @cxxFlags\"";
1017     push @cmakeArgs, "-DCMAKE_CXX_FLAGS=\"-Vgcc_nto${cpu}_cpp-ne -g -lang-c++ @cxxFlags\"";
1018
1019     # We cannot use CMAKE_INCLUDE_PATH since this describes the search path for header files in user directories.
1020     # And the QNX system headers are in user directories on the host OS (i.e. they aren't installed in the host OS's
1021     # system header search path). So, we need to inform g++ that these user directories (@includeSystemDirectories)
1022     # are to be taken as the host OS's system header directories when building our port.
1023     #
1024     # Also, we cannot use CMAKE_SYSTEM_INCLUDE_PATH since that will override the entire system header path.
1025     # So, we define the additional system include paths in ADDITIONAL_SYSTEM_INCLUDE_PATH. This list will
1026     # be processed in OptionsBlackBerry.cmake.
1027     push @cmakeArgs, '-DADDITIONAL_SYSTEM_INCLUDE_PATH="' . join(';', @includeSystemDirectories) . '"';
1028
1029     # FIXME: Make this more general purpose such that we can pass a list of directories and files.
1030     push @cmakeArgs, '-DTHIRD_PARTY_ICU_DIR="' . File::Spec->catdir($stageInc, "unicode") . '"';
1031     push @cmakeArgs, '-DTHIRD_PARTY_UNICODE_FILE="' . File::Spec->catfile($stageInc, "unicode.h") . '"';
1032
1033     push @cmakeArgs, "-DCMAKE_LIBRARY_PATH=\"$stageLib;$stageUsrLib\"";
1034     push @cmakeArgs, '-DCMAKE_AR="' . File::Spec->catfile($qnxHost, "usr", "bin", "nto${buSuffix}-ar") . '"';
1035     push @cmakeArgs, '-DCMAKE_RANLIB="' . File::Spec->catfile($qnxHost, "usr", "bin", "nto${buSuffix}-ranlib") . '"';
1036     push @cmakeArgs, '-DCMAKE_LD="'. File::Spec->catfile($qnxHost, "usr", "bin", "nto${buSuffix}-ld") . '"';
1037     push @cmakeArgs, '-DCMAKE_LINKER="' . File::Spec->catfile($qnxHost, "usr", "bin", "nto${buSuffix}-ld") . '"';
1038     push @cmakeArgs, "-DECLIPSE_CDT4_GENERATE_SOURCE_PROJECT=TRUE";
1039     push @cmakeArgs, '-G"Eclipse CDT4 - Unix Makefiles"';
1040     push @cmakeArgs, @cmakeExtraOptions;
1041     return @cmakeArgs;
1042 }
1043
1044 sub determineIsEfl()
1045 {
1046     return if defined($isEfl);
1047     $isEfl = checkForArgumentAndRemoveFromARGV("--efl");
1048 }
1049
1050 sub isEfl()
1051 {
1052     determineIsEfl();
1053     return $isEfl;
1054 }
1055
1056 sub isGtk()
1057 {
1058     determineIsGtk();
1059     return $isGtk;
1060 }
1061
1062 sub determineIsGtk()
1063 {
1064     return if defined($isGtk);
1065     $isGtk = checkForArgumentAndRemoveFromARGV("--gtk");
1066 }
1067
1068 sub isWinCE()
1069 {
1070     determineIsWinCE();
1071     return $isWinCE;
1072 }
1073
1074 sub determineIsWinCE()
1075 {
1076     return if defined($isWinCE);
1077     $isWinCE = checkForArgumentAndRemoveFromARGV("--wince");
1078 }
1079
1080 # Determine if this is debian, ubuntu, linspire, or something similar.
1081 sub isDebianBased()
1082 {
1083     return -e "/etc/debian_version";
1084 }
1085
1086 sub isFedoraBased()
1087 {
1088     return -e "/etc/fedora-release";
1089 }
1090
1091 sub isWinCairo()
1092 {
1093     determineIsWinCairo();
1094     return $isWinCairo;
1095 }
1096
1097 sub determineIsWinCairo()
1098 {
1099     return if defined($isWinCairo);
1100     $isWinCairo = checkForArgumentAndRemoveFromARGV("--wincairo");
1101 }
1102
1103 sub isWin64()
1104 {
1105     determineIsWin64();
1106     return $isWin64;
1107 }
1108
1109 sub determineIsWin64()
1110 {
1111     return if defined($isWin64);
1112     $isWin64 = checkForArgumentAndRemoveFromARGV("--64-bit");
1113 }
1114
1115 sub isCygwin()
1116 {
1117     return ($^O eq "cygwin") || 0;
1118 }
1119
1120 sub isAnyWindows()
1121 {
1122     return isWindows() || isCygwin();
1123 }
1124
1125 sub determineWinVersion()
1126 {
1127     return if $winVersion;
1128
1129     if (!isAnyWindows()) {
1130         $winVersion = -1;
1131         return;
1132     }
1133
1134     my $versionString = `cmd /c ver`;
1135     $versionString =~ /(\d)\.(\d)\.(\d+)/;
1136
1137     $winVersion = {
1138         major => $1,
1139         minor => $2,
1140         build => $3,
1141     };
1142 }
1143
1144 sub winVersion()
1145 {
1146     determineWinVersion();
1147     return $winVersion;
1148 }
1149
1150 sub isWindows7SP0()
1151 {
1152     return isAnyWindows() && winVersion()->{major} == 6 && winVersion()->{minor} == 1 && winVersion()->{build} == 7600;
1153 }
1154
1155 sub isWindowsVista()
1156 {
1157     return isAnyWindows() && winVersion()->{major} == 6 && winVersion()->{minor} == 0;
1158 }
1159
1160 sub isWindowsXP()
1161 {
1162     return isAnyWindows() && winVersion()->{major} == 5 && winVersion()->{minor} == 1;
1163 }
1164
1165 sub isDarwin()
1166 {
1167     return ($^O eq "darwin") || 0;
1168 }
1169
1170 sub isWindows()
1171 {
1172     return ($^O eq "MSWin32") || 0;
1173 }
1174
1175 sub isLinux()
1176 {
1177     return ($^O eq "linux") || 0;
1178 }
1179
1180 sub isFreeBSD()
1181 {
1182     return ($^O eq "freebsd") || 0;
1183 }
1184
1185 sub isARM()
1186 {
1187     return $Config{archname} =~ /^arm[v\-]/;
1188 }
1189
1190 sub isCrossCompilation()
1191 {
1192   my $compiler = "";
1193   $compiler = $ENV{'CC'} if (defined($ENV{'CC'}));
1194   if ($compiler =~ /gcc/) {
1195       my $compiler_options = `$compiler -v 2>&1`;
1196       my @host = $compiler_options =~ m/--host=(.*?)\s/;
1197       my @target = $compiler_options =~ m/--target=(.*?)\s/;
1198
1199       return ($host[0] ne "" && $target[0] ne "" && $host[0] ne $target[0]);
1200   }
1201   return 0;
1202 }
1203
1204 sub isAppleWebKit()
1205 {
1206     return !(isGtk() or isEfl() or isWinCE() or isBlackBerry());
1207 }
1208
1209 sub isAppleMacWebKit()
1210 {
1211     return isAppleWebKit() && isDarwin();
1212 }
1213
1214 sub isAppleWinWebKit()
1215 {
1216     return isAppleWebKit() && (isCygwin() || isWindows());
1217 }
1218
1219 sub willUseIOSDeviceSDKWhenBuilding()
1220 {
1221     return xcodeSDKPlatformName() eq "iphoneos";
1222 }
1223
1224 sub willUseIOSSimulatorSDKWhenBuilding()
1225 {
1226     return xcodeSDKPlatformName() eq "iphonesimulator";
1227 }
1228
1229 sub isIOSWebKit()
1230 {
1231     determineXcodeSDK();
1232     return isAppleMacWebKit() && (willUseIOSDeviceSDKWhenBuilding() || willUseIOSSimulatorSDKWhenBuilding());
1233 }
1234
1235 sub isPerianInstalled()
1236 {
1237     if (!isAppleWebKit()) {
1238         return 0;
1239     }
1240
1241     if (-d "/Library/QuickTime/Perian.component") {
1242         return 1;
1243     }
1244
1245     if (-d "$ENV{HOME}/Library/QuickTime/Perian.component") {
1246         return 1;
1247     }
1248
1249     return 0;
1250 }
1251
1252 sub determineNmPath()
1253 {
1254     return if $nmPath;
1255
1256     if (isAppleMacWebKit()) {
1257         $nmPath = `xcrun -find nm`;
1258         chomp $nmPath;
1259     }
1260     $nmPath = "nm" if !$nmPath;
1261 }
1262
1263 sub nmPath()
1264 {
1265     determineNmPath();
1266     return $nmPath;
1267 }
1268
1269 sub determineOSXVersion()
1270 {
1271     return if $osXVersion;
1272
1273     if (!isDarwin()) {
1274         $osXVersion = -1;
1275         return;
1276     }
1277
1278     my $version = `sw_vers -productVersion`;
1279     my @splitVersion = split(/\./, $version);
1280     @splitVersion >= 2 or die "Invalid version $version";
1281     $osXVersion = {
1282             "major" => $splitVersion[0],
1283             "minor" => $splitVersion[1],
1284             "subminor" => (defined($splitVersion[2]) ? $splitVersion[2] : 0),
1285     };
1286 }
1287
1288 sub osXVersion()
1289 {
1290     determineOSXVersion();
1291     return $osXVersion;
1292 }
1293
1294 sub isSnowLeopard()
1295 {
1296     return isDarwin() && osXVersion()->{"minor"} == 6;
1297 }
1298
1299 sub isLion()
1300 {
1301     return isDarwin() && osXVersion()->{"minor"} == 7;
1302 }
1303
1304 sub isWindowsNT()
1305 {
1306     return $ENV{'OS'} eq 'Windows_NT';
1307 }
1308
1309 sub shouldTargetWebProcess
1310 {
1311     determineShouldTargetWebProcess();
1312     return $shouldTargetWebProcess;
1313 }
1314
1315 sub determineShouldTargetWebProcess
1316 {
1317     return if defined($shouldTargetWebProcess);
1318     $shouldTargetWebProcess = checkForArgumentAndRemoveFromARGV("--target-web-process");
1319 }
1320
1321 sub shouldUseXPCServiceForWebProcess
1322 {
1323     determineShouldUseXPCServiceForWebProcess();
1324     return $shouldUseXPCServiceForWebProcess;
1325 }
1326
1327 sub determineShouldUseXPCServiceForWebProcess
1328 {
1329     return if defined($shouldUseXPCServiceForWebProcess);
1330     $shouldUseXPCServiceForWebProcess = checkForArgumentAndRemoveFromARGV("--use-web-process-xpc-service");
1331 }
1332
1333 sub debugger
1334 {
1335     determineDebugger();
1336     return $debugger;
1337 }
1338
1339 sub determineDebugger
1340 {
1341     return if defined($debugger);
1342
1343     determineXcodeVersion();
1344     if (eval "v$xcodeVersion" ge v4.5) {
1345         $debugger = "lldb";
1346     } else {
1347         $debugger = "gdb";
1348     }
1349
1350     if (checkForArgumentAndRemoveFromARGV("--use-lldb")) {
1351         $debugger = "lldb";
1352     }
1353
1354     if (checkForArgumentAndRemoveFromARGV("--use-gdb")) {
1355         $debugger = "gdb";
1356     }
1357 }
1358
1359 sub appendToEnvironmentVariableList
1360 {
1361     my ($environmentVariableName, $value) = @_;
1362
1363     if (defined($ENV{$environmentVariableName})) {
1364         $ENV{$environmentVariableName} .= ":" . $value;
1365     } else {
1366         $ENV{$environmentVariableName} = $value;
1367     }
1368 }
1369
1370 sub setUpGuardMallocIfNeeded
1371 {
1372     if (!isDarwin()) {
1373         return;
1374     }
1375
1376     if (!defined($shouldUseGuardMalloc)) {
1377         $shouldUseGuardMalloc = checkForArgumentAndRemoveFromARGV("--guard-malloc");
1378     }
1379
1380     if ($shouldUseGuardMalloc) {
1381         appendToEnvironmentVariableList("DYLD_INSERT_LIBRARIES", "/usr/lib/libgmalloc.dylib");
1382     }
1383 }
1384
1385 sub relativeScriptsDir()
1386 {
1387     my $scriptDir = File::Spec->catpath("", File::Spec->abs2rel($FindBin::Bin, getcwd()), "");
1388     if ($scriptDir eq "") {
1389         $scriptDir = ".";
1390     }
1391     return $scriptDir;
1392 }
1393
1394 sub launcherPath()
1395 {
1396     my $relativeScriptsPath = relativeScriptsDir();
1397     if (isGtk() || isEfl() || isWinCE()) {
1398         return "$relativeScriptsPath/run-launcher";
1399     } elsif (isAppleWebKit()) {
1400         return "$relativeScriptsPath/run-safari";
1401     }
1402 }
1403
1404 sub launcherName()
1405 {
1406     if (isGtk()) {
1407         return "GtkLauncher";
1408     } elsif (isAppleWebKit()) {
1409         return "Safari";
1410     } elsif (isEfl()) {
1411         return "EWebLauncher/MiniBrowser";
1412     } elsif (isWinCE()) {
1413         return "WinCELauncher";
1414     }
1415 }
1416
1417 sub checkRequiredSystemConfig
1418 {
1419     if (isDarwin()) {
1420         chomp(my $productVersion = `sw_vers -productVersion`);
1421         if (eval "v$productVersion" lt v10.7.5) {
1422             print "*************************************************************\n";
1423             print "Mac OS X Version 10.7.5 or later is required to build WebKit.\n";
1424             print "You have " . $productVersion . ", thus the build will most likely fail.\n";
1425             print "*************************************************************\n";
1426         }
1427         my $xcodebuildVersionOutput = `xcodebuild -version`;
1428         my $xcodeVersion = ($xcodebuildVersionOutput =~ /Xcode ([0-9](\.[0-9]+)*)/) ? $1 : undef;
1429         if (!$xcodeVersion || $xcodeVersion && eval "v$xcodeVersion" lt v4.6) {
1430             print "*************************************************************\n";
1431             print "Xcode Version 4.6 or later is required to build WebKit.\n";
1432             print "You have an earlier version of Xcode, thus the build will\n";
1433             print "most likely fail. The latest Xcode is available from the App Store.\n";
1434             print "*************************************************************\n";
1435         }
1436     } elsif (isGtk() or isEfl()) {
1437         my @cmds = qw(bison gperf flex);
1438         my @missing = ();
1439         my $oldPath = $ENV{PATH};
1440         foreach my $cmd (@cmds) {
1441             push @missing, $cmd if not commandExists($cmd);
1442         }
1443
1444         if (@missing) {
1445             my $list = join ", ", @missing;
1446             die "ERROR: $list missing but required to build WebKit.\n";
1447         }
1448     }
1449     # Win32 and other platforms may want to check for minimum config
1450 }
1451
1452 sub determineWindowsSourceDir()
1453 {
1454     return if $windowsSourceDir;
1455     $windowsSourceDir = sourceDir();
1456     chomp($windowsSourceDir = `cygpath -w '$windowsSourceDir'`) if isCygwin();
1457 }
1458
1459 sub windowsSourceDir()
1460 {
1461     determineWindowsSourceDir();
1462     return $windowsSourceDir;
1463 }
1464
1465 sub windowsSourceSourceDir()
1466 {
1467     return windowsSourceDir() . "\\Source";
1468 }
1469
1470 sub windowsLibrariesDir()
1471 {
1472     return windowsSourceDir() . "\\WebKitLibraries\\win";
1473 }
1474
1475 sub windowsOutputDir()
1476 {
1477     return windowsSourceDir() . "\\WebKitBuild";
1478 }
1479
1480 sub setupAppleWinEnv()
1481 {
1482     return unless isAppleWinWebKit();
1483
1484     if (isWindowsNT()) {
1485         my $restartNeeded = 0;
1486         my %variablesToSet = ();
1487
1488         # FIXME: We should remove this explicit version check for cygwin once we stop supporting Cygwin 1.7.9 or older versions. 
1489         # https://bugs.webkit.org/show_bug.cgi?id=85791
1490         my $uname_version = (POSIX::uname())[2];
1491         $uname_version =~ s/\(.*\)//;  # Remove the trailing cygwin version, if any.
1492         if (version->parse($uname_version) < version->parse("1.7.10")) {
1493             # Setting the environment variable 'CYGWIN' to 'tty' makes cygwin enable extra support (i.e., termios)
1494             # for UNIX-like ttys in the Windows console
1495             $variablesToSet{CYGWIN} = "tty" unless $ENV{CYGWIN};
1496         }
1497         
1498         # Those environment variables must be set to be able to build inside Visual Studio.
1499         $variablesToSet{WEBKIT_LIBRARIES} = windowsLibrariesDir() unless $ENV{WEBKIT_LIBRARIES};
1500         $variablesToSet{WEBKIT_OUTPUTDIR} = windowsOutputDir() unless $ENV{WEBKIT_OUTPUTDIR};
1501
1502         foreach my $variable (keys %variablesToSet) {
1503             print "Setting the Environment Variable '" . $variable . "' to '" . $variablesToSet{$variable} . "'\n\n";
1504             system qw(regtool -s set), '\\HKEY_CURRENT_USER\\Environment\\' . $variable, $variablesToSet{$variable};
1505             $restartNeeded ||=  $variable eq "WEBKIT_LIBRARIES" || $variable eq "WEBKIT_OUTPUTDIR";
1506         }
1507
1508         if ($restartNeeded) {
1509             print "Please restart your computer before attempting to build inside Visual Studio.\n\n";
1510         }
1511     } else {
1512         if (!$ENV{'WEBKIT_LIBRARIES'}) {
1513             # VS2010 (and newer) version. This will replace the VS2005 version as part of
1514             # https://bugs.webkit.org/show_bug.cgi?id=109472. 
1515             print "Warning: You must set the 'WebKit_Libraries' environment variable\n";
1516             print "         to be able build WebKit from within Visual Studio 2010 and newer.\n";
1517             print "         Make sure that 'WebKit_Libraries' points to the\n";
1518             print "         'WebKitLibraries/win' directory, not the 'WebKitLibraries/' directory.\n\n";
1519         }
1520         if (!$ENV{'WEBKIT_OUTPUTDIR'}) {
1521             # VS2010 (and newer) version. This will replace the VS2005 version as part of
1522             # https://bugs.webkit.org/show_bug.cgi?id=109472. 
1523             print "Warning: You must set the 'WebKit_OutputDir' environment variable\n";
1524             print "         to be able build WebKit from within Visual Studio 2010 and newer.\n\n";
1525         }
1526     }
1527 }
1528
1529 sub setupCygwinEnv()
1530 {
1531     return if !isCygwin() && !isWindows();
1532     return if $vcBuildPath;
1533
1534     my $programFilesPath = programFilesPath();
1535     $vcBuildPath = File::Spec->catfile(visualStudioInstallDir(), qw(Common7 IDE devenv.com));
1536     if (-e $vcBuildPath) {
1537         # Visual Studio is installed;
1538         if (visualStudioVersion() eq "10") {
1539             $vcBuildPath = File::Spec->catfile(visualStudioInstallDir(), qw(Common7 IDE devenv.exe));
1540         }
1541     } else {
1542         # Visual Studio not found, try VC++ Express
1543         $vcBuildPath = File::Spec->catfile(visualStudioInstallDir(), qw(Common7 IDE VCExpress.exe));
1544         if (! -e $vcBuildPath) {
1545             print "*************************************************************\n";
1546             print "Cannot find '$vcBuildPath'\n";
1547             print "Please execute the file 'vcvars32.bat' from\n";
1548             print "'$programFilesPath\\Microsoft Visual Studio 8\\VC\\bin\\'\n";
1549             print "to setup the necessary environment variables.\n";
1550             print "*************************************************************\n";
1551             die;
1552         }
1553         $willUseVCExpressWhenBuilding = 1;
1554     }
1555
1556     print "Building results into: ", baseProductDir(), "\n";
1557     print "WEBKIT_OUTPUTDIR is set to: ", $ENV{"WEBKIT_OUTPUTDIR"}, "\n";
1558     print "WEBKIT_LIBRARIES is set to: ", $ENV{"WEBKIT_LIBRARIES"}, "\n";
1559 }
1560
1561 sub dieIfWindowsPlatformSDKNotInstalled
1562 {
1563     my $registry32Path = "/proc/registry/";
1564     my $registry64Path = "/proc/registry64/";
1565     my @windowsPlatformSDKRegistryEntries = (
1566         "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Microsoft SDKs/Windows/v8.0A",
1567         "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Microsoft SDKs/Windows/v8.0",
1568         "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Microsoft SDKs/Windows/v7.1A",
1569         "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Microsoft SDKs/Windows/v7.0A",
1570         "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/MicrosoftSDK/InstalledSDKs/D2FF9F89-8AA2-4373-8A31-C838BF4DBBE1",
1571     );
1572
1573     # FIXME: It would be better to detect whether we are using 32- or 64-bit Windows
1574     # and only check the appropriate entry. But for now we just blindly check both.
1575     my $recommendedPlatformSDK = $windowsPlatformSDKRegistryEntries[0];
1576
1577     while (@windowsPlatformSDKRegistryEntries) {
1578         my $windowsPlatformSDKRegistryEntry = shift @windowsPlatformSDKRegistryEntries;
1579         return if (-e $registry32Path . $windowsPlatformSDKRegistryEntry) || (-e $registry64Path . $windowsPlatformSDKRegistryEntry);
1580     }
1581
1582     print "*************************************************************\n";
1583     print "Cannot find registry entry '$recommendedPlatformSDK'.\n";
1584     print "Please download and install the Microsoft Windows SDK\n";
1585     print "from <http://www.microsoft.com/en-us/download/details.aspx?id=8279>.\n\n";
1586     print "Then follow step 2 in the Windows section of the \"Installing Developer\n";
1587     print "Tools\" instructions at <http://www.webkit.org/building/tools.html>.\n";
1588     print "*************************************************************\n";
1589     die;
1590 }
1591
1592 sub copyInspectorFrontendFiles
1593 {
1594     my $productDir = productDir();
1595     my $sourceInspectorPath = sourceDir() . "/Source/WebCore/inspector/front-end/";
1596     my $inspectorResourcesDirPath = $ENV{"WEBKITINSPECTORRESOURCESDIR"};
1597
1598     if (!defined($inspectorResourcesDirPath)) {
1599         $inspectorResourcesDirPath = "";
1600     }
1601
1602     if (isAppleMacWebKit()) {
1603         if (isIOSWebKit()) {
1604             $inspectorResourcesDirPath = $productDir . "/WebCore.framework/inspector";
1605         } else {
1606             $inspectorResourcesDirPath = $productDir . "/WebCore.framework/Resources/inspector";
1607         }
1608     } elsif (isAppleWinWebKit()) {
1609         $inspectorResourcesDirPath = $productDir . "/WebKit.resources/inspector";
1610     } elsif (isGtk()) {
1611         my $prefix = $ENV{"WebKitInstallationPrefix"};
1612         $inspectorResourcesDirPath = (defined($prefix) ? $prefix : "/usr/share") . "/webkit-1.0/webinspector";
1613     } elsif (isEfl()) {
1614         my $prefix = $ENV{"WebKitInstallationPrefix"};
1615         $inspectorResourcesDirPath = (defined($prefix) ? $prefix : "/usr/share") . "/ewebkit/webinspector";
1616     }
1617
1618     if (! -d $inspectorResourcesDirPath) {
1619         print "*************************************************************\n";
1620         print "Cannot find '$inspectorResourcesDirPath'.\n" if (defined($inspectorResourcesDirPath));
1621         print "Make sure that you have built WebKit first.\n" if (! -d $productDir || defined($inspectorResourcesDirPath));
1622         print "Optionally, set the environment variable 'WebKitInspectorResourcesDir'\n";
1623         print "to point to the directory that contains the WebKit Inspector front-end\n";
1624         print "files for the built WebCore framework.\n";
1625         print "*************************************************************\n";
1626         die;
1627     }
1628
1629     if (isAppleMacWebKit()) {
1630         my $sourceLocalizedStrings = sourceDir() . "/Source/WebCore/English.lproj/localizedStrings.js";
1631         my $destinationLocalizedStrings;
1632         if (isIOSWebKit()) {
1633             $destinationLocalizedStrings = $productDir . "/WebCore.framework/English.lproj/localizedStrings.js";
1634         } else {
1635             $destinationLocalizedStrings = $productDir . "/WebCore.framework/Resources/English.lproj/localizedStrings.js";
1636         }
1637         system "ditto", $sourceLocalizedStrings, $destinationLocalizedStrings;
1638     }
1639
1640     my $exitStatus = system "rsync", "-aut", "--exclude=/.DS_Store", "--exclude=*.re2js", "--exclude=.svn/", $sourceInspectorPath, $inspectorResourcesDirPath;
1641     return $exitStatus if $exitStatus;
1642
1643     if (isIOSWebKit()) {
1644         chdir($productDir . "/WebCore.framework");
1645         return system "zip", "--quiet", "--exclude=*.qrc", "-r", "inspector-remote.zip", "inspector";
1646     }
1647
1648     return 0; # Success; did copy files.
1649 }
1650
1651 sub buildXCodeProject($$@)
1652 {
1653     my ($project, $clean, @extraOptions) = @_;
1654
1655     if ($clean) {
1656         push(@extraOptions, "-alltargets");
1657         push(@extraOptions, "clean");
1658     }
1659
1660     return system "xcodebuild", "-project", "$project.xcodeproj", @extraOptions;
1661 }
1662
1663 sub usingVisualStudioExpress()
1664 {
1665     setupCygwinEnv();
1666     return $willUseVCExpressWhenBuilding;
1667 }
1668
1669 sub buildVisualStudioProject
1670 {
1671     my ($project, $clean) = @_;
1672     setupCygwinEnv();
1673
1674     my $config = configurationForVisualStudio();
1675
1676     dieIfWindowsPlatformSDKNotInstalled() if $willUseVCExpressWhenBuilding;
1677
1678     chomp($project = `cygpath -w "$project"`) if isCygwin();
1679     
1680     my $action = "/build";
1681     if ($clean) {
1682         $action = "/clean";
1683     }
1684
1685     my @command = ($vcBuildPath, $project, $action, $config);
1686
1687     print join(" ", @command), "\n";
1688     return system @command;
1689 }
1690
1691 sub retrieveQMakespecVar
1692 {
1693     my $mkspec = $_[0];
1694     my $varname = $_[1];
1695
1696     my $varvalue = undef;
1697     #print "retrieveMakespecVar " . $mkspec . ", " . $varname . "\n";
1698
1699     local *SPEC;
1700     open SPEC, "<$mkspec" or return $varvalue;
1701     while (<SPEC>) {
1702         if ($_ =~ /\s*include\((.+)\)/) {
1703             # open the included mkspec
1704             my $oldcwd = getcwd();
1705             (my $volume, my $directories, my $file) = File::Spec->splitpath($mkspec);
1706             my $newcwd = "$volume$directories";
1707             chdir $newcwd if $newcwd;
1708             $varvalue = retrieveQMakespecVar($1, $varname);
1709             chdir $oldcwd;
1710         } elsif ($_ =~ /$varname\s*=\s*([^\s]+)/) {
1711             $varvalue = $1;
1712             last;
1713         }
1714     }
1715     close SPEC;
1716     return $varvalue;
1717 }
1718
1719 sub autotoolsFlag($$)
1720 {
1721     my ($flag, $feature) = @_;
1722     my $prefix = $flag ? "--enable" : "--disable";
1723
1724     return $prefix . '-' . $feature;
1725 }
1726
1727 sub runAutogenForAutotoolsProjectIfNecessary($@)
1728 {
1729     my ($dir, $prefix, $sourceDir, $project, $joinedOverridableFeatures, @buildArgs) = @_;
1730
1731     # Always enable introspection when building WebKitGTK+.
1732     unshift(@buildArgs, "--enable-introspection");
1733
1734     # Also, always enable developer mode for developer/test builds.
1735     unshift(@buildArgs, "--enable-developer-mode");
1736
1737     my $joinedBuildArgs = join(" ", @buildArgs);
1738
1739     if (-e "GNUmakefile") {
1740         # Just assume that build-jsc will never be used to reconfigure JSC. Later
1741         # we can go back and make this more complicated if the demand is there.
1742         if ($project ne "WebKit") {
1743             return;
1744         }
1745
1746         # Run autogen.sh again if either the features overrided by build-webkit or build arguments have changed.
1747         if (!mustReRunAutogen($sourceDir, "WebKitFeatureOverrides.txt", $joinedOverridableFeatures)
1748             && !mustReRunAutogen($sourceDir, "previous-autogen-arguments.txt", $joinedBuildArgs)) {
1749             return;
1750         }
1751     }
1752
1753     print "Calling autogen.sh in " . $dir . "\n\n";
1754     print "Installation prefix directory: $prefix\n" if(defined($prefix));
1755
1756     # Only for WebKit, write the autogen.sh arguments to a file so that we can detect
1757     # when they change and automatically re-run it.
1758     if ($project eq 'WebKit') {
1759         open(OVERRIDABLE_FEATURES, ">WebKitFeatureOverrides.txt");
1760         print OVERRIDABLE_FEATURES $joinedOverridableFeatures;
1761         close(OVERRIDABLE_FEATURES);
1762
1763         open(AUTOTOOLS_ARGUMENTS, ">previous-autogen-arguments.txt");
1764         print AUTOTOOLS_ARGUMENTS $joinedBuildArgs;
1765         close(AUTOTOOLS_ARGUMENTS);
1766     }
1767
1768     # Make the path relative since it will appear in all -I compiler flags.
1769     # Long argument lists cause bizarre slowdowns in libtool.
1770     my $relSourceDir = File::Spec->abs2rel($sourceDir) || ".";
1771
1772     # Compiler options to keep floating point values consistent
1773     # between 32-bit and 64-bit architectures. The options are also
1774     # used on Chromium build.
1775     determineArchitecture();
1776     if ($architecture ne "x86_64" && !isARM()) {
1777         $ENV{'CXXFLAGS'} = "-march=pentium4 -msse2 -mfpmath=sse " . ($ENV{'CXXFLAGS'} || "");
1778     }
1779
1780     # Prefix the command with jhbuild run.
1781     unshift(@buildArgs, "$relSourceDir/autogen.sh");
1782     unshift(@buildArgs, jhbuildWrapperPrefixIfNeeded());
1783     if (system(@buildArgs) ne 0) {
1784         die "Calling autogen.sh failed!\n";
1785     }
1786 }
1787
1788 sub getJhbuildPath()
1789 {
1790     my @jhbuildPath = File::Spec->splitdir(baseProductDir());
1791     if (isGit() && isGitBranchBuild() && gitBranch()) {
1792         pop(@jhbuildPath);
1793     }
1794     push(@jhbuildPath, "Dependencies");
1795     return File::Spec->catdir(@jhbuildPath);
1796 }
1797
1798 sub mustReRunAutogen($@)
1799 {
1800     my ($sourceDir, $filename, $currentContents) = @_;
1801
1802     if (! -e $filename) {
1803         return 1;
1804     }
1805
1806     open(CONTENTS_FILE, $filename);
1807     chomp(my $previousContents = <CONTENTS_FILE>);
1808     close(CONTENTS_FILE);
1809
1810     # We only care about the WebKit2 argument when we are building WebKit itself.
1811     # build-jsc never passes --enable-webkit2, so if we didn't do this, autogen.sh
1812     # would run for every single build on the bots, since it runs both build-webkit
1813     # and build-jsc.
1814     if ($previousContents ne $currentContents) {
1815         print "Contents for file $filename have changed.\n";
1816         print "Previous contents were: $previousContents\n\n";
1817         print "New contents are: $currentContents\n";
1818         return 1;
1819     }
1820
1821     return 0;
1822 }
1823
1824 sub buildAutotoolsProject($@)
1825 {
1826     my ($project, $clean, $prefix, $makeArgs, $noWebKit1, $noWebKit2, @features) = @_;
1827
1828     my $make = 'make';
1829     my $dir = productDir();
1830     my $config = passedConfiguration() || configuration();
1831
1832     # Use rm to clean the build directory since distclean may miss files
1833     if ($clean && -d $dir) {
1834         system "rm", "-rf", "$dir";
1835     }
1836
1837     if (! -d $dir) {
1838         File::Path::mkpath($dir) or die "Failed to create build directory " . $dir
1839     }
1840     chdir $dir or die "Failed to cd into " . $dir . "\n";
1841
1842     if ($clean) {
1843         return 0;
1844     }
1845
1846     my @buildArgs = @ARGV;
1847     if ($noWebKit1) {
1848         unshift(@buildArgs, "--disable-webkit1");
1849     }
1850     if ($noWebKit2) {
1851         unshift(@buildArgs, "--disable-webkit2");
1852     }
1853
1854     # Configurable features listed here should be kept in sync with the
1855     # features for which there exists a configuration option in configure.ac.
1856     my %configurableFeatures = (
1857         "battery-status" => 1,
1858         "gamepad" => 1,
1859         "geolocation" => 1,
1860         "svg" => 1,
1861         "svg-fonts" => 1,
1862         "video" => 1,
1863         "webgl" => 1,
1864         "web-audio" => 1,
1865     );
1866
1867     # These features are ones which build-webkit cannot control, typically because
1868     # they can only be active when we have the proper dependencies.
1869     my %unsetFeatures = (
1870         "accelerated-2d-canvas" => 1,
1871     );
1872
1873     my @overridableFeatures = ();
1874     foreach (@features) {
1875         if ($configurableFeatures{$_->{option}}) {
1876             push @buildArgs, autotoolsFlag(${$_->{value}}, $_->{option});;
1877         } elsif (!$unsetFeatures{$_->{option}}) {
1878             push @overridableFeatures, $_->{define} . "=" . (${$_->{value}} ? "1" : "0");
1879         }
1880     }
1881
1882     $makeArgs = $makeArgs || "";
1883     $makeArgs = $makeArgs . " " . $ENV{"WebKitMakeArguments"} if $ENV{"WebKitMakeArguments"};
1884
1885     # Automatically determine the number of CPUs for make only
1886     # if make arguments haven't already been specified.
1887     if ($makeArgs eq "") {
1888         $makeArgs = "-j" . numberOfCPUs();
1889     }
1890
1891     # WebKit is the default target, so we don't need to specify anything.
1892     if ($project eq "JavaScriptCore") {
1893         $makeArgs .= " jsc";
1894     } elsif ($project eq "WTF") {
1895         $makeArgs .= " libWTF.la";
1896     }
1897
1898     $prefix = $ENV{"WebKitInstallationPrefix"} if !defined($prefix);
1899     push @buildArgs, "--prefix=" . $prefix if defined($prefix);
1900
1901     # Check if configuration is Debug.
1902     my $debug = $config =~ m/debug/i;
1903     if ($debug) {
1904         push @buildArgs, "--enable-debug";
1905     } else {
1906         push @buildArgs, "--disable-debug";
1907     }
1908
1909     if (checkForArgumentAndRemoveFromArrayRef("--update-gtk", \@buildArgs)) {
1910         # Force autogen to run, to catch the possibly updated libraries.
1911         system("rm -f previous-autogen-arguments.txt");
1912
1913         system("perl", "$sourceDir/Tools/Scripts/update-webkitgtk-libs") == 0 or die $!;
1914     }
1915
1916     # If GNUmakefile exists, don't run autogen.sh unless its arguments
1917     # have changed. The makefile should be smart enough to track autotools
1918     # dependencies and re-run autogen.sh when build files change.
1919     my $joinedOverridableFeatures = join(" ", @overridableFeatures);
1920     runAutogenForAutotoolsProjectIfNecessary($dir, $prefix, $sourceDir, $project, $joinedOverridableFeatures, @buildArgs);
1921
1922     my $runWithJhbuild = join(" ", jhbuildWrapperPrefixIfNeeded());
1923     if (system("$runWithJhbuild $make $makeArgs") ne 0) {
1924         die "\nFailed to build WebKit using '$make'!\n";
1925     }
1926
1927     chdir ".." or die;
1928
1929     if ($project eq 'WebKit' && !isCrossCompilation() && !($noWebKit1 && $noWebKit2)) {
1930         my @docGenerationOptions = ("$sourceDir/Tools/gtk/generate-gtkdoc", "--skip-html");
1931         push(@docGenerationOptions, productDir());
1932
1933         unshift(@docGenerationOptions, jhbuildWrapperPrefixIfNeeded());
1934
1935         if (system(@docGenerationOptions)) {
1936             die "\n gtkdoc did not build without warnings\n";
1937         }
1938     }
1939
1940     return 0;
1941 }
1942
1943 sub jhbuildWrapperPrefixIfNeeded()
1944 {
1945     if (-e getJhbuildPath()) {
1946         my @prefix = (File::Spec->catfile(sourceDir(), "Tools", "jhbuild", "jhbuild-wrapper"));
1947         if (isEfl()) {
1948             push(@prefix, "--efl");
1949         } elsif (isGtk()) {
1950             push(@prefix, "--gtk");
1951         }
1952         push(@prefix, "run");
1953
1954         return @prefix;
1955     }
1956
1957     return ();
1958 }
1959
1960 sub removeCMakeCache()
1961 {
1962     my $cacheFilePath = File::Spec->catdir(baseProductDir(), configuration(), "CMakeCache.txt");
1963     unlink($cacheFilePath) if -e $cacheFilePath;
1964 }
1965
1966 sub generateBuildSystemFromCMakeProject
1967 {
1968     my ($port, $prefixPath, @cmakeArgs, $additionalCMakeArgs) = @_;
1969     my $config = configuration();
1970     my $buildPath = File::Spec->catdir(baseProductDir(), $config);
1971     File::Path::mkpath($buildPath) unless -d $buildPath;
1972     my $originalWorkingDirectory = getcwd();
1973     chdir($buildPath) or die;
1974
1975     my @args;
1976     push @args, "-DPORT=\"$port\"";
1977     push @args, "-DCMAKE_INSTALL_PREFIX=\"$prefixPath\"" if $prefixPath;
1978     push @args, "-DSHARED_CORE=ON" if isEfl() && $ENV{"ENABLE_DRT"};
1979     if ($config =~ /release/i) {
1980         push @args, "-DCMAKE_BUILD_TYPE=Release";
1981     } elsif ($config =~ /debug/i) {
1982         push @args, "-DCMAKE_BUILD_TYPE=Debug";
1983     }
1984     # Don't warn variables which aren't used by cmake ports.
1985     push @args, "--no-warn-unused-cli";
1986     push @args, @cmakeArgs if @cmakeArgs;
1987     push @args, $additionalCMakeArgs if $additionalCMakeArgs;
1988
1989     push @args, '"' . sourceDir() . '"';
1990
1991     # Compiler options to keep floating point values consistent
1992     # between 32-bit and 64-bit architectures.
1993     determineArchitecture();
1994     if ($architecture ne "x86_64" && !isARM()) {
1995         $ENV{'CXXFLAGS'} = "-march=pentium4 -msse2 -mfpmath=sse " . ($ENV{'CXXFLAGS'} || "");
1996     }
1997
1998     # We call system("cmake @args") instead of system("cmake", @args) so that @args is
1999     # parsed for shell metacharacters.
2000     my $wrapper = join(" ", jhbuildWrapperPrefixIfNeeded()) . " ";
2001     my $returnCode = system($wrapper . "cmake @args");
2002
2003     chdir($originalWorkingDirectory);
2004     return $returnCode;
2005 }
2006
2007 sub buildCMakeGeneratedProject($)
2008 {
2009     my ($makeArgs) = @_;
2010     my $config = configuration();
2011     my $buildPath = File::Spec->catdir(baseProductDir(), $config);
2012     if (! -d $buildPath) {
2013         die "Must call generateBuildSystemFromCMakeProject() before building CMake project.";
2014     }
2015     my @args = ("--build", $buildPath, "--config", $config);
2016     push @args, ("--", $makeArgs) if $makeArgs;
2017
2018     # We call system("cmake @args") instead of system("cmake", @args) so that @args is
2019     # parsed for shell metacharacters. In particular, $makeArgs may contain such metacharacters.
2020     my $wrapper = join(" ", jhbuildWrapperPrefixIfNeeded()) . " ";
2021     return system($wrapper . "cmake @args");
2022 }
2023
2024 sub cleanCMakeGeneratedProject()
2025 {
2026     my $config = configuration();
2027     my $buildPath = File::Spec->catdir(baseProductDir(), $config);
2028     if (-d $buildPath) {
2029         return system("cmake", "--build", $buildPath, "--config", $config, "--target", "clean");
2030     }
2031     return 0;
2032 }
2033
2034 sub buildCMakeProjectOrExit($$$$@)
2035 {
2036     my ($clean, $port, $prefixPath, $makeArgs, @cmakeArgs) = @_;
2037     my $returnCode;
2038
2039     exit(exitStatus(cleanCMakeGeneratedProject())) if $clean;
2040
2041     if (isEfl() && checkForArgumentAndRemoveFromARGV("--update-efl")) {
2042         system("perl", "$sourceDir/Tools/Scripts/update-webkitefl-libs") == 0 or die $!;
2043     }
2044
2045
2046     $returnCode = exitStatus(generateBuildSystemFromCMakeProject($port, $prefixPath, @cmakeArgs));
2047     exit($returnCode) if $returnCode;
2048     if (isBlackBerry()) {
2049         return 0 if (defined($ENV{"GENERATE_CMAKE_PROJECT_ONLY"}) eq '1');
2050     }
2051     $returnCode = exitStatus(buildCMakeGeneratedProject($makeArgs));
2052     exit($returnCode) if $returnCode;
2053     return 0;
2054 }
2055
2056 sub cmakeBasedPortArguments()
2057 {
2058     return blackberryCMakeArguments() if isBlackBerry();
2059     return ('-G "Visual Studio 8 2005 STANDARDSDK_500 (ARMV4I)"') if isWinCE();
2060     return ();
2061 }
2062
2063 sub cmakeBasedPortName()
2064 {
2065     return "BlackBerry" if isBlackBerry();
2066     return "Efl" if isEfl();
2067     return "WinCE" if isWinCE();
2068     return "";
2069 }
2070
2071 sub promptUser
2072 {
2073     my ($prompt, $default) = @_;
2074     my $defaultValue = $default ? "[$default]" : "";
2075     print "$prompt $defaultValue: ";
2076     chomp(my $input = <STDIN>);
2077     return $input ? $input : $default;
2078 }
2079
2080 sub buildGtkProject
2081 {
2082     my ($project, $clean, $prefix, $makeArgs, $noWebKit1, $noWebKit2, @features) = @_;
2083
2084     if ($project ne "WebKit" and $project ne "JavaScriptCore" and $project ne "WTF") {
2085         die "Unsupported project: $project. Supported projects: WebKit, JavaScriptCore, WTF\n";
2086     }
2087
2088     return buildAutotoolsProject($project, $clean, $prefix, $makeArgs, $noWebKit1, $noWebKit2, @features);
2089 }
2090
2091 sub appleApplicationSupportPath
2092 {
2093     open INSTALL_DIR, "</proc/registry/HKEY_LOCAL_MACHINE/SOFTWARE/Apple\ Inc./Apple\ Application\ Support/InstallDir";
2094     my $path = <INSTALL_DIR>;
2095     $path =~ s/[\r\n\x00].*//;
2096     close INSTALL_DIR;
2097
2098     my $unixPath = `cygpath -u '$path'`;
2099     chomp $unixPath;
2100     return $unixPath;
2101 }
2102
2103 sub setPathForRunningWebKitApp
2104 {
2105     my ($env) = @_;
2106
2107     if (isAppleWinWebKit()) {
2108         $env->{PATH} = join(':', productDir(), dirname(installedSafariPath()), appleApplicationSupportPath(), $env->{PATH} || "");
2109     }
2110 }
2111
2112 sub printHelpAndExitForRunAndDebugWebKitAppIfNeeded
2113 {
2114     return unless checkForArgumentAndRemoveFromARGV("--help");
2115
2116     my ($includeOptionsForDebugging) = @_;
2117
2118     print STDERR <<EOF;
2119 Usage: @{[basename($0)]} [options] [args ...]
2120   --help                            Show this help message
2121   --no-saved-state                  Launch the application without state restoration (OS X 10.7 and later)
2122   --guard-malloc                    Enable Guard Malloc (OS X only)
2123   --use-web-process-xpc-service     Launch the Web Process as an XPC Service (OS X only)
2124 EOF
2125
2126     if ($includeOptionsForDebugging) {
2127         print STDERR <<EOF;
2128   --target-web-process              Debug the web process
2129   --use-gdb                         Use GDB (this is the default when using Xcode 4.4 or earlier)
2130   --use-lldb                        Use LLDB (this is the default when using Xcode 4.5 or later)
2131 EOF
2132     }
2133
2134     exit(1);
2135 }
2136
2137 sub argumentsForRunAndDebugMacWebKitApp()
2138 {
2139     my @args = ();
2140     push @args, ("-ApplePersistenceIgnoreState", "YES") if checkForArgumentAndRemoveFromARGV("--no-saved-state");
2141     push @args, ("-WebKit2UseXPCServiceForWebProcess", "YES") if shouldUseXPCServiceForWebProcess();
2142     unshift @args, @ARGV;
2143
2144     return @args;
2145 }
2146
2147 sub runMacWebKitApp($;$)
2148 {
2149     my ($appPath, $useOpenCommand) = @_;
2150     my $productDir = productDir();
2151     print "Starting @{[basename($appPath)]} with DYLD_FRAMEWORK_PATH set to point to built WebKit in $productDir.\n";
2152     $ENV{DYLD_FRAMEWORK_PATH} = $productDir;
2153     $ENV{WEBKIT_UNSET_DYLD_FRAMEWORK_PATH} = "YES";
2154
2155     setUpGuardMallocIfNeeded();
2156
2157     if (defined($useOpenCommand) && $useOpenCommand == USE_OPEN_COMMAND) {
2158         return system("open", "-W", "-a", $appPath, "--args", argumentsForRunAndDebugMacWebKitApp());
2159     }
2160     if (architecture()) {
2161         return system "arch", "-" . architecture(), $appPath, argumentsForRunAndDebugMacWebKitApp();
2162     }
2163     return system { $appPath } $appPath, argumentsForRunAndDebugMacWebKitApp();
2164 }
2165
2166 sub execMacWebKitAppForDebugging($)
2167 {
2168     my ($appPath) = @_;
2169     my $architectureSwitch;
2170     my $argumentsSeparator;
2171
2172     if (debugger() eq "lldb") {
2173         $architectureSwitch = "--arch";
2174         $argumentsSeparator = "--";
2175     } elsif (debugger() eq "gdb") {
2176         $architectureSwitch = "-arch";
2177         $argumentsSeparator = "--args";
2178     } else {
2179         die "Unknown debugger $debugger.\n";
2180     }
2181
2182     my $debuggerPath = `xcrun -find $debugger`;
2183     chomp $debuggerPath;
2184     die "Can't find the $debugger executable.\n" unless -x $debuggerPath;
2185
2186     my $productDir = productDir();
2187     $ENV{DYLD_FRAMEWORK_PATH} = $productDir;
2188     $ENV{WEBKIT_UNSET_DYLD_FRAMEWORK_PATH} = "YES";
2189
2190     setUpGuardMallocIfNeeded();
2191
2192     my @architectureFlags = ($architectureSwitch, architecture());
2193     if (!shouldTargetWebProcess()) {
2194         print "Starting @{[basename($appPath)]} under $debugger with DYLD_FRAMEWORK_PATH set to point to built WebKit in $productDir.\n";
2195         exec { $debuggerPath } $debuggerPath, @architectureFlags, $argumentsSeparator, $appPath, argumentsForRunAndDebugMacWebKitApp() or die;
2196     } else {
2197         if (shouldUseXPCServiceForWebProcess()) {
2198             die "Targetting the Web Process is not compatible with using an XPC Service for the Web Process at this time.";
2199         }
2200         
2201         my $webProcessShimPath = File::Spec->catfile($productDir, "SecItemShim.dylib");
2202         my $webProcessPath = File::Spec->catdir($productDir, "WebProcess.app");
2203         my $webKit2ExecutablePath = File::Spec->catfile($productDir, "WebKit2.framework", "WebKit2");
2204
2205         appendToEnvironmentVariableList("DYLD_INSERT_LIBRARIES", $webProcessShimPath);
2206
2207         print "Starting WebProcess under $debugger with DYLD_FRAMEWORK_PATH set to point to built WebKit in $productDir.\n";
2208         exec { $debuggerPath } $debuggerPath, @architectureFlags, $argumentsSeparator, $webProcessPath, $webKit2ExecutablePath, "-type", "webprocess", "-client-executable", $appPath or die;
2209     }
2210 }
2211
2212 sub debugSafari
2213 {
2214     if (isAppleMacWebKit()) {
2215         checkFrameworks();
2216         execMacWebKitAppForDebugging(safariPath());
2217     }
2218
2219     return 1; # Unsupported platform; can't debug Safari on this platform.
2220 }
2221
2222 sub runSafari
2223 {
2224
2225     if (isAppleMacWebKit()) {
2226         return runMacWebKitApp(safariPath());
2227     }
2228
2229     if (isAppleWinWebKit()) {
2230         my $result;
2231         my $productDir = productDir();
2232         my $webKitLauncherPath = File::Spec->catfile(productDir(), "WinLauncher.exe");
2233         return system { $webKitLauncherPath } $webKitLauncherPath, @ARGV;
2234     }
2235
2236     return 1; # Unsupported platform; can't run Safari on this platform.
2237 }
2238
2239 sub runMiniBrowser
2240 {
2241     if (isAppleMacWebKit()) {
2242         return runMacWebKitApp(File::Spec->catfile(productDir(), "MiniBrowser.app", "Contents", "MacOS", "MiniBrowser"));
2243     }
2244
2245     return 1;
2246 }
2247
2248 sub debugMiniBrowser
2249 {
2250     if (isAppleMacWebKit()) {
2251         execMacWebKitAppForDebugging(File::Spec->catfile(productDir(), "MiniBrowser.app", "Contents", "MacOS", "MiniBrowser"));
2252     }
2253     
2254     return 1;
2255 }
2256
2257 sub runWebKitTestRunner
2258 {
2259     if (isAppleMacWebKit()) {
2260         return runMacWebKitApp(File::Spec->catfile(productDir(), "WebKitTestRunner"));
2261     } elsif (isGtk()) {
2262         my $productDir = productDir();
2263         my $injectedBundlePath = "$productDir/Libraries/.libs/libTestRunnerInjectedBundle";
2264         print "Starting WebKitTestRunner with TEST_RUNNER_INJECTED_BUNDLE_FILENAME set to point to $injectedBundlePath.\n";
2265         $ENV{TEST_RUNNER_INJECTED_BUNDLE_FILENAME} = $injectedBundlePath;
2266         my @args = ("$productDir/Programs/WebKitTestRunner", @ARGV);
2267         return system {$args[0] } @args;
2268     }
2269
2270     return 1;
2271 }
2272
2273 sub debugWebKitTestRunner
2274 {
2275     if (isAppleMacWebKit()) {
2276         execMacWebKitAppForDebugging(File::Spec->catfile(productDir(), "WebKitTestRunner"));
2277     }
2278
2279     return 1;
2280 }
2281
2282 sub runTestWebKitAPI
2283 {
2284     if (isAppleMacWebKit()) {
2285         return runMacWebKitApp(File::Spec->catfile(productDir(), "TestWebKitAPI"));
2286     }
2287
2288     return 1;
2289 }
2290
2291 sub readRegistryString
2292 {
2293     my ($valueName) = @_;
2294     chomp(my $string = `regtool --wow32 get "$valueName"`);
2295     return $string;
2296 }
2297
2298 sub writeRegistryString
2299 {
2300     my ($valueName, $string) = @_;
2301
2302     my $error = system "regtool", "--wow32", "set", "-s", $valueName, $string;
2303
2304     # On Windows Vista/7 with UAC enabled, regtool will fail to modify the registry, but will still
2305     # return a successful exit code. So we double-check here that the value we tried to write to the
2306     # registry was really written.
2307     return !$error && readRegistryString($valueName) eq $string;
2308 }
2309
2310 1;