This commit is contained in:
SheetJS 2023-11-13 18:19:19 -05:00
parent 073f8a3be3
commit 014c28c5f5

View File

@ -43,7 +43,7 @@ These instructions were tested on the following platforms:
| Linux (Ubuntu 18 AArch64) | 2023-09-07 |
| MacOS 10.13.6 (x64) | 2023-09-30 |
| MacOS 13.6 (ARM64) | 2023-09-30 |
| Windows 10 (x64) + WSL Ubuntu | 2023-07-23 |
| Windows 10 (x64) + WSL Ubuntu | 2023-11-13 |
| Windows 11 (x64) + WSL Ubuntu | 2023-10-14 |
| Windows 11 (ARM) + WSL Ubuntu | 2023-09-18 |
@ -79,6 +79,12 @@ The following command installs Ubuntu within WSL:
wsl --install Ubuntu
```
In some versions of `wsl`, the `-d` flag must be specified:
```powershell
wsl --install -d Ubuntu
```
:::caution pass
In the last Windows 11 test, there was a `WSL_E_DEFAULT_DISTRO_NOT_FOUND` error.
@ -183,6 +189,25 @@ git clone https://git.sheetjs.com/sheetjs/js-crc32
:::note pass
On Windows 10, this clone may fail due to issues with `core.filemode`:
```
fatal: could not set 'core.filemode' to 'false'
```
The main drive must be remounted with the metadata option:
```bash
cd /
sudo umount /mnt/c
sudo mount -t drvfs C: /mnt/c -o metadata
cd -
```
:::
:::note pass
If this clone fails with an error message that mentions SSL or secure connection
or certificates, build and install a version of Git with proper SSL support:
@ -393,10 +418,19 @@ to work and known to produce consistent results.
2) Initialize the test files:
```bash
make init
rmdir test_files
curl -LO https://test-files.sheetjs.com/test_files.zip
unzip test_files.zip
mkdir -p tmp
```
This step may take a while as it will be downloading a number of test files.
:::note pass
The `rmdir` command may fail if the folder is missing. The error can be ignored.
:::
This step may take a few minutes as the current test snapshot is large.
3) Run the `esbuild` tool once:
@ -533,6 +567,7 @@ curl -L https://cdn.sheetjs.com/xlsx-0.20.0/package/dist/xlsx.full.min.js | md5s
When the demo was last tested on macOS, against version `0.20.0`:
>
```bash
$ md5 dist/xlsx.full.min.js
# highlight-next-line