From 77b46fb326b595e984a540e676187d4d01750e60 Mon Sep 17 00:00:00 2001 From: Louis Dionne Date: Wed, 8 Apr 2020 15:26:31 -0400 Subject: [PATCH] [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. --- libcxx/utils/ci/apple-install-libcxx.sh | 159 ++++++++++++++++++++++++++ libcxx/utils/ci/apple-install-libcxxabi.sh | 172 +++++++++++++++++++++++++++++ 2 files changed, 331 insertions(+) create mode 100755 libcxx/utils/ci/apple-install-libcxx.sh create mode 100755 libcxx/utils/ci/apple-install-libcxxabi.sh diff --git a/libcxx/utils/ci/apple-install-libcxx.sh b/libcxx/utils/ci/apple-install-libcxx.sh new file mode 100755 index 0000000..1337ca2 --- /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 < --build-dir --install-dir --symbols-dir --sdk --architectures --version --cache + +--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 0000000..cf1e462 --- /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 < --build-dir --install-dir --symbols-dir --sdk --architectures --version --cache + +--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" -- 2.7.4