From d22aea700b3f2c349b53689b783e7569e06dc1cd Mon Sep 17 00:00:00 2001 From: Wenhui Zhang Date: Wed, 4 Aug 2021 17:23:59 -0700 Subject: [PATCH 1/9] Update ReadMe.md --- ReadMe.md | 176 ++---------------------------------------------------- 1 file changed, 6 insertions(+), 170 deletions(-) diff --git a/ReadMe.md b/ReadMe.md index fd30bbcf83d3..8a7c1834a0b5 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -2,183 +2,19 @@ WebKit is a cross-platform web browser engine. On iOS and macOS, it powers Safari, Mail, iBooks, and many other applications. -## Feature Status +# install -Visit [WebKit Feature Status](https://webkit.org/status/) page to see which Web API has been implemented, in development, or under consideration. - -## Trying the Latest - -On macOS, [download Safari Technology Preview](https://webkit.org/downloads/) to test the latest version of WebKit. On Linux, download [Epiphany Technology Preview](https://webkitgtk.org/epiphany-tech-preview). On Windows, you'll have to build it yourself. - -## Reporting Bugs - -1. [Search WebKit Bugzilla](https://bugs.webkit.org/query.cgi?format=specific&product=WebKit) to see if there is an existing report for the bug you've encountered. -2. [Create a Bugzilla account](https://bugs.webkit.org/createaccount.cgi) to to report bugs (and to comment on them) if you haven't done so already. -3. File a bug in accordance with [our guidelines](https://webkit.org/bug-report-guidelines/). - -Once your bug is filed, you will receive email when it is updated at each stage in the [bug life cycle](https://webkit.org/bug-life-cycle). After the bug is considered fixed, you may be asked to download the [latest nightly](https://webkit.org/nightly) and confirm that the fix works for you. - -## Getting the Code - -On Windows, follow the [instructions on our website](https://webkit.org/webkit-on-windows/). - -### Cloning the Git SVN Repository - -Run the following command to clone WebKit's Git SVN repository: - -``` -git clone git@github.com:WebKit/WebKit.git WebKit -``` - -or - -``` -git clone https://github.com/WebKit/WebKit.git WebKit -``` - -If you want to be able to track Subversion revision from your git checkout, you can run the following command to do so: - -``` -Tools/Scripts/git-webkit setup-git-svn -``` - -For information about this, and other aspects of using Git with WebKit, read [the wiki page](https://trac.webkit.org/wiki/UsingGitWithWebKit). - -### Checking out the Subversion Repository - -If you don't want to use Git, run the following command to check out WebKit's Subversion repository: - -``` -svn checkout https://svn.webkit.org/repository/webkit/trunk WebKit -``` - -## Building WebKit - -### Building macOS Port - -Install Xcode and its command line tools if you haven't done so already: - -1. **Install Xcode** Get Xcode from https://developer.apple.com/downloads. To build WebKit for OS X, Xcode 5.1.1 or later is required. To build WebKit for iOS Simulator, Xcode 7 or later is required. -2. **Install the Xcode Command Line Tools** In Terminal, run the command: `xcode-select --install` - -Run the following command to build a debug build with debugging symbols and assertions: - -``` -Tools/Scripts/build-webkit --debug -``` - -For performance testing, and other purposes, use `--release` instead. - -### Using Xcode - -You can open `WebKit.xcworkspace` to build and debug WebKit within Xcode. - -If you don't use a custom build location in Xcode preferences, you have to update the workspace settings to use `WebKitBuild` directory. In menu bar, choose File > Workspace Settings, then click the Advanced button, select "Custom", "Relative to Workspace", and enter `WebKitBuild` for both Products and Intermediates. - -### Embedded Builds - -iOS, tvOS and watchOS are all considered embedded builds. The first time after you install a new Xcode, you will need to run: - -``` -sudo Tools/Scripts/configure-xcode-for-embedded-development -``` - -Without this step, you will see the error message: "`target specifies product type ‘com.apple.product-type.tool’, but there’s no such product type for the ‘iphonesimulator’ platform.`" when building target `JSCLLIntOffsetsExtractor` of project `JavaScriptCore`. - -Run the following command to build a debug build with debugging symbols and assertions for embededded simulators: - -``` -Tools/Scripts/build-webkit --debug ---simulator -``` - -or embedded devices: -``` -Tools/Scripts/build-webkit --debug ---device -``` - -where `platform` is `ios`, `tvos` or `watchos`. - -### Building the GTK+ Port - -For production builds: - -``` -cmake -DPORT=GTK -DCMAKE_BUILD_TYPE=RelWithDebInfo -GNinja -ninja -sudo ninja install ``` +sudo apt install libicu-dev python ruby bison flex cmake build-essential ninja-build git gperf -For development builds: +git clone git://git.webkit.org/WebKit.git -``` -Tools/gtk/install-dependencies -Tools/Scripts/update-webkitgtk-libs -Tools/Scripts/build-webkit --gtk --debug +Tools/Scripts/build-webkit --jsc-only ``` -For more information on building WebKitGTK+, see the [wiki page](https://trac.webkit.org/wiki/BuildingGtk). -### Building the WPE Port - -For production builds: - -``` -cmake -DPORT=WPE -DCMAKE_BUILD_TYPE=RelWithDebInfo -GNinja -ninja -sudo ninja install -``` - -For development builds: +Ref: ``` -Tools/wpe/install-dependencies -Tools/Scripts/update-webkitwpe-libs -Tools/Scripts/build-webkit --wpe --debug +https://constellation.slowstart.org/blog/2016/05/02/how-to-build-javascriptcore-on-your-machine/ ``` - -### Building Windows Port - -For building WebKit on Windows, see the [wiki page](https://webkit.org/webkit-on-windows/). - -## Running WebKit - -### With Safari and Other macOS Applications - -Run the following command to launch Safari with your local build of WebKit: - -``` -Tools/Scripts/run-safari --debug -``` - -The `run-safari` script sets the `DYLD_FRAMEWORK_PATH` environment variable to point to your build products, and then launches `/Applications/Safari.app`. `DYLD_FRAMEWORK_PATH` tells the system loader to prefer your build products over the frameworks installed in `/System/Library/Frameworks`. - -To run other applications with your local build of WebKit, run the following command: - -``` -Tools/Scripts/run-webkit-app -``` - -### iOS Simulator - -Run the following command to launch iOS simulator with your local build of WebKit: - -``` -run-safari --debug --ios-simulator -``` - -In both cases, if you have built release builds instead, use `--release` instead of `--debug`. - -### Linux Ports - -If you have a development build, you can use the run-minibrowser script, e.g.: - -``` -run-minibrowser --debug --wpe -``` - -Pass one of `--gtk`, `--jsc-only`, or `--wpe` to indicate the port to use. - -## Contribute - -Congratulations! You’re up and running. Now you can begin coding in WebKit and contribute your fixes and new features to the project. For details on submitting your code to the project, read [Contributing Code](https://webkit.org/contributing-code/). - From 2e0b9136e29ec2957bfa90a631f49301cdcee865 Mon Sep 17 00:00:00 2001 From: Wenhui Zhang Date: Thu, 23 Sep 2021 17:06:51 -0700 Subject: [PATCH 2/9] Update ReadMe.md --- ReadMe.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/ReadMe.md b/ReadMe.md index 8a7c1834a0b5..5154fd5abccc 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -9,6 +9,8 @@ sudo apt install libicu-dev python ruby bison flex cmake build-essential ninja-b git clone git://git.webkit.org/WebKit.git +cmake -DPORT=WPE -DCMAKE_BUILD_TYPE=RelWithDebInfo -GNinja + Tools/Scripts/build-webkit --jsc-only ``` From a02734c77cea6f5aa48d679d14becd329c51cfc8 Mon Sep 17 00:00:00 2001 From: Wenhui Zhang Date: Thu, 23 Sep 2021 17:07:59 -0700 Subject: [PATCH 3/9] Update ReadMe.md --- ReadMe.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/ReadMe.md b/ReadMe.md index 5154fd5abccc..893577526407 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -7,8 +7,10 @@ WebKit is a cross-platform web browser engine. On iOS and macOS, it powers Safar ``` sudo apt install libicu-dev python ruby bison flex cmake build-essential ninja-build git gperf -git clone git://git.webkit.org/WebKit.git +git clone https://github.com/JavaScriptBench/WebKit.git +cd WebKit +git checkout cmake -DPORT=WPE -DCMAKE_BUILD_TYPE=RelWithDebInfo -GNinja Tools/Scripts/build-webkit --jsc-only From 28d433b7cadcdede9c17be8689e1df5a10d44bd9 Mon Sep 17 00:00:00 2001 From: Wenhui Zhang Date: Thu, 23 Sep 2021 17:21:12 -0700 Subject: [PATCH 4/9] Update ReadMe.md --- ReadMe.md | 1 + 1 file changed, 1 insertion(+) diff --git a/ReadMe.md b/ReadMe.md index 893577526407..214c68a58c4e 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -14,6 +14,7 @@ git checkout cmake -DPORT=WPE -DCMAKE_BUILD_TYPE=RelWithDebInfo -GNinja Tools/Scripts/build-webkit --jsc-only +Tools/Scripts/build-webkit --jsc-only --cmakeargs="-DENABLE_STATIC_JSC=ON -DUSE_THIN_ARCHIVES=OFF" ``` From 3312b5178715da550eb17476480513642b271ec3 Mon Sep 17 00:00:00 2001 From: Wenhui Zhang Date: Thu, 23 Sep 2021 17:28:03 -0700 Subject: [PATCH 5/9] Update ReadMe.md --- ReadMe.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/ReadMe.md b/ReadMe.md index 214c68a58c4e..86ef788f1c6f 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -11,10 +11,11 @@ git clone https://github.com/JavaScriptBench/WebKit.git cd WebKit git checkout -cmake -DPORT=WPE -DCMAKE_BUILD_TYPE=RelWithDebInfo -GNinja - -Tools/Scripts/build-webkit --jsc-only +#cmake -DPORT=WPE -DCMAKE_BUILD_TYPE=RelWithDebInfo -GNinja +rm CMakeCache.txt +#Tools/Scripts/build-webkit --jsc-only Tools/Scripts/build-webkit --jsc-only --cmakeargs="-DENABLE_STATIC_JSC=ON -DUSE_THIN_ARCHIVES=OFF" +./WebKitBuild/Release/bin/jsc test.js ``` From 6ed9f84b967a94dae21cf5b71123b908f637ceaf Mon Sep 17 00:00:00 2001 From: Wenhui Zhang Date: Thu, 23 Sep 2021 17:30:34 -0700 Subject: [PATCH 6/9] Update ReadMe.md --- ReadMe.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/ReadMe.md b/ReadMe.md index 86ef788f1c6f..5f9a202c25e7 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -6,11 +6,10 @@ WebKit is a cross-platform web browser engine. On iOS and macOS, it powers Safar ``` sudo apt install libicu-dev python ruby bison flex cmake build-essential ninja-build git gperf - +sudo apt-get install python3-gi-cairo git clone https://github.com/JavaScriptBench/WebKit.git - cd WebKit -git checkout +git checkout remotes/origin/safari-4-branch #cmake -DPORT=WPE -DCMAKE_BUILD_TYPE=RelWithDebInfo -GNinja rm CMakeCache.txt #Tools/Scripts/build-webkit --jsc-only From e8ce3514866a39b7dc5649613d99e9d8bee3007f Mon Sep 17 00:00:00 2001 From: Wenhui Zhang Date: Thu, 23 Sep 2021 17:32:13 -0700 Subject: [PATCH 7/9] Update ReadMe.md --- ReadMe.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ReadMe.md b/ReadMe.md index 5f9a202c25e7..f322bccee37f 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -9,7 +9,7 @@ sudo apt install libicu-dev python ruby bison flex cmake build-essential ninja-b sudo apt-get install python3-gi-cairo git clone https://github.com/JavaScriptBench/WebKit.git cd WebKit -git checkout remotes/origin/safari-4-branch +git checkout master #cmake -DPORT=WPE -DCMAKE_BUILD_TYPE=RelWithDebInfo -GNinja rm CMakeCache.txt #Tools/Scripts/build-webkit --jsc-only From 64e8ea96f79031edd9cf938790ba7dc65bfbff20 Mon Sep 17 00:00:00 2001 From: Wenhui Zhang Date: Thu, 23 Sep 2021 17:59:29 -0700 Subject: [PATCH 8/9] Update ReadMe.md --- ReadMe.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ReadMe.md b/ReadMe.md index f322bccee37f..855ab5cb0a20 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -9,7 +9,7 @@ sudo apt install libicu-dev python ruby bison flex cmake build-essential ninja-b sudo apt-get install python3-gi-cairo git clone https://github.com/JavaScriptBench/WebKit.git cd WebKit -git checkout master +git checkout safari-612.1.26-branch #cmake -DPORT=WPE -DCMAKE_BUILD_TYPE=RelWithDebInfo -GNinja rm CMakeCache.txt #Tools/Scripts/build-webkit --jsc-only From aabd00fe68b7b1fc7e31e6feb61a2ddc69ccdd0e Mon Sep 17 00:00:00 2001 From: Wenhui Zhang Date: Thu, 23 Sep 2021 20:27:19 -0700 Subject: [PATCH 9/9] Update ReadMe.md --- ReadMe.md | 1 + 1 file changed, 1 insertion(+) diff --git a/ReadMe.md b/ReadMe.md index 855ab5cb0a20..1c4095bad809 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -15,6 +15,7 @@ rm CMakeCache.txt #Tools/Scripts/build-webkit --jsc-only Tools/Scripts/build-webkit --jsc-only --cmakeargs="-DENABLE_STATIC_JSC=ON -DUSE_THIN_ARCHIVES=OFF" ./WebKitBuild/Release/bin/jsc test.js +./WebKitBuild/Release/bin/jsc --useJIT=false test.js ```