Files

T

Sergey Bogolepov bcd28615a6 [Native] Add initial version of LLVM buildscript

Previously there was no determined way to build LLVM for Kotlin/Native.
This commits adds a Python script that allows to do so on all hosts.

2021-06-08 14:42:43 +00:00

package.py

…

README.md

…

README.md

LLVM Build Infrastructure

package.py script automates downloading, building and packing of LLVM distribution used by Kotlin/Native.

Requirements

Check LLVM requirements. Note that:
- Visual Studio 2017 is required on Windows
- Xcode is required on macOS
Python 3
ninja
git
CMake

Usage

Just run

python3 package.py

It will create a llvm-distribution folder which contains LLVM distribution.
Note that build will take a lot of time and all your machine cores. 😈
See HACKING.md on how to use freshly built distribution.

Tuning

Run python3 package.py -h to check how one can tune script's behavior. Some examples:

--archive-path creates an archive (zip on Windows, tar.gz on macOS and Linux) with distribution alongside with its SHA256.
--install-path allows overriding distribution's output directory.
--num-stages specifies number of steps in build. Passing 2 or more makes bootstrap build which means that LLVM will build itself by using distribution from the previous step.
--stage0 allows using existing LLVM toolchain for bootstrapping.

Known problems

Bootstrap build is not working on macOS for default git branch.
libcxx and compiler-rt are built as projects, not runtimes.
No way to run LLVM tests out of the box.
No way to override default install task out of the box.