Tools/Scripts/webkitdirs.pm

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