You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/mono/wasm/README.md
+18-16Lines changed: 18 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
This depends on `emsdk` to be installed.
4
4
5
-
## emsdk on mac
5
+
## emsdk on macOS
6
6
7
7
* You can run `make provision-wasm`, which will install it to `$reporoot/src/mono/wasm/emsdk` .
8
8
Note: Irrespective of `$(EMSDK_PATH)`'s value, `provision-wasm` will always install into `$reporoot/src/mono/wasm/emsdk`.
@@ -17,13 +17,7 @@ Do not install `latest` but rather specific version e.g. `./emsdk install 2.0.23
17
17
18
18
Make sure to set `EMSDK_PATH` variable, whenever building, or running tests for wasm.
19
19
20
-
### Windows dependencies
21
-
22
-
Windows build [requirements](https://github.com/dotnet/runtime/blob/main/docs/workflow/requirements/windows-requirements.md)
23
-
24
-
If `EMSDK_PATH` is not set, the `emsdk` should be provisioned automatically during the build.
25
-
26
-
## Building on mac
20
+
## Building on macOS
27
21
28
22
* To build the whole thing, with libraries:
29
23
@@ -33,9 +27,17 @@ If `EMSDK_PATH` is not set, the `emsdk` should be provisioned automatically duri
33
27
34
28
`make runtime`
35
29
36
-
### Note: Additional msbuild arguments can be passed with: `make build-all MSBUILD_ARGS="/p:a=b"`
30
+
**Note:** Additional msbuild arguments can be passed with: `make build-all MSBUILD_ARGS="/p:a=b"`
31
+
32
+
## emsdk on Windows
33
+
34
+
Windows build [requirements](https://github.com/dotnet/runtime/blob/main/docs/workflow/requirements/windows-requirements.md)
35
+
36
+
If `EMSDK_PATH` is not set, the `emsdk` should be provisioned automatically during the build.
37
+
38
+
**Note:** The EMSDK has an implicit dependency on Python for it to be initialized. A consequence of this is that if the system doesn't have Python installed prior to attempting a build, the automatic provisioning will fail and be in an invalid state. Therefore, if Python needs to be installed after a build attempt the `$reporoot/src/mono/wasm/emsdk` directory should be manually deleted and then a rebuild attempted.
37
39
38
-
###Bulding on windows
40
+
## Bulding on Windows
39
41
40
42
* To build everything
41
43
@@ -47,7 +49,7 @@ If `EMSDK_PATH` is not set, the `emsdk` should be provisioned automatically duri
47
49
48
50
The latest engines can be installed with jsvu (JavaScript engine Version Updater https://github.com/GoogleChromeLabs/jsvu)
49
51
50
-
### Mac
52
+
### macOS
51
53
52
54
* Install npm with brew:
53
55
@@ -83,7 +85,7 @@ Add `~/.jsvu` to your `PATH`:
83
85
84
86
Library tests can be run with js engines: `v8`, `SpiderMonkey`,or `JavaScriptCore`:
85
87
86
-
### Mac
88
+
### macOS
87
89
88
90
*`v8`: `make run-tests-v8-$(lib_name)`
89
91
* SpiderMonkey: `make run-tests-sm-$(lib_name)`
@@ -105,7 +107,7 @@ Examples of running tests for individual libraries:
@@ -125,9 +127,9 @@ The wrapper script used to actually run these tests, accepts:
125
127
126
128
* set `XHARNESS_CLI_PATH=/path/to/xharness/artifacts/bin/Microsoft.DotNet.XHarness.CLI/Debug/netcoreapp3.1/Microsoft.DotNet.XHarness.CLI.dll`
127
129
128
-
### Note: Additional msbuild arguments can be passed with: `make .. MSBUILD_ARGS="/p:a=b"`
130
+
**Note:** Additional msbuild arguments can be passed with: `make .. MSBUILD_ARGS="/p:a=b"`
129
131
130
-
## Debugger tests on mac
132
+
## Debugger tests on macOS
131
133
132
134
Debugger tests need `Google Chrome` to be installed.
133
135
@@ -173,4 +175,4 @@ Bumping Emscripten version involves these steps:
173
175
## Code style
174
176
* Is enforced via [eslint](https://eslint.org/) and rules are in `./.eslintrc.js`
175
177
* You could check the style by running `npm run lint` in `src/mono/wasm/runtime` directory
176
-
* You can install [plugin into your VS Code](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) to show you the errors as you type
178
+
* You can install [plugin into your VS Code](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) to show you the errors as you type
0 commit comments