[Win] build-jsc and run-javascriptcore-tests do not work
[WebKit-https.git] / Tools / Scripts / webkitdirs.pm
1 # Copyright (C) 2005-2007, 2010-2015 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 # Copyright (C) 2013 Nokia Corporation and/or its subsidiary(-ies).
5 #
6 # Redistribution and use in source and binary forms, with or without
7 # modification, are permitted provided that the following conditions
8 # are met:
9 #
10 # 1.  Redistributions of source code must retain the above copyright
11 #     notice, this list of conditions and the following disclaimer. 
12 # 2.  Redistributions in binary form must reproduce the above copyright
13 #     notice, this list of conditions and the following disclaimer in the
14 #     documentation and/or other materials provided with the distribution. 
15 # 3.  Neither the name of Apple Inc. ("Apple") nor the names of
16 #     its contributors may be used to endorse or promote products derived
17 #     from this software without specific prior written permission. 
18 #
19 # THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
20 # EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
21 # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22 # DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
23 # DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
24 # (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25 # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
26 # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
28 # THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29
30 # Module to share code to get to WebKit directories.
31
32 use strict;
33 use version;
34 use warnings;
35 use Config;
36 use Cwd qw(realpath);
37 use Digest::MD5 qw(md5_hex);
38 use FindBin;
39 use File::Basename;
40 use File::Find;
41 use File::Path qw(make_path mkpath rmtree);
42 use File::Spec;
43 use File::stat;
44 use List::Util;
45 use POSIX;
46 use Time::HiRes qw(usleep);
47 use VCSUtils;
48
49 BEGIN {
50    use Exporter   ();
51    our ($VERSION, @ISA, @EXPORT, @EXPORT_OK, %EXPORT_TAGS);
52    $VERSION     = 1.00;
53    @ISA         = qw(Exporter);
54    @EXPORT      = qw(
55        &XcodeCoverageSupportOptions
56        &XcodeOptionString
57        &XcodeOptionStringNoConfig
58        &XcodeOptions
59        &XcodeStaticAnalyzerOption
60        &appDisplayNameFromBundle
61        &baseProductDir
62        &chdirWebKit
63        &checkFrameworks
64        &cmakeBasedPortArguments
65        &cmakeBasedPortName
66        &currentSVNRevision
67        &debugSafari
68        &executableProductDir
69        &findOrCreateSimulatorForIOSDevice
70        &iosSimulatorDeviceByName
71        &nmPath
72        &passedConfiguration
73        &printHelpAndExitForRunAndDebugWebKitAppIfNeeded
74        &productDir
75        &quitIOSSimulator
76        &relaunchIOSSimulator
77        &runIOSWebKitApp
78        &runMacWebKitApp
79        &safariPath
80        &iosVersion
81        &setConfiguration
82        &setupMacWebKitEnvironment
83        &sharedCommandLineOptions
84        &sharedCommandLineOptionsUsage
85        SIMULATOR_DEVICE_SUFFIX_FOR_WEBKIT_DEVELOPMENT
86        USE_OPEN_COMMAND
87    );
88    %EXPORT_TAGS = ( );
89    @EXPORT_OK   = ();
90 }
91
92 use constant USE_OPEN_COMMAND => 1; # Used in runMacWebKitApp().
93 use constant INCLUDE_OPTIONS_FOR_DEBUGGING => 1;
94 use constant SIMULATOR_DEVICE_STATE_SHUTDOWN => "1";
95 use constant SIMULATOR_DEVICE_STATE_BOOTED => "3";
96 use constant SIMULATOR_DEVICE_SUFFIX_FOR_WEBKIT_DEVELOPMENT  => "For WebKit Development";
97
98 # See table "Certificate types and names" on <https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html#//apple_ref/doc/uid/TP40012582-CH31-SW41>.
99 use constant IOS_DEVELOPMENT_CERTIFICATE_NAME_PREFIX => "iPhone Developer: ";
100
101 our @EXPORT_OK;
102
103 my $architecture;
104 my $asanIsEnabled;
105 my $numberOfCPUs;
106 my $maxCPULoad;
107 my $baseProductDir;
108 my @baseProductDirOption;
109 my $configuration;
110 my $xcodeSDK;
111 my $configurationForVisualStudio;
112 my $configurationProductDir;
113 my $sourceDir;
114 my $currentSVNRevision;
115 my $debugger;
116 my $didLoadIPhoneSimulatorNotification;
117 my $nmPath;
118 my $osXVersion;
119 my $iosVersion;
120 my $generateDsym;
121 my $isCMakeBuild;
122 my $isGtk;
123 my $isWinCairo;
124 my $isWin64;
125 my $isEfl;
126 my $isInspectorFrontend;
127 my $shouldTargetWebProcess;
128 my $shouldUseXPCServiceForWebProcess;
129 my $shouldUseGuardMalloc;
130 my $shouldNotUseNinja;
131 my $xcodeVersion;
132
133 # Variables for Win32 support
134 my $programFilesPath;
135 my $vcBuildPath;
136 my $vsInstallDir;
137 my $msBuildInstallDir;
138 my $vsVersion;
139 my $windowsSourceDir;
140 my $winVersion;
141 my $willUseVCExpressWhenBuilding = 0;
142
143 # Defined in VCSUtils.
144 sub exitStatus($);
145
146 sub findMatchingArguments($$);
147 sub hasArgument($$);
148
149 sub determineSourceDir
150 {
151     return if $sourceDir;
152     $sourceDir = $FindBin::Bin;
153     $sourceDir =~ s|/+$||; # Remove trailing '/' as we would die later
154
155     # walks up path checking each directory to see if it is the main WebKit project dir, 
156     # defined by containing Sources, WebCore, and WebKit
157     until ((-d File::Spec->catdir($sourceDir, "Source") && -d File::Spec->catdir($sourceDir, "Source", "WebCore") && -d File::Spec->catdir($sourceDir, "Source", "WebKit")) || (-d File::Spec->catdir($sourceDir, "Internal") && -d File::Spec->catdir($sourceDir, "OpenSource")))
158     {
159         if ($sourceDir !~ s|/[^/]+$||) {
160             die "Could not find top level webkit directory above source directory using FindBin.\n";
161         }
162     }
163
164     $sourceDir = File::Spec->catdir($sourceDir, "OpenSource") if -d File::Spec->catdir($sourceDir, "OpenSource");
165 }
166
167 sub currentPerlPath()
168 {
169     my $thisPerl = $^X;
170     if ($^O ne 'VMS') {
171         $thisPerl .= $Config{_exe} unless $thisPerl =~ m/$Config{_exe}$/i;
172     }
173     return $thisPerl;
174 }
175
176 # used for scripts which are stored in a non-standard location
177 sub setSourceDir($)
178 {
179     ($sourceDir) = @_;
180 }
181
182 sub determineNinjaVersion
183 {
184     chomp(my $ninjaVersion = `ninja --version`);
185     return $ninjaVersion;
186 }
187
188 sub determineXcodeVersion
189 {
190     return if defined $xcodeVersion;
191     my $xcodebuildVersionOutput = `xcodebuild -version`;
192     $xcodeVersion = ($xcodebuildVersionOutput =~ /Xcode ([0-9](\.[0-9]+)*)/) ? $1 : "3.0";
193 }
194
195 sub readXcodeUserDefault($)
196 {
197     my ($unprefixedKey) = @_;
198
199     determineXcodeVersion();
200
201     my $xcodeDefaultsDomain = (eval "v$xcodeVersion" lt v4) ? "com.apple.Xcode" : "com.apple.dt.Xcode";
202     my $xcodeDefaultsPrefix = (eval "v$xcodeVersion" lt v4) ? "PBX" : "IDE";
203     my $devnull = File::Spec->devnull();
204
205     my $value = `defaults read $xcodeDefaultsDomain ${xcodeDefaultsPrefix}${unprefixedKey} 2> ${devnull}`;
206     return if $?;
207
208     chomp $value;
209     return $value;
210 }
211
212 sub determineBaseProductDir
213 {
214     return if defined $baseProductDir;
215     determineSourceDir();
216
217     my $setSharedPrecompsDir;
218     $baseProductDir = $ENV{"WEBKIT_OUTPUTDIR"};
219
220     if (!defined($baseProductDir) and isAppleMacWebKit()) {
221         # Silently remove ~/Library/Preferences/xcodebuild.plist which can
222         # cause build failure. The presence of
223         # ~/Library/Preferences/xcodebuild.plist can prevent xcodebuild from
224         # respecting global settings such as a custom build products directory
225         # (<rdar://problem/5585899>).
226         my $personalPlistFile = $ENV{HOME} . "/Library/Preferences/xcodebuild.plist";
227         if (-e $personalPlistFile) {
228             unlink($personalPlistFile) || die "Could not delete $personalPlistFile: $!";
229         }
230
231         determineXcodeVersion();
232
233         if (eval "v$xcodeVersion" ge v4) {
234             my $buildLocationStyle = join '', readXcodeUserDefault("BuildLocationStyle");
235             if ($buildLocationStyle eq "Custom") {
236                 my $buildLocationType = join '', readXcodeUserDefault("CustomBuildLocationType");
237                 # FIXME: Read CustomBuildIntermediatesPath and set OBJROOT accordingly.
238                 $baseProductDir = readXcodeUserDefault("CustomBuildProductsPath") if $buildLocationType eq "Absolute";
239             }
240
241             # DeterminedByTargets corresponds to a setting of "Legacy" in Xcode.
242             # It is the only build location style for which SHARED_PRECOMPS_DIR is not
243             # overridden when building from within Xcode.
244             $setSharedPrecompsDir = 1 if $buildLocationStyle ne "DeterminedByTargets";
245         }
246
247         if (!defined($baseProductDir)) {
248             $baseProductDir = join '', readXcodeUserDefault("ApplicationwideBuildSettings");
249             $baseProductDir = $1 if $baseProductDir =~ /SYMROOT\s*=\s*\"(.*?)\";/s;
250         }
251
252         undef $baseProductDir unless $baseProductDir =~ /^\//;
253     }
254
255     if (!defined($baseProductDir)) { # Port-specific checks failed, use default
256         $baseProductDir = File::Spec->catdir($sourceDir, "WebKitBuild");
257     }
258
259     if (isGit() && isGitBranchBuild()) {
260         my $branch = gitBranch();
261         $baseProductDir = "$baseProductDir/$branch";
262     }
263
264     if (isAppleMacWebKit()) {
265         $baseProductDir =~ s|^\Q$(SRCROOT)/..\E$|$sourceDir|;
266         $baseProductDir =~ s|^\Q$(SRCROOT)/../|$sourceDir/|;
267         $baseProductDir =~ s|^~/|$ENV{HOME}/|;
268         die "Can't handle Xcode product directory with a ~ in it.\n" if $baseProductDir =~ /~/;
269         die "Can't handle Xcode product directory with a variable in it.\n" if $baseProductDir =~ /\$/;
270         @baseProductDirOption = ("SYMROOT=$baseProductDir", "OBJROOT=$baseProductDir");
271         push(@baseProductDirOption, "SHARED_PRECOMPS_DIR=${baseProductDir}/PrecompiledHeaders") if $setSharedPrecompsDir;
272     }
273
274     if (isCygwin()) {
275         my $dosBuildPath = `cygpath --windows \"$baseProductDir\"`;
276         chomp $dosBuildPath;
277         $ENV{"WEBKIT_OUTPUTDIR"} = $dosBuildPath;
278         my $unixBuildPath = `cygpath --unix \"$baseProductDir\"`;
279         chomp $unixBuildPath;
280         $baseProductDir = $dosBuildPath;
281     }
282 }
283
284 sub setBaseProductDir($)
285 {
286     ($baseProductDir) = @_;
287 }
288
289 sub determineConfiguration
290 {
291     return if defined $configuration;
292     determineBaseProductDir();
293     if (open CONFIGURATION, "$baseProductDir/Configuration") {
294         $configuration = <CONFIGURATION>;
295         close CONFIGURATION;
296     }
297     if ($configuration) {
298         chomp $configuration;
299         # compatibility for people who have old Configuration files
300         $configuration = "Release" if $configuration eq "Deployment";
301         $configuration = "Debug" if $configuration eq "Development";
302     } else {
303         $configuration = "Release";
304     }
305 }
306
307 sub determineArchitecture
308 {
309     return if defined $architecture;
310     # make sure $architecture is defined in all cases
311     $architecture = "";
312
313     determineBaseProductDir();
314     determineXcodeSDK();
315
316     if (isAppleMacWebKit()) {
317         if (open ARCHITECTURE, "$baseProductDir/Architecture") {
318             $architecture = <ARCHITECTURE>;
319             close ARCHITECTURE;
320         }
321         if ($architecture) {
322             chomp $architecture;
323         } else {
324             if (not defined $xcodeSDK or $xcodeSDK =~ /^(\/$|macosx)/) {
325                 my $supports64Bit = `sysctl -n hw.optional.x86_64`;
326                 chomp $supports64Bit;
327                 $architecture = 'x86_64' if $supports64Bit;
328             } elsif ($xcodeSDK =~ /^iphonesimulator/) {
329                 $architecture = 'x86_64';
330             } elsif ($xcodeSDK =~ /^iphoneos/) {
331                 $architecture = 'armv7';
332             }
333         }
334     } elsif (isEfl() || isGtk()) {
335         my $host_processor = "";
336         $host_processor = `cmake --system-information | grep CMAKE_SYSTEM_PROCESSOR`;
337         if ($host_processor =~ m/^CMAKE_SYSTEM_PROCESSOR \"([^"]+)\"/) {
338             # We have a configured build tree; use it.
339             $architecture = $1;
340             $architecture = 'x86_64' if $architecture eq 'amd64';
341         }
342     }
343
344     if (!$architecture && (isGtk() || isAppleMacWebKit() || isEfl())) {
345         # Fall back to output of `arch', if it is present.
346         $architecture = `arch`;
347         chomp $architecture;
348     }
349
350     if (!$architecture && (isGtk() || isAppleMacWebKit() || isEfl())) {
351         # Fall back to output of `uname -m', if it is present.
352         $architecture = `uname -m`;
353         chomp $architecture;
354     }
355
356     $architecture = 'x86_64' if ($architecture =~ /amd64/ && isBSD());
357 }
358
359 sub determineASanIsEnabled
360 {
361     return if defined $asanIsEnabled;
362     determineBaseProductDir();
363
364     $asanIsEnabled = 0;
365     my $asanConfigurationValue;
366
367     if (open ASAN, "$baseProductDir/ASan") {
368         $asanConfigurationValue = <ASAN>;
369         close ASAN;
370         chomp $asanConfigurationValue;
371         $asanIsEnabled = 1 if $asanConfigurationValue eq "YES";
372     }
373 }
374
375 sub determineNumberOfCPUs
376 {
377     return if defined $numberOfCPUs;
378     if (defined($ENV{NUMBER_OF_PROCESSORS})) {
379         $numberOfCPUs = $ENV{NUMBER_OF_PROCESSORS};
380     } elsif (isLinux()) {
381         # First try the nproc utility, if it exists. If we get no
382         # results fall back to just interpretting /proc directly.
383         chomp($numberOfCPUs = `nproc --all 2> /dev/null`);
384         if ($numberOfCPUs eq "") {
385             $numberOfCPUs = (grep /processor/, `cat /proc/cpuinfo`);
386         }
387     } elsif (isWindows() || isCygwin()) {
388         # Assumes cygwin
389         $numberOfCPUs = `ls /proc/registry/HKEY_LOCAL_MACHINE/HARDWARE/DESCRIPTION/System/CentralProcessor | wc -w`;
390     } elsif (isDarwin() || isBSD()) {
391         chomp($numberOfCPUs = `sysctl -n hw.ncpu`);
392     }
393 }
394
395 sub determineMaxCPULoad
396 {
397     return if defined $maxCPULoad;
398     if (defined($ENV{MAX_CPU_LOAD})) {
399         $maxCPULoad = $ENV{MAX_CPU_LOAD};
400     }
401 }
402
403 sub jscPath($)
404 {
405     my ($productDir) = @_;
406     my $jscName = "jsc";
407     $jscName .= "_debug"  if configuration() eq "Debug_All";
408     $jscName .= ".exe" if (isWindows() || isCygwin());
409     return "$productDir/$jscName" if -e "$productDir/$jscName";
410     return "$productDir/JavaScriptCore.framework/Resources/$jscName";
411 }
412
413 sub argumentsForConfiguration()
414 {
415     determineConfiguration();
416     determineArchitecture();
417     determineXcodeSDK();
418
419     my @args = ();
420     # FIXME: Is it necessary to pass --debug, --release, --32-bit or --64-bit?
421     # These are determined automatically from stored configuration.
422     push(@args, '--debug') if ($configuration =~ "^Debug");
423     push(@args, '--release') if ($configuration =~ "^Release");
424     push(@args, '--device') if (defined $xcodeSDK && $xcodeSDK =~ /^iphoneos/);
425     push(@args, '--ios-simulator') if (defined $xcodeSDK && $xcodeSDK =~ /^iphonesimulator/);
426     push(@args, '--32-bit') if ($architecture ne "x86_64" and !isWin64());
427     push(@args, '--64-bit') if (isWin64());
428     push(@args, '--gtk') if isGtk();
429     push(@args, '--efl') if isEfl();
430     push(@args, '--wincairo') if isWinCairo();
431     push(@args, '--inspector-frontend') if isInspectorFrontend();
432     return @args;
433 }
434
435 sub determineXcodeSDK
436 {
437     return if defined $xcodeSDK;
438     my $sdk;
439     if (checkForArgumentAndRemoveFromARGVGettingValue("--sdk", \$sdk)) {
440         $xcodeSDK = $sdk;
441     }
442     if (checkForArgumentAndRemoveFromARGV("--device")) {
443         my $hasInternalSDK = exitStatus(system("xcrun --sdk iphoneos.internal --show-sdk-version > /dev/null 2>&1")) == 0;
444         $xcodeSDK ||= $hasInternalSDK ? "iphoneos.internal" : "iphoneos";
445     }
446     if (checkForArgumentAndRemoveFromARGV("--ios-simulator")) {
447         $xcodeSDK ||= 'iphonesimulator';
448     }
449 }
450
451 sub xcodeSDK
452 {
453     determineXcodeSDK();
454     return $xcodeSDK;
455 }
456
457 sub setXcodeSDK($)
458 {
459     ($xcodeSDK) = @_;
460 }
461
462
463 sub xcodeSDKPlatformName()
464 {
465     determineXcodeSDK();
466     return "" if !defined $xcodeSDK;
467     return "iphoneos" if $xcodeSDK =~ /iphoneos/i;
468     return "iphonesimulator" if $xcodeSDK =~ /iphonesimulator/i;
469     return "macosx" if $xcodeSDK =~ /macosx/i;
470     die "Couldn't determine platform name from Xcode SDK";
471 }
472
473 sub XcodeSDKPath
474 {
475     determineXcodeSDK();
476
477     die "Can't find the SDK path because no Xcode SDK was specified" if not $xcodeSDK;
478
479     my $sdkPath = `xcrun --sdk $xcodeSDK --show-sdk-path` if $xcodeSDK;
480     die 'Failed to get SDK path from xcrun' if $?;
481     chomp $sdkPath;
482
483     return $sdkPath;
484 }
485
486 sub xcodeSDKVersion
487 {
488     determineXcodeSDK();
489
490     die "Can't find the SDK version because no Xcode SDK was specified" if !$xcodeSDK;
491
492     chomp(my $sdkVersion = `xcrun --sdk $xcodeSDK --show-sdk-version`);
493     die "Failed to get SDK version from xcrun" if exitStatus($?);
494
495     return $sdkVersion;
496 }
497
498 sub programFilesPath
499 {
500     return $programFilesPath if defined $programFilesPath;
501
502     $programFilesPath = $ENV{'PROGRAMFILES(X86)'} || $ENV{'PROGRAMFILES'} || "C:\\Program Files";
503
504     return $programFilesPath;
505 }
506
507 sub visualStudioInstallDir
508 {
509     return $vsInstallDir if defined $vsInstallDir;
510
511     if ($ENV{'VSINSTALLDIR'}) {
512         $vsInstallDir = $ENV{'VSINSTALLDIR'};
513         $vsInstallDir =~ s|[\\/]$||;
514     } else {
515         $vsInstallDir = File::Spec->catdir(programFilesPath(), "Microsoft Visual Studio 14.0");
516     }
517     chomp($vsInstallDir = `cygpath "$vsInstallDir"`) if isCygwin();
518
519     print "Using Visual Studio: $vsInstallDir\n";
520     return $vsInstallDir;
521 }
522
523 sub msBuildInstallDir
524 {
525     return $msBuildInstallDir if defined $msBuildInstallDir;
526
527     $msBuildInstallDir = File::Spec->catdir(programFilesPath(), "MSBuild", "14.0", "Bin");
528    
529     chomp($msBuildInstallDir = `cygpath "$msBuildInstallDir"`) if isCygwin();
530
531     print "Using MSBuild: $msBuildInstallDir\n";
532     return $msBuildInstallDir;
533 }
534
535 sub visualStudioVersion
536 {
537     return $vsVersion if defined $vsVersion;
538
539     my $installDir = visualStudioInstallDir();
540
541     $vsVersion = ($installDir =~ /Microsoft Visual Studio ([0-9]+\.[0-9]*)/) ? $1 : "14";
542
543     print "Using Visual Studio $vsVersion\n";
544     return $vsVersion;
545 }
546
547 sub determineConfigurationForVisualStudio
548 {
549     return if defined $configurationForVisualStudio;
550     determineConfiguration();
551     # FIXME: We should detect when Debug_All or Production has been chosen.
552     $configurationForVisualStudio = "/p:Configuration=" . $configuration;
553 }
554
555 sub usesPerConfigurationBuildDirectory
556 {
557     # [Gtk] We don't have Release/Debug configurations in straight
558     # autotool builds (non build-webkit). In this case and if
559     # WEBKIT_OUTPUTDIR exist, use that as our configuration dir. This will
560     # allows us to run run-webkit-tests without using build-webkit.
561     return ($ENV{"WEBKIT_OUTPUTDIR"} && isGtk()) || isAppleWinWebKit();
562 }
563
564 sub determineConfigurationProductDir
565 {
566     return if defined $configurationProductDir;
567     determineBaseProductDir();
568     determineConfiguration();
569     if (isAppleWinWebKit() || isWinCairo()) {
570         $configurationProductDir = File::Spec->catdir($baseProductDir, $configuration);
571     } else {
572         if (usesPerConfigurationBuildDirectory()) {
573             $configurationProductDir = "$baseProductDir";
574         } else {
575             $configurationProductDir = "$baseProductDir/$configuration";
576             $configurationProductDir .= "-" . xcodeSDKPlatformName() if isIOSWebKit();
577         }
578     }
579 }
580
581 sub setConfigurationProductDir($)
582 {
583     ($configurationProductDir) = @_;
584 }
585
586 sub determineCurrentSVNRevision
587 {
588     # We always update the current SVN revision here, and leave the caching
589     # to currentSVNRevision(), so that changes to the SVN revision while the
590     # script is running can be picked up by calling this function again.
591     determineSourceDir();
592     $currentSVNRevision = svnRevisionForDirectory($sourceDir);
593     return $currentSVNRevision;
594 }
595
596
597 sub chdirWebKit
598 {
599     determineSourceDir();
600     chdir $sourceDir or die;
601 }
602
603 sub baseProductDir
604 {
605     determineBaseProductDir();
606     return $baseProductDir;
607 }
608
609 sub sourceDir
610 {
611     determineSourceDir();
612     return $sourceDir;
613 }
614
615 sub productDir
616 {
617     determineConfigurationProductDir();
618     return $configurationProductDir;
619 }
620
621 sub executableProductDir
622 {
623     my $productDirectory = productDir();
624
625     my $binaryDirectory;
626     if (isEfl() || isGtk()) {
627         $binaryDirectory = "bin";
628     } elsif (isAnyWindows()) {
629         $binaryDirectory = isWin64() ? "bin64" : "bin32";
630     } else {
631         return $productDirectory;
632     }
633
634     return File::Spec->catdir($productDirectory, $binaryDirectory);
635 }
636
637 sub jscProductDir
638 {
639     return executableProductDir();
640 }
641
642 sub configuration()
643 {
644     determineConfiguration();
645     return $configuration;
646 }
647
648 sub asanIsEnabled()
649 {
650     determineASanIsEnabled();
651     return $asanIsEnabled;
652 }
653
654 sub configurationForVisualStudio()
655 {
656     determineConfigurationForVisualStudio();
657     return $configurationForVisualStudio;
658 }
659
660 sub currentSVNRevision
661 {
662     determineCurrentSVNRevision() if not defined $currentSVNRevision;
663     return $currentSVNRevision;
664 }
665
666 sub generateDsym()
667 {
668     determineGenerateDsym();
669     return $generateDsym;
670 }
671
672 sub determineGenerateDsym()
673 {
674     return if defined($generateDsym);
675     $generateDsym = checkForArgumentAndRemoveFromARGV("--dsym");
676 }
677
678 sub hasIOSDevelopmentCertificate()
679 {
680     return !exitStatus(system("security find-identity -p codesigning | grep '" . IOS_DEVELOPMENT_CERTIFICATE_NAME_PREFIX . "' > /dev/null 2>&1"));
681 }
682
683 sub argumentsForXcode()
684 {
685     my @args = ();
686     push @args, "DEBUG_INFORMATION_FORMAT=dwarf-with-dsym" if generateDsym();
687     return @args;
688 }
689
690 sub XcodeOptions
691 {
692     determineBaseProductDir();
693     determineConfiguration();
694     determineArchitecture();
695     determineASanIsEnabled();
696     determineXcodeSDK();
697
698     my @options;
699     push @options, "-UseSanitizedBuildSystemEnvironment=YES";
700     push @options, ("-configuration", $configuration);
701     push @options, ("-xcconfig", sourceDir() . "/Tools/asan/asan.xcconfig", "ASAN_IGNORE=" . sourceDir() . "/Tools/asan/webkit-asan-ignore.txt") if $asanIsEnabled;
702     push @options, @baseProductDirOption;
703     push @options, "ARCHS=$architecture" if $architecture;
704     push @options, "SDKROOT=$xcodeSDK" if $xcodeSDK;
705     if (willUseIOSDeviceSDKWhenBuilding()) {
706         push @options, "ENABLE_BITCODE=NO";
707         if (hasIOSDevelopmentCertificate()) {
708             # FIXME: May match more than one installed development certificate.
709             push @options, "CODE_SIGN_IDENTITY=" . IOS_DEVELOPMENT_CERTIFICATE_NAME_PREFIX;
710         } else {
711             push @options, "CODE_SIGN_IDENTITY="; # No identity
712             push @options, "CODE_SIGNING_REQUIRED=NO";
713         }
714     }
715     push @options, argumentsForXcode();
716     return @options;
717 }
718
719 sub XcodeOptionString
720 {
721     return join " ", XcodeOptions();
722 }
723
724 sub XcodeOptionStringNoConfig
725 {
726     return join " ", @baseProductDirOption;
727 }
728
729 sub XcodeCoverageSupportOptions()
730 {
731     my @coverageSupportOptions = ();
732     push @coverageSupportOptions, "GCC_GENERATE_TEST_COVERAGE_FILES=YES";
733     push @coverageSupportOptions, "GCC_INSTRUMENT_PROGRAM_FLOW_ARCS=YES";
734     return @coverageSupportOptions;
735 }
736
737 sub XcodeStaticAnalyzerOption()
738 {
739     return "RUN_CLANG_STATIC_ANALYZER=YES";
740 }
741
742 my $passedConfiguration;
743 my $searchedForPassedConfiguration;
744 sub determinePassedConfiguration
745 {
746     return if $searchedForPassedConfiguration;
747     $searchedForPassedConfiguration = 1;
748     $passedConfiguration = undef;
749
750     if (checkForArgumentAndRemoveFromARGV("--debug")) {
751         $passedConfiguration = "Debug";
752     } elsif(checkForArgumentAndRemoveFromARGV("--release")) {
753         $passedConfiguration = "Release";
754     } elsif (checkForArgumentAndRemoveFromARGV("--profile") || checkForArgumentAndRemoveFromARGV("--profiling")) {
755         $passedConfiguration = "Profiling";
756     }
757 }
758
759 sub passedConfiguration
760 {
761     determinePassedConfiguration();
762     return $passedConfiguration;
763 }
764
765 sub setConfiguration
766 {
767     setArchitecture();
768
769     if (my $config = shift @_) {
770         $configuration = $config;
771         return;
772     }
773
774     determinePassedConfiguration();
775     $configuration = $passedConfiguration if $passedConfiguration;
776 }
777
778
779 my $passedArchitecture;
780 my $searchedForPassedArchitecture;
781 sub determinePassedArchitecture
782 {
783     return if $searchedForPassedArchitecture;
784     $searchedForPassedArchitecture = 1;
785
786     $passedArchitecture = undef;
787     if (checkForArgumentAndRemoveFromARGV("--32-bit")) {
788         if (isAppleMacWebKit()) {
789             # PLATFORM_IOS: Don't run `arch` command inside Simulator environment
790             local %ENV = %ENV;
791             delete $ENV{DYLD_ROOT_PATH};
792             delete $ENV{DYLD_FRAMEWORK_PATH};
793
794             $passedArchitecture = `arch`;
795             chomp $passedArchitecture;
796         }
797     }
798 }
799
800 sub passedArchitecture
801 {
802     determinePassedArchitecture();
803     return $passedArchitecture;
804 }
805
806 sub architecture()
807 {
808     determineArchitecture();
809     return $architecture;
810 }
811
812 sub numberOfCPUs()
813 {
814     determineNumberOfCPUs();
815     return $numberOfCPUs;
816 }
817
818 sub maxCPULoad()
819 {
820     determineMaxCPULoad();
821     return $maxCPULoad;
822 }
823
824 sub setArchitecture
825 {
826     if (my $arch = shift @_) {
827         $architecture = $arch;
828         return;
829     }
830
831     determinePassedArchitecture();
832     $architecture = $passedArchitecture if $passedArchitecture;
833 }
834
835 sub skipSafariExecutableEntitlementChecks
836 {
837     return `defaults read /Library/Preferences/org.webkit.BuildConfiguration SkipSafariExecutableEntitlementChecks 2>/dev/null` eq "1\n";
838 }
839
840 sub executableHasEntitlements
841 {
842     my $executablePath = shift;
843     return (`codesign -d --entitlements - $executablePath 2>&1` =~ /<key>/);
844 }
845
846 sub safariPathFromSafariBundle
847 {
848     my ($safariBundle) = @_;
849
850     die "Safari path is only relevant on Apple Mac platform\n" unless isAppleMacWebKit();
851
852     my $safariPath = "$safariBundle/Contents/MacOS/Safari";
853     return $safariPath if skipSafariExecutableEntitlementChecks();
854
855     my $safariForWebKitDevelopmentPath = "$safariBundle/Contents/MacOS/SafariForWebKitDevelopment";
856     return $safariForWebKitDevelopmentPath if -f $safariForWebKitDevelopmentPath && executableHasEntitlements($safariPath);
857
858     return $safariPath;
859 }
860
861 sub installedSafariPath
862 {
863     return safariPathFromSafariBundle("/Applications/Safari.app");
864 }
865
866 # Locate Safari.
867 sub safariPath
868 {
869     die "Safari path is only relevant on Apple Mac platform\n" unless isAppleMacWebKit();
870
871     # Use WEBKIT_SAFARI environment variable if present.
872     my $safariBundle = $ENV{WEBKIT_SAFARI};
873     if (!$safariBundle) {
874         determineConfigurationProductDir();
875         # Use Safari.app in product directory if present (good for Safari development team).
876         if (-d "$configurationProductDir/Safari.app") {
877             $safariBundle = "$configurationProductDir/Safari.app";
878         }
879         if (!$safariBundle) {
880             return installedSafariPath();
881         }
882     }
883     my $safariPath = safariPathFromSafariBundle($safariBundle);
884     die "Can't find executable at $safariPath.\n" if !-x $safariPath;
885     return $safariPath;
886 }
887
888 sub builtDylibPathForName
889 {
890     my $libraryName = shift;
891     determineConfigurationProductDir();
892
893     if (isGtk()) {
894         my $extension = isDarwin() ? ".dylib" : ".so";
895         return "$configurationProductDir/lib/libwebkit2gtk-4.0" . $extension;
896     }
897     if (isEfl()) {
898         return "$configurationProductDir/lib/libewebkit2.so";
899     }
900     if (isIOSWebKit()) {
901         return "$configurationProductDir/$libraryName.framework/$libraryName";
902     }
903     if (isAppleMacWebKit()) {
904         return "$configurationProductDir/$libraryName.framework/Versions/A/$libraryName";
905     }
906     if (isAppleWinWebKit()) {
907         if ($libraryName eq "JavaScriptCore") {
908             return "$baseProductDir/lib/$libraryName.lib";
909         } else {
910             return "$baseProductDir/$libraryName.intermediate/$configuration/$libraryName.intermediate/$libraryName.lib";
911         }
912     }
913
914     die "Unsupported platform, can't determine built library locations.\nTry `build-webkit --help` for more information.\n";
915 }
916
917 # Check to see that all the frameworks are built.
918 sub checkFrameworks # FIXME: This is a poor name since only the Mac calls built WebCore a Framework.
919 {
920     return if isCygwin() || isWindows();
921     my @frameworks = ("JavaScriptCore", "WebCore");
922     push(@frameworks, "WebKit") if isAppleMacWebKit(); # FIXME: This seems wrong, all ports should have a WebKit these days.
923     for my $framework (@frameworks) {
924         my $path = builtDylibPathForName($framework);
925         die "Can't find built framework at \"$path\".\n" unless -e $path;
926     }
927 }
928
929 sub isInspectorFrontend()
930 {
931     determineIsInspectorFrontend();
932     return $isInspectorFrontend;
933 }
934
935 sub determineIsInspectorFrontend()
936 {
937     return if defined($isInspectorFrontend);
938     $isInspectorFrontend = checkForArgumentAndRemoveFromARGV("--inspector-frontend");
939 }
940
941 sub commandExists($)
942 {
943     my $command = shift;
944     my $devnull = File::Spec->devnull();
945
946     if (isAnyWindows()) {
947         return exitStatus(system("where /q $command >$devnull 2>&1")) == 0;
948     }
949     return exitStatus(system("which $command >$devnull 2>&1")) == 0;
950 }
951
952 sub checkForArgumentAndRemoveFromARGV($)
953 {
954     my $argToCheck = shift;
955     return checkForArgumentAndRemoveFromArrayRef($argToCheck, \@ARGV);
956 }
957
958 sub checkForArgumentAndRemoveFromArrayRefGettingValue($$$)
959 {
960     my ($argToCheck, $valueRef, $arrayRef) = @_;
961     my $argumentStartRegEx = qr#^$argToCheck(?:=\S|$)#;
962     my $i = 0;
963     for (; $i < @$arrayRef; ++$i) {
964         last if $arrayRef->[$i] =~ $argumentStartRegEx;
965     }
966     if ($i >= @$arrayRef) {
967         return $$valueRef = undef;
968     }
969     my ($key, $value) = split("=", $arrayRef->[$i]);
970     splice(@$arrayRef, $i, 1);
971     if (defined($value)) {
972         # e.g. --sdk=iphonesimulator
973         return $$valueRef = $value;
974     }
975     return $$valueRef = splice(@$arrayRef, $i, 1); # e.g. --sdk iphonesimulator
976 }
977
978 sub checkForArgumentAndRemoveFromARGVGettingValue($$)
979 {
980     my ($argToCheck, $valueRef) = @_;
981     return checkForArgumentAndRemoveFromArrayRefGettingValue($argToCheck, $valueRef, \@ARGV);
982 }
983
984 sub findMatchingArguments($$)
985 {
986     my ($argToCheck, $arrayRef) = @_;
987     my @matchingIndices;
988     foreach my $index (0 .. $#$arrayRef) {
989         my $opt = $$arrayRef[$index];
990         if ($opt =~ /^$argToCheck$/i ) {
991             push(@matchingIndices, $index);
992         }
993     }
994     return @matchingIndices; 
995 }
996
997 sub hasArgument($$)
998 {
999     my ($argToCheck, $arrayRef) = @_;
1000     my @matchingIndices = findMatchingArguments($argToCheck, $arrayRef);
1001     return scalar @matchingIndices > 0;
1002 }
1003
1004 sub checkForArgumentAndRemoveFromArrayRef
1005 {
1006     my ($argToCheck, $arrayRef) = @_;
1007     my @indicesToRemove = findMatchingArguments($argToCheck, $arrayRef);
1008     my $removeOffset = 0;
1009     foreach my $index (@indicesToRemove) {
1010         splice(@$arrayRef, $index - $removeOffset++, 1);
1011     }
1012     return scalar @indicesToRemove > 0;
1013 }
1014
1015 sub determineIsEfl()
1016 {
1017     return if defined($isEfl);
1018     $isEfl = checkForArgumentAndRemoveFromARGV("--efl");
1019 }
1020
1021 sub isEfl()
1022 {
1023     determineIsEfl();
1024     return $isEfl;
1025 }
1026
1027 sub determineIsGtk()
1028 {
1029     return if defined($isGtk);
1030     $isGtk = checkForArgumentAndRemoveFromARGV("--gtk");
1031 }
1032
1033 sub isGtk()
1034 {
1035     determineIsGtk();
1036     return $isGtk;
1037 }
1038
1039 # Determine if this is debian, ubuntu, linspire, or something similar.
1040 sub isDebianBased()
1041 {
1042     return -e "/etc/debian_version";
1043 }
1044
1045 sub isFedoraBased()
1046 {
1047     return -e "/etc/fedora-release";
1048 }
1049
1050 sub isWinCairo()
1051 {
1052     determineIsWinCairo();
1053     return $isWinCairo;
1054 }
1055
1056 sub determineIsWinCairo()
1057 {
1058     return if defined($isWinCairo);
1059     $isWinCairo = checkForArgumentAndRemoveFromARGV("--wincairo");
1060 }
1061
1062 sub isWin64()
1063 {
1064     determineIsWin64();
1065     return $isWin64;
1066 }
1067
1068 sub determineIsWin64()
1069 {
1070     return if defined($isWin64);
1071     $isWin64 = checkForArgumentAndRemoveFromARGV("--64-bit");
1072 }
1073
1074 sub determineIsWin64FromArchitecture($)
1075 {
1076     my $arch = shift;
1077     $isWin64 = ($arch eq "x86_64");
1078     return $isWin64;
1079 }
1080
1081 sub isCygwin()
1082 {
1083     return ($^O eq "cygwin") || 0;
1084 }
1085
1086 sub isAnyWindows()
1087 {
1088     return isWindows() || isCygwin();
1089 }
1090
1091 sub determineWinVersion()
1092 {
1093     return if $winVersion;
1094
1095     if (!isAnyWindows()) {
1096         $winVersion = -1;
1097         return;
1098     }
1099
1100     my $versionString = `cmd /c ver`;
1101     $versionString =~ /(\d)\.(\d)\.(\d+)/;
1102
1103     $winVersion = {
1104         major => $1,
1105         minor => $2,
1106         build => $3,
1107     };
1108 }
1109
1110 sub winVersion()
1111 {
1112     determineWinVersion();
1113     return $winVersion;
1114 }
1115
1116 sub isWindows7SP0()
1117 {
1118     return isAnyWindows() && winVersion()->{major} == 6 && winVersion()->{minor} == 1 && winVersion()->{build} == 7600;
1119 }
1120
1121 sub isWindowsVista()
1122 {
1123     return isAnyWindows() && winVersion()->{major} == 6 && winVersion()->{minor} == 0;
1124 }
1125
1126 sub isWindowsXP()
1127 {
1128     return isAnyWindows() && winVersion()->{major} == 5 && winVersion()->{minor} == 1;
1129 }
1130
1131 sub isDarwin()
1132 {
1133     return ($^O eq "darwin") || 0;
1134 }
1135
1136 sub isWindows()
1137 {
1138     return ($^O eq "MSWin32") || 0;
1139 }
1140
1141 sub isLinux()
1142 {
1143     return ($^O eq "linux") || 0;
1144 }
1145
1146 sub isBSD()
1147 {
1148     return ($^O eq "freebsd") || ($^O eq "openbsd") || ($^O eq "netbsd") || 0;
1149 }
1150
1151 sub isARM()
1152 {
1153     return ($Config{archname} =~ /^arm[v\-]/) || ($Config{archname} =~ /^aarch64[v\-]/);
1154 }
1155
1156 sub isCrossCompilation()
1157 {
1158   my $compiler = "";
1159   $compiler = $ENV{'CC'} if (defined($ENV{'CC'}));
1160   if ($compiler =~ /gcc/) {
1161       my $compiler_options = `$compiler -v 2>&1`;
1162       my @host = $compiler_options =~ m/--host=(.*?)\s/;
1163       my @target = $compiler_options =~ m/--target=(.*?)\s/;
1164
1165       return ($host[0] ne "" && $target[0] ne "" && $host[0] ne $target[0]);
1166   }
1167   return 0;
1168 }
1169
1170 sub isAppleWebKit()
1171 {
1172     return isAppleMacWebKit() || isAppleWinWebKit();
1173 }
1174
1175 sub isAppleMacWebKit()
1176 {
1177     return isDarwin() && !isGtk();
1178 }
1179
1180 sub isAppleWinWebKit()
1181 {
1182     return (isCygwin() || isWindows()) && !isWinCairo() && !isGtk();
1183 }
1184
1185 sub iOSSimulatorDevicesPath
1186 {
1187     return "$ENV{HOME}/Library/Developer/CoreSimulator/Devices";
1188 }
1189
1190 sub iOSSimulatorDevices
1191 {
1192     eval "require Foundation";
1193     my $devicesPath = iOSSimulatorDevicesPath();
1194     opendir(DEVICES, $devicesPath);
1195     my @udids = grep {
1196         $_ =~ m/[0-9A-F]{8}-([0-9A-F]{4}-){3}[0-9A-F]{12}/;
1197     } readdir(DEVICES);
1198     close(DEVICES);
1199
1200     # FIXME: We should parse the device.plist file ourself and map the dictionary keys in it to known
1201     #        dictionary keys so as to decouple our representation of the plist from the actual structure
1202     #        of the plist, which may change.
1203     my @devices = map {
1204         Foundation::perlRefFromObjectRef(NSDictionary->dictionaryWithContentsOfFile_("$devicesPath/$_/device.plist"));
1205     } @udids;
1206
1207     return @devices;
1208 }
1209
1210 sub createiOSSimulatorDevice
1211 {
1212     my $name = shift;
1213     my $deviceTypeId = shift;
1214     my $runtimeId = shift;
1215
1216     my $created = system("xcrun", "--sdk", "iphonesimulator", "simctl", "create", $name, $deviceTypeId, $runtimeId) == 0;
1217     die "Couldn't create simulator device: $name $deviceTypeId $runtimeId" if not $created;
1218
1219     system("xcrun", "--sdk", "iphonesimulator", "simctl", "list");
1220
1221     print "Waiting for device to be created ...\n";
1222     sleep 5;
1223     for (my $tries = 0; $tries < 5; $tries++){
1224         my @devices = iOSSimulatorDevices();
1225         foreach my $device (@devices) {
1226             return $device if $device->{name} eq $name and $device->{deviceType} eq $deviceTypeId and $device->{runtime} eq $runtimeId;
1227         }
1228         sleep 5;
1229     }
1230     die "Device $name $deviceTypeId $runtimeId wasn't found in " . iOSSimulatorDevicesPath();
1231 }
1232
1233 sub willUseIOSDeviceSDKWhenBuilding()
1234 {
1235     return xcodeSDKPlatformName() eq "iphoneos";
1236 }
1237
1238 sub willUseIOSSimulatorSDKWhenBuilding()
1239 {
1240     return xcodeSDKPlatformName() eq "iphonesimulator";
1241 }
1242
1243 sub isIOSWebKit()
1244 {
1245     determineXcodeSDK();
1246     return isAppleMacWebKit() && (willUseIOSDeviceSDKWhenBuilding() || willUseIOSSimulatorSDKWhenBuilding());
1247 }
1248
1249 sub determineNmPath()
1250 {
1251     return if $nmPath;
1252
1253     if (isAppleMacWebKit()) {
1254         $nmPath = `xcrun -find nm`;
1255         chomp $nmPath;
1256     }
1257     $nmPath = "nm" if !$nmPath;
1258 }
1259
1260 sub nmPath()
1261 {
1262     determineNmPath();
1263     return $nmPath;
1264 }
1265
1266 sub splitVersionString
1267 {
1268     my $versionString = shift;
1269     my @splitVersion = split(/\./, $versionString);
1270     @splitVersion >= 2 or die "Invalid version $versionString";
1271     $osXVersion = {
1272             "major" => $splitVersion[0],
1273             "minor" => $splitVersion[1],
1274             "subminor" => (defined($splitVersion[2]) ? $splitVersion[2] : 0),
1275     };
1276 }
1277
1278 sub determineOSXVersion()
1279 {
1280     return if $osXVersion;
1281
1282     if (!isDarwin()) {
1283         $osXVersion = -1;
1284         return;
1285     }
1286
1287     my $versionString = `sw_vers -productVersion`;
1288     $osXVersion = splitVersionString($versionString);
1289 }
1290
1291 sub osXVersion()
1292 {
1293     determineOSXVersion();
1294     return $osXVersion;
1295 }
1296
1297 sub determineIOSVersion()
1298 {
1299     return if $iosVersion;
1300
1301     if (!isIOSWebKit()) {
1302         $iosVersion = -1;
1303         return;
1304     }
1305
1306     my $versionString = xcodeSDKVersion();
1307     $iosVersion = splitVersionString($versionString);
1308 }
1309
1310 sub iosVersion()
1311 {
1312     determineIOSVersion();
1313     return $iosVersion;
1314 }
1315
1316 sub isWindowsNT()
1317 {
1318     return $ENV{'OS'} eq 'Windows_NT';
1319 }
1320
1321 sub shouldTargetWebProcess
1322 {
1323     determineShouldTargetWebProcess();
1324     return $shouldTargetWebProcess;
1325 }
1326
1327 sub determineShouldTargetWebProcess
1328 {
1329     return if defined($shouldTargetWebProcess);
1330     $shouldTargetWebProcess = checkForArgumentAndRemoveFromARGV("--target-web-process");
1331 }
1332
1333 sub shouldUseXPCServiceForWebProcess
1334 {
1335     determineShouldUseXPCServiceForWebProcess();
1336     return $shouldUseXPCServiceForWebProcess;
1337 }
1338
1339 sub determineShouldUseXPCServiceForWebProcess
1340 {
1341     return if defined($shouldUseXPCServiceForWebProcess);
1342     $shouldUseXPCServiceForWebProcess = checkForArgumentAndRemoveFromARGV("--use-web-process-xpc-service");
1343 }
1344
1345 sub debugger
1346 {
1347     determineDebugger();
1348     return $debugger;
1349 }
1350
1351 sub determineDebugger
1352 {
1353     return if defined($debugger);
1354
1355     determineXcodeVersion();
1356     if (eval "v$xcodeVersion" ge v4.5) {
1357         $debugger = "lldb";
1358     } else {
1359         $debugger = "gdb";
1360     }
1361
1362     if (checkForArgumentAndRemoveFromARGV("--use-lldb")) {
1363         $debugger = "lldb";
1364     }
1365
1366     if (checkForArgumentAndRemoveFromARGV("--use-gdb")) {
1367         $debugger = "gdb";
1368     }
1369 }
1370
1371 sub appendToEnvironmentVariableList
1372 {
1373     my ($environmentVariableName, $value) = @_;
1374
1375     if (defined($ENV{$environmentVariableName})) {
1376         $ENV{$environmentVariableName} .= ":" . $value;
1377     } else {
1378         $ENV{$environmentVariableName} = $value;
1379     }
1380 }
1381
1382 sub sharedCommandLineOptions()
1383 {
1384     return (
1385         "g|guard-malloc" => \$shouldUseGuardMalloc,
1386     );
1387 }
1388
1389 sub sharedCommandLineOptionsUsage
1390 {
1391     my %opts = @_;
1392
1393     my %switches = (
1394         '-g|--guard-malloc' => 'Use guardmalloc when running executable',
1395     );
1396
1397     my $indent = " " x ($opts{indent} || 2);
1398     my $switchWidth = List::Util::max(int($opts{switchWidth}), List::Util::max(map { length($_) } keys %switches) + ($opts{brackets} ? 2 : 0));
1399
1400     my $result = "Common switches:\n";
1401
1402     for my $switch (keys %switches) {
1403         my $switchName = $opts{brackets} ? "[" . $switch . "]" : $switch;
1404         $result .= sprintf("%s%-" . $switchWidth . "s %s\n", $indent, $switchName, $switches{$switch});
1405     }
1406
1407     return $result;
1408 }
1409
1410 sub setUpGuardMallocIfNeeded
1411 {
1412     if (!isDarwin()) {
1413         return;
1414     }
1415
1416     if (!defined($shouldUseGuardMalloc)) {
1417         $shouldUseGuardMalloc = checkForArgumentAndRemoveFromARGV("-g") || checkForArgumentAndRemoveFromARGV("--guard-malloc");
1418     }
1419
1420     if ($shouldUseGuardMalloc) {
1421         appendToEnvironmentVariableList("DYLD_INSERT_LIBRARIES", "/usr/lib/libgmalloc.dylib");
1422     }
1423 }
1424
1425 sub relativeScriptsDir()
1426 {
1427     my $scriptDir = File::Spec->catpath("", File::Spec->abs2rel($FindBin::Bin, getcwd()), "");
1428     if ($scriptDir eq "") {
1429         $scriptDir = ".";
1430     }
1431     return $scriptDir;
1432 }
1433
1434 sub launcherPath()
1435 {
1436     my $relativeScriptsPath = relativeScriptsDir();
1437     if (isGtk() || isEfl()) {
1438         return "$relativeScriptsPath/run-minibrowser";
1439     } elsif (isAppleWebKit()) {
1440         return "$relativeScriptsPath/run-safari";
1441     }
1442 }
1443
1444 sub launcherName()
1445 {
1446     if (isGtk() || isEfl()) {
1447         return "MiniBrowser";
1448     } elsif (isAppleMacWebKit()) {
1449         return "Safari";
1450     } elsif (isAppleWinWebKit()) {
1451         return "MiniBrowser";
1452     }
1453 }
1454
1455 sub checkRequiredSystemConfig
1456 {
1457     if (isDarwin()) {
1458         chomp(my $productVersion = `sw_vers -productVersion`);
1459         if (eval "v$productVersion" lt v10.7.5) {
1460             print "*************************************************************\n";
1461             print "Mac OS X Version 10.7.5 or later is required to build WebKit.\n";
1462             print "You have " . $productVersion . ", thus the build will most likely fail.\n";
1463             print "*************************************************************\n";
1464         }
1465         my $xcodebuildVersionOutput = `xcodebuild -version`;
1466         my $xcodeVersion = ($xcodebuildVersionOutput =~ /Xcode ([0-9](\.[0-9]+)*)/) ? $1 : undef;
1467         if (!$xcodeVersion || $xcodeVersion && eval "v$xcodeVersion" lt v4.6) {
1468             print "*************************************************************\n";
1469             print "Xcode Version 4.6 or later is required to build WebKit.\n";
1470             print "You have an earlier version of Xcode, thus the build will\n";
1471             print "most likely fail. The latest Xcode is available from the App Store.\n";
1472             print "*************************************************************\n";
1473         }
1474     } elsif (isGtk() or isEfl() or isWindows() or isCygwin()) {
1475         my @cmds = qw(bison gperf flex);
1476         my @missing = ();
1477         my $oldPath = $ENV{PATH};
1478         foreach my $cmd (@cmds) {
1479             push @missing, $cmd if not commandExists($cmd);
1480         }
1481
1482         if (@missing) {
1483             my $list = join ", ", @missing;
1484             die "ERROR: $list missing but required to build WebKit.\n";
1485         }
1486     }
1487     # Win32 and other platforms may want to check for minimum config
1488 }
1489
1490 sub determineWindowsSourceDir()
1491 {
1492     return if $windowsSourceDir;
1493     $windowsSourceDir = sourceDir();
1494     chomp($windowsSourceDir = `cygpath -w '$windowsSourceDir'`) if isCygwin();
1495 }
1496
1497 sub windowsSourceDir()
1498 {
1499     determineWindowsSourceDir();
1500     return $windowsSourceDir;
1501 }
1502
1503 sub windowsSourceSourceDir()
1504 {
1505     return File::Spec->catdir(windowsSourceDir(), "Source");
1506 }
1507
1508 sub windowsLibrariesDir()
1509 {
1510     return File::Spec->catdir(windowsSourceDir(), "WebKitLibraries", "win");
1511 }
1512
1513 sub windowsOutputDir()
1514 {
1515     return File::Spec->catdir(windowsSourceDir(), "WebKitBuild");
1516 }
1517
1518 sub fontExists($)
1519 {
1520     my $font = shift;
1521     my $cmd = "reg query \"HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Fonts\\" . $font ."\" 2>&1";
1522     my $val = `$cmd`;
1523     return $? == 0;
1524 }
1525
1526 sub checkInstalledTools()
1527 {
1528     # environment variables. Avoid until this is corrected.
1529     my $pythonVer = `python --version 2>&1`;
1530     die "You must have Python installed to build WebKit.\n" if ($?);
1531
1532     # cURL 7.34.0 has a bug that prevents authentication with opensource.apple.com (and other things using SSL3).
1533     my $curlVer = `curl --version 2> NUL`;
1534     if (!$? and $curlVer =~ "(.*curl.*)") {
1535         $curlVer = $1;
1536         if ($curlVer =~ /libcurl\/7\.34\.0/) {
1537             print "cURL version 7.34.0 has a bug that prevents authentication with SSL v2 or v3.\n";
1538             print "cURL 7.33.0 is known to work. The cURL projects is preparing an update to\n";
1539             print "correct this problem.\n\n";
1540             die "Please install a working cURL and try again.\n";
1541         }
1542     }
1543
1544     # MathML requires fonts that do not ship with Windows (at least through Windows 8). Warn the user if they are missing
1545     my @fonts = qw(STIXGeneral-Regular MathJax_Main-Regular);
1546     my @missing = ();
1547     foreach my $font (@fonts) {
1548         push @missing, $font if not fontExists($font);
1549     }
1550
1551     if (scalar @missing > 0) {
1552         print "*************************************************************\n";
1553         print "Mathematical fonts, such as STIX and MathJax, are needed to\n";
1554         print "use the MathML feature.  You do not appear to have these fonts\n";
1555         print "on your system.\n\n";
1556         print "You can download a suitable set of fonts from the following URL:\n";
1557         print "https://developer.mozilla.org/Mozilla/MathML_Projects/Fonts\n";
1558         print "*************************************************************\n";
1559     }
1560
1561     print "Installed tools are correct for the WebKit build.\n";
1562 }
1563
1564 sub setupAppleWinEnv()
1565 {
1566     return unless isAppleWinWebKit();
1567
1568     checkInstalledTools();
1569
1570     if (isWindowsNT()) {
1571         my $restartNeeded = 0;
1572         my %variablesToSet = ();
1573
1574         # FIXME: We should remove this explicit version check for cygwin once we stop supporting Cygwin 1.7.9 or older versions. 
1575         # https://bugs.webkit.org/show_bug.cgi?id=85791
1576         my $uname_version = (POSIX::uname())[2];
1577         $uname_version =~ s/\(.*\)//;  # Remove the trailing cygwin version, if any.
1578         $uname_version =~ s/\-.*$//; # Remove trailing dash-version content, if any
1579         if (version->parse($uname_version) < version->parse("1.7.10")) {
1580             # Setting the environment variable 'CYGWIN' to 'tty' makes cygwin enable extra support (i.e., termios)
1581             # for UNIX-like ttys in the Windows console
1582             $variablesToSet{CYGWIN} = "tty" unless $ENV{CYGWIN};
1583         }
1584         
1585         # Those environment variables must be set to be able to build inside Visual Studio.
1586         $variablesToSet{WEBKIT_LIBRARIES} = windowsLibrariesDir() unless $ENV{WEBKIT_LIBRARIES};
1587         $variablesToSet{WEBKIT_OUTPUTDIR} = windowsOutputDir() unless $ENV{WEBKIT_OUTPUTDIR};
1588         $variablesToSet{MSBUILDDISABLENODEREUSE} = "1" unless $ENV{MSBUILDDISABLENODEREUSE};
1589         $variablesToSet{_IsNativeEnvironment} = "true" unless $ENV{_IsNativeEnvironment};
1590         $variablesToSet{PreferredToolArchitecture} = "x64" unless $ENV{PreferredToolArchitecture};
1591
1592         foreach my $variable (keys %variablesToSet) {
1593             print "Setting the Environment Variable '" . $variable . "' to '" . $variablesToSet{$variable} . "'\n\n";
1594             my $ret = system "setx", $variable, $variablesToSet{$variable};
1595             if ($ret != 0) {
1596                 system qw(regtool -s set), '\\HKEY_CURRENT_USER\\Environment\\' . $variable, $variablesToSet{$variable};
1597             }
1598             $restartNeeded ||=  $variable eq "WEBKIT_LIBRARIES" || $variable eq "WEBKIT_OUTPUTDIR";
1599         }
1600
1601         if ($restartNeeded) {
1602             print "Please restart your computer before attempting to build inside Visual Studio.\n\n";
1603         }
1604     } else {
1605         if (!defined $ENV{'WEBKIT_LIBRARIES'} || !$ENV{'WEBKIT_LIBRARIES'}) {
1606             print "Warning: You must set the 'WebKit_Libraries' environment variable\n";
1607             print "         to be able build WebKit from within Visual Studio 2013 and newer.\n";
1608             print "         Make sure that 'WebKit_Libraries' points to the\n";
1609             print "         'WebKitLibraries/win' directory, not the 'WebKitLibraries/' directory.\n\n";
1610         }
1611         if (!defined $ENV{'WEBKIT_OUTPUTDIR'} || !$ENV{'WEBKIT_OUTPUTDIR'}) {
1612             print "Warning: You must set the 'WebKit_OutputDir' environment variable\n";
1613             print "         to be able build WebKit from within Visual Studio 2013 and newer.\n\n";
1614         }
1615         if (!defined $ENV{'MSBUILDDISABLENODEREUSE'} || !$ENV{'MSBUILDDISABLENODEREUSE'}) {
1616             print "Warning: You should set the 'MSBUILDDISABLENODEREUSE' environment variable to '1'\n";
1617             print "         to avoid periodic locked log files when building.\n\n";
1618         }
1619     }
1620     # FIXME (125180): Remove the following temporary 64-bit support once official support is available.
1621     if (isWin64() and !$ENV{'WEBKIT_64_SUPPORT'}) {
1622         print "Warning: You must set the 'WEBKIT_64_SUPPORT' environment variable\n";
1623         print "         to be able run WebKit or JavaScriptCore tests.\n\n";
1624     }
1625 }
1626
1627 sub setupCygwinEnv()
1628 {
1629     return if !isCygwin() && !isWindows();
1630     return if $vcBuildPath;
1631
1632     my $programFilesPath = programFilesPath();
1633     my $visualStudioPath = File::Spec->catfile(visualStudioInstallDir(), qw(Common7 IDE devenv.com));
1634     if (-e $visualStudioPath) {
1635         # Visual Studio is installed;
1636         if (visualStudioVersion() eq "12") {
1637             $visualStudioPath = File::Spec->catfile(visualStudioInstallDir(), qw(Common7 IDE devenv.exe));
1638         }
1639     } else {
1640         # Visual Studio not found, try VC++ Express
1641         $visualStudioPath = File::Spec->catfile(visualStudioInstallDir(), qw(Common7 IDE WDExpress.exe));
1642         if (! -e $visualStudioPath) {
1643             print "*************************************************************\n";
1644             print "Cannot find '$visualStudioPath'\n";
1645             print "Please execute the file 'vcvars32.bat' from\n";
1646             print "'$programFilesPath\\Microsoft Visual Studio 14.0\\VC\\bin\\'\n";
1647             print "to setup the necessary environment variables.\n";
1648             print "*************************************************************\n";
1649             die;
1650         }
1651         $willUseVCExpressWhenBuilding = 1;
1652     }
1653
1654     print "Building results into: ", baseProductDir(), "\n";
1655     print "WEBKIT_OUTPUTDIR is set to: ", $ENV{"WEBKIT_OUTPUTDIR"}, "\n";
1656     print "WEBKIT_LIBRARIES is set to: ", $ENV{"WEBKIT_LIBRARIES"}, "\n";
1657     # FIXME (125180): Remove the following temporary 64-bit support once official support is available.
1658     print "WEBKIT_64_SUPPORT is set to: ", $ENV{"WEBKIT_64_SUPPORT"}, "\n" if isWin64();
1659
1660     # We will actually use MSBuild to build WebKit, but we need to find the Visual Studio install (above) to make
1661     # sure we use the right options.
1662     $vcBuildPath = File::Spec->catfile(msBuildInstallDir(), qw(MSBuild.exe));
1663     if (! -e $vcBuildPath) {
1664         print "*************************************************************\n";
1665         print "Cannot find '$vcBuildPath'\n";
1666         print "Please make sure execute that the Microsoft .NET Framework SDK\n";
1667         print "is installed on this machine.\n";
1668         print "*************************************************************\n";
1669         die;
1670     }
1671 }
1672
1673 sub dieIfWindowsPlatformSDKNotInstalled
1674 {
1675     my $registry32Path = "/proc/registry/";
1676     my $registry64Path = "/proc/registry64/";
1677     my @windowsPlatformSDKRegistryEntries = (
1678         "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Microsoft SDKs/Windows/v8.0A",
1679         "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Microsoft SDKs/Windows/v8.0",
1680         "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Microsoft SDKs/Windows/v7.1A",
1681         "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Microsoft SDKs/Windows/v7.0A",
1682         "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/MicrosoftSDK/InstalledSDKs/D2FF9F89-8AA2-4373-8A31-C838BF4DBBE1",
1683     );
1684
1685     # FIXME: It would be better to detect whether we are using 32- or 64-bit Windows
1686     # and only check the appropriate entry. But for now we just blindly check both.
1687     my $recommendedPlatformSDK = $windowsPlatformSDKRegistryEntries[0];
1688
1689     while (@windowsPlatformSDKRegistryEntries) {
1690         my $windowsPlatformSDKRegistryEntry = shift @windowsPlatformSDKRegistryEntries;
1691         return if (-e $registry32Path . $windowsPlatformSDKRegistryEntry) || (-e $registry64Path . $windowsPlatformSDKRegistryEntry);
1692     }
1693
1694     print "*************************************************************\n";
1695     print "Cannot find registry entry '$recommendedPlatformSDK'.\n";
1696     print "Please download and install the Microsoft Windows SDK\n";
1697     print "from <http://www.microsoft.com/en-us/download/details.aspx?id=8279>.\n\n";
1698     print "Then follow step 2 in the Windows section of the \"Installing Developer\n";
1699     print "Tools\" instructions at <http://www.webkit.org/building/tools.html>.\n";
1700     print "*************************************************************\n";
1701     die;
1702 }
1703
1704 sub buildXCodeProject($$@)
1705 {
1706     my ($project, $clean, @extraOptions) = @_;
1707
1708     if ($clean) {
1709         push(@extraOptions, "-alltargets");
1710         push(@extraOptions, "clean");
1711     }
1712
1713     push(@extraOptions, ("-sdk", xcodeSDK())) if isIOSWebKit();
1714
1715     chomp($ENV{DSYMUTIL_NUM_THREADS} = `sysctl -n hw.activecpu`);
1716     return system "xcodebuild", "-project", "$project.xcodeproj", @extraOptions;
1717 }
1718
1719 sub usingVisualStudioExpress()
1720 {
1721     setupCygwinEnv();
1722     return $willUseVCExpressWhenBuilding;
1723 }
1724
1725 sub buildVisualStudioProject
1726 {
1727     my ($project, $clean) = @_;
1728     setupCygwinEnv();
1729
1730     my $config = configurationForVisualStudio();
1731
1732     dieIfWindowsPlatformSDKNotInstalled() if $willUseVCExpressWhenBuilding;
1733
1734     chomp($project = `cygpath -w "$project"`) if isCygwin();
1735
1736     my $action = "/t:build";
1737     if ($clean) {
1738         $action = "/t:clean";
1739     }
1740
1741     my $platform = "/p:Platform=" . (isWin64() ? "x64" : "Win32");
1742     my $logPath = File::Spec->catdir($baseProductDir, $configuration);
1743     make_path($logPath) unless -d $logPath or $logPath eq ".";
1744
1745     my $errorLogFile = File::Spec->catfile($logPath, "webkit_errors.log");
1746     chomp($errorLogFile = `cygpath -w "$errorLogFile"`) if isCygwin();
1747     my $errorLogging = "/flp:LogFile=" . $errorLogFile . ";ErrorsOnly";
1748
1749     my $warningLogFile = File::Spec->catfile($logPath, "webkit_warnings.log");
1750     chomp($warningLogFile = `cygpath -w "$warningLogFile"`) if isCygwin();
1751     my $warningLogging = "/flp1:LogFile=" . $warningLogFile . ";WarningsOnly";
1752
1753     my @command = ($vcBuildPath, "/verbosity:minimal", $project, $action, $config, $platform, "/fl", $errorLogging, "/fl1", $warningLogging);
1754     print join(" ", @command), "\n";
1755     return system @command;
1756 }
1757
1758 sub getJhbuildPath()
1759 {
1760     my @jhbuildPath = File::Spec->splitdir(baseProductDir());
1761     if (isGit() && isGitBranchBuild() && gitBranch()) {
1762         pop(@jhbuildPath);
1763     }
1764     if (isEfl()) {
1765         push(@jhbuildPath, "DependenciesEFL");
1766     } elsif (isGtk()) {
1767         push(@jhbuildPath, "DependenciesGTK");
1768     } else {
1769         die "Cannot get JHBuild path for platform that isn't GTK+ or EFL.\n";
1770     }
1771     return File::Spec->catdir(@jhbuildPath);
1772 }
1773
1774 sub isCachedArgumentfileOutOfDate($@)
1775 {
1776     my ($filename, $currentContents) = @_;
1777
1778     if (! -e $filename) {
1779         return 1;
1780     }
1781
1782     open(CONTENTS_FILE, $filename);
1783     chomp(my $previousContents = <CONTENTS_FILE>);
1784     close(CONTENTS_FILE);
1785
1786     if ($previousContents ne $currentContents) {
1787         print "Contents for file $filename have changed.\n";
1788         print "Previous contents were: $previousContents\n\n";
1789         print "New contents are: $currentContents\n";
1790         return 1;
1791     }
1792
1793     return 0;
1794 }
1795
1796 sub wrapperPrefixIfNeeded()
1797 {
1798     if (isWindows() || isCygwin()) {
1799         return ();
1800     }
1801     if (isAppleMacWebKit()) {
1802         return ("xcrun");
1803     }
1804     if (-e getJhbuildPath()) {
1805         my @prefix = (File::Spec->catfile(sourceDir(), "Tools", "jhbuild", "jhbuild-wrapper"));
1806         if (isEfl()) {
1807             push(@prefix, "--efl");
1808         } elsif (isGtk()) {
1809             push(@prefix, "--gtk");
1810         }
1811         push(@prefix, "run");
1812
1813         return @prefix;
1814     }
1815
1816     return ();
1817 }
1818
1819 sub cmakeCachePath()
1820 {
1821     return File::Spec->catdir(baseProductDir(), configuration(), "CMakeCache.txt");
1822 }
1823
1824 sub shouldRemoveCMakeCache(@)
1825 {
1826     my ($cacheFilePath, @buildArgs) = @_;
1827
1828     # We check this first, because we always want to create this file for a fresh build.
1829     my $productDir = File::Spec->catdir(baseProductDir(), configuration());
1830     my $optionsCache = File::Spec->catdir($productDir, "build-webkit-options.txt");
1831     my $joinedBuildArgs = join(" ", @buildArgs);
1832     if (isCachedArgumentfileOutOfDate($optionsCache, $joinedBuildArgs)) {
1833         File::Path::mkpath($productDir) unless -d $productDir;
1834         open(CACHED_ARGUMENTS, ">", $optionsCache);
1835         print CACHED_ARGUMENTS $joinedBuildArgs;
1836         close(CACHED_ARGUMENTS);
1837
1838         return 1;
1839     }
1840
1841     my $cmakeCache = cmakeCachePath();
1842     unless (-e $cmakeCache) {
1843         return 0;
1844     }
1845
1846     my $cacheFileModifiedTime = stat($cmakeCache)->mtime;
1847     my $platformConfiguration = File::Spec->catdir(sourceDir(), "Source", "cmake", "Options" . cmakeBasedPortName() . ".cmake");
1848     if ($cacheFileModifiedTime < stat($platformConfiguration)->mtime) {
1849         return 1;
1850     }
1851
1852     my $globalConfiguration = File::Spec->catdir(sourceDir(), "Source", "cmake", "OptionsCommon.cmake");
1853     if ($cacheFileModifiedTime < stat($globalConfiguration)->mtime) {
1854         return 1;
1855     }
1856
1857     my $inspectorUserInterfaceDircetory = File::Spec->catdir(sourceDir(), "Source", "WebInspectorUI", "UserInterface");
1858     if ($cacheFileModifiedTime < stat($inspectorUserInterfaceDircetory)->mtime) {
1859         return 1;
1860     }
1861
1862     return 0;
1863 }
1864
1865 sub removeCMakeCache(@)
1866 {
1867     my (@buildArgs) = @_;
1868     if (shouldRemoveCMakeCache(@buildArgs)) {
1869         my $cmakeCache = cmakeCachePath();
1870         unlink($cmakeCache) if -e $cmakeCache;
1871     }
1872 }
1873
1874 sub canUseNinja(@)
1875 {
1876     if (!defined($shouldNotUseNinja)) {
1877         $shouldNotUseNinja = checkForArgumentAndRemoveFromARGV("--no-ninja");
1878     }
1879
1880     if ($shouldNotUseNinja) {
1881         return 0;
1882     }
1883
1884     # Test both ninja and ninja-build. Fedora uses ninja-build and has patched CMake to also call ninja-build.
1885     return commandExists("ninja") || commandExists("ninja-build");
1886 }
1887
1888 sub canUseEclipse(@)
1889 {
1890     return commandExists("eclipse");
1891 }
1892
1893 sub cmakeGeneratedBuildfile(@)
1894 {
1895     my ($willUseNinja) = @_;
1896     if ($willUseNinja) {
1897         return File::Spec->catfile(baseProductDir(), configuration(), "build.ninja")
1898     } elsif (isWindows() || isCygwin()) {
1899         return File::Spec->catfile(baseProductDir(), configuration(), "WebKit.sln")
1900     } else {
1901         return File::Spec->catfile(baseProductDir(), configuration(), "Makefile")
1902     }
1903 }
1904
1905 sub generateBuildSystemFromCMakeProject
1906 {
1907     my ($port, $prefixPath, @cmakeArgs, $additionalCMakeArgs) = @_;
1908     my $config = configuration();
1909     my $buildPath = File::Spec->catdir(baseProductDir(), $config);
1910     File::Path::mkpath($buildPath) unless -d $buildPath;
1911     my $originalWorkingDirectory = getcwd();
1912     chdir($buildPath) or die;
1913
1914     # We try to be smart about when to rerun cmake, so that we can have faster incremental builds.
1915     my $willUseNinja = canUseNinja();
1916     if (-e cmakeCachePath() && -e cmakeGeneratedBuildfile($willUseNinja)) {
1917         return 0;
1918     }
1919
1920     my @args;
1921     push @args, "-DPORT=\"$port\"";
1922     push @args, "-DCMAKE_INSTALL_PREFIX=\"$prefixPath\"" if $prefixPath;
1923     push @args, "-DCMAKE_EXPORT_COMPILE_COMMANDS=ON" if isGtk();
1924     if ($config =~ /release/i) {
1925         push @args, "-DCMAKE_BUILD_TYPE=Release";
1926     } elsif ($config =~ /debug/i) {
1927         push @args, "-DCMAKE_BUILD_TYPE=Debug";
1928     }
1929
1930     if ($willUseNinja) {
1931         push @args, "-G";
1932         if (canUseEclipse()) {
1933             push @args, "'Eclipse CDT4 - Ninja'";
1934         } else {
1935             push @args, "Ninja";
1936         }
1937     } elsif (isAnyWindows() && isWin64()) {
1938         push @args, '-G "Visual Studio 14 2015 Win64"';
1939     }
1940
1941     # GTK+ has a production mode, but build-webkit should always use developer mode.
1942     push @args, "-DDEVELOPER_MODE=ON" if isEfl() || isGtk();
1943
1944     # Don't warn variables which aren't used by cmake ports.
1945     push @args, "--no-warn-unused-cli";
1946     push @args, @cmakeArgs if @cmakeArgs;
1947     push @args, $additionalCMakeArgs if $additionalCMakeArgs;
1948
1949     my $cmakeSourceDir = isCygwin() ? windowsSourceDir() : sourceDir();
1950     push @args, '"' . $cmakeSourceDir . '"';
1951
1952     # Compiler options to keep floating point values consistent
1953     # between 32-bit and 64-bit architectures.
1954     determineArchitecture();
1955     if ($architecture ne "x86_64" && !isARM() && !isCrossCompilation() && !isWindows() && !isCygwin()) {
1956         $ENV{'CXXFLAGS'} = "-march=pentium4 -msse2 -mfpmath=sse " . ($ENV{'CXXFLAGS'} || "");
1957     }
1958
1959     # We call system("cmake @args") instead of system("cmake", @args) so that @args is
1960     # parsed for shell metacharacters.
1961     my $wrapper = join(" ", wrapperPrefixIfNeeded()) . " ";
1962     my $returnCode = system($wrapper . "cmake @args");
1963
1964     chdir($originalWorkingDirectory);
1965     return $returnCode;
1966 }
1967
1968 sub buildCMakeGeneratedProject($)
1969 {
1970     my ($makeArgs) = @_;
1971     my $config = configuration();
1972     my $buildPath = File::Spec->catdir(baseProductDir(), $config);
1973     if (! -d $buildPath) {
1974         die "Must call generateBuildSystemFromCMakeProject() before building CMake project.";
1975     }
1976
1977     my $command = "cmake";
1978     my @args = ("--build", $buildPath, "--config", $config);
1979     push @args, ("--", $makeArgs) if $makeArgs;
1980
1981     # GTK can use a build script to preserve colors and pretty-printing.
1982     if (isGtk() && -e "$buildPath/build.sh") {
1983         chdir "$buildPath" or die;
1984         $command = "$buildPath/build.sh";
1985         @args = ($makeArgs);
1986     }
1987
1988     if ($ENV{VERBOSE} && canUseNinja()) {
1989         push @args, "-v";
1990         push @args, "-d keeprsp" if (version->parse(determineNinjaVersion()) >= version->parse("1.4.0"));
1991     }
1992
1993     # We call system("cmake @args") instead of system("cmake", @args) so that @args is
1994     # parsed for shell metacharacters. In particular, $makeArgs may contain such metacharacters.
1995     my $wrapper = join(" ", wrapperPrefixIfNeeded()) . " ";
1996     return system($wrapper . "$command @args");
1997 }
1998
1999 sub cleanCMakeGeneratedProject()
2000 {
2001     my $config = configuration();
2002     my $buildPath = File::Spec->catdir(baseProductDir(), $config);
2003     if (-d $buildPath) {
2004         return system("cmake", "--build", $buildPath, "--config", $config, "--target", "clean");
2005     }
2006     return 0;
2007 }
2008
2009 sub buildCMakeProjectOrExit($$$$@)
2010 {
2011     my ($clean, $port, $prefixPath, $makeArgs, @cmakeArgs) = @_;
2012     my $returnCode;
2013
2014     exit(exitStatus(cleanCMakeGeneratedProject())) if $clean;
2015
2016     if (isEfl() && checkForArgumentAndRemoveFromARGV("--update-efl")) {
2017         system("perl", "$sourceDir/Tools/Scripts/update-webkitefl-libs") == 0 or die $!;
2018     }
2019
2020     if (isGtk() && checkForArgumentAndRemoveFromARGV("--update-gtk")) {
2021         system("perl", "$sourceDir/Tools/Scripts/update-webkitgtk-libs") == 0 or die $!;
2022     }
2023
2024     $returnCode = exitStatus(generateBuildSystemFromCMakeProject($port, $prefixPath, @cmakeArgs));
2025     exit($returnCode) if $returnCode;
2026
2027     $returnCode = exitStatus(buildCMakeGeneratedProject($makeArgs));
2028     exit($returnCode) if $returnCode;
2029     return 0;
2030 }
2031
2032 sub cmakeBasedPortArguments()
2033 {
2034     return ();
2035 }
2036
2037 sub cmakeBasedPortName()
2038 {
2039     return "Efl" if isEfl();
2040     return "GTK" if isGtk();
2041     return "Mac" if isAppleMacWebKit();
2042     return "WinCairo" if isWinCairo();
2043     return "AppleWin" if isAppleWinWebKit();
2044     return "";
2045 }
2046
2047 sub determineIsCMakeBuild()
2048 {
2049     return if defined($isCMakeBuild);
2050     $isCMakeBuild = checkForArgumentAndRemoveFromARGV("--cmake");
2051 }
2052
2053 sub isCMakeBuild()
2054 {
2055     if (isEfl() || isGtk() || isAnyWindows()) {
2056         return 1;
2057     }
2058     determineIsCMakeBuild();
2059     return $isCMakeBuild;
2060 }
2061
2062 sub promptUser
2063 {
2064     my ($prompt, $default) = @_;
2065     my $defaultValue = $default ? "[$default]" : "";
2066     print "$prompt $defaultValue: ";
2067     chomp(my $input = <STDIN>);
2068     return $input ? $input : $default;
2069 }
2070
2071 sub appleApplicationSupportPath
2072 {
2073     open INSTALL_DIR, "</proc/registry/HKEY_LOCAL_MACHINE/SOFTWARE/Apple\ Inc./Apple\ Application\ Support/InstallDir";
2074     my $path = <INSTALL_DIR>;
2075     $path =~ s/[\r\n\x00].*//;
2076     close INSTALL_DIR;
2077
2078     my $unixPath = `cygpath -u '$path'`;
2079     chomp $unixPath;
2080     return $unixPath;
2081 }
2082
2083 sub setPathForRunningWebKitApp
2084 {
2085     my ($env) = @_;
2086
2087     if (isAnyWindows()) {
2088         my $productBinaryDir = executableProductDir();
2089         if (isAppleWinWebKit()) {
2090             $env->{PATH} = join(':', $productBinaryDir, appleApplicationSupportPath(), $env->{PATH} || "");
2091         } elsif (isWinCairo()) {
2092             my $winCairoBin = sourceDir() . "/WebKitLibraries/win/" . (isWin64() ? "bin64/" : "bin32/");
2093             my $gstreamerBin = isWin64() ? $ENV{"GSTREAMER_1_0_ROOT_X86_64"} . "bin" : $ENV{"GSTREAMER_1_0_ROOT_X86"} . "bin";
2094             $env->{PATH} = join(':', $productBinaryDir, $winCairoBin, $gstreamerBin, $env->{PATH} || "");
2095         }
2096     }
2097 }
2098
2099 sub printHelpAndExitForRunAndDebugWebKitAppIfNeeded
2100 {
2101     return unless checkForArgumentAndRemoveFromARGV("--help");
2102
2103     my ($includeOptionsForDebugging) = @_;
2104
2105     print STDERR <<EOF;
2106 Usage: @{[basename($0)]} [options] [args ...]
2107   --help                            Show this help message
2108   --no-saved-state                  Launch the application without state restoration (OS X 10.7 and later)
2109   -g|--guard-malloc                 Enable Guard Malloc (OS X only)
2110   --use-web-process-xpc-service     Launch the Web Process as an XPC Service (OS X only)
2111 EOF
2112
2113     if ($includeOptionsForDebugging) {
2114         print STDERR <<EOF;
2115   --target-web-process              Debug the web process
2116   --use-gdb                         Use GDB (this is the default when using Xcode 4.4 or earlier)
2117   --use-lldb                        Use LLDB (this is the default when using Xcode 4.5 or later)
2118 EOF
2119     }
2120
2121     exit(1);
2122 }
2123
2124 sub argumentsForRunAndDebugMacWebKitApp()
2125 {
2126     my @args = ();
2127     if (checkForArgumentAndRemoveFromARGV("--no-saved-state")) {
2128         push @args, ("-ApplePersistenceIgnoreStateQuietly", "YES");
2129         # FIXME: Don't set ApplePersistenceIgnoreState once all supported OS versions respect ApplePersistenceIgnoreStateQuietly (rdar://15032886).
2130         push @args, ("-ApplePersistenceIgnoreState", "YES");
2131     }
2132     push @args, ("-WebKit2UseXPCServiceForWebProcess", "YES") if shouldUseXPCServiceForWebProcess();
2133     unshift @args, @ARGV;
2134
2135     return @args;
2136 }
2137
2138 sub setupMacWebKitEnvironment($)
2139 {
2140     my ($dyldFrameworkPath) = @_;
2141
2142     $dyldFrameworkPath = File::Spec->rel2abs($dyldFrameworkPath);
2143
2144     $ENV{DYLD_FRAMEWORK_PATH} = $ENV{DYLD_FRAMEWORK_PATH} ? join(":", $dyldFrameworkPath, $ENV{DYLD_FRAMEWORK_PATH}) : $dyldFrameworkPath;
2145     $ENV{__XPC_DYLD_FRAMEWORK_PATH} = $dyldFrameworkPath;
2146     $ENV{WEBKIT_UNSET_DYLD_FRAMEWORK_PATH} = "YES";
2147
2148     setUpGuardMallocIfNeeded();
2149 }
2150
2151 sub setupIOSWebKitEnvironment($)
2152 {
2153     my ($dyldFrameworkPath) = @_;
2154     $dyldFrameworkPath = File::Spec->rel2abs($dyldFrameworkPath);
2155
2156     $ENV{DYLD_FRAMEWORK_PATH} = $dyldFrameworkPath;
2157     $ENV{DYLD_LIBRARY_PATH} = $dyldFrameworkPath;
2158
2159     setUpGuardMallocIfNeeded();
2160 }
2161
2162 sub iosSimulatorApplicationsPath()
2163 {
2164     return File::Spec->catdir(XcodeSDKPath(), "Applications");
2165 }
2166
2167 sub installedMobileSafariBundle()
2168 {
2169     return File::Spec->catfile(iosSimulatorApplicationsPath(), "MobileSafari.app");
2170 }
2171
2172 sub mobileSafariBundle()
2173 {
2174     determineConfigurationProductDir();
2175
2176     # Use MobileSafari.app in product directory if present.
2177     if (isAppleMacWebKit() && -d "$configurationProductDir/MobileSafari.app") {
2178         return "$configurationProductDir/MobileSafari.app";
2179     }
2180     return installedMobileSafariBundle();
2181 }
2182
2183 sub plistPathFromBundle($)
2184 {
2185     my ($appBundle) = @_;
2186     return "$appBundle/Info.plist" if -f "$appBundle/Info.plist"; # iOS app bundle
2187     return "$appBundle/Contents/Info.plist" if -f "$appBundle/Contents/Info.plist"; # Mac app bundle
2188     return "";
2189 }
2190
2191 sub appIdentifierFromBundle($)
2192 {
2193     my ($appBundle) = @_;
2194     my $plistPath = File::Spec->rel2abs(plistPathFromBundle($appBundle)); # defaults(1) will complain if the specified path is not absolute.
2195     chomp(my $bundleIdentifier = `defaults read '$plistPath' CFBundleIdentifier 2> /dev/null`);
2196     return $bundleIdentifier;
2197 }
2198
2199 sub appDisplayNameFromBundle($)
2200 {
2201     my ($appBundle) = @_;
2202     my $plistPath = File::Spec->rel2abs(plistPathFromBundle($appBundle)); # defaults(1) will complain if the specified path is not absolute.
2203     chomp(my $bundleDisplayName = `defaults read '$plistPath' CFBundleDisplayName 2> /dev/null`);
2204     return $bundleDisplayName;
2205 }
2206
2207 sub waitUntilIOSSimulatorDeviceIsInState($$)
2208 {
2209     my ($deviceUDID, $waitUntilState) = @_;
2210     my $device = iosSimulatorDeviceByUDID($deviceUDID);
2211     while ($device->{state} ne $waitUntilState) {
2212         usleep(500 * 1000); # Waiting 500ms between file system polls does not make script run-safari feel sluggish.
2213         $device = iosSimulatorDeviceByUDID($deviceUDID);
2214     }
2215 }
2216
2217 sub relaunchIOSSimulator($)
2218 {
2219     my ($simulatedDevice) = @_;
2220     quitIOSSimulator($simulatedDevice->{UDID});
2221
2222     # FIXME: <rdar://problem/20916140> Switch to using CoreSimulator.framework for launching and quitting iOS Simulator
2223     my $iosSimulatorBundleID = "com.apple.iphonesimulator";
2224     system("open", "-b", $iosSimulatorBundleID, "--args", "-CurrentDeviceUDID", $simulatedDevice->{UDID}) == 0 or die "Failed to open $iosSimulatorBundleID: $!";
2225
2226     waitUntilIOSSimulatorDeviceIsInState($simulatedDevice->{UDID}, SIMULATOR_DEVICE_STATE_BOOTED);
2227 }
2228
2229 sub quitIOSSimulator(;$)
2230 {
2231     my ($waitForShutdownOfSimulatedDeviceUDID) = @_;
2232     # FIXME: <rdar://problem/20916140> Switch to using CoreSimulator.framework for launching and quitting iOS Simulator
2233     exitStatus(system {"osascript"} "osascript", "-e", 'tell application id "com.apple.iphonesimulator" to quit') == 0 or die "Failed to quit iOS Simulator: $!";
2234     if (!defined($waitForShutdownOfSimulatedDeviceUDID)) {
2235         return;
2236     }
2237     # FIXME: We assume that $waitForShutdownOfSimulatedDeviceUDID was not booted using the simctl command line tool.
2238     #        Otherwise we will spin indefinitely since quiting the iOS Simulator will not shutdown this device. We
2239     #        should add a maximum time limit to wait for a device to shutdown and either return an error or die()
2240     #        on expiration of the time limit.
2241     waitUntilIOSSimulatorDeviceIsInState($waitForShutdownOfSimulatedDeviceUDID, SIMULATOR_DEVICE_STATE_SHUTDOWN);
2242 }
2243
2244 sub iosSimulatorDeviceByName($)
2245 {
2246     my ($simulatorName) = @_;
2247     my $simulatorRuntime = iosSimulatorRuntime();
2248     my @devices = iOSSimulatorDevices();
2249     for my $device (@devices) {
2250         if ($device->{name} eq $simulatorName && $device->{runtime} eq $simulatorRuntime) {
2251             return $device;
2252         }
2253     }
2254     return undef;
2255 }
2256
2257 sub iosSimulatorDeviceByUDID($)
2258 {
2259     my ($simulatedDeviceUDID) = @_;
2260     my $devicePlistPath = File::Spec->catfile(iOSSimulatorDevicesPath(), $simulatedDeviceUDID, "device.plist");
2261     if (!-f $devicePlistPath) {
2262         return;
2263     }
2264     # FIXME: We should parse the device.plist file ourself and map the dictionary keys in it to known
2265     #        dictionary keys so as to decouple our representation of the plist from the actual structure
2266     #        of the plist, which may change.
2267     eval "require Foundation";
2268     return Foundation::perlRefFromObjectRef(NSDictionary->dictionaryWithContentsOfFile_($devicePlistPath));
2269 }
2270
2271 sub iosSimulatorRuntime()
2272 {
2273     my $xcodeSDKVersion = xcodeSDKVersion();
2274     $xcodeSDKVersion =~ s/\./-/;
2275     return "com.apple.CoreSimulator.SimRuntime.iOS-$xcodeSDKVersion";
2276 }
2277
2278 sub findOrCreateSimulatorForIOSDevice($)
2279 {
2280     my ($simulatorNameSuffix) = @_;
2281     my $simulatorName;
2282     my $simulatorDeviceType;
2283     if (architecture() eq "x86_64") {
2284         $simulatorName = "iPhone 5s " . $simulatorNameSuffix;
2285         $simulatorDeviceType = "com.apple.CoreSimulator.SimDeviceType.iPhone-5s";
2286     } else {
2287         $simulatorName = "iPhone 5 " . $simulatorNameSuffix;
2288         $simulatorDeviceType = "com.apple.CoreSimulator.SimDeviceType.iPhone-5";
2289     }
2290     my $simulatedDevice = iosSimulatorDeviceByName($simulatorName);
2291     return $simulatedDevice if $simulatedDevice;
2292     return createiOSSimulatorDevice($simulatorName, $simulatorDeviceType, iosSimulatorRuntime());
2293 }
2294
2295 sub isIOSSimulatorSystemInstalledApp($)
2296 {
2297     my ($appBundle) = @_;
2298     my $simulatorApplicationsPath = realpath(iosSimulatorApplicationsPath());
2299     return substr(realpath($appBundle), 0, length($simulatorApplicationsPath)) eq $simulatorApplicationsPath;
2300 }
2301
2302 sub hasUserInstalledAppInSimulatorDevice($$)
2303 {
2304     my ($appIdentifier, $simulatedDeviceUDID) = @_;
2305     my $userInstalledAppPath = File::Spec->catfile($ENV{HOME}, "Library", "Developer", "CoreSimulator", "Devices", $simulatedDeviceUDID, "data", "Containers", "Bundle", "Application");
2306     if (!-d $userInstalledAppPath) {
2307         return 0; # No user installed apps.
2308     }
2309     local @::userInstalledAppBundles;
2310     my $wantedFunction = sub {
2311         my $file = $_;
2312
2313         # Ignore hidden files and directories.
2314         if ($file =~ /^\../) {
2315             $File::Find::prune = 1;
2316             return;
2317         }
2318
2319         return if !-d $file || $file !~ /\.app$/;
2320         push @::userInstalledAppBundles, $File::Find::name;
2321         $File::Find::prune = 1; # Do not traverse contents of app bundle.
2322     };
2323     find($wantedFunction, $userInstalledAppPath);
2324     for my $userInstalledAppBundle (@::userInstalledAppBundles) {
2325         if (appIdentifierFromBundle($userInstalledAppBundle) eq $appIdentifier) {
2326             return 1; # Has user installed app.
2327         }
2328     }
2329     return 0; # Does not have user installed app.
2330 }
2331
2332 sub isSimulatorDeviceBooted($)
2333 {
2334     my ($simulatedDeviceUDID) = @_;
2335     my $device = iosSimulatorDeviceByUDID($simulatedDeviceUDID);
2336     return $device && $device->{state} eq SIMULATOR_DEVICE_STATE_BOOTED;
2337 }
2338
2339 sub runIOSWebKitAppInSimulator($;$)
2340 {
2341     my ($appBundle, $simulatorOptions) = @_;
2342     my $productDir = productDir();
2343     my $appDisplayName = appDisplayNameFromBundle($appBundle);
2344     my $appIdentifier = appIdentifierFromBundle($appBundle);
2345     my $simulatedDevice = findOrCreateSimulatorForIOSDevice(SIMULATOR_DEVICE_SUFFIX_FOR_WEBKIT_DEVELOPMENT);
2346     my $simulatedDeviceUDID = $simulatedDevice->{UDID};
2347
2348     my $willUseSystemInstalledApp = isIOSSimulatorSystemInstalledApp($appBundle);
2349     if ($willUseSystemInstalledApp) {
2350         if (hasUserInstalledAppInSimulatorDevice($appIdentifier, $simulatedDeviceUDID)) {
2351             # Restore the system-installed app in the simulator device corresponding to $appBundle as it
2352             # was previously overwritten with a custom built version of the app.
2353             # FIXME: Only restore the system-installed version of the app instead of erasing all contents and settings.
2354             print "Quitting iOS Simulator...\n";
2355             quitIOSSimulator($simulatedDeviceUDID);
2356             print "Erasing contents and settings for simulator device \"$simulatedDevice->{name}\".\n";
2357             exitStatus(system("xcrun", "--sdk", "iphonesimulator", "simctl", "erase", $simulatedDeviceUDID)) == 0 or die;
2358         }
2359         # FIXME: We assume that if $simulatedDeviceUDID is not booted then iOS Simulator is not open. However
2360         #        $simulatedDeviceUDID may have been booted using the simctl command line tool. If $simulatedDeviceUDID
2361         #        was booted using simctl then we should shutdown the device and launch iOS Simulator to boot it again.
2362         if (!isSimulatorDeviceBooted($simulatedDeviceUDID)) {
2363             print "Launching iOS Simulator...\n";
2364             relaunchIOSSimulator($simulatedDevice);
2365         }
2366     } else {
2367         # FIXME: We should killall(1) any running instances of $appBundle before installing it to ensure
2368         #        that simctl launch opens the latest installed version of the app. For now we quit and
2369         #        launch the iOS Simulator again to ensure there are no running instances of $appBundle.
2370         print "Quitting and launching iOS Simulator...\n";
2371         relaunchIOSSimulator($simulatedDevice);
2372
2373         print "Installing $appBundle.\n";
2374         # Install custom built app, overwriting an app with the same app identifier if one exists.
2375         exitStatus(system("xcrun", "--sdk", "iphonesimulator", "simctl", "install", $simulatedDeviceUDID, $appBundle)) == 0 or die;
2376
2377     }
2378
2379     $simulatorOptions = {} unless $simulatorOptions;
2380
2381     my %simulatorENV;
2382     %simulatorENV = %{$simulatorOptions->{applicationEnvironment}} if $simulatorOptions->{applicationEnvironment};
2383     {
2384         local %ENV; # Shadow global-scope %ENV so that changes to it will not be seen outside of this scope.
2385         setupIOSWebKitEnvironment($productDir);
2386         %simulatorENV = %ENV;
2387     }
2388     my $applicationArguments = \@ARGV;
2389     $applicationArguments = $simulatorOptions->{applicationArguments} if $simulatorOptions && $simulatorOptions->{applicationArguments};
2390
2391     # Prefix the environment variables with SIMCTL_CHILD_ per `xcrun simctl help launch`.
2392     foreach my $key (keys %simulatorENV) {
2393         $ENV{"SIMCTL_CHILD_$key"} = $simulatorENV{$key};
2394     }
2395
2396     print "Starting $appDisplayName with DYLD_FRAMEWORK_PATH set to point to built WebKit in $productDir.\n";
2397     return exitStatus(system("xcrun", "--sdk", "iphonesimulator", "simctl", "launch", $simulatedDeviceUDID, $appIdentifier, @$applicationArguments));
2398 }
2399
2400 sub runIOSWebKitApp($)
2401 {
2402     my ($appBundle) = @_;
2403     if (willUseIOSDeviceSDKWhenBuilding()) {
2404         die "Only running Safari in iOS Simulator is supported now.";
2405     }
2406     if (willUseIOSSimulatorSDKWhenBuilding()) {
2407         return runIOSWebKitAppInSimulator($appBundle);
2408     }
2409     die "Not using an iOS SDK."
2410 }
2411
2412 sub runMacWebKitApp($;$)
2413 {
2414     my ($appPath, $useOpenCommand) = @_;
2415     my $productDir = productDir();
2416     print "Starting @{[basename($appPath)]} with DYLD_FRAMEWORK_PATH set to point to built WebKit in $productDir.\n";
2417
2418     local %ENV = %ENV;
2419     setupMacWebKitEnvironment($productDir);
2420
2421     if (defined($useOpenCommand) && $useOpenCommand == USE_OPEN_COMMAND) {
2422         return system("open", "-W", "-a", $appPath, "--args", argumentsForRunAndDebugMacWebKitApp());
2423     }
2424     if (architecture()) {
2425         return system "arch", "-" . architecture(), $appPath, argumentsForRunAndDebugMacWebKitApp();
2426     }
2427     return system { $appPath } $appPath, argumentsForRunAndDebugMacWebKitApp();
2428 }
2429
2430 sub execMacWebKitAppForDebugging($)
2431 {
2432     my ($appPath) = @_;
2433     my $architectureSwitch;
2434     my $argumentsSeparator;
2435
2436     if (debugger() eq "lldb") {
2437         $architectureSwitch = "--arch";
2438         $argumentsSeparator = "--";
2439     } elsif (debugger() eq "gdb") {
2440         $architectureSwitch = "-arch";
2441         $argumentsSeparator = "--args";
2442     } else {
2443         die "Unknown debugger $debugger.\n";
2444     }
2445
2446     my $debuggerPath = `xcrun -find $debugger`;
2447     chomp $debuggerPath;
2448     die "Can't find the $debugger executable.\n" unless -x $debuggerPath;
2449
2450     my $productDir = productDir();
2451     setupMacWebKitEnvironment($productDir);
2452
2453     my @architectureFlags = ($architectureSwitch, architecture());
2454     if (!shouldTargetWebProcess()) {
2455         print "Starting @{[basename($appPath)]} under $debugger with DYLD_FRAMEWORK_PATH set to point to built WebKit in $productDir.\n";
2456         exec { $debuggerPath } $debuggerPath, @architectureFlags, $argumentsSeparator, $appPath, argumentsForRunAndDebugMacWebKitApp() or die;
2457     } else {
2458         if (shouldUseXPCServiceForWebProcess()) {
2459             die "Targeting the Web Process is not compatible with using an XPC Service for the Web Process at this time.";
2460         }
2461         
2462         my $webProcessShimPath = File::Spec->catfile($productDir, "SecItemShim.dylib");
2463         my $webProcessPath = File::Spec->catdir($productDir, "WebProcess.app");
2464         my $webKit2ExecutablePath = File::Spec->catfile($productDir, "WebKit2.framework", "WebKit2");
2465
2466         appendToEnvironmentVariableList("DYLD_INSERT_LIBRARIES", $webProcessShimPath);
2467
2468         print "Starting WebProcess under $debugger with DYLD_FRAMEWORK_PATH set to point to built WebKit in $productDir.\n";
2469         exec { $debuggerPath } $debuggerPath, @architectureFlags, $argumentsSeparator, $webProcessPath, $webKit2ExecutablePath, "-type", "webprocess", "-client-executable", $appPath or die;
2470     }
2471 }
2472
2473 sub debugSafari
2474 {
2475     if (isAppleMacWebKit()) {
2476         checkFrameworks();
2477         execMacWebKitAppForDebugging(safariPath());
2478     }
2479
2480     return 1; # Unsupported platform; can't debug Safari on this platform.
2481 }
2482
2483 sub runSafari
2484 {
2485     if (isIOSWebKit()) {
2486         return runIOSWebKitApp(mobileSafariBundle());
2487     }
2488
2489     if (isAppleMacWebKit()) {
2490         return runMacWebKitApp(safariPath());
2491     }
2492
2493     if (isAppleWinWebKit()) {
2494         my $result;
2495         my $webKitLauncherPath = File::Spec->catfile(executableProductDir(), "MiniBrowser.exe");
2496         return system { $webKitLauncherPath } $webKitLauncherPath, @ARGV;
2497     }
2498
2499     return 1; # Unsupported platform; can't run Safari on this platform.
2500 }
2501
2502 sub runMiniBrowser
2503 {
2504     if (isAppleMacWebKit()) {
2505         return runMacWebKitApp(File::Spec->catfile(productDir(), "MiniBrowser.app", "Contents", "MacOS", "MiniBrowser"));
2506     } elsif (isAppleWinWebKit()) {
2507         my $result;
2508         my $webKitLauncherPath = File::Spec->catfile(executableProductDir(), "MiniBrowser.exe");
2509         return system { $webKitLauncherPath } $webKitLauncherPath, @ARGV;
2510     }
2511
2512     return 1;
2513 }
2514
2515 sub debugMiniBrowser
2516 {
2517     if (isAppleMacWebKit()) {
2518         execMacWebKitAppForDebugging(File::Spec->catfile(productDir(), "MiniBrowser.app", "Contents", "MacOS", "MiniBrowser"));
2519     }
2520     
2521     return 1;
2522 }
2523
2524 sub runWebKitTestRunner
2525 {
2526     if (isAppleMacWebKit()) {
2527         return runMacWebKitApp(File::Spec->catfile(productDir(), "WebKitTestRunner"));
2528     }
2529
2530     return 1;
2531 }
2532
2533 sub debugWebKitTestRunner
2534 {
2535     if (isAppleMacWebKit()) {
2536         execMacWebKitAppForDebugging(File::Spec->catfile(productDir(), "WebKitTestRunner"));
2537     }
2538
2539     return 1;
2540 }
2541
2542 sub readRegistryString
2543 {
2544     my ($valueName) = @_;
2545     chomp(my $string = `regtool --wow32 get "$valueName"`);
2546     return $string;
2547 }
2548
2549 sub writeRegistryString
2550 {
2551     my ($valueName, $string) = @_;
2552
2553     my $error = system "regtool", "--wow32", "set", "-s", $valueName, $string;
2554
2555     # On Windows Vista/7 with UAC enabled, regtool will fail to modify the registry, but will still
2556     # return a successful exit code. So we double-check here that the value we tried to write to the
2557     # registry was really written.
2558     return !$error && readRegistryString($valueName) eq $string;
2559 }
2560
2561 sub formatBuildTime($)
2562 {
2563     my ($buildTime) = @_;
2564
2565     my $buildHours = int($buildTime / 3600);
2566     my $buildMins = int(($buildTime - $buildHours * 3600) / 60);
2567     my $buildSecs = $buildTime - $buildHours * 3600 - $buildMins * 60;
2568
2569     if ($buildHours) {
2570         return sprintf("%dh:%02dm:%02ds", $buildHours, $buildMins, $buildSecs);
2571     }
2572     return sprintf("%02dm:%02ds", $buildMins, $buildSecs);
2573 }
2574
2575 sub runSvnUpdateAndResolveChangeLogs(@)
2576 {
2577     my @svnOptions = @_;
2578     my $openCommand = "svn update " . join(" ", @svnOptions);
2579     open my $update, "$openCommand |" or die "cannot execute command $openCommand";
2580     my @conflictedChangeLogs;
2581     while (my $line = <$update>) {
2582         print $line;
2583         $line =~ m/^C\s+(.+?)[\r\n]*$/;
2584         if ($1) {
2585           my $filename = normalizePath($1);
2586           push @conflictedChangeLogs, $filename if basename($filename) eq "ChangeLog";
2587         }
2588     }
2589     close $update or die;
2590
2591     if (@conflictedChangeLogs) {
2592         print "Attempting to merge conflicted ChangeLogs.\n";
2593         my $resolveChangeLogsPath = File::Spec->catfile(sourceDir(), "Tools", "Scripts", "resolve-ChangeLogs");
2594         (system($resolveChangeLogsPath, "--no-warnings", @conflictedChangeLogs) == 0)
2595             or die "Could not open resolve-ChangeLogs script: $!.\n";
2596     }
2597 }
2598
2599 sub runGitUpdate()
2600 {
2601     # Doing a git fetch first allows setups with svn-remote.svn.fetch = trunk:refs/remotes/origin/master
2602     # to perform the rebase much much faster.
2603     system("git", "fetch");
2604     if (isGitSVNDirectory(".")) {
2605         system("git", "svn", "rebase") == 0 or die;
2606     } else {
2607         # This will die if branch.$BRANCHNAME.merge isn't set, which is
2608         # almost certainly what we want.
2609         system("git", "pull") == 0 or die;
2610     }
2611 }
2612
2613 1;