/home/mrjunejune/zenbu: third_party/emsdk/README.md annotate

annotate third_party/emsdk/README.md @ 279:b3b547563ec7

Add Google connector service and agent wiki Implement the C/Seobeo Google Drive and Gmail connector with encrypted OAuth storage, Zenbu authentication, browser testing, AI tool discovery, chunked HTTP decoding, and Bazel coverage. Consolidate repository guidance into progressive wiki documentation and enforce arena-first allocation for new first-party C code. Co-authored-by: Copilot <[email protected]> Copilot-Session: 84c338fd-0939-4bb3-b7f3-1062eb213e5d

author	MrJuneJune <me@mrjunejune.com>
date	Mon, 17 Aug 2026 22:22:36 -0700
parents	8d17f6e6e290
children

rev	line source
179 8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	1 Emscripten SDK
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	2 ==============
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	3
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	4 [![CircleCI](https://circleci.com/gh/emscripten-core/emsdk/tree/main.svg?style=svg)](https://circleci.com/gh/emscripten-core/emsdk/tree/main)
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	5
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	6 The Emscripten toolchain is distributed as a standalone Emscripten SDK. The SDK
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	7 provides all the required tools, such as Clang, Python and Node.js along with an
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	8 update mechanism that enables migrating to newer Emscripten versions as they are
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	9 released.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	10
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	11 You can also set up Emscripten from source, without the pre-built SDK, see
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	12 "Installing from Source" below.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	13
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	14 ## Downloads / How do I get the latest Emscripten build?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	15
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	16 To get started with Emscripten development, see the [Emscripten website
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	17 documentation](https://emscripten.org/docs/getting_started/downloads.html).
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	18
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	19 That explains how to use the emsdk to get the latest binary builds (without
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	20 compiling from source). Basically, that amounts to
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	21
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	22 ```
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	23 git pull
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	24 ./emsdk install latest
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	25 ./emsdk activate latest
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	26 ```
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	27
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	28 ## SDK Concepts
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	29
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	30 The Emscripten SDK is effectively a small package manager for tools that are
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	31 used in conjunction with Emscripten. The following glossary highlights the
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	32 important concepts to help understanding the internals of the SDK:
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	33
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	34 * Tool: The basic unit of software bundled in the SDK. A Tool has a name and
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	35 a version. For example, 'clang-3.2-32bit' is a Tool that contains the 32-bit
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	36 version of the Clang v3.2 compiler.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	37 * SDK: A set of tools. For example, 'sdk-1.5.6-32bit' is an SDK consisting
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	38 of the tools `clang-3.2-32bit`, `node-0.10.17-32bit`, `python-2.7.5.1-32bit`
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	39 and `emscripten-1.5.6`.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	40 * Active Tool/SDK: Emscripten SDK stores compiler configuration in a file
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	41 called `.emscripten` within the emsdk directory. This file points to paths
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	42 for Emscripten, Python, Clang and so on. If the configuration file points to a
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	43 Tool in a specific directory, then that tool is denoted as being
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	44 active. This mechanism allows switching between different installed
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	45 tools and SDKs.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	46 * emsdk: This is the name of the manager script that Emscripten SDK is
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	47 accessed through. Most operations are of the form `emsdk <command>`.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	48
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	49 ## System Requirements
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	50
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	51 Using the emsdk pre-compiled packages requires only the minimal set of
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	52 dependencies lists below. When building from source a wider set of tools
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	53 include git, cmake, and a host compiler are required. See:
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	54 https://emscripten.org/docs/building_from_source/toolchain_what_is_needed.html.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	55
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	56 ### Mac OS X
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	57
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	58 - macOS 11.0 or newer.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	59 - `java`: For running closure compiler (optional). After installing emscripten
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	60 via emsdk, typing 'emcc --help' should pop up a OS X dialog "Java is not
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	61 installed. To open java, you need a Java SE 6 runtime. Would you like to
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	62 install one now?" that will automatically download a Java runtime to the
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	63 system.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	64
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	65 ### Linux
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	66
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	67 - `python`: Version 3.8 or above.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	68 - `java`: For running closure compiler (optional)
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	69
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	70 The emsdk pre-compiled binaries are built against debian/stretch (for x86_64)
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	71 and debian/bullseye (for arm64) sysroots and therefore depend on system
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	72 libraries compatible with the version of `glibc` (and other libraries) present
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	73 in those releases. If your linux distribution is very old you may not be able to
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	74 use the pre-compiled binaries packages. Note that `libc++` is statically linked
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	75 so there should be no issues with older versions of `libstdc++` or `libc++`.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	76
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	77 ### Windows
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	78
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	79 - `java`: For running closure compiler (optional)
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	80
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	81 ## Uninstalling the Emscripten SDK
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	82
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	83 To remove the Emscripten SDK, simply delete the emsdk directory.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	84
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	85 ## SDK Maintenance
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	86
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	87 The following tasks are common with the Emscripten SDK:
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	88
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	89 ### How do I work the emsdk utility?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	90
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	91 Run `emsdk help` or just `emsdk` to get information about all available commands.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	92
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	93 ### How do I check the installation status and version of the SDK and tools?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	94
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	95 To get a list of all currently installed tools and SDK versions, and all
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	96 available tools, run `emsdk list`.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	97 * A line will be printed for each tool/SDK that is available for installation.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	98 * The text `INSTALLED` will be shown for each tool that has already been
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	99 installed.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	100 * If a tool/SDK is currently active, a star * will be shown next to it.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	101 * If a tool/SDK is currently active, but the terminal your are calling emsdk
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	102 from does not have `PATH` and environment set up to utilize that tool, a star
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	103 in parentheses (\*) will be shown next to it. Run `emsdk_env.bat` (Windows) or
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	104 `source ./emsdk_env.sh` (Linux and OS X) to set up the environment for the
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	105 calling terminal.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	106
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	107 ### How do I install a tool/SDK version?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	108
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	109 Run the command `emsdk install <tool/sdk name>` to download and install a new
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	110 tool or an SDK version.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	111
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	112 ### How do I remove a tool or an SDK?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	113
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	114 Run the command `emsdk uninstall <tool/sdk name>` to delete the given tool or
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	115 SDK from the local hard drive completely.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	116
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	117 ### How do I check for updates to the Emscripten SDK?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	118
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	119 `emsdk update` will fetch package information for all the new tools and
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	120 SDK versions. After that, run `emsdk install <tool/sdk name>` to install a new
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	121 version.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	122
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	123 ### How do I install an old Emscripten compiler version?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	124
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	125 Emsdk contains a history of old compiler versions that you can use to maintain
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	126 your migration path. Type `emsdk list --old` to get a list of archived tool and
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	127 SDK versions, and `emsdk install <name_of_tool>` to install it.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	128
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	129 ### I want to build from source!
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	130
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	131 Some Emsdk Tool and SDK targets refer to packages that are precompiled, and
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	132 no compilation is needed when installing them. Other Emsdk Tools and SDK
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	133 targets come "from source", meaning that they will fetch the source repositories
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	134 using git, and compile the package on demand.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	135
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	136 When you run `emsdk list`, it will group the Tools and SDKs under these two
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	137 categories.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	138
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	139 To obtain and build latest wasm SDK from source, run
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	140
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	141 ```
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	142 emsdk install sdk-main-64bit
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	143 emsdk activate sdk-main-64bit
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	144 ```
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	145
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	146 You can use this target for example to bootstrap developing patches to LLVM,
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	147 Binaryen or Emscripten. (After initial installation, use `git remote add`
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	148 in the cloned tree to add your own fork to push changes as patches)
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	149
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	150 If you only intend to contribute to Emscripten repository, and not to LLVM
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	151 or Binaryen, you can also use precompiled versions of them, and only git
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	152 clone the Emscripten repository. For more details, see
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	153
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	154 https://emscripten.org/docs/contributing/developers_guide.html?highlight=developer#setting-up
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	155
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	156 ### When working on git branches compiled from source, how do I update to a newer compiler version?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	157
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	158 Unlike tags and precompiled versions, a few of the SDK packages are based on
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	159 "moving" git branches and compiled from source (e.g. sdk-main,
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	160 sdk-main, emscripten-main, binaryen-main). Because of that, the
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	161 compiled versions will eventually go out of date as new commits are introduced
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	162 to the development branches. To update an old compiled installation of one of
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	163 this branches, simply reissue the "emsdk install" command on that tool/SDK. This
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	164 will `git pull` the latest changes to the branch and issue an incremental
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	165 recompilation of the target in question. This way you can keep calling `emsdk
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	166 install` to keep an Emscripten installation up to date with a given git branch.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	167
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	168 Note though that if the previously compiled branch is very old, sometimes CMake
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	169 gets confused and is unable to properly rebuild a project. This has happened in
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	170 the past e.g. when LLVM migrated to requiring a newer CMake version. In cases of
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	171 any odd compilation errors, it is advised to try deleting the intermediate build
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	172 directory to clear the build (e.g. "emsdk/clang/fastcomp/build_xxx/") before
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	173 reissuing `emsdk install`.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	174
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	175 ### How do I change the currently active SDK version?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	176
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	177 You can toggle between different tools and SDK versions by running `emsdk
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	178 activate <tool/sdk name>`. Activating a tool will set up `~/.emscripten` to
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	179 point to that particular tool. On Windows, you can pass the option `--permanent` to
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	180 the `activate` command to register the environment permanently for the current user. Use `--system` to do this for all users.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	181
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	182 ### How do I track the latest Emscripten development with the SDK?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	183
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	184 A common and supported use case of the Emscripten SDK is to enable the workflow
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	185 where you directly interact with the github repositories. This allows you to
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	186 obtain new features and latest fixes immediately as they are pushed to the
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	187 github repository, without having to wait for release to be tagged. You do not
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	188 need a github account or a fork of Emscripten to do this. To switch to using the
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	189 latest git development branch `main`, run the following:
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	190
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	191 emsdk install git-1.9.4 # Install git. Skip if the system already has it.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	192 emsdk install sdk-main-64bit # Clone+pull the latest emscripten-core/emscripten/main.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	193 emsdk activate sdk-main-64bit # Set the main SDK as the currently active one.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	194
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	195 ### How do I use my own Emscripten github fork with the SDK?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	196
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	197 It is also possible to use your own fork of the Emscripten repository via the
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	198 SDK. This is achieved with standard git machinery, so if you are already
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	199 acquainted with working on multiple remotes in a git clone, these steps should
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	200 be familiar to you. This is useful in the case when you want to make your own
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	201 modifications to the Emscripten toolchain, but still keep using the SDK
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	202 environment and tools. To set up your own fork as the currently active
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	203 Emscripten toolchain, first install the `sdk-main` SDK like shown in the
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	204 previous section, and then run the following commands in the emsdk directory:
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	205
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	206 cd emscripten/main
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	207 # Add a git remote link to your own repository.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	208 git remote add myremote https://github.com/mygituseraccount/emscripten.git
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	209 # Obtain the changes in your link.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	210 git fetch myremote
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	211 # Switch the emscripten-main tool to use your fork.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	212 git checkout -b mymain --track myremote/main
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	213
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	214 In this way you can utilize the Emscripten SDK tools while using your own git
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	215 fork. You can switch back and forth between remotes via the `git checkout`
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	216 command as usual.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	217
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	218 ### How do I use Emscripten SDK with a custom version of python, java, node.js or some other tool?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	219
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	220 The provided Emscripten SDK targets are metapackages that refer to a specific
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	221 set of tools that have been tested to work together. For example,
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	222 `sdk-1.35.0-64bit` is an alias to the individual packages `clang-e1.35.0-64bit`,
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	223 `node-4.1.1-64bit`, `python-2.7.5.3-64bit` and `emscripten-1.35.0`. This means
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	224 that if you install this version of the SDK, both python and node.js will be
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	225 installed inside emsdk as well. If you want to use your own/system python or
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	226 node.js instead, you can opt to install emsdk by specifying the individual set
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	227 of packages that you want to use. For example, `emsdk install
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	228 clang-e1.35.0-64bit emscripten-1.35.0` will only install the Emscripten
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	229 LLVM/Clang compiler and the Emscripten frontend without supplying python and
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	230 node.js.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	231
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	232 ### My installation fails with "fatal error: ld terminated with signal 9 [Killed]"?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	233
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	234 This may happen if the system runs out of memory. If you are attempting to build
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	235 one of the packages from source and are running in a virtual OS or may have
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	236 relatively little RAM and disk space available, then the build might fail. Try
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	237 feeding your computer more memory. Another thing to try is to force emsdk
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	238 install to build in a singlethreaded mode, which will require less RAM
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	239 simultaneously. To do this, pass the `-j1` flag to the `emsdk install` command.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	240
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	241 ### How do I run Emscripten on 32-bit systems or non-x86-64 systems?
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	242
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	243 Emscripten SDK releases are no longer packaged or maintained for 32-bit systems.
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	244 If you want to run Emscripten on a 32-bit system, you can try manually building
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	245 the compiler. Follow the steps in the above section "Building an Emscripten tag
8d17f6e6e290 [ThirdParty] Added emsdk bazel rules that can be supported by bazel 9.0.0 MrJuneJune <me@mrjunejune.com> parents: diff changeset	246 or branch from source" to get started.

Mercurial

annotate third_party/emsdk/README.md @ 279:b3b547563ec7