使用 Emscripten 为 WebAssembly 进行交叉编译#

先决条件#

您需要按照常规构建说明安装 CMake 和编译器等。在使用 Emscripten 进行构建之前，您还需要安装 Emscripten 并使用以下命令激活它（有关详细信息，请参阅https://emscripten.cn/docs/getting_started/downloads.html）。

git clone https://github.com/emscripten-core/emsdk.git
cd emsdk
# replace <version> with the desired EMSDK version.
# e.g. for Pyodide 0.26, you need EMSDK version 3.1.58
# the versions can be found in the Makefile.envs file in the Pyodide repo:
# https://github.com/pyodide/pyodide/blob/10b484cfe427e076c929a55dc35cfff01ea8d3bc/Makefile.envs
./emsdk install <version>
./emsdk activate <version>
source ./emsdk_env.sh

如果您想为 Pyodide 构建 PyArrow，您需要通过 pip 安装 pyodide-build，并使用 Pyodide 构建所用的相同 Python 版本以及相同版本的 emsdk 工具运行。

# install Pyodide build tools.
# e.g., for version 0.26 of Pyodide, pyodide-build 0.26 and later work
pip install "pyodide-build>=0.26"

然后使用 ninja-release-emscripten CMake 预设进行构建，如下所示

emcmake cmake --preset "ninja-release-emscripten"
ninja install

这会将 libarrow 的构建静态库版本安装到 Emscripten sysroot 缓存中，这意味着您可以构建依赖于它的东西，并且它们将找到 libarrow。

例如，如果您想为 Pyodide 构建，请运行上述命令，然后转到 arrow/python 并运行

pyodide build

它应该会在 dist 子目录中创建一个针对当前启用版本的 Pyodide 的 wheel。

手动构建#

如果您想手动为 Emscripten 构建，请查看 arrow/cpp 目录中的 CMakePresets.json 文件，以获取您需要覆盖的项列表。特别是，您将需要

  1. 构建依赖项设置为 BUNDLED，以便它使用正确交叉编译的构建依赖项。

  2. 通过使用 emcmake cmake 而不是仅仅使用 cmake 来设置 CMAKE_TOOLCHAIN_FILE。

  3. 对于针对单线程 Emscripten 环境（例如 Pyodide）的构建，您需要将 ARROW_ENABLE_THREADING 设置为 OFF。

  4. ARROW_FLIGHT 和任何其他使用网络的组件可能无法工作。

  5. ARROW_JEMALLOC 和 ARROW_MIMALLOC 同样可能需要设置为 OFF

  6. 将 ARROW_BUILD_STATIC 设置为 ON，将 ARROW_BUILD_SHARED 设置为 OFF 最有可能成功。