[libcxx-commits] [libcxx] 77b46fb - [libc++/abi] Add scripts for building libc++ and libc++abi on Apple platforms
Louis Dionne via libcxx-commits
libcxx-commits at lists.llvm.org
Thu Apr 9 09:59:22 PDT 2020
Author: Louis Dionne
Date: 2020-04-09T12:58:54-04:00
New Revision: 77b46fb326b595e984a540e676187d4d01750e60
URL: https://github.com/llvm/llvm-project/commit/77b46fb326b595e984a540e676187d4d01750e60
DIFF: https://github.com/llvm/llvm-project/commit/77b46fb326b595e984a540e676187d4d01750e60.diff
LOG: [libc++/abi] Add scripts for building libc++ and libc++abi on Apple platforms
These scripts allow creating dylibs that are very close to the dylibs
shipped on Apple platforms.
Added:
libcxx/utils/ci/apple-install-libcxx.sh
libcxx/utils/ci/apple-install-libcxxabi.sh
Modified:
Removed:
################################################################################
diff --git a/libcxx/utils/ci/apple-install-libcxx.sh b/libcxx/utils/ci/apple-install-libcxx.sh
new file mode 100755
index 000000000000..1337ca2c271f
--- /dev/null
+++ b/libcxx/utils/ci/apple-install-libcxx.sh
@@ -0,0 +1,159 @@
+#!/usr/bin/env bash
+#===----------------------------------------------------------------------===##
+#
+# Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
+# See https://llvm.org/LICENSE.txt for license information.
+# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+#
+#===----------------------------------------------------------------------===##
+
+set -e
+
+PROGNAME="$(basename "${0}")"
+function usage() {
+cat <<EOF
+Usage:
+${PROGNAME} [-h|--help] --llvm-root <DIR> --build-dir <DIR> --install-dir <DIR> --symbols-dir <DIR> --sdk <SDK> --architectures <architectures...> --version <X.Y.Z> --cache <PATH>
+
+--llvm-root Full path to the root of the LLVM monorepo. Only the libcxx
+ and libcxxabi directories are required.
+
+--build-dir Directory to use for building. This will contain intermediate
+ build products.
+
+--install-dir Directory to install the library to.
+
+--symbols-dir Directory to install the .dSYM bundle to.
+
+--sdk SDK used for building the library. This represents the target
+ platform that the library will run on. You can get a list of
+ SDKs with \`xcodebuild -showsdks\`.
+
+--architectures A whitespace separated list of architectures to build for.
+ The library will be built for each architecture independently,
+ and a universal binary containing all architectures will be
+ created from that.
+
+--version The version of the library to encode in the dylib.
+
+--cache The CMake cache to use to control how the library gets built.
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+ case ${1} in
+ -h|--help)
+ usage
+ exit 0
+ ;;
+ --llvm-root)
+ llvm_root="${2}"
+ shift; shift
+ ;;
+ --build-dir)
+ build_dir="${2}"
+ shift; shift
+ ;;
+ --symbols-dir)
+ symbols_dir="${2}"
+ shift; shift
+ ;;
+ --install-dir)
+ install_dir="${2}"
+ shift; shift
+ ;;
+ --sdk)
+ sdk="${2}"
+ shift; shift
+ ;;
+ --architectures)
+ architectures=""
+ shift
+ while [[ $# -gt 0 ]]; do
+ if [[ "${1}" == "-"* ]]; then
+ break
+ fi
+ architectures+=" ${1}"
+ shift
+ done
+ ;;
+ --version)
+ version="${2}"
+ shift; shift
+ ;;
+ --cache)
+ cache="${2}"
+ shift; shift
+ ;;
+ *)
+ echo "Unknown argument '${1}'"
+ exit 1
+ ;;
+ esac
+done
+
+for arg in llvm_root build_dir symbols_dir install_dir sdk architectures version cache; do
+ if [ -z ${!arg+x} ]; then
+ echo "Missing required argument '--${arg//_/-}'"
+ exit 1
+ elif [ "${!arg}" == "" ]; then
+ echo "Argument to --${arg//_/-} must not be empty"
+ exit 1
+ fi
+done
+
+install_name_dir="/usr/lib"
+dylib_name="libc++.1.dylib"
+make_symlink="yes"
+
+function step() {
+ separator="$(printf "%0.s-" $(seq 1 ${#1}))"
+ echo
+ echo "${separator}"
+ echo "${1}"
+ echo "${separator}"
+}
+
+for arch in ${architectures}; do
+ step "Building libc++.dylib for architecture ${arch}"
+ mkdir -p "${build_dir}/${arch}"
+ (cd "${build_dir}/${arch}" &&
+ xcrun --sdk "${sdk}" cmake "${llvm_root}/libcxx" \
+ -GNinja \
+ -DCMAKE_MAKE_PROGRAM="$(xcrun --sdk "${sdk}" --find ninja)" \
+ -C "${cache}" \
+ -DCMAKE_INSTALL_PREFIX="${build_dir}/${arch}-install" \
+ -DCMAKE_INSTALL_NAME_DIR="${install_name_dir}" \
+ -DCMAKE_OSX_ARCHITECTURES="${arch}" \
+ -DLIBCXX_INCLUDE_BENCHMARKS=OFF \
+ -DLIBCXX_INCLUDE_TESTS=OFF
+ )
+
+ xcrun --sdk "${sdk}" cmake --build "${build_dir}/${arch}" --target install-cxx -- -v
+done
+
+step "Creating a universal dylib from the dylibs for all architectures"
+input_dylibs=$(for arch in ${architectures}; do
+ echo "${build_dir}/${arch}-install/lib/${dylib_name}"
+done)
+xcrun --sdk "${sdk}" lipo -create ${input_dylibs} -output "${build_dir}/${dylib_name}"
+
+step "Installing the (stripped) universal dylib to ${install_dir}/usr/lib"
+mkdir -p "${install_dir}/usr/lib"
+cp "${build_dir}/${dylib_name}" "${install_dir}/usr/lib/${dylib_name}"
+xcrun --sdk "${sdk}" strip -S "${install_dir}/usr/lib/${dylib_name}"
+if [[ "${make_symlink}" == "yes" ]]; then
+ (cd "${install_dir}/usr/lib" && ln -s "${dylib_name}" libc++.dylib)
+fi
+
+step "Installing the unstripped dylib and the dSYM bundle to ${symbols_dir}"
+xcrun --sdk "${sdk}" dsymutil "${build_dir}/${dylib_name}" -o "${symbols_dir}/${dylib_name}.dSYM"
+cp "${build_dir}/${dylib_name}" "${symbols_dir}/${dylib_name}"
+
+#
+# Install the headers by copying the headers from one of the built architectures
+# into the install directory. Headers from all architectures should be the same.
+#
+any_arch=$(echo ${architectures} | cut -d ' ' -f 1)
+mkdir -p "${install_dir}/usr/include"
+ditto "${build_dir}/${any_arch}-install/include" "${install_dir}/usr/include"
diff --git a/libcxx/utils/ci/apple-install-libcxxabi.sh b/libcxx/utils/ci/apple-install-libcxxabi.sh
new file mode 100755
index 000000000000..cf1e462b3225
--- /dev/null
+++ b/libcxx/utils/ci/apple-install-libcxxabi.sh
@@ -0,0 +1,172 @@
+#!/usr/bin/env bash
+#===----------------------------------------------------------------------===##
+#
+# Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
+# See https://llvm.org/LICENSE.txt for license information.
+# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+#
+#===----------------------------------------------------------------------===##
+
+set -e
+
+PROGNAME="$(basename "${0}")"
+function usage() {
+cat <<EOF
+Usage:
+${PROGNAME} [-h|--help] --llvm-root <DIR> --build-dir <DIR> --install-dir <DIR> --symbols-dir <DIR> --sdk <SDK> --architectures <architectures...> --version <X.Y.Z> --cache <PATH>
+
+--llvm-root Full path to the root of the LLVM monorepo. Only the libcxx
+ and libcxxabi directories are required.
+
+--build-dir Directory to use for building. This will contain intermediate
+ build products.
+
+--install-dir Directory to install the library to.
+
+--symbols-dir Directory to install the .dSYM bundle to.
+
+--sdk SDK used for building the library. This represents the target
+ platform that the library will run on. You can get a list of
+ SDKs with \`xcodebuild -showsdks\`.
+
+--architectures A whitespace separated list of architectures to build for.
+ The library will be built for each architecture independently,
+ and a universal binary containing all architectures will be
+ created from that.
+
+--version The version of the library to encode in the dylib.
+
+--cache The CMake cache to use to control how the library gets built.
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+ case ${1} in
+ -h|--help)
+ usage
+ exit 0
+ ;;
+ --llvm-root)
+ llvm_root="${2}"
+ shift; shift
+ ;;
+ --build-dir)
+ build_dir="${2}"
+ shift; shift
+ ;;
+ --symbols-dir)
+ symbols_dir="${2}"
+ shift; shift
+ ;;
+ --install-dir)
+ install_dir="${2}"
+ shift; shift
+ ;;
+ --sdk)
+ sdk="${2}"
+ shift; shift
+ ;;
+ --architectures)
+ architectures=""
+ shift
+ while [[ $# -gt 0 ]]; do
+ if [[ "${1}" == "-"* ]]; then
+ break
+ fi
+ architectures+=" ${1}"
+ shift
+ done
+ ;;
+ --version)
+ version="${2}"
+ shift; shift
+ ;;
+ --cache)
+ cache="${2}"
+ shift; shift
+ ;;
+ *)
+ echo "Unknown argument '${1}'"
+ exit 1
+ ;;
+ esac
+done
+
+for arg in llvm_root build_dir symbols_dir install_dir sdk architectures version cache; do
+ if [ -z ${!arg+x} ]; then
+ echo "Missing required argument '--${arg//_/-}'"
+ exit 1
+ elif [ "${!arg}" == "" ]; then
+ echo "Argument to --${arg//_/-} must not be empty"
+ exit 1
+ fi
+done
+
+function step() {
+ separator="$(printf "%0.s-" $(seq 1 ${#1}))"
+ echo
+ echo "${separator}"
+ echo "${1}"
+ echo "${separator}"
+}
+
+install_name_dir="/usr/lib"
+headers_prefix="${install_dir}"
+
+for arch in ${architectures}; do
+ step "Building libc++abi.dylib for architecture ${arch}"
+ mkdir -p "${build_dir}/${arch}"
+ (cd "${build_dir}/${arch}" &&
+ xcrun --sdk "${sdk}" cmake "${llvm_root}/libcxxabi" \
+ -GNinja \
+ -DCMAKE_MAKE_PROGRAM="$(xcrun --sdk "${sdk}" --find ninja)" \
+ -C "${cache}" \
+ -DCMAKE_INSTALL_PREFIX="${build_dir}/${arch}-install" \
+ -DCMAKE_INSTALL_NAME_DIR="${install_name_dir}" \
+ -DCMAKE_OSX_ARCHITECTURES="${arch}" \
+ -DLIBCXXABI_LIBRARY_VERSION="${version}" \
+ -DLIBCXXABI_LIBCXX_INCLUDES="$(xcrun --sdk "${sdk}" c++ -print-resource-dir)/../../../include/c++/v1"
+ )
+
+ xcrun --sdk "${sdk}" cmake --build "${build_dir}/${arch}" --target install-cxxabi -- -v
+done
+
+all_dylibs=$(for arch in ${architectures}; do
+ echo "${build_dir}/${arch}-install/lib/libc++abi.dylib"
+done)
+
+all_archives=$(for arch in ${architectures}; do
+ echo "${build_dir}/${arch}-install/lib/libc++abi.a"
+done)
+
+step "Creating a universal dylib from the dylibs for each architecture at ${install_dir}/usr/lib"
+xcrun --sdk "${sdk}" lipo -create ${all_dylibs} -output "${build_dir}/libc++abi.dylib"
+
+step "Installing the (stripped) universal dylib to ${install_dir}/usr/lib"
+mkdir -p "${install_dir}/usr/lib"
+cp "${build_dir}/libc++abi.dylib" "${install_dir}/usr/lib/libc++abi.dylib"
+xcrun --sdk "${sdk}" strip -S "${install_dir}/usr/lib/libc++abi.dylib"
+
+step "Installing the unstripped dylib and the dSYM bundle to ${symbols_dir}"
+xcrun --sdk "${sdk}" dsymutil "${build_dir}/libc++abi.dylib" -o "${symbols_dir}/libc++abi.dylib.dSYM"
+cp "${build_dir}/libc++abi.dylib" "${symbols_dir}/libc++abi.dylib"
+
+step "Creating a universal static archive from the static archives for each architecture"
+mkdir -p "${install_dir}/usr/local/lib/libcxx"
+xcrun --sdk "${sdk}" libtool -static ${all_archives} -o "${install_dir}/usr/local/lib/libcxx/libc++abi-static.a"
+
+#
+# Install the headers by copying the headers from the source directory into
+# the install directory.
+# TODO: In the future, we should install the headers through CMake.
+#
+step "Installing the libc++abi headers to ${headers_prefix}/usr/include"
+mkdir -p "${headers_prefix}/usr/include"
+ditto "${llvm_root}/libcxxabi/include" "${headers_prefix}/usr/include"
+if [[ $EUID -eq 0 ]]; then # Only chown if we're running as root
+ chown -R root:wheel "${headers_prefix}/usr/include"
+fi
+
+step "Installing the libc++abi license"
+mkdir -p "${headers_prefix}/usr/local/OpenSourceLicenses"
+cp "${llvm_root}/libcxxabi/LICENSE.TXT" "${headers_prefix}/usr/local/OpenSourceLicenses/libcxxabi.txt"
More information about the libcxx-commits
mailing list