OpenHarmonyllvm交叉编译工具链编译介绍

一、工具链基础介绍

1.1 工具链下载

repo init -u https://gitee.com/OpenHarmony/manifest.git -b master -m llvm-toolchain.xml
repo sync -c 
repo forall -c 'git lfs pull'
repo start master --all

1.2 环境配置

下载clang+llvm-10.0.1-x86_64-linux-gnu-ubuntu-16.04.tar.xzgithub网址,当前已经下载了,可以直接使用

bash ./toolchain/llvm-project/llvm-build/env_prepare.sh

1.3 安装依赖

1.3.1 基础组件安装

sudo apt-get install autoconf
sudo apt-get install automake
sudo apt-get install autotools-dev
sudo apt-get install texinfo
sudo apt-get install libncursesw5-dev
sudo apt-get install swig3.0
sudo apt-get install liblzma-dev
sudo apt-get install liblua5.3-dev
sudo apt-get install libedit-dev
sudo apt-get install libsphinxbase-dev
sudo apt-get install lzma-dev
sudo apt-get install swig
sudo apt-get install lua5.1
sudo apt-get install liblua5.1-dev
sudo apt install libncurses5
sudo apt install python3-sphinx
python3 -m pip install pyyaml
pip3 install -U Sphinx -i https://mirrors.aliyun.com/pypi/simple
pip3 install recommonmark -i https://mirrors.aliyun.com/pypi/simple

1.4 工具链编译

1.4.1 clang15.0.4版本全量编译

python3 ./toolchain/llvm-project/llvm-build/build.py

1.4.2 clang15.0.4版本不编译windows平台

python3 ./toolchain/llvm-project/llvm-build/build.py --no-build windows

1.4.3 clang12.0.1版本全量编译

【Note】:该版本编译不支持gtx30xx系列显卡的电脑编译

# 方法一:官方指导
repo init -u https://gitee.com/OpenHarmony/manifest.git -b master -m llvm-toolchain.xml
# 将.repo/manifests/llvm-toolchain.xml文件内容替换成https://repo.huaweicloud.com/harmonyos/compiler/clang/12.0.1-1971c8/manifest-20230313.xml里面内容
repo sync -c
repo forall -c 'git lfs pull'
./toolchain/llvm-project/llvm-build/env_prepare.sh
python3 ./toolchain/llvm-project/llvm-build/build.py
​
# 方法二:本地指导
​

二、工具链脚本介绍

文档作为基于x86_64Ubuntu20.04环境的解析,对于windows以及mac下编译直接忽略

2.1 env_prepare.sh脚本解析

脚本路径:toolchain/llvm-project/llvm-build/env_prepare.sh

Ubuntu下功能:

  • 下载cmake解压到prebuilts/cmake/linux-x86里面

  • 下载llvm解压到prebuilts/clang/ohos/linux-x86_64

  • 下载clang解压到prebuilts/clang/ohos/linux-x86_64

  • 重命名prebuilts/clang/ohos/linux-x86_64/clang+llvm-10.0.1-x86_64-linux-gnu-ubuntu-16.04prebuilts/clang/ohos/linux-x86_64/clang-10.0.1

2.1.1 设置host_platform

当前是在Ubuntu中编译,所以host_platform=linux

case $(uname -s) in
    Linux)
​
        host_platform=linux
        ;;
    Darwin)
        host_platform=darwin
        ;;
    *)
        echo "Unsupported host platform: $(uname -s)"
        exit 1
esac

2.1.2 设置host_cpu

当前使用的是x86_64,所以host_cpu=x86_64

case $(uname -m) in
    arm64)
​
        host_cpu=arm64
        ;;
    *)
        host_cpu=x86_64
esac

2.1.3 设置当前根目录路径code_dir

code_dir=$(pwd)

2.1.4 设置并创建下载安装包目录bin_dir

bin_dir=${code_dir}/download_packages
if [ ! -d "${bin_dir}" ];then
    mkdir -p "${bin_dir}"
fi

2.1.5 download_and_archive函数介绍

下载文件并解压

function download_and_archive() {
    archive_dir=$1
    download_source_url=$2
    # 获取download_source_url链接中的文件名,默认以/为分隔符
    bin_file=$(basename ${download_source_url})
    # 下载download_source_ur里的内容保存到${bin_dir}/${bin_file}文件中
    # -t3表示最大尝试链接次数为3次
    # -T10设定响应超时的秒数为10s
    # -O 把文档写到FILE文件中
    wget -t3 -T10 -O "${bin_dir}/${bin_file}" "${download_source_url}"
    if [ ! -d "${code_dir}/${archive_dir}" ];then
        mkdir -p "${code_dir}/${archive_dir}"
    fi
    # ${bin_file:0-3}表示获取bin_file的最后3个字符
    if [ "X${bin_file:0-3}" = "Xzip" ];then
        unzip -o "${bin_dir}/${bin_file}" -d "${code_dir}/${archive_dir}/"
    elif [ "X${bin_file:0-6}" = "Xtar.gz" ];then
        tar -xvzf "${bin_dir}/${bin_file}" -C "${code_dir}/${archive_dir}"
    else
        tar -xvf "${bin_dir}/${bin_file}" -C "${code_dir}/${archive_dir}"
    fi
}

2.1.6 配置下载路径和链接

copy_config="""
"""
​
copy_config_linux_x86_64="""
prebuilts/cmake,https://mirrors.huaweicloud.com/harmonyos/compiler/cmake/3.16.5/${host_platform}/cmake-${host_platform}-x86-3.16.5.tar.gz
prebuilts/clang/ohos/${host_platform}-${host_cpu},https://mirrors.huaweicloud.com/openharmony/compiler/clang/10.0.1-62608/${host_platform}/llvm.tar.gz
prebuilts/clang/ohos/${host_platform}-${host_cpu},https://github.com/llvm/llvm-project/releases/download/llvmorg-10.0.1/clang+llvm-10.0.1-x86_64-linux-gnu-ubuntu-16.04.tar.xz
"""
​
copy_config_darwin_x86_64="""
prebuilts/cmake,https://mirrors.huaweicloud.com/harmonyos/compiler/cmake/3.16.5/${host_platform}/cmake-${host_platform}-x86-3.16.5.tar.gz
prebuilts/clang/ohos/${host_platform}-${host_cpu},https://github.com/llvm/llvm-project/releases/download/llvmorg-12.0.0/clang+llvm-12.0.0-x86_64-apple-darwin.tar.xz
"""
​
if [[ "${host_platform}" == "linux" ]]; then
    if [[ "${host_cpu}" == "x86_64" ]]; then
        copy_config+=${copy_config_linux_x86_64}
        echo "add ubuntu here"
    else
        echo "unknwon host_cpu - ${host_cpu} for linux"
    fi
elif [[ "${host_platform}" == "darwin" ]]; then
    if [[ "${host_cpu}" == "x86_64" ]]; then
        copy_config+=${copy_config_darwin_x86_64}
        echo "add x86-64 mac here"
    elif [[ "${host_cpu}" == "arm64" ]]; then
        echo "add m1 config here"
    else
        echo "unknwon host_cpu - ${host_cpu} for darwin"
    fi
else
    echo "unknown ${host_platform}"
fi
​
# 当前配置完成后
copy_config="""
prebuilts/cmake,https://mirrors.huaweicloud.com/harmonyos/compiler/cmake/3.16.5/${host_platform}/cmake-${host_platform}-x86-3.16.5.tar.gz
prebuilts/clang/ohos/${host_platform}-${host_cpu},https://mirrors.huaweicloud.com/openharmony/compiler/clang/10.0.1-62608/${host_platform}/llvm.tar.gz
prebuilts/clang/ohos/${host_platform}-${host_cpu},https://github.com/llvm/llvm-project/releases/download/llvmorg-10.0.1/clang+llvm-10.0.1-x86_64-linux-gnu-ubuntu-16.04.tar.xz
"""

2.1.7 下载代码

for i in $(echo ${copy_config})
do
    unzip_dir=$(echo $i|awk -F ',' '{print $1}')
    remote_url=$(echo $i|awk -F ',' '{print $2}')
    download_and_archive "${unzip_dir}" "${remote_url}"
done

2.1.8 配置工具链

# 不执行
if [ -d "${code_dir}/prebuilts/clang/ohos/linux-x86_64/clang-62608" ];then
    rm -rf "${code_dir}/prebuilts/clang/ohos/linux-x86_64/llvm"
    mv "${code_dir}/prebuilts/clang/ohos/linux-x86_64/clang-62608" "${code_dir}/prebuilts/clang/ohos/linux-x86_64/llvm"
    ln -snf 10.0.1 "${code_dir}/prebuilts/clang/ohos/linux-x86_64/llvm/lib/clang/current"
fi
​
# 执行
if [ -d "${code_dir}/prebuilts/clang/ohos/linux-x86_64/clang+llvm-10.0.1-x86_64-linux-gnu-ubuntu-16.04" ];then
    rm -rf "${code_dir}/prebuilts/clang/ohos/linux-x86_64/clang-10.0.1"
    mv "${code_dir}/prebuilts/clang/ohos/linux-x86_64/clang+llvm-10.0.1-x86_64-linux-gnu-ubuntu-16.04" "${code_dir}/prebuilts/clang/ohos/linux-x86_64/clang-10.0.1"
fi
​
# 不执行
if [ -d "${code_dir}/prebuilts/clang/ohos/darwin-x86_64/clang+llvm-12.0.0-x86_64-apple-darwin" ];then
    rm -rf "${code_dir}/prebuilts/clang/ohos/darwin-x86_64/clang-10.0.1"
    mv "${code_dir}/prebuilts/clang/ohos/darwin-x86_64/clang+llvm-12.0.0-x86_64-apple-darwin" "${code_dir}/prebuilts/clang/ohos/darwin-x86_64/clang-10.0.1"
fi

2.2 build.py脚本解析

2.2.1 BuildConfig类解析

2.2.1.1 parse_args方法解析

定义所有编译的参数选项,然后返回该对象,从返回的对象中可以获取编译选项的状态

def parse_args(self):
​
    # description 用于描述该程序用来做什么
    parser = argparse.ArgumentParser(description='Process some integers.')
​
    # Options to skip build or packaging, can't skip two
    # 创建一个互斥组,确保互斥组中只有一个参数在命令行中可用
    # 参考用例:https://blog.csdn.net/weixin_36670529/article/details/113783239
    build_package_group = parser.add_mutually_exclusive_group()
    build_package_group.add_argument(
        '--skip-build',
        '-sb',
        action='store_true',
        default=False,
        help='Omit the build, perform the packaging step directly.')
​
    build_package_group.add_argument(
        '--skip-package',
        '-sp',
        action='store_true',
        default=False,
        help='Omit the packaging, perform the packaging step directly.')
​
    self.parse_add_argument(parser)
​
    known_platforms = ('windows', 'libs', 'lldb-mi', 'lldb-server', 'linux', 'check-api')
    # 将known_platforms的值以, + 空格串联起来,结果为"windows, libs, lldb-mi, lldb-server, linux, check-api"
    known_platforms_str = ', '.join(known_platforms)
​
    class SeparatedListByCommaAction(argparse.Action):
        # 把类当做一个方法使用
        # 参考用例:https://zhuanlan.zhihu.com/p/165245990
        def __call__(self, parser, namespace, vals, option_string):
            for val in vals.split(','):
                if val in known_platforms:
                    continue
                else:
                    error = '\'{}\' invalid.  Choose from {}'.format(val, known_platforms)
                    raise argparse.ArgumentError(self, error)
            setattr(namespace, self.dest, vals.split(','))
​
    parser.add_argument(
        '--no-build',
        action=SeparatedListByCommaAction,
        default=list(),
        help='Don\'t build toolchain for specified platforms.  Choices: ' + known_platforms_str)
​
    return parser.parse_args()

2.2.1.2 parse_add_argument方法解析

增加运行命令的可能参数

@staticmethod
def parse_add_argument(parser):
​
    parser.add_argument(
        '--enable-assertions',
        action='store_true',
        default=False,
        help='Apply assertions, some parameters are affected.')
​
    parser.add_argument(
        '--build-name',
        default='dev',
        help='Release name for the package.')
​
    parser.add_argument(
        '--debug',
        action='store_true',
        default=False,
        help='Building Clang and LLVM Tools for Debugging (only affects stage2)')
​
    parser.add_argument(
        '--strip',
        action='store_true',
        default=False,
        help='Strip final LLVM binaries.')
​
    parser.add_argument(
        '--no-build-arm',
        action='store_true',
        default=False,
        help='Omit build os target: arm.')
​
    parser.add_argument(
        '--no-build-aarch64',
        action='store_true',
        default=False,
        help='Omit build os target: aarch64.')
​
    parser.add_argument(
        '--no-build-riscv64',
        action='store_true',
        default=False,
        help='Omit build os target: 64-bit RISC-V.')
​
    parser.add_argument(
        '--no-build-mipsel',
        action='store_true',
        default=False,
        help='Omit build os target: mipsel.')
​
    parser.add_argument(
        '--no-build-x86_64',
        action='store_true',
        default=False,
        help='Omit build os target: x86_64.')
​
    parser.add_argument(
        '--no-lto',
        action='store_true',
        default=False,
        help='Accelerate builds by disabling LTO (only affects llvm product)')
​
    parser.add_argument(
        '--build-instrumented',
        action='store_true',
        default=False,
        help='Using the PGO instrumentation to build LLVM tool')
​
    parser.add_argument(
        '--xunit-xml-output',
        default=None,
        help='Output path for LLVM unit tests XML report')

2.2.1.3 discover_paths方法解析

设置各种路径

def discover_paths(self):
    # 获取当前脚本所在目录的绝对路径
    self.LLVM_BUILD_DIR = os.path.abspath(os.path.dirname(__file__))

	# 获取脚本所在的目录的父目录名称
    parent_of_llvm_build = os.path.basename(os.path.dirname(self.LLVM_BUILD_DIR))
    if parent_of_llvm_build == 'toolchain':
        # 设置编译root路径
        self.REPOROOT_DIR = os.path.abspath(os.path.join(self.LLVM_BUILD_DIR, '../..'))
    else:
        assert parent_of_llvm_build == 'llvm-project'
        self.REPOROOT_DIR = os.path.abspath(os.path.join(self.LLVM_BUILD_DIR, '../../..'))

    # 设置llvm-project路径
    self.LLVM_PROJECT_DIR = os.path.join(self.REPOROOT_DIR, 'toolchain', 'llvm-project')
    # 设置out路径
    self.OUT_PATH = os.path.join(self.REPOROOT_DIR, 'out')

2.2.1.4 logging.basicConfig方法解析

logging.basicConfig(level=logging.INFO)

2.2.2 ClangVersion类解析

2.2.2.1 _parse_version_file方法解析

从version_file文件中获取major、minor、patch的值

def _parse_version_file(self, version_file):
    with open(version_file, 'r') as fp:
        text = fp.read()
    self.major = self._parse(text, 'CLANG_VERSION_MAJOR')
    self.minor = self._parse(text, 'CLANG_VERSION_MINOR')
    self.patch = self._parse(text, 'CLANG_VERSION_PATCHLEVEL')

2.2.2.2 _parse方法解析

通过正则表达式来获取字符串中变量对应的值

@staticmethod
def _parse(text, key):
    # %s 表示搜索到匹配key字符串
    # \s+ 表示匹配一个或多个空白符合(空格、回车、Tab等)
    # () 表示提取匹配字符串
    # \d+ 表示一个或多个数字
    # 整个意思是查找每个key字符串后提取后面的数字
    return re.findall(r'%s\s+(\d+)' % key, text)[0]

2.2.2.3 long_version方法解析

major、minor、patchmajor.minor.patch连接

def long_version(self):
    return '.'.join([self.major, self.minor, self.patch])

2.2.2.4 short_version方法解析

major、minormajor.minor连接

def short_version(self):
    return '.'.join([self.major, self.minor])

2.2.2.5 major_version方法解析

def major_version(self):
    return self.major

2.2.3 BuildUtils类解析

2.2.3.0 __init__方法解析

def __init__(self, build_config):
    self.build_config = build_config
​
    # 结果是prebuilts/cmake/linux-x86/bin
    self.CMAKE_BIN_DIR = os.path.abspath(
        os.path.join(self.build_config.REPOROOT_DIR, 'prebuilts/cmake', self.platform_prefix(), 'bin'))

2.2.3.1 platform_prefix方法解析

基于Ubuntux86_64架构直接返回linux-x86

def platform_prefix(self):
    prefix = self.use_platform()
    if (prefix.endswith('x86_64')):
        return prefix[:-3]
    return prefix

2.2.3.2 use_platform方法解析

直接返回的是linux-x86_64

@staticmethod
def use_platform():
    # 以小写字母返回当前系统名称,这里返回的是linux
    sysstr = platform.system().lower()
    # 返回当前的架构类型,这里返回的是x86_64
    arch = platform.machine()
    return "%s-%s" % (sysstr, arch)

2.2.3.3 open_ohos_triple方法解析

返回值推测是${arch}-linux-ohos

def open_ohos_triple(self, arch):
    return arch + self.build_config.OPENHOS_SFX

2.2.3.4 liteos_triple方法解析

返回值推测是${arch}-liteos-ohos

def liteos_triple(self, arch):
    return arch + self.build_config.LITEOS_SFX

2.2.3.4 set_clang_version方法解析

prebuilts/clang/ohos/linux-x86_64/clang-10.0.1/include/clang/Basic/Version.inc文件中获取long_version,结果是10.0.1

def set_clang_version(self, install_dir):
    self.build_config.VERSION = self.get_clang_version(install_dir).long_version()

2.2.3.5 get_clang_version方法解析

打开prebuilts/clang/ohos/linux-x86_64/clang-10.0.1/include/clang/Basic/Version.inc文件,用于获取其中的version

@staticmethod
def get_clang_version(llvm_install):
    version_file = os.path.join(llvm_install, 'include', 'clang', 'Basic',
                            'Version.inc')
    return ClangVersion(version_file)

2.2.3.5 invoke_ninja方法解析

def invoke_ninja(self,
                 out_path,
                 env,
                 target=None,
                 install=True,
                 build_threads=False):

    # 获取的ninja路径为:prebuilts/cmake/linux-x86/bin/ninja
    ninja_bin_path = os.path.join(self.CMAKE_BIN_DIR, 'ninja')

    ninja_list = ['-l{}'.format(build_threads)] if build_threads else []

    ninja_target = [target] if target else []

    self.check_call([ninja_bin_path] + ninja_list + ninja_target, cwd=out_path, env=env)
    if install:
        self.check_call([ninja_bin_path, 'install'], cwd=out_path, env=env)

2.2.3.6 check_call方法解析

def check_call(self, cmd, *args, **kwargs):
    """subprocess.check_call with logging."""
    self.logger().info('check_call:%s %s',
                       datetime.datetime.now().strftime("%H:%M:%S"), subprocess.list2cmdline(cmd))

    subprocess.check_call(cmd, *args, **kwargs)

2.2.3.7 invoke_cmake方法解析

def invoke_cmake(self,
                 cmake_path,
                 out_path,
                 invoke_defines,
                 env):

    cmake_bin_path = os.path.join(self.CMAKE_BIN_DIR, 'cmake')
    # 设置后面编译使用Ninja
    flags = ['-G', 'Ninja']
    flags += ['-DCMAKE_PREFIX_PATH=%s' % self.CMAKE_BIN_DIR]

    for key in invoke_defines:
        # 将invoke_defines中的宏定义字典按照'-Dkey=value'重新组合
        newdef = ''.join(['-D', key, '=', invoke_defines[key]])
        flags += [newdef]

    flags += [cmake_path]
    self.check_create_dir(out_path)

    self.check_call([cmake_bin_path] + flags, cwd=out_path, env=env)

# 具体的执行命令形式可能是这样的
# cmake -G "Ninja" \
#   -DCOMPILER_RT_BUILD_BUILTINS=ON \
#   -DCOMPILER_RT_INCLUDE_TESTS=OFF \
#   -DCOMPILER_RT_BUILD_SANITIZERS=ON \
#   -DCOMPILER_RT_BUILD_XRAY=ON \
#   -DCOMPILER_RT_BUILD_LIBFUZZER=ON \
#   -DCOMPILER_RT_BUILD_PROFILE=ON \
#   -DCOMPILER_RT_DEFAULT_TARGET_ONLY=ON \
#   -DCMAKE_C_COMPILER=clang \
#   -DCMAKE_CXX_COMPILER=clang++ \
#   -DCMAKE_ASM_COMPILER_TARGET="riscv64-unknown-linux-gnu" \
#   -DCMAKE_C_COMPILER_TARGET="riscv64-unknown-linux-gnu" \
#   -DCMAKE_CXX_COMPILER_TARGET="riscv64-unknown-linux-gnu" \
#   -DCMAKE_ASM_FLAGS="-O2 --gcc-toolchain=/home/wen_fei/toolchains/riscv64-gnu-gcc -march=rv64imafdc -mabi=lp64d -mno-relax" \
#   -DCMAKE_C_FLAGS="-O2 --gcc-toolchain=/home/wen_fei/toolchains/riscv64-gnu-gcc -march=rv64imafdc -mabi=lp64d -mno-relax" \
#   -DCMAKE_CXX_FLAGS="-O2 --gcc-toolchain=/home/wen_fei/toolchains/riscv64-gnu-gcc -march=rv64imafdc -mabi=lp64d -mno-relax" \
#   -DCMAKE_EXE_LINKER_FLAGS="-z separate-code" \
#   -DCMAKE_SYSROOT="/home/wen_fei/toolchains/riscv64-gnu-gcc/sysroot" \
#   -DCMAKE_INSTALL_PREFIX="/home/wen_fei/toolchains/sysroot" \
#   -DCMAKE_C_COMPILER_WORKS=1 \
#   -DCMAKE_CXX_COMPILER_WORKS=1 \
#   -DCMAKE_SIZEOF_VOID_P=8 \
#   ../compiler-rt

2.2.3.8 check_create_dir方法解析

递归创建目录

def check_create_dir(self, path):
    if not os.path.exists(path):
        """Proxy for os.makedirs with logging and dry-run support."""
        self.logger().info('makedirs %s', path)
        os.makedirs(path)

2.2.3.9 check_rm_tree方法解析

递归删除目录

def check_rm_tree(self, tree_dir):
    """Removes directory tree."""
    def chmod_and_retry(func, path, _):
        if not os.access(path, os.W_OK):
            os.chmod(path, stat.S_IWUSR)
            return func(path)
        raise IOError("rmtree on %s failed" % path)

    if os.path.exists(tree_dir):
        self.logger().info('shutil rmtree %s', tree_dir)
        shutil.rmtree(tree_dir, οnerrοr=chmod_and_retry)

2.2.3.10 check_copy_tree方法解析

拷贝目录

def check_copy_tree(self, src_dir, dst_dir):
    self.check_rm_tree(dst_dir)
    """Proxy for shutil.copytree with logging and dry-run support."""
    self.logger().info('copytree %s %s', src_dir, dst_dir)
    shutil.copytree(src_dir, dst_dir, symlinks=True)

2.2.3.11 check_copy_file方法解析

拷贝文件

def check_copy_file(self, src_file, dst_file):
    if os.path.exists(src_file):
        """Proxy for shutil.copy2 with logging and dry-run support."""
        self.logger().info('copy %s %s', src_file, dst_file)
        shutil.copy2(src_file, dst_file)

2.2.3.12 check_call方法解析

创建子进程执行命令

def check_call(self, cmd, *args, **kwargs):
    """subprocess.check_call with logging."""
    self.logger().info('check_call:%s %s',
                       datetime.datetime.now().strftime("%H:%M:%S"), subprocess.list2cmdline(cmd))

    # 创建子进程执行cmd命令,如果命令执行成功返回0,否则抛出异常,也可以使用subprocess.Popen接口
    subprocess.check_call(cmd, *args, **kwargs)

2.2.3.13 merge_out_path方法解析

返回输出路径

def merge_out_path(self, *args):
    return os.path.abspath(os.path.join(self.build_config.OUT_PATH, *args))

2.2.3.14 host_is_linux方法解析

判断是否为linux,这里返回的是True

def host_is_linux(self):
    return self.use_platform().startswith('linux-')

2.2.3.15 host_is_darwin方法解析

def host_is_darwin(self):
    return self.use_platform().startswith('darwin-')

2.2.3.16 rm_cmake_cache方法解析

def rm_cmake_cache(self, cache_dir):
    os.walk()主要用来扫描某个指定目录下所包含的子目录和文件
    for dirpath, dirs, files in os.walk(cache_dir):
        if 'CMakeCache.txt' in files:
            self.logger().info('rm CMakeCache.txt on %s', cache_dir)
            os.remove(os.path.join(dirpath, 'CMakeCache.txt'))
        if 'CMakeFiles' in dirs:
            self.logger().info('rm CMakeFiles on %s', cache_dir)
            self.check_rm_tree(os.path.join(dirpath, 'CMakeFiles'))

2.2.3.17 find_program方法解析

返回命令的路径

@staticmethod
def find_program(name):
    # FIXME: Do we need Windows support here?
    return os.popen('which ' + name).read().strip()

2.2.3.18 base_cmake_defines方法解析

以字典形式定义了cmake编译的基本选项

def base_cmake_defines(self):
    mac_min_version = '10.9'
    defines = {}

    defines['CMAKE_BUILD_TYPE'] = 'Release'
    defines['LLVM_ENABLE_ASSERTIONS'] = 'OFF'
    defines['LLVM_ENABLE_TERMINFO'] = 'OFF'
    defines['LLVM_ENABLE_THREADS'] = 'ON'
    defines['LLVM_USE_NEWPM'] = 'ON'
    defines['LLVM_ENABLE_BINDINGS'] = 'OFF'
    defines['CLANG_REPOSITORY_STRING'] = 'llvm-project'

    if self.host_is_darwin():
        defines['CMAKE_OSX_DEPLOYMENT_TARGET'] = mac_min_version
        defines['LLDB_INCLUDE_TESTS'] = 'OFF'
        defines['LIBCXX_INCLUDE_TESTS'] = 'OFF'

    defines['COMPILER_RT_BUILD_XRAY'] = 'OFF'
    return defines

2.2.4 LlvmCore

2.2.4.1 build_llvm方法解析

执行编译命令

def build_llvm(self,
               targets,
               build_dir,
               install_dir,
               build_name,
               extra_defines=None,
               extra_env=None):
​
    # 获取cmake编译的基本选项
    common_defines = self.base_cmake_defines()
    common_defines['CMAKE_INSTALL_PREFIX'] = install_dir
    common_defines['LLVM_INSTALL_UTILS'] = 'ON'
    common_defines['LLVM_TARGETS_TO_BUILD'] = targets
    common_defines['LLVM_BUILD_LLVM_DYLIB'] = 'ON'
​
    build_number = ''
    # 字符串必须是数字-非数字组合才能匹配,例如: 1234-abcd
    # \d+ 表示至少匹配一个数字
    # - 表示要匹配一个字符'-'
    # . 表示任意一个字符
    # \D* 表示匹配任意的非数字的字符
    # $ 表示直到结尾
    if re.match(r'\d+-.\D*$', build_name):
        build_number, build_name = build_name.split('-', 1)
    # ^\d+$ 表示匹配全数字字符串
    elif re.match(r'^\d+$', build_name):
        build_number = build_name
        build_name = ''
    # ^\D+$ 表示匹配全非数字字符串
    elif re.match(r'^\D+$', build_name):
        build_name = build_name
    else:
        raise Exception('Warning! Build name is invalid, because it must not contain digits. '
                        'If you want to pass digit version, please, use follow template: {NUMBER}-{SUFFIX} '
                        'or just pass number. Otherwise unit tests will fail with assertions')
​
    common_defines['CLANG_VENDOR'] = 'OHOS (%s) ' % build_name
    common_defines['CLANG_VENDOR_BUILD_VERSION'] = build_number
    common_defines.update(extra_defines)
​
    env = dict(self.build_config.ORIG_ENV)
    if extra_env is not None:
        env.update(extra_env)
​
    llvm_project_path = os.path.abspath(os.path.join(self.build_config.LLVM_PROJECT_DIR, 'llvm'))
​
    # 执行cmake命令生成ninja编译的环境
    self.invoke_cmake(llvm_project_path,
                      build_dir,
                      common_defines,
                      env=env)
​
    # 调用ninja进行编译
    self.invoke_ninja(out_path=build_dir,
                      env=env,
                      target=None,
                      install=True)

2.2.4.2 llvm_compile_darwin_defines方法解析

设置darwin环境编译的红

def llvm_compile_darwin_defines(self, llvm_defines):
    if self.host_is_darwin():
        llvm_defines['LIBUNWIND_ENABLE_SHARED'] = 'OFF'
        llvm_defines['LLDB_ENABLE_LIBEDIT'] = 'OFF'
        llvm_defines['LLDB_NO_DEBUGSERVER'] = 'ON'
        llvm_defines['LLDB_ENABLE_PYTHON'] = 'ON'
        llvm_defines['COMPILER_RT_BUILD_LIBFUZZER'] = 'OFF'
        llvm_defines['LLVM_BUILD_EXTERNAL_COMPILER_RT'] = 'ON'

2.2.4.3 llvm_compile_linux_defines方法解析

定义linux编译的宏

def llvm_compile_linux_defines(self,
                               llvm_defines,
                               debug_build=False,
                               no_lto=False,
                               build_instrumented=False):
    if self.host_is_linux():
        llvm_defines['LLVM_ENABLE_LLD'] = 'ON'
        llvm_defines['COMPILER_RT_BUILD_LIBFUZZER'] = 'ON'
        llvm_defines['LIBCXX_ENABLE_STATIC_ABI_LIBRARY'] = 'ON'
        llvm_defines['LIBCXX_ENABLE_ABI_LINKER_SCRIPT'] = 'OFF'
        llvm_defines['LIBCXX_USE_COMPILER_RT'] = 'ON'
        llvm_defines['LIBCXXABI_USE_LLVM_UNWINDER'] = 'ON'
        llvm_defines['LIBCXXABI_ENABLE_STATIC_UNWINDER'] = 'ON'
        llvm_defines['LIBCXXABI_STATICALLY_LINK_UNWINDER_IN_STATIC_LIBRARY'] = 'YES'
        llvm_defines['LIBCXXABI_USE_COMPILER_RT'] = 'ON'
        llvm_defines['COMPILER_RT_USE_LLVM_UNWINDER'] = 'ON'
        llvm_defines['COMPILER_RT_ENABLE_STATIC_UNWINDER'] = 'ON'
        llvm_defines['COMPILER_RT_USE_BUILTINS_LIBRARY'] = 'ON'
        llvm_defines['COMPILER_RT_BUILD_ORC'] = 'OFF'
        llvm_defines['LIBUNWIND_USE_COMPILER_RT'] = 'ON'
        llvm_defines['LLVM_BINUTILS_INCDIR'] = '/usr/include'

        if not build_instrumented and not no_lto and not debug_build:
            llvm_defines['LLVM_ENABLE_LTO'] = 'Thin'

2.2.4.4 llvm_compile_llvm_defines方法解析

定义llvm编译的宏

@staticmethod
def llvm_compile_llvm_defines(llvm_defines, llvm_root, cflags, ldflags):
    llvm_defines['LLVM_ENABLE_PROJECTS'] = 'clang;lld;clang-tools-extra;openmp;lldb'
    llvm_defines['LLVM_ENABLE_RUNTIMES'] = 'libunwind;libcxxabi;libcxx;compiler-rt'
    llvm_defines['LLVM_ENABLE_BINDINGS'] = 'OFF'
    llvm_defines['CMAKE_C_COMPILER'] = os.path.join(llvm_root, 'bin', 'clang')
    llvm_defines['CMAKE_CXX_COMPILER'] = os.path.join(llvm_root, 'bin', 'clang++')
    llvm_defines['CMAKE_AR'] = os.path.join(llvm_root, 'bin', 'llvm-ar')
    llvm_defines['CMAKE_RANLIB'] = os.path.join(llvm_root, 'bin', 'llvm-ranlib')
    llvm_defines['LLVM_ENABLE_LIBCXX'] = 'ON'
    llvm_defines['SANITIZER_ALLOW_CXXABI'] = 'OFF'
    llvm_defines['LIBOMP_ENABLE_SHARED'] = 'FALSE'
    llvm_defines['OPENMP_TEST_FLAGS'] = '-Wl,-ldl'
    llvm_defines['CLANG_BUILD_EXAMPLES'] = 'OFF'
    llvm_defines['LLDB_ENABLE_LIBEDIT'] = 'OFF'
    llvm_defines['LLDB_ENABLE_PYTHON'] = 'ON'
    llvm_defines['COMPILER_RT_BUILD_SANITIZERS'] = 'OFF'
    llvm_defines['COMPILER_RT_BUILD_MEMPROF'] = 'OFF'
    llvm_defines['CMAKE_ASM_FLAGS'] = cflags
    llvm_defines['CMAKE_C_FLAGS'] = cflags
    llvm_defines['CMAKE_CXX_FLAGS'] = '%s -stdlib=libc++' % cflags
    llvm_defines['CMAKE_EXE_LINKER_FLAGS'] = ldflags
    llvm_defines['CMAKE_SHARED_LINKER_FLAGS'] = ldflags
    llvm_defines['CMAKE_MODULE_LINKER_FLAGS'] = ldflags

2.2.4.5 llvm_compile方法解析

配置相关的宏,然后调用编译

python中基础数据类型,如:int、float、str等是值传递,对于list、dict、tuple等是地址传递

def llvm_compile(self,
                 build_name,
                 out_dir,
                 debug_build=False,
                 no_lto=False,
                 build_instrumented=False,
                 xunit_xml_output=None):
​
    llvm_clang_install = os.path.abspath(os.path.join(self.build_config.REPOROOT_DIR,
                                                      'prebuilts/clang/ohos', self.use_platform(),
                                                      'clang-%s' % self.build_config.CLANG_VERSION))
    llvm_path = self.merge_out_path('llvm_make')
    llvm_profdata = os.path.join(llvm_clang_install, 'bin', 'llvm-profdata')
​
    if self.host_is_darwin():
        ldflags = ''
    else:
        ldflags = '-fuse-ld=lld'
    ldflags = '%s -L%s' % (ldflags, os.path.join(llvm_clang_install, 'lib'))
​
    llvm_extra_env = {}
    llvm_extra_env['LD_LIBRARY_PATH'] = os.path.join(llvm_clang_install, 'lib')
​
    llvm_defines = {}
​
    self.llvm_compile_darwin_defines(llvm_defines)
    self.llvm_compile_linux_defines(llvm_defines, debug_build, no_lto, build_instrumented)
​
    if self.host_is_linux():
        ldflags += ' -l:libunwind.a -l:libc++abi.a --rtlib=compiler-rt -stdlib=libc++ -static-libstdc++'
​
    if xunit_xml_output:
        llvm_defines['LLVM_LIT_ARGS'] = "--xunit-xml-output={} -sv".format(xunit_xml_output)
​
    if self.build_config.enable_assertions:
        llvm_defines['LLVM_ENABLE_ASSERTIONS'] = 'ON'
​
    if debug_build:
        llvm_defines['CMAKE_BUILD_TYPE'] = 'Debug'
​
    if build_instrumented:
        llvm_defines['LLVM_BUILD_INSTRUMENTED'] = 'ON'
        llvm_defines['LLVM_PROFDATA'] = llvm_profdata
​
        resource_dir = "lib/clang/10.0.1/lib/linux/libclang_rt.profile-x86_64.a"
        ldflags += ' %s' % os.path.join(llvm_clang_install, resource_dir)
​
    cflags = '-fstack-protector-strong -fPIE'
    if not self.host_is_darwin():
        ldflags += ' -Wl,-z,relro,-z,now -pie'
        if self.build_config.strip:
            ldflags += ' -s'
​
    self.llvm_compile_llvm_defines(llvm_defines, llvm_clang_install, cflags, ldflags)
​
    linker_path = os.path.abspath(os.path.join(self.build_config.REPOROOT_DIR, 'prebuilts', 'clang',
        'ohos', 'linux-x86_64', 'llvm', 'bin', 'ld.lld'))
    llvm_defines['CMAKE_LINKER'] = linker_path
​
    self.build_llvm(targets=self.build_config.TARGETS,
                    build_dir=llvm_path,
                    install_dir=out_dir,
                    build_name=build_name,
                    extra_defines=llvm_defines,
                    extra_env=llvm_extra_env)

2.2.4.6 llvm_compile_windows_defines方法解析

windows环境宏定义

def llvm_compile_windows_defines(self,
                                 windows_defines,
                                 cc,
                                 cxx,
                                 windows_sysroot):
​
    if self.build_config.enable_assertions:
​
        windows_defines['LLVM_ENABLE_ASSERTIONS'] = 'ON'
​
    windows_defines['LLDB_RELOCATABLE_PYTHON'] = 'OFF'
    win_sysroot = self.merge_out_path('mingw', self.build_config.MINGW_TRIPLE)
    windows_defines['LLDB_ENABLE_PYTHON'] = 'ON'
    windows_defines['LLDB_PYTHON_HOME'] = 'python'
    windows_defines['LLDB_PYTHON_RELATIVE_PATH'] = \
      'bin/python/lib/python%s' % (self.build_config.LLDB_PY_VERSION)
    windows_defines['LLDB_PYTHON_EXE_RELATIVE_PATH'] = 'bin/python'
    windows_defines['LLDB_PYTHON_EXT_SUFFIX'] = '.pys'
    windows_defines['PYTHON_INCLUDE_DIRS'] = os.path.join(win_sysroot,
                                    'include', 'python%s' % self.build_config.LLDB_PY_VERSION)
    windows_defines['PYTHON_LIBRARIES'] = os.path.join(win_sysroot, 'lib', 'libpython%s.dll.a'
                                                        % self.build_config.LLDB_PY_VERSION)
    windows_defines['SWIG_EXECUTABLE'] = self.find_program('swig')
    windows_defines['PYTHON_EXECUTABLE'] = self.find_program('python3')
​
    windows_defines['CMAKE_C_COMPILER'] = cc
    windows_defines['CMAKE_CXX_COMPILER'] = cxx
    windows_defines['CMAKE_SYSTEM_NAME'] = 'Windows'
    windows_defines['CMAKE_BUILD_TYPE'] = 'Release'
    windows_defines['LLVM_BUILD_RUNTIME'] = 'OFF'
    windows_defines['LLVM_TOOL_CLANG_TOOLS_EXTRA_BUILD'] = 'ON'
    windows_defines['LLVM_TOOL_OPENMP_BUILD'] = 'OFF'
    windows_defines['LLVM_INCLUDE_TESTS'] = 'OFF'
    windows_defines['LLVM_ENABLE_LIBCXX'] = 'ON'
    windows_defines['LLVM_ENABLE_PROJECTS'] = 'clang;clang-tools-extra;lld;lldb'
    windows_defines['LLVM_BUILD_LLVM_DYLIB'] = 'OFF'
    windows_defines['CLANG_BUILD_EXAMPLES'] = 'OFF'
    windows_defines['CMAKE_SYSROOT'] = windows_sysroot
    windows_defines['CMAKE_FIND_ROOT_PATH_MODE_INCLUDE'] = 'ONLY'
    windows_defines['CMAKE_FIND_ROOT_PATH_MODE_LIBRARY'] = 'ONLY'
    windows_defines['CMAKE_FIND_ROOT_PATH_MODE_PACKAGE'] = 'ONLY'
    windows_defines['CMAKE_FIND_ROOT_PATH_MODE_PROGRAM'] = 'NEVER'
    windows_defines['LLDB_ENABLE_LIBEDIT'] = 'OFF'
    windows_defines['LLDB_RELOCATABLE_PYTHON'] = 'OFF'

2.2.4.7 llvm_compile_windows_flags方法解析

windows环境宏定义

def llvm_compile_windows_flags(self,
                               windows_defines,
                               windowstool_path,
                               windows64_install,
                               ldflags,
                               cflags):

    windows_defines['CROSS_TOOLCHAIN_FLAGS_NATIVE'] = ';'.join([
        '-DCMAKE_PREFIX_PATH=%s' % self.CMAKE_BIN_DIR,
        '-DCOMPILER_RT_BUILD_LIBFUZZER=OFF',
        '-DLLVM_ENABLE_LIBCXX=ON',
        '-DCMAKE_BUILD_WITH_INSTALL_RPATH=TRUE',
        '-DCMAKE_INSTALL_RPATH=%s' % os.path.join(windowstool_path, 'lib')]
    )

    ldflag = ['-fuse-ld=lld',
              '-stdlib=libc++',
              '--rtlib=compiler-rt',
              '-lunwind', '-Wl,--dynamicbase',
              '-Wl,--nxcompat',
              '-lucrt',
              '-lucrtbase',
              '-L',
              os.path.join(windows64_install, 'lib'),
              '-Wl,--high-entropy-va']
    ldflags.extend(ldflag)

    cflag = ['-stdlib=libc++',
             '--target=x86_64-pc-windows-gnu',
             '-D_LARGEFILE_SOURCE',
             '-D_FILE_OFFSET_BITS=64',
             '-D_WIN32_WINNT=0x0600',
             '-DWINVER=0x0600',
             '-D__MSVCRT_VERSION__=0x1400',
             '-DMS_WIN64']
    cflags.extend(cflag)

2.2.4.8 llvm_compile_windows_cmake方法解析

windows环境宏定义

def llvm_compile_windows_cmake(self,
                               cflags,
                               cxxflags,
                               ldflags,
                               windows_defines):


    zlib_path = self.merge_out_path('../', 'prebuilts', 'clang', 'host', 'windows-x86', 'toolchain-prebuilts',
                                    'zlib')
    zlib_inc = os.path.join(zlib_path, 'include')
    zlib_lib = os.path.join(zlib_path, 'lib')

    cflags.extend(['-I', zlib_inc])
    cxxflags.extend(['-I', zlib_inc])
    ldflags.extend(['-L', zlib_lib])

    windows_defines['CMAKE_ASM_FLAGS'] = ' '.join(cflags)
    windows_defines['CMAKE_C_FLAGS'] = ' '.join(cflags)
    windows_defines['CMAKE_CXX_FLAGS'] = ' '.join(cxxflags)
    windows_defines['CMAKE_EXE_LINKER_FLAGS'] = ' '.join(ldflags)
    windows_defines['CMAKE_SHARED_LINKER_FLAGS'] = ' '.join(ldflags)
    windows_defines['CMAKE_MODULE_LINKER_FLAGS'] = ' '.join(ldflags)

2.2.4.9 llvm_compile_for_windows方法解析

windows环境编译

def llvm_compile_for_windows(self,
                             targets,
                             enable_assertions,
                             build_name):

    self.logger().info('Building llvm for windows.')

    build_dir = self.merge_out_path("windows-x86_64")
    windowstool_path = self.merge_out_path('llvm-install')
    windows64_install = self.merge_out_path('windows-x86_64-install')
    windows_sysroot = self.merge_out_path('mingw', self.build_config.MINGW_TRIPLE)

    self.check_create_dir(build_dir)

    # Write a NATIVE.cmake in windows_path that contains the compilers used
    # to build native tools such as llvm-tblgen and llvm-config.  This is
    # used below via the CMake variable CROSS_TOOLCHAIN_FLAGS_NATIVE.
    cc = os.path.join(windowstool_path, 'bin', 'clang')
    cxx = os.path.join(windowstool_path, 'bin', 'clang++')

    # Extra cmake defines to use while building for Windows
    windows_defines = {}
    self.llvm_compile_windows_defines(windows_defines, cc, cxx, windows_sysroot)

    # Set CMake path, toolchain file for native compilation (to build tablegen
    # etc).  Also disable libfuzzer build during native compilation.

    ldflags = []
    cflags = []

    self.llvm_compile_windows_flags(windows_defines,
        windowstool_path, windows64_install, ldflags, cflags)

    cxxflags = list(cflags)

    windows_extra_env = dict()

    cxxflags.append('-fuse-cxa-atexit')
    cxxflags.extend(('-I', os.path.join(windows64_install, 'include', 'c++', 'v1')))

    self.llvm_compile_windows_cmake(cflags, cxxflags, ldflags, windows_defines)

    self.build_llvm(self.build_config.TARGETS,
                    build_dir,
                    windows64_install,
                    build_name,
                    extra_defines=windows_defines,
                    extra_env=windows_extra_env)

2.2.5 SysrootComposer

2.2.5.1 setup_cmake_platform方法解析

重新拷贝OHOS.cmakeprebuilts/cmake/linux-x86/share/cmake-3.16/Modules/Platform目录下

def setup_cmake_platform(self, llvm_install):

    # OHOS.cmake already exsit on cmake prebuilts,
    # but it didn't contain these two lines, so we still need OHOS.cmake.
    ohos_cmake = 'OHOS.cmake'
    # 这个目录路径是 prebuilts/cmake/linux-x86/share/cmake-3.16/Modules/Platform
    dst_dir = self.merge_out_path(
        '../prebuilts/cmake/%s/share/cmake-3.16/Modules/Platform' % self.platform_prefix())
    # 这个文件路径是 toolchain/llvm-project/llvm-build/OHOS.cmake
    src_file = '%s/%s' % (self.build_config.LLVM_BUILD_DIR, ohos_cmake)
    if os.path.exists(os.path.join(dst_dir, ohos_cmake)):
        os.remove(os.path.join(dst_dir, ohos_cmake))
    shutil.copy2(src_file, dst_dir)

2.2.5.2 build_musl方法解析

调用build_musl.sh脚本执行命令

def build_musl(self, llvm_install, target, *extra_args):
    cur_dir = os.getcwd()
    os.chdir(self.build_config.LLVM_BUILD_DIR)
    self.logger().info('build musl %s', self.merge_out_path('install'))
    args = ['./build_musl.sh', '-t', target,
            '-c', self.merge_out_path(llvm_install, 'bin'),
            '-o', self.merge_out_path(),
            '-T', self.build_config.REPOROOT_DIR] + list(extra_args)
    self.check_call(args)
    os.chdir(cur_dir)

2.2.5.3 install_linux_headers方法解析

def install_linux_headers(self, arch, target):
    dir_suffix = arch
    if arch == 'x86_64':
        dir_suffix = 'x86'
    elif arch == 'mipsel':
        dir_suffix = 'mips'
    linux_kernel_dir = os.path.join('kernel_linux_patches', 'linux-5.10')
    linux_kernel_path = os.path.join(self.build_config.OUT_PATH, '..', linux_kernel_dir)
    ohosmusl_sysroot_dst = self.merge_out_path('sysroot', target, 'usr')
    headers_tmp_dir = os.path.join(linux_kernel_path, 'prebuilts', 'usr', 'include')
    self.check_copy_tree(os.path.join(headers_tmp_dir, 'linux'),
                         os.path.join(ohosmusl_sysroot_dst, 'include/linux'))
    self.check_copy_tree(os.path.join(headers_tmp_dir, 'asm-%s' % dir_suffix,'asm'),
                         os.path.join(ohosmusl_sysroot_dst, 'include', 'asm'))
    self.check_copy_tree(os.path.join(headers_tmp_dir, 'asm-generic'),
                         os.path.join(ohosmusl_sysroot_dst, 'include/asm-generic'))

2.2.5.4copy_libz_to_sysroot方法解析

def copy_libz_to_sysroot(self, libz_path, llvm_triple):
    # Install to sysroot
    dest_usr = self.merge_out_path('sysroot', llvm_triple, 'usr')
    dest_usr_include = os.path.join(dest_usr, 'include')

    # Copy over usr/include.
    zlib_h = self.merge_out_path('../third_party/zlib', 'zlib.h')
    self.check_copy_file(zlib_h, dest_usr_include)

    zconf_h = os.path.join(libz_path, 'zconf.h')
    self.check_copy_file(zconf_h, dest_usr_include)

    # Copy over usr/lib.
    dest_usr_lib = os.path.join(dest_usr, 'lib')
    static_zlib = os.path.join(libz_path, 'libz.a')
    self.check_copy_file(static_zlib, dest_usr_lib)

2.2.6 LlvmLibs

2.2.6.1 build_crt_libs方法解析

编译crt

def build_crt_libs(self, configs, llvm_install, need_lldb_server):
    for (arch, target) in configs:
        self.sysroot_composer.build_musl(llvm_install, target)
        # self.build_config.OPENHOS_SFX 值是 '-linux-ohos'
        if target.endswith(self.build_config.OPENHOS_SFX):
            self.sysroot_composer.install_linux_headers(arch, target)
        self.build_libs(need_lldb_server,
                            llvm_install,
                            target,
                            precompilation=True)
        self.sysroot_composer.build_musl(llvm_install, target, '-l')

2.2.6.2 build_libs_defines方法解析

编译库的基础宏配置

def build_libs_defines(self,
                       llvm_triple,
                       defines,
                       cc,
                       cxx,
                       ar,
                       llvm_config,
                       ldflags,
                       cflags,
                       extra_flags):

    sysroot = self.merge_out_path('sysroot')

    defines['CMAKE_C_COMPILER'] = cc
    defines['CMAKE_CXX_COMPILER'] = cxx
    defines['CMAKE_AR'] = ar
    defines['LLVM_CONFIG_PATH'] = llvm_config
    defines['CMAKE_SYSROOT'] = sysroot
    defines['CMAKE_FIND_ROOT_PATH_MODE_INCLUDE'] = 'ONLY'
    defines['CMAKE_FIND_ROOT_PATH_MODE_LIBRARY'] = 'ONLY'
    defines['CMAKE_FIND_ROOT_PATH_MODE_PACKAGE'] = 'ONLY'
    defines['CMAKE_FIND_ROOT_PATH_MODE_PROGRAM'] = 'NEVER'

    ldflag = [
            '-fuse-ld=lld',
            '-Wl,--gc-sections',
            '-Wl,--build-id=sha1',
            '--rtlib=compiler-rt',
            '-stdlib=libc++', ]

    if not self.host_is_darwin():
        ldflag.append('-Wl,-z,relro,-z,now -pie')
        if self.build_config.strip:
            ldflag.append('-s')

    ldflags.extend(ldflag)

    cflag = [
            '-fstack-protector-strong',
            '-fPIE',
            '--target=%s' % llvm_triple,
            '-ffunction-sections',
            '-fdata-sections',
            extra_flags, ]

    cflags.extend(cflag)

2.2.6.3 build_libs方法解析 # Todo

编译库

def build_libs(self, need_lldb_server, llvm_install, llvm_build, precompilation=False):
    # self.liteos_triple('arm') 返回的是'arm-linux-ohos'
    configs_list = [
        ('arm', self.liteos_triple('arm'), '-march=armv7-a -mfloat-abi=soft', ''),
        ('arm', self.liteos_triple('arm'), '-march=armv7-a -mcpu=cortex-a7 -mfloat-abi=soft', 'a7_soft'),
        ('arm', self.liteos_triple('arm'),
         '-march=armv7-a -mcpu=cortex-a7 -mfloat-abi=softfp -mfpu=neon-vfpv4', 'a7_softfp_neon-vfpv4'),
        ('arm', self.liteos_triple('arm'),
         '-march=armv7-a -mcpu=cortex-a7 -mfloat-abi=hard -mfpu=neon-vfpv4', 'a7_hard_neon-vfpv4'),
​
        ('arm', self.open_ohos_triple('arm'), '-march=armv7-a -mfloat-abi=soft', ''),
        ('arm', self.open_ohos_triple('arm'), '-march=armv7-a -mcpu=cortex-a7 -mfloat-abi=soft', 'a7_soft'),
        ('arm', self.open_ohos_triple('arm'),
         '-march=armv7-a -mcpu=cortex-a7 -mfloat-abi=softfp -mfpu=neon-vfpv4', 'a7_softfp_neon-vfpv4'),
        ('arm', self.open_ohos_triple('arm'),
         '-march=armv7-a -mcpu=cortex-a7 -mfloat-abi=hard -mfpu=neon-vfpv4', 'a7_hard_neon-vfpv4'),
        ('aarch64', self.open_ohos_triple('aarch64'), '', ''),
        ('riscv64', self.open_ohos_triple('riscv64'), '', ''),
        ('mipsel', self.open_ohos_triple('mipsel'), '-march=mips32r2', ''),
        ('x86_64', self.open_ohos_triple('x86_64'), '', ''),]
​
    cc = os.path.join(llvm_install, 'bin', 'clang')
    cxx = os.path.join(llvm_install, 'bin', 'clang++')
    ar = os.path.join(llvm_install, 'bin', 'llvm-ar')
    llvm_config = os.path.join(llvm_install, 'bin', 'llvm-config')
    seen_arch_list = [self.liteos_triple('arm')]
​
    self.set_clang_version(llvm_install)
    for (arch, llvm_triple, extra_flags, multilib_suffix) in configs_list:
        if llvm_build != llvm_triple:
            continue
​
        has_lldb_server = arch not in ['riscv64', 'mipsel']
​
        defines = {}
        ldflags = []
        cflags = []
        self.logger().info('Build libs for %s', llvm_triple)
        self.build_libs_defines(llvm_triple, defines, cc, cxx, ar, llvm_config, ldflags, cflags, extra_flags)
        if arch == 'mipsel':
            ldflags.append('-Wl,-z,notext')
            ldflags.append('-Wl,--no-check-dynamic-relocations')
​
        llvm_path = self.merge_out_path('llvm_make')
        arch_list = [self.liteos_triple('arm'), self.open_ohos_triple('arm'),
                     self.open_ohos_triple('aarch64'), self.open_ohos_triple('riscv64'),
                     self.open_ohos_triple('mipsel'), self.open_ohos_triple('x86_64')]
        if precompilation:
            self.build_crts(llvm_install, arch, llvm_triple, cflags, ldflags, multilib_suffix, defines)
            continue
        # libunwind is added to linker command line by OHOS toolchain, so we have to use two step build
        self.build_runtimes(llvm_install, "libunwind", ldflags, cflags, llvm_triple, arch, multilib_suffix, defines)
        self.build_runtimes(llvm_install, "libunwind;libcxxabi;libcxx", ldflags, cflags, llvm_triple, arch, multilib_suffix, defines)
​
        libcxx_ndk_install = self.merge_out_path('libcxx-ndk')
        libcxx_ndk_install_tmp = self.merge_out_path('libcxx-ndk-tmp')
        self.check_create_dir(libcxx_ndk_install)
        self.build_runtimes(libcxx_ndk_install_tmp, "libunwind;libcxxabi;libcxx", ldflags, cflags, llvm_triple,
                                arch, multilib_suffix, defines, libcxx_ndk_install)
​
        self.build_crts(llvm_install, arch, llvm_triple, cflags, ldflags, multilib_suffix, defines,
                            first_time=False)
​
        if llvm_triple in arch_list:
            if need_lldb_server and has_lldb_server and llvm_triple not in seen_arch_list:
                self.build_lldb_server(llvm_install, llvm_path, arch, llvm_triple, cflags, ldflags,
                                               defines)
                seen_arch_list.append(llvm_triple)
            continue
​
        self.build_libomp(llvm_install, arch, llvm_triple, cflags, ldflags, multilib_suffix, defines)
        self.build_libz(arch, llvm_triple, cflags, ldflags, defines)
        if need_lldb_server and has_lldb_server and llvm_triple not in seen_arch_list:
            self.build_lldb_server(llvm_install, llvm_path, arch, llvm_triple, cflags, ldflags, defines)
            seen_arch_list.append(llvm_triple)

2.2.6.4 build_runtimes方法解析 # Todo

编译运行时库

def build_runtimes(self,
                   llvm_install,
                   rt_list,
                   ldflags,
                   cflags,
                   llvm_triple,
                   arch,
                   multilib_suffix,
                   defines,
                   libcxx_ndk_install=None):

    self.logger().info('Building runtimes(%s) for %s', rt_list, arch)

    ndk_suffix = '-ndk' if libcxx_ndk_install else ''
    out_path = self.merge_out_path('lib', rt_list.replace(';', '-') + ndk_suffix + '-' + str(llvm_triple))

    rt_cflags = list(cflags)
    rt_cflags.append('-fstack-protector-strong')

    rt_defines = defines.copy()
    rt_defines['OHOS'] = '1'
    rt_defines['LLVM_ENABLE_PER_TARGET_RUNTIME_DIR'] = 'ON'
    rt_defines['LLVM_TARGET_MULTILIB_SUFFIX'] = multilib_suffix
    rt_defines['LLVM_DEFAULT_TARGET_TRIPLE'] = llvm_triple
    rt_defines['LLVM_ENABLE_RUNTIMES'] = rt_list
    rt_defines['LIBUNWIND_USE_COMPILER_RT'] = 'ON'
    rt_defines['LIBUNWIND_ENABLE_SHARED'] = 'OFF'
    rt_defines['LIBCXXABI_USE_COMPILER_RT'] = 'ON'
    rt_defines['LIBCXXABI_USE_LLVM_UNWINDER'] = 'ON'
    rt_defines['LIBCXXABI_ENABLE_STATIC_UNWINDER'] = 'ON'
    rt_defines['LIBCXXABI_HAS_CXA_THREAD_ATEXIT_IMPL'] = 'OFF'
    rt_defines['LIBCXXABI_ENABLE_SHARED'] = 'OFF'
    rt_defines['LIBCXXABI_LIBCXX_INCLUDES'] = os.path.abspath(os.path.join(self.build_config.LLVM_PROJECT_DIR, 'libcxx', 'include'))
    rt_defines['LIBCXX_USE_COMPILER_RT'] = 'ON'
    rt_defines['LIBCXX_ENABLE_ABI_LINKER_SCRIPT'] = 'OFF'
    rt_defines['LIBCXX_ENABLE_STATIC_ABI_LIBRARY'] = 'ON'
    rt_defines['CMAKE_ASM_FLAGS'] = ' '.join(rt_cflags)
    rt_defines['CMAKE_C_FLAGS'] = ' '.join(rt_cflags)
    rt_defines['CMAKE_CXX_FLAGS'] = ' '.join(rt_cflags)
    rt_defines['CMAKE_INSTALL_PREFIX'] = llvm_install
    rt_defines['CMAKE_SHARED_LINKER_FLAGS'] = ' '.join(ldflags)
    rt_defines['CMAKE_SYSTEM_NAME'] = 'OHOS'
    rt_defines['CMAKE_CROSSCOMPILING'] = 'True'
    rt_defines['CMAKE_TRY_COMPILE_TARGET_TYPE'] = 'STATIC_LIBRARY'

    if libcxx_ndk_install:
        rt_defines['LIBCXX_ABI_NAMESPACE'] = '__n1'
        rt_defines['LIBCXX_OUTPUT_NAME'] = 'c++_shared'
        rt_defines['LIBCXX_OUTPUT_STATIC_NAME'] = 'c++_static'
        rt_defines['LIBCXX_INSTALL_INCLUDE_DIR'] = self.merge_out_path(libcxx_ndk_install, 'include', 'libcxx-ohos', 'include', 'c++', 'v1')
        rt_defines['LIBCXX_INSTALL_LIBRARY_DIR'] = self.merge_out_path(libcxx_ndk_install, 'lib', llvm_triple, 'c++', multilib_suffix)
        rt_defines['LIBCXXABI_INSTALL_LIBRARY'] = 'OFF'
        rt_defines['LIBUNWIND_INSTALL_LIBRARY'] = 'OFF'
    else:
        rt_defines['LIBCXX_ABI_NAMESPACE'] = '__h'

    self.check_rm_tree(out_path)
    cmake_rt = os.path.abspath(os.path.join(self.build_config.LLVM_PROJECT_DIR, 'runtimes'))

    self.invoke_cmake(cmake_rt,
                      out_path,
                      rt_defines,
                      env=dict(self.build_config.ORIG_ENV))

    self.invoke_ninja(out_path=out_path,
                      env=dict(self.build_config.ORIG_ENV),
                      target=None,
                      install=True)

2.2.6.5 build_crts方法解析

def build_crts(self,
               llvm_install,
               arch,
               llvm_triple,
               cflags,
               ldflags,
               multilib_suffix,
               defines,
               first_time=True):
​
    self.logger().info('Building compiler-rt for %s', arch)
​
    suffix = '-' + multilib_suffix if multilib_suffix else ''
    crt_path = self.merge_out_path('lib', 'clangrt-%s%s' % (llvm_triple, suffix))
    crt_install = os.path.join(llvm_install, 'lib', 'clang', self.build_config.VERSION)
​
    crt_extra_flags = []
    if not self.build_config.debug:
        # Remove absolute paths from compiler-rt debug info emitted with -gline-tables-only
        crt_extra_flags = ['-ffile-prefix-map=%s=.' % self.build_config.REPOROOT_DIR]
​
    crt_defines = defines.copy()
    crt_defines.update(self.base_cmake_defines())
    crt_defines['CMAKE_EXE_LINKER_FLAGS'] = ' '.join(ldflags)
    crt_defines['CMAKE_SHARED_LINKER_FLAGS'] = ' '.join(ldflags)
    crt_defines['CMAKE_MODULE_LINKER_FLAGS'] = ' '.join(ldflags)
    crt_defines['CMAKE_C_FLAGS'] = ' '.join(cflags + crt_extra_flags)
    crt_defines['CMAKE_ASM_FLAGS'] = ' '.join(cflags + crt_extra_flags)
    crt_defines['CMAKE_CXX_FLAGS'] = ' '.join(cflags + crt_extra_flags)
    crt_defines['COMPILER_RT_TEST_COMPILER_CFLAGS'] = ' '.join(cflags)
    crt_defines['OHOS'] = '1'
    crt_defines['COMPILER_RT_TEST_TARGET_TRIPLE'] = llvm_triple
    crt_defines['COMPILER_RT_INCLUDE_TESTS'] = 'ON'
    crt_defines['CMAKE_INSTALL_PREFIX'] = crt_install
    crt_defines['LLVM_TARGET_MULTILIB_SUFFIX'] = multilib_suffix
    if first_time or llvm_triple == self.liteos_triple('arm'):
        crt_defines['COMPILER_RT_BUILD_LIBFUZZER'] = 'OFF'
    else:
        crt_defines['COMPILER_RT_BUILD_LIBFUZZER'] = 'ON'
    crt_defines['COMPILER_RT_BUILD_ORC'] = 'OFF'
    crt_defines['LLVM_ENABLE_PER_TARGET_RUNTIME_DIR'] = 'ON'
    crt_defines['COMPILER_RT_USE_BUILTINS_LIBRARY'] = 'ON'
    crt_defines['CMAKE_SYSTEM_NAME'] = 'OHOS'
    crt_defines['CMAKE_CROSSCOMPILING'] = 'True'
    crt_defines['SANITIZER_CXX_ABI'] = 'libcxxabi'
    crt_defines['CMAKE_TRY_COMPILE_TARGET_TYPE'] = 'STATIC_LIBRARY'
    crt_defines['COMPILER_RT_HWASAN_WITH_INTERCEPTORS'] = 'OFF'
    crt_defines['COMPILER_RT_BUILD_SANITIZERS'] = \
        'OFF' if llvm_triple == self.liteos_triple('arm') or first_time else 'ON'
    crt_defines['COMPILER_RT_DEFAULT_TARGET_TRIPLE'] = llvm_triple
    crt_cmake_path = os.path.abspath(os.path.join(self.build_config.LLVM_PROJECT_DIR, 'compiler-rt'))
    self.rm_cmake_cache(crt_path)
​
    self.invoke_cmake(crt_cmake_path,
                      crt_path,
                      crt_defines,
                      env=dict(self.build_config.ORIG_ENV))
​
    self.invoke_ninja(out_path=crt_path,
                      env=dict(self.build_config.ORIG_ENV),
                      target=None,
                      install=True)

2.2.6.6 build_libomp方法解析

def build_libomp(self,
                 llvm_install,
                 arch,
                 llvm_triple,
                 cflags,
                 ldflags,
                 multilib_suffix,
                 defines):

    self.logger().info('Building libomp for %s', arch)

    libomp_path = self.merge_out_path('lib', 'libomp-%s' % llvm_triple)
    out_dir = os.path.join(libomp_path, 'lib')

    libomp_cflags = list(cflags)
    libomp_cflags.append('-fPIC')

    libomp_defines = defines.copy()
    libomp_defines.update(self.base_cmake_defines())
    libomp_defines['CMAKE_EXE_LINKER_FLAGS'] = ' '.join(ldflags)
    libomp_defines['CMAKE_SHARED_LINKER_FLAGS'] = ' '.join(ldflags)
    libomp_defines['CMAKE_MODULE_LINKER_FLAGS'] = ' '.join(ldflags)

    libomp_defines['OHOS'] = '1'
    libomp_defines['CMAKE_ASM_FLAGS'] = ' '.join(libomp_cflags)
    libomp_defines['CMAKE_C_FLAGS'] = ' '.join(libomp_cflags)
    libomp_defines['CMAKE_CXX_FLAGS'] = ' '.join(libomp_cflags)
    libomp_defines['OPENMP_ENABLE_LIBOMPTARGET'] = 'FALSE'

    libomp_defines['OPENMP_LIBDIR_SUFFIX'] = os.path.join(os.sep, llvm_triple, multilib_suffix)
    libomp_defines['LIBOMP_ENABLE_SHARED'] = 'FALSE'
    libomp_defines['CMAKE_POLICY_DEFAULT_CMP0056'] = 'NEW'
    libomp_defines['CMAKE_INSTALL_PREFIX'] = llvm_install
    libomp_defines['COMPILER_RT_USE_BUILTINS_LIBRARY'] = 'ON'
    libomp_defines['CMAKE_SYSTEM_NAME'] = 'OHOS'
    libomp_defines['CMAKE_CROSSCOMPILING'] = 'True'
    libomp_defines['LLVM_ENABLE_LIBCXX'] = 'ON'
    libomp_defines['CMAKE_TRY_COMPILE_TARGET_TYPE'] = 'STATIC_LIBRARY'

    libomp_cmake_path = os.path.join(self.build_config.LLVM_PROJECT_DIR, 'openmp')
    self.rm_cmake_cache(libomp_path)

    self.invoke_cmake(libomp_cmake_path,
                      libomp_path,
                      libomp_defines,
                      env=dict(self.build_config.ORIG_ENV))

    self.invoke_ninja(out_path=libomp_path,
                      env=dict(self.build_config.ORIG_ENV),
                      target=None,
                      install=True)

2.2.6.7 build_libz方法解析

def build_libz(self,
               arch,
               llvm_triple,
               cflags,
               ldflags,
               defines):

    self.logger().info('Building libz for %s ', arch)

    libz_path = self.merge_out_path('lib', 'libz-%s' % llvm_triple)
    if llvm_triple == self.hos_triple('arm'):
        ldflags.append('-lunwind')

    libz_cflags = list(cflags)
    libz_cflags.append('-fPIC')

    libz_defines = defines.copy()
    libz_defines.update(self.base_cmake_defines())
    libz_defines['CMAKE_EXE_LINKER_FLAGS'] = ' '.join(ldflags)
    libz_defines['CMAKE_SHARED_LINKER_FLAGS'] = ' '.join(ldflags)
    libz_defines['CMAKE_MODULE_LINKER_FLAGS'] = ' '.join(ldflags)
    libz_defines['OHOS'] = '1'
    libz_defines['CMAKE_ASM_FLAGS'] = ' '.join(libz_cflags)
    libz_defines['CMAKE_C_FLAGS'] = ' '.join(libz_cflags)
    libz_defines['CMAKE_CXX_FLAGS'] = ' '.join(libz_cflags)
    libz_defines['CMAKE_TRY_COMPILE_TARGET_TYPE'] = 'STATIC_LIBRARY'

    libz_cmake_path = os.path.join(self.build_config.REPOROOT_DIR, 'third_party/zlib')
    self.rm_cmake_cache(libz_path)

    self.invoke_cmake(libz_cmake_path,
                      libz_path,
                      libz_defines,
                      env=dict(self.build_config.ORIG_ENV))

    self.invoke_ninja(out_path=libz_path,
                      env=dict(self.build_config.ORIG_ENV),
                      target=None,
                      install=False)

    self.sysroot_composer.copy_libz_to_sysroot(libz_path, llvm_triple)

2.2.6.8 build_lldb_server方法解析

def build_lldb_server(self,
                      llvm_install,
                      llvm_path,
                      arch,
                      llvm_triple,
                      cflags,
                      ldflags,
                      defines):
​
    self.logger().info('Building lldb for %s', arch)
​
    lldb_path = self.merge_out_path('lib', 'lldb-server-%s' % llvm_triple)
    crt_install = os.path.join(llvm_install, 'lib', 'clang', self.build_config.VERSION)
    out_dir = os.path.join(lldb_path, 'bin')
​
    lldb_ldflags = list(ldflags)
    lldb_cflags = list(cflags)
​
    lldb_ldflags.append('-lunwind')
    lldb_ldflags.append('-static')
​
    lldb_defines = defines.copy()
    lldb_defines.update(self.base_cmake_defines())
​
    lldb_defines['CMAKE_EXE_LINKER_FLAGS'] = ' '.join(lldb_ldflags)
    lldb_defines['CMAKE_SHARED_LINKER_FLAGS'] = ' '.join(lldb_ldflags)
    lldb_defines['CMAKE_MODULE_LINKER_FLAGS'] = ' '.join(lldb_ldflags)
​
    lldb_defines['OHOS'] = '1'
    lldb_defines['CMAKE_C_FLAGS'] = ' '.join(lldb_cflags)
    lldb_defines['CMAKE_ASM_FLAGS'] = ' '.join(lldb_cflags)
    lldb_defines['CMAKE_CXX_FLAGS'] = ' '.join(lldb_cflags)
    lldb_defines['CMAKE_INSTALL_PREFIX'] = crt_install
    lldb_defines['LLVM_ENABLE_PER_TARGET_RUNTIME_DIR'] = 'ON'
    lldb_defines['COMPILER_RT_USE_BUILTINS_LIBRARY'] = 'ON'
    lldb_defines['CMAKE_SYSTEM_NAME'] = 'OHOS'
    lldb_defines['CMAKE_CROSSCOMPILING'] = 'True'
    lldb_defines['LLVM_DEFAULT_TARGET_TRIPLE'] = llvm_triple
    lldb_defines['LLVM_ENABLE_LIBCXX'] = 'ON'
    lldb_defines['LLVM_ENABLE_PROJECTS'] = 'clang;lldb'
    lldb_defines['LLVM_TABLEGEN'] = os.path.join(llvm_install, 'bin', 'llvm-tblgen')
    lldb_defines['CLANG_TABLEGEN'] = os.path.join(llvm_install, '..', llvm_path, 'bin', 'clang-tblgen')
    lldb_defines['LLDB_TABLEGEN'] = os.path.join(llvm_install, '..', llvm_path, 'bin', 'lldb-tblgen')
    lldb_defines['LLVM_HOST_TRIPLE'] = llvm_triple
    lldb_defines['LLVM_TARGET_ARCH'] = arch
    lldb_defines['LLVM_TARGETS_TO_BUILD'] = self.build_config.TARGETS
​
    lldb_cmake_path = os.path.join(self.build_config.LLVM_PROJECT_DIR, 'llvm')
​
    self.invoke_cmake(lldb_cmake_path,
                      lldb_path,
                      lldb_defines,
                      env=dict(self.build_config.ORIG_ENV))
​
    self.invoke_ninja(out_path=lldb_path,
                      env=dict(self.build_config.ORIG_ENV),
                      target='lldb-server',
                      install=False)
​
    self.llvm_package.copy_lldb_server_to_llvm_install(lldb_path, crt_install, llvm_triple)

2.2.6.9 build_runtimes_for_windows方法解析

def build_runtimes_for_windows(self, enable_assertions):

    self.logger().info('Building libs for windows.')
    toolchain_dir = self.merge_out_path('llvm-install')
    install_dir = self.merge_out_path('windows-x86_64-install')
    windows_sysroot = self.merge_out_path('mingw', self.build_config.MINGW_TRIPLE)

    cflags = ['-stdlib=libc++', '--target=x86_64-pc-windows-gnu', '-D_LARGEFILE_SOURCE',
              '-D_FILE_OFFSET_BITS=64', '-D_WIN32_WINNT=0x0600', '-DWINVER=0x0600', '-D__MSVCRT_VERSION__=0x1400']

    cmake_defines = {}
    cmake_defines['CMAKE_C_COMPILER'] = os.path.join(toolchain_dir, 'bin', 'clang')
    cmake_defines['CMAKE_CXX_COMPILER'] = os.path.join(toolchain_dir, 'bin', 'clang++')
    cmake_defines['CMAKE_CROSSCOMPILING'] = 'True'
    cmake_defines['CMAKE_SYSTEM_NAME'] = 'Windows'
    cmake_defines['CMAKE_SYSROOT'] = windows_sysroot
    cmake_defines['CMAKE_ASM_FLAGS'] = ' '.join(cflags)
    cmake_defines['CMAKE_C_FLAGS'] = ' '.join(cflags)
    cmake_defines['CMAKE_CXX_FLAGS'] = ' '.join(cflags)
    cmake_defines['CMAKE_TRY_COMPILE_TARGET_TYPE'] = 'STATIC_LIBRARY'
    cmake_defines['CMAKE_INSTALL_PREFIX'] = install_dir
    cmake_defines['LLVM_CONFIG_PATH'] = os.path.join(toolchain_dir, 'bin', 'llvm-config')
    cmake_defines['LIBCXX_ENABLE_SHARED'] = 'OFF'
    cmake_defines['LIBCXX_ENABLE_STATIC_ABI_LIBRARY'] = 'ON'
    cmake_defines['LIBCXX_ENABLE_NEW_DELETE_DEFINITIONS'] = 'ON'
    cmake_defines['LIBCXXABI_ENABLE_SHARED'] = 'OFF'
    cmake_defines['LIBUNWIND_ENABLE_SHARED'] = 'OFF'
    cmake_defines['LIBCXXABI_USE_LLVM_UNWINDER'] = 'ON'
    cmake_defines['LLVM_ENABLE_RUNTIMES'] = 'libunwind;libcxxabi;libcxx'
    cmake_defines['LLVM_ENABLE_ASSERTIONS'] = 'ON' if enable_assertions else 'OFF'

    out_path = self.merge_out_path('lib', 'windows-runtimes')
    cmake_path = os.path.abspath(os.path.join(self.build_config.LLVM_PROJECT_DIR, 'runtimes'))

    self.invoke_cmake(cmake_path,
                      out_path,
                      cmake_defines,
                      env=dict(self.build_config.ORIG_ENV))

    self.invoke_ninja(out_path,
                      env=dict(self.build_config.ORIG_ENV),
                      install=True)

2.2.7 LldbMi

2.2.7.1 build_lldb_mi方法解析

def build_lldb_mi(self, llvm_install):
    self.logger().info('Building lldb-mi for linux.')

    llvm_path = os.path.abspath(os.path.join(self.build_config.REPOROOT_DIR,
                                             'prebuilts/clang/ohos', self.use_platform(), 'clang-%s' % self.build_config.CLANG_VERSION))
    lldb_mi_cmake_path = os.path.join(self.build_config.LLVM_PROJECT_DIR, '../lldb-mi')
    lldb_mi_path = self.merge_out_path('lldb_mi_build')

    self.check_rm_tree(lldb_mi_path)
    self.rm_cmake_cache(lldb_mi_path)

    if self.host_is_darwin():
        cflags = []
        cxxflags =[]
        ldflags = ['-Wl,-rpath,%s' % '@loader_path/../lib']
    else:
        cflags = []
        cxxflags =[]
        ldflags = ['-fuse-ld=lld', '-Wl,-rpath,%s' % '\$ORIGIN/../lib']
        ldflags.append('-Wl,-z,relro,-z,now -pie')
        if self.build_config.strip:
            ldflags.append('-s')

    ldflags.append('-L%s' % os.path.join(llvm_path, 'lib'))
    cxxflags.append('-std=c++14')
    cxxflags.append('-fstack-protector-strong -fPIE')
    cflags.append('-fstack-protector-strong -fPIE')

    lldb_mi_defines = {}
    lldb_mi_defines['CMAKE_C_COMPILER'] = os.path.join(llvm_path, 'bin', 'clang')
    lldb_mi_defines['CMAKE_CXX_COMPILER'] = os.path.join(llvm_path, 'bin', 'clang++')
    lldb_mi_defines['CMAKE_C_FLAGS'] = ' '.join(cflags)
    lldb_mi_defines['CMAKE_CXX_FLAGS'] = ' '.join(cxxflags)
    lldb_mi_defines['CMAKE_EXE_LINKER_FLAGS'] = ' '.join(ldflags)
    lldb_mi_defines['CMAKE_SHARED_LINKER_FLAGS'] = ' '.join(ldflags)
    lldb_mi_defines['CMAKE_MODULE_LINKER_FLAGS'] = ' '.join(ldflags)
    lldb_mi_defines['LLVM_DIR'] = os.path.join(llvm_install, 'lib/cmake/llvm/')
    lldb_mi_defines['LLVM_ENABLE_LIBCXX'] = 'ON'
    lldb_mi_defines['CMAKE_INSTALL_PREFIX'] = llvm_install

    self.invoke_cmake(lldb_mi_cmake_path,
                      lldb_mi_path,
                      lldb_mi_defines,
                      env=dict(self.build_config.ORIG_ENV))

    self.invoke_ninja(lldb_mi_path,
                      env=dict(self.build_config.ORIG_ENV),
                      install=False)

    self.llvm_package.copy_lldb_mi_to_llvm_install(lldb_mi_path, llvm_install)

2.2.7.2 ldflags_lists_define方法解析

@staticmethod
def ldflags_lists_define():
    ldflags_lists = ['-Wl,--dynamicbase',
                '-Wl,--nxcompat',
                '-lucrt',
                '-lucrtbase',
                '-L', ]
    return ldflags_lists

2.2.7.3 cflags_lists_define方法解析

@staticmethod
def cflags_lists_define():
    cflags_lists = ['-D_LARGEFILE_SOURCE',
                '-D_FILE_OFFSET_BITS=64',
                '-D_WIN32_WINNT=0x0600',
                '-DWINVER=0x0600',
                '-D__MSVCRT_VERSION__=0x1400',
                '-DMS_WIN64', ]
    return cflags_lists

2.2.7.4 lldb_mi_windefines_dictionary方法解析

def lldb_mi_windefines_dictionary(self, cc, cxx, windows_sysroot, cflags, cxxflags, ldflags):
    lldb_mi_windefines = {}
    lldb_mi_windefines['CMAKE_C_COMPILER'] = cc
    lldb_mi_windefines['CMAKE_CXX_COMPILER'] = cxx
    lldb_mi_windefines['CMAKE_C_COMPILER_WORKS'] = '1'
    lldb_mi_windefines['CMAKE_CXX_COMPILER_WORKS'] = '1'
    lldb_mi_windefines['CMAKE_SYSTEM_NAME'] = 'Windows'
    lldb_mi_windefines['CMAKE_SYSTEM_PROCESSOR'] = 'x86_64'
    lldb_mi_windefines['LLVM_ENABLE_LIBCXX'] = 'ON'
    lldb_mi_windefines['CMAKE_SYSROOT'] = windows_sysroot
    lldb_mi_windefines['LLVM_INSTALL_PREFIX'] = self.merge_out_path('windows-x86_64-install')
    lldb_mi_windefines['LLVM_DIR'] = self.merge_out_path('windows-x86_64-install/lib/cmake/llvm/')
    lldb_mi_windefines['CMAKE_C_FLAGS'] = ' '.join(cflags)
    lldb_mi_windefines['CMAKE_CXX_FLAGS'] = ' '.join(cxxflags)
    lldb_mi_windefines['CMAKE_EXE_LINKER_FLAGS'] = ' '.join(ldflags)
    lldb_mi_windefines['CMAKE_SHARED_LINKER_FLAGS'] = ' '.join(ldflags)
    lldb_mi_windefines['CMAKE_MODULE_LINKER_FLAGS'] = ' '.join(ldflags)

    if self.build_config.enable_assertions:
        lldb_mi_windefines['LLVM_ENABLE_ASSERTIONS'] = 'ON'

    return lldb_mi_windefines

2.2.7.5 build_lldb_mi_for_windows方法解析

def build_lldb_mi_for_windows(self):
    self.logger().info('Building lldb-mi for windows.')
​
    build_dir = self.merge_out_path('llvm-install')
    lldb_mi_windows64_path = self.merge_out_path('windows-x86_64-lldb-mi')
    lldb_mi_cmake_path = os.path.abspath(os.path.join(self.build_config.LLVM_PROJECT_DIR, '../lldb-mi'))
    windows64_install = self.merge_out_path('windows-x86_64-install')
    cc = os.path.join(build_dir, 'bin', 'clang')
    cxx = os.path.join(build_dir, 'bin', 'clang++')
​
    windows_sysroot = self.merge_out_path('mingw', self.build_config.MINGW_TRIPLE)
    self.check_create_dir(lldb_mi_windows64_path)
​
    ldflags = ['-fuse-ld=lld',
               '--rtlib=compiler-rt',
               '-lunwind',
               '-L%s' % os.path.join(windows64_install, 'lib'),
               ]
    ldflags.extend(self.ldflags_lists_define())
    ldflags.append(os.path.join(windows64_install, 'lib'))
    ldflags.append('-Wl,--high-entropy-va')
​
​
    cflags = ['-stdlib=libc++',
              '--target=x86_64-pc-windows-gnu',
             ]
    cflags.extend(self.cflags_lists_define())
    cflags.append('-fno-exceptions')
    cflags.append('-fno-rtti')
​
    cxxflags = list(cflags)
    cxxflags.extend(('-I', os.path.join(windows64_install, 'include', 'c++', 'v1')))
​
    zlib_path = os.path.abspath(
        os.path.join('../../', 'prebuilts', 'clang', 'host', 'windows-x86', 'toolchain-prebuilts', 'zlib'))
    zlib_inc = os.path.join(zlib_path, 'include')
    zlib_lib = os.path.join(zlib_path, 'lib')
​
    cflags.extend(['-I', zlib_inc])
    cxxflags.extend(['-I', zlib_inc])
    ldflags.extend(['-L', zlib_lib])
​
​
    lldb_mi_env = dict(self.build_config.ORIG_ENV)
    lldb_mi_env['LD_LIBRARY_PATH'] = os.path.join(build_dir, 'lib')
    self.rm_cmake_cache(lldb_mi_windows64_path)
​
    self.invoke_cmake(lldb_mi_cmake_path,
                      lldb_mi_windows64_path,
                      self.lldb_mi_windefines_dictionary(cc, cxx, windows_sysroot, cflags, cxxflags, ldflags),
                      env=lldb_mi_env)
​
    self.invoke_ninja(lldb_mi_windows64_path,
                      env=lldb_mi_env,
                      install=False)
​
    self.llvm_package.copy_lldb_mi_to_windows(windows64_install, lldb_mi_windows64_path)

2.2.8 LlvmPackage

2.2.8.1 copy_lldb_server_to_llvm_install方法解析

拷贝lldb-serverinstall目录

def copy_lldb_server_to_llvm_install(self, lldb_path, crt_install, llvm_triple):
    # Copy lldb-server
    libname = 'lldb-server'
    src_lib = os.path.join(lldb_path, 'bin', libname)
    dst_dir = os.path.join(crt_install, 'bin', llvm_triple)
    self.check_create_dir(dst_dir)
    self.check_copy_file(src_lib, os.path.join(dst_dir, libname))

2.2.8.2 copy_lldb_mi_to_llvm_install方法解析

拷贝lldb-miinstall目录

def copy_lldb_mi_to_llvm_install(self, lldb_mi_path, llvm_install):
    # Copy lldb-mi
    lldb_mi_dst = os.path.join(llvm_install, 'bin', 'lldb-mi')
    lldb_mi_src = os.path.join(lldb_mi_path, 'src', 'lldb-mi')
​
    if os.path.exists(lldb_mi_dst):
        os.remove(lldb_mi_dst)
    self.check_copy_file(lldb_mi_src, lldb_mi_dst)

2.2.8.3 copy_lldb_mi_to_windows方法解析

拷贝lldb-miwindows目录

def copy_lldb_mi_to_windows(self, windows64_install, lldb_mi_windows64_path):
    # Copy lldb-mi for windows
    lldb_mi_dst = os.path.join(windows64_install, 'bin', 'lldb-mi.exe')
    lldb_mi_src = os.path.join(lldb_mi_windows64_path, 'src', 'lldb-mi.exe')
    if os.path.exists(lldb_mi_dst):
        os.remove(lldb_mi_dst)
    self.check_copy_file(lldb_mi_src, lldb_mi_dst)

2.2.8.4 package_libcxx方法解析

打包镜像成tar.bz2格式

def package_libcxx(self):
    libcxx_ndk_install=self.merge_out_path('libcxx-ndk')
    libcxx_ndk_install_tmp=self.merge_out_path('libcxx-ndk-tmp')
    libcxx_ndk_install_include=self.merge_out_path(libcxx_ndk_install, 'include', 'libcxx-ohos', 'include', 'c++', 'v1')
    hosts_list=['linux-x86_64', 'darwin-x86_64', 'windows-x86_64', 'darwin-arm64']
​
    if os.path.exists(libcxx_ndk_install):
        for headerfile in os.listdir(libcxx_ndk_install_include):
            if not headerfile =='__config':
                if os.path.isdir(os.path.join(libcxx_ndk_install_include, headerfile)):
                    shutil.rmtree(os.path.join(libcxx_ndk_install_include, headerfile))
                else:
                    os.remove(os.path.join(libcxx_ndk_install_include, headerfile))
​
        #Package libcxx-ndk
        for host in hosts_list:
            tarball_name = 'libcxx-ndk-%s-%s' % (self.build_config.build_name, host)
            package_path = '%s%s' % (self.merge_out_path(tarball_name), '.tar.bz2')
            self.logger().info('Packaging %s', package_path)
            args = ['tar', '-chjC', self.build_config.OUT_PATH, '-f', package_path, 'libcxx-ndk']
            self.check_call(args)
        self.check_rm_tree(libcxx_ndk_install)
        self.check_rm_tree(libcxx_ndk_install_tmp)

2.2.8.5 merge_tree方法解析

拷贝文件和目录

@staticmethod
def merge_tree(src_dir, dst_dir):
    for item in os.listdir(src_dir):
        src_path = os.path.join(src_dir, item)
        dst_path = os.path.join(dst_dir, item)
        if os.path.isfile(src_path):
            shutil.copyfile(src_path, dst_path)
        else:
            shutil.copytree(src_path, dst_path)

2.2.8.6 install_mingw_python方法解析

安装mingw_python

def install_mingw_python(self, install_dir):
    py_root = self.merge_out_path('../third_party', 'mingw-w64', 'mingw-w64-python',
                                    self.build_config.LLDB_PY_VERSION)
    bin_root = os.path.join(install_dir, 'bin')
    py_dll = 'libpython' + self.build_config.LLDB_PY_VERSION + '.dll'
    shutil.copyfile(os.path.join(py_root, py_dll), os.path.join(bin_root, py_dll))
    self.merge_tree(os.path.join(py_root, 'lib'),
                    os.path.join(bin_root, 'python', 'lib', 'python%s' % self.build_config.LLDB_PY_VERSION))

2.2.8.7 windows_lib_files_operation方法解析

windows库文件的操作,不介绍

def windows_lib_files_operation(self, lib_files, lib_dir, install_dir):

        # Remove unnecessary Windows lib files.
        windows_necessary_lib_files = ['libc++.a', 'libc++abi.a']

        for lib_file in lib_files:
            if lib_file.endswith('.a') and lib_file not in windows_necessary_lib_files:
                static_library = os.path.join(lib_dir, lib_file)
                os.remove(static_library)

        for necessary_lib_file in windows_necessary_lib_files:
            if not os.path.isfile(os.path.join(lib_dir, necessary_lib_file)):
                raise RuntimeError('Did not find %s under %s' % (necessary_lib_file, lib_dir))
        self.install_mingw_python(install_dir)

2.2.8.8 darwin_stripped_xargs方法解析

darwin系统相关,不介绍

def darwin_stripped_xargs(self, bin_dir, necessary_bin_files, script_bins, need_x_bins_darwin):
    for bin_filename in os.listdir(bin_dir):
        binary = os.path.join(bin_dir, bin_filename)
        if not os.path.isfile(binary):
            continue
        if bin_filename not in necessary_bin_files:
            os.remove(binary)
        elif bin_filename not in script_bins and self.build_config.strip:
            if bin_filename not in need_x_bins_darwin and self.host_is_darwin():
                self.check_call(['strip', '-x', binary])
            else:
                self.check_call(['strip', binary])

2.2.8.9 strip_lldb_server方法解析

使用llvm-strip工具对${clang_version_bin_dir}/lib/clang/bin里面的文件进行瘦身,也就是lldb-server文件

def strip_lldb_server(self, host, install_dir):
    clang_version_bin_dir = os.path.join(install_dir, 'lib', 'clang', self.build_config.CLANG_VERSION, 'bin')
​
    if not host.startswith('linux') or not os.path.exists(clang_version_bin_dir) or not self.build_config.strip:
        return
    llvm_strip = os.path.join(install_dir, 'bin', 'llvm-strip')
    # os.listdir 返回指定路径下的目录和文件列表
    for llvm_triple_dir in os.listdir(clang_version_bin_dir):
        llvm_triple_bin_dir = os.path.join(clang_version_bin_dir, llvm_triple_dir)
​
        if not os.path.isdir(llvm_triple_bin_dir):
            continue
​
        for bin_filename in os.listdir(llvm_triple_bin_dir):
            binary = os.path.join(llvm_triple_bin_dir, bin_filename)
            if os.path.isfile(binary):
                self.check_call([llvm_strip, binary])

2.2.8.10 notice_prebuilts_file方法解析

添加NOTICE文件到每个工程下

def notice_prebuilts_file(self, host, projects, install_dir):
​
    # Fetch all the LICENSE.* files under our projects and append them into a
    # Single NOTICE file for the resulting prebuilts.
    notices = []
    for project in projects:
        license_pattern = os.path.abspath(os.path.join(self.build_config.LLVM_PROJECT_DIR, project, 'LICENSE.*'))
        # glob.glob 查找符合特定规则的文件路径名
        for license_file in glob.glob(license_pattern):
            with open(license_file) as notice_file:
                notices.append(notice_file.read())
​
    zlib_license_file = os.path.abspath(os.path.join(self.build_config.REPOROOT_DIR, 'third_party/zlib/LICENSE'))
    with open(zlib_license_file) as notice_file:
        notices.append(notice_file.read())
​
    if host.startswith('windows'):
        mingw_license_file = os.path.abspath(os.path.join(self.build_config.REPOROOT_DIR,
                                                            'third_party/mingw-w64/COPYING'))
        with open(mingw_license_file) as notice_file:
            notices.append(notice_file.read())
​
    with open(os.path.join(install_dir, 'NOTICE'), 'w') as notice_file:
        notice_file.write('\n'.join(notices))

2.2.8.11 package_clang_bin_file方法解析

二进制文件添加扩展名,linux里面不涉及

@staticmethod
def package_clang_bin_file(self, necessary_bin_files, ext):
    necessary_bin_file = [
        'clang%s' % ext,
        'clang++%s' % ext,
        'clang-cpp%s' % ext,
        'clang-%s%s' % (self.build_config.VERSION.split('.')[0], ext),
        'clang-check%s' % ext,
        'clang-cl%s' % ext,
        'clang-format%s' % ext,
        'clang-tidy%s' % ext,
        'clangd%s' % ext,
        'count%s' % ext,
        ]
    necessary_bin_files.extend(necessary_bin_file)

2.2.8.12 package_lldb_bin_file方法解析

同上

@staticmethod
def package_llvm_bin_file(necessary_bin_files, ext):
    necessary_bin_file = [
        'llvm-addr2line%s' % ext,
        'llvm-ar%s' % ext,
        'llvm-as%s' % ext,
        'llvm-cfi-verify%s' % ext,
        'llvm-config%s' % ext,
        'llvm-cov%s' % ext,
        'llvm-cxxfilt%s' % ext,
        'llvm-dis%s' % ext,
        'llvm-lib%s' % ext,
        'llvm-link%s' % ext,
        'llvm-modextract%s' % ext,
        'llvm-nm%s' % ext,
        'llvm-objcopy%s' % ext,
        'llvm-objdump%s' % ext,
        'llvm-profdata%s' % ext,
        'llvm-ranlib%s' % ext,
        'llvm-readelf%s' % ext,
        'llvm-readobj%s' % ext,
        'llvm-rc%s' % ext,
        'llvm-size%s' % ext,
        'llvm-strings%s' % ext,
        'llvm-strip%s' % ext,
        'llvm-symbolizer%s' % ext,
        ]
    necessary_bin_files.extend(necessary_bin_file)

2.2.8.13package_llvm_bin_file方法解析

同上

@staticmethod
def package_llvm_bin_file(necessary_bin_files, ext):
    necessary_bin_file = [
        'llvm-addr2line%s' % ext,
        'llvm-ar%s' % ext,
        'llvm-as%s' % ext,
        'llvm-cfi-verify%s' % ext,
        'llvm-config%s' % ext,
        'llvm-cov%s' % ext,
        'llvm-cxxfilt%s' % ext,
        'llvm-dis%s' % ext,
        'llvm-lib%s' % ext,
        'llvm-link%s' % ext,
        'llvm-modextract%s' % ext,
        'llvm-nm%s' % ext,
        'llvm-objcopy%s' % ext,
        'llvm-objdump%s' % ext,
        'llvm-profdata%s' % ext,
        'llvm-ranlib%s' % ext,
        'llvm-readelf%s' % ext,
        'llvm-readobj%s' % ext,
        'llvm-rc%s' % ext,
        'llvm-size%s' % ext,
        'llvm-strings%s' % ext,
        'llvm-strip%s' % ext,
        'llvm-symbolizer%s' % ext,
        ]
    necessary_bin_files.extend(necessary_bin_file)

2.2.8.14 package_scan_bin_file方法解析

同上

@staticmethod
def package_scan_bin_file(necessary_bin_files, ext):
    necessary_bin_file = [
        'not%s' % ext,
        'sancov%s' % ext,
        'sanstats%s' % ext,
        'scan-build%s' % ext,
        'scan-view%s' % ext,
        'yaml2obj%s' % ext,
        ]
    necessary_bin_files.extend(necessary_bin_file)

2.2.8.15 package_license_project_tuple方法解析

@staticmethod
def package_license_project_tuple():
    # Install license files as NOTICE in the toolchain install dir.
    projects = (
        'llvm',
        'compiler-rt',
        'libcxx',
        'libcxxabi',
        'openmp',
        'clang',
        'clang-tools-extra',
        'lld',
        'lldb',
        'libunwind',
    )
    return projects

2.2.8.16 remove_unnecessary_bin方法解析

移除无用的文件,针对linux环境就是移除.a静态库

def remove_unnecessary_bin(self, necessary_bin_files, host, lib_dir, install_dir, ext, shlib_ext):
​
    lib_files = []
    if os.path.isdir(lib_dir):
            lib_files = os.listdir(lib_dir)
    if host.startswith('windows'):
        vers_major = int(self.build_config.VERSION.split('.')[0])
        # Redefining necessary bin files for Windows.
        windows_forbidden_list_bin_files = ['clang-%s%s' % (vers_major, ext), 'scan-build%s' % ext,
                                       'scan-view%s' % ext]
        windows_additional_bin_files = ['liblldb%s' % shlib_ext, 'libpython3.10%s' % shlib_ext]
​
        new_necessary_bin_files = list(set(necessary_bin_files) - set(windows_forbidden_list_bin_files))
        new_necessary_bin_files.extend(windows_additional_bin_files)
        del necessary_bin_files[:]
        necessary_bin_files.extend(new_necessary_bin_files)
​
        self.windows_lib_files_operation(lib_files, lib_dir, install_dir)
    else:
        # Remove unnecessary static libraries.
        for lib_file in lib_files:
            if lib_file.endswith('.a'):
                static_library = os.path.join(lib_dir, lib_file)
                os.remove(static_library)

2.2.8.17 package_up_resulting方法解析

打包结果

def package_up_resulting(self, package_name, host, install_host_dir):
    # Package up the resulting trimmed install/ directory.
    tarball_name = '%s-%s' % (package_name, host)
    package_path = '%s%s' % (self.merge_out_path(tarball_name), '.tar.bz2')
    self.logger().info('Packaging %s', package_path)
    args = ['tar', '-cjC', install_host_dir, '-f', package_path, package_name]
    if host.startswith('windows'):
        # windows do not support symlinks,
        # replace them with file copies
        args.insert(1, '--dereference')

    self.check_call(args)

    # Package ohos NDK
    if os.path.exists(self.merge_out_path('sysroot')):
        tarball_ndk_name = 'ohos-sysroot-%s' % self.build_config.build_name
        package_ndk_path = '%s%s' % (self.merge_out_path(tarball_ndk_name), '.tar.bz2')
        self.logger().info('Packaging %s', package_ndk_path)
        args = ['tar', '-chjC', self.build_config.OUT_PATH, '-f', package_ndk_path, 'sysroot']
        self.check_call(args)

2.2.8.18 package_operation方法解析

打包操作

    def package_operation(self, build_dir, host):
​
        self.logger().info('Packaging for other environments.')
        package_name = 'clang-%s' % self.build_config.build_name
        self.set_clang_version(build_dir)
​
        if host.startswith('windows'):
            ext = '.exe'
            shlib_ext = '.dll'
        elif host.startswith('linux'):
            ext = ''
            shlib_ext = '.so'
        else:
            ext = ''
            shlib_ext = '.dylib'
​
        install_dir = self.merge_out_path('install', host, package_name)
        bin_dir = os.path.join(install_dir, 'bin')
        lib_dir = os.path.join(install_dir, 'lib')
        install_host_dir = os.path.abspath(os.path.join(install_dir, '../'))
        self.check_rm_tree(install_host_dir)
        self.check_copy_tree(build_dir, install_dir)
        # copy readme file to install_dir
        shutil.copyfile(os.path.join(self.build_config.LLVM_BUILD_DIR, "toolchain_readme.md"),
                        os.path.join(install_dir, "README.md"))
​
        # Generate manifest in install_dir
        manifest = os.path.join(install_dir, 'manifest.xml')
        repo_tool = os.path.join(self.build_config.REPOROOT_DIR, '.repo', 'repo', 'repo')
        if os.path.isfile(repo_tool):
            self.logger().info('Generating manifest.')
            # 执行命令 .repo/repo/repo manifest -r -o 
            subprocess.run([repo_tool, 'manifest', '-r', '-o', manifest], shell=False,
                           stdout=subprocess.PIPE, cwd=self.build_config.REPOROOT_DIR)
        else:
            self.logger().error('Cannot generate manifest, repo tool not found.')
​
        # Remove unnecessary binaries.
        necessary_bin_files = []
        self.package_clang_bin_file(necessary_bin_files, ext)
        self.package_lldb_bin_file(necessary_bin_files, ext)
        self.package_llvm_bin_file(necessary_bin_files, ext)
        self.package_scan_bin_file(necessary_bin_files, ext)
​
        if self.build_config.need_lldb_mi:
            necessary_bin_files.append('lldb-mi%s' % ext)
        self.remove_unnecessary_bin(necessary_bin_files, host, lib_dir, install_dir, ext, shlib_ext)
​
        # Scripts that should not be stripped
        script_bins = ['git-clang-format', 'scan-build', 'scan-view']
        need_x_bins_darwin = ['clang', 'clang++', 'clang-9', 'clang-cl', 'clang-cpp']
​
        # Bin file in the list should be stripped with -x args when host=darwin
        self.darwin_stripped_xargs(bin_dir, necessary_bin_files, script_bins, need_x_bins_darwin)
​
        # Strip lldb-server
        self.strip_lldb_server(host, install_dir)
​
        for necessary_bin_file in necessary_bin_files:
            if not os.path.isfile(os.path.join(bin_dir, necessary_bin_file)):
                print('Did not find %s in %s' % (necessary_bin_file, bin_dir))
                raise RuntimeError('Did not find %s in %s' % (necessary_bin_file, bin_dir))
​
        cmake_dir = os.path.join(lib_dir, 'cmake')
        self.check_rm_tree(cmake_dir)
​
        self.notice_prebuilts_file(host, self.package_license_project_tuple(), install_dir)
​
        create_tar = True
        if create_tar:
            self.package_up_resulting(package_name, host, install_host_dir)
​
        return

2.2.9 main函数介绍

def main():
    build_config = BuildConfig()
    build_utils = BuildUtils(build_config)
    sysroot_composer = SysrootComposer(build_config)
    llvm_core = LlvmCore(build_config)
    llvm_package = LlvmPackage(build_config)
    lldb_mi = LldbMi(build_config, llvm_package)
    llvm_libs = LlvmLibs(build_config, sysroot_composer, llvm_package)
​
    args = build_config.parse_args()
    need_host = build_utils.host_is_darwin() or ('linux' not in args.no_build)
    need_windows = build_utils.host_is_linux() and \
                   ('windows' not in args.no_build)
​
    llvm_install = build_utils.merge_out_path('llvm-install')
    windows64_install = build_utils.merge_out_path('windows-x86_64-install')
​
    configs = []
    if not build_config.no_build_arm:
        configs.append(('arm', build_utils.liteos_triple('arm')))
        configs.append(('arm', build_utils.open_ohos_triple('arm')))
​
    if not build_config.no_build_aarch64:
        configs.append(('arm64', build_utils.open_ohos_triple('aarch64')))
​
    if not build_config.no_build_riscv64:
        configs.append(('riscv', build_utils.open_ohos_triple('riscv64')))
​
    if not build_config.no_build_mipsel:
        configs.append(('mipsel', build_utils.open_ohos_triple('mipsel')))
​
    if not build_config.no_build_x86_64:
        configs.append(('x86_64', build_utils.open_ohos_triple('x86_64')))
​
​
    if build_config.do_build and need_host:
        llvm_core.llvm_compile(
            build_config.build_name,
            llvm_install,
            build_config.debug,
            build_config.no_lto,
            build_config.build_instrumented,
            build_config.xunit_xml_output)
​
    llvm_core.set_clang_version(llvm_install)
​
    if build_config.do_build and build_utils.host_is_linux():
        sysroot_composer.setup_cmake_platform(llvm_install)
        llvm_libs.build_crt_libs(configs, llvm_install, build_config.need_lldb_server)
​
        if build_config.need_libs:
            for (arch, target) in configs:
                llvm_libs.build_libs(build_config.need_lldb_server, llvm_install, target)
​
    if build_config.do_build and need_windows:
        mingw.main(build_config.VERSION)
        llvm_libs.build_runtimes_for_windows(build_config.enable_assertions)
        llvm_core.llvm_compile_for_windows(build_config.TARGETS,
                                          build_config.enable_assertions,
                                          build_config.build_name)
​
        if build_config.need_lldb_mi:
            lldb_mi.build_lldb_mi_for_windows()
​
    if build_config.do_build and build_config.need_lldb_mi and need_host:
        lldb_mi.build_lldb_mi(llvm_install)
​
    if build_config.do_package:
        if build_utils.host_is_linux():
            llvm_package.package_libcxx()
        llvm_package.package_operation(llvm_install, build_utils.use_platform())
        if build_config.do_package and need_windows:
            llvm_package.package_operation(windows64_install, 'windows-x86_64')

三、编译报错问题解决

3.1 编译报Curses问题处理

【问题描述】

执行命令python3 ./toolchain/llvm-project/llvm-build/build.py报错如下:

CMake Error at /home/wen_fei/OpenHarmony/llvm-toolchains/prebuilts/cmake/linux-x86/share/cmake-3.16/Modules/FindPackageHandleStandardArgs.cmake:146 (message):
  Could NOT find Curses (missing: CURSES_LIBRARY CURSES_INCLUDE_PATH)
Call Stack (most recent call first):
  /home/wen_fei/OpenHarmony/llvm-toolchains/prebuilts/cmake/linux-x86/share/cmake-3.16/Modules/FindPackageHandleStandardArgs.cmake:393 (_FPHSA_FAILURE_MESSAGE)
  /home/wen_fei/OpenHarmony/llvm-toolchains/prebuilts/cmake/linux-x86/share/cmake-3.16/Modules/FindCurses.cmake:258 (FIND_PACKAGE_HANDLE_STANDARD_ARGS)
  src/CMakeLists.txt:92 (find_package)


-- Configuring incomplete, errors occurred!

【问题分析】

出现该错误的是因为在系统中找不到libncurses.so库的原因

【问题处理】

  • 安装如下软件

    sudo apt-get install liblua5.1-dev
    sudo apt install libncurses5
  • 进入/usr/lib目录下执行find ./ -name libncurses.so*,发现这些库都在x86_64-linux-gnu目录下

    # find . -name  libncurses.so*
    ./x86_64-linux-gnu/libncurses.so.6
    ./x86_64-linux-gnu/libncurses.so
    ./x86_64-linux-gnu/libncurses.so.5.9
    ./x86_64-linux-gnu/libncurses.so.5
    ./x86_64-linux-gnu/libncurses.so.6.2
  • 添加软链接

    sudo su
    cd /usr/lib
    ln -s ./x86_64-linux-gnu/libncurses.so libncurses.so
  • 重新编译即可

3.2 编译报fatal error: 'plugin-api.h'问题处理

【问题描述】

执行命令python3 ./toolchain/llvm-project/llvm-build/build.py报错如下:

-- Failed to find LLVM FileCheck
-- git version: v0.0.0-dirty normalized to 0.0.0
-- Version: 1.6.0
-- Performing Test HAVE_THREAD_SAFETY_ATTRIBUTES -- failed to compile
-- Performing Test HAVE_GNU_POSIX_REGEX -- failed to compile
-- Performing Test HAVE_POSIX_REGEX -- success
-- Performing Test HAVE_STEADY_CLOCK -- success
-- Configuring done
-- Generating done
-- Build files have been written to: /home/wen_fei/OpenHarmony/llvm/out/llvm_make
INFO:__main__:check_call:22:34:51 /home/wen_fei/OpenHarmony/llvm/prebuilts/cmake/linux-x86/bin/ninja
[92/3581] Building CXX object tools/gold/CMakeFiles/LLVMgold.dir/gold-plugin.cpp.o
FAILED: tools/gold/CMakeFiles/LLVMgold.dir/gold-plugin.cpp.o
/home/wen_fei/OpenHarmony/llvm/prebuilts/clang/ohos/linux-x86_64/clang-10.0.1/bin/clang++  -DGTEST_HAS_RTTI=0 -D_GNU_SOURCE -D__STDC_CONSTANT_MACROS -D__STDC_FORMAT_MACROS -D__STDC_LIMIT_MACROS -Itools/gold -I/home/wen_fei/OpenHarmony/llvm/toolchain/llvm-project/llvm/tools/gold -Iinclude -I/home/wen_fei/OpenHarmony/llvm/toolchain/llvm-project/llvm/include -fstack-protector-strong -fPIE -stdlib=libc++ -stdlib=libc++ -fPIC -fvisibility-inlines-hidden -Werror=date-time -Werror=unguarded-availability-new -Wall -Wextra -Wno-unused-parameter -Wwrite-strings -Wcast-qual -Wmissing-field-initializers -pedantic -Wno-long-long -Wc++98-compat-extra-semi -Wimplicit-fallthrough -Wcovered-switch-default -Wno-noexcept-type -Wnon-virtual-dtor -Wdelete-non-virtual-dtor -Wno-comment -Wstring-conversion -Wmisleading-indentation -fdiagnostics-color -ffunction-sections -fdata-sections -flto=thin -O3 -DNDEBUG -fPIC    -fno-exceptions -fno-rtti -std=c++14 -MD -MT tools/gold/CMakeFiles/LLVMgold.dir/gold-plugin.cpp.o -MF tools/gold/CMakeFiles/LLVMgold.dir/gold-plugin.cpp.o.d -o tools/gold/CMakeFiles/LLVMgold.dir/gold-plugin.cpp.o -c /home/wen_fei/OpenHarmony/llvm/toolchain/llvm-project/llvm/tools/gold/gold-plugin.cpp
/home/wen_fei/OpenHarmony/llvm/toolchain/llvm-project/llvm/tools/gold/gold-plugin.cpp:38:10: fatal error: 'plugin-api.h' file not found
#include 
         ^~~~~~~~~~~~~~
1 error generated.
[125/3581] Linking CXX shared library lib/libLTO.so.15
clang-10: warning: argument unused during compilation: '-pie' [-Wunused-command-line-argument]
ninja: build stopped: subcommand failed.
Traceback (most recent call last):
  File "./toolchain/llvm-project/llvm-build/build.py", line 1855, in 
    main()
  File "./toolchain/llvm-project/llvm-build/build.py", line 1816, in main
    llvm_core.llvm_compile(
  File "./toolchain/llvm-project/llvm-build/build.py", line 556, in llvm_compile
    self.build_llvm(targets=self.build_config.TARGETS,
  File "./toolchain/llvm-project/llvm-build/build.py", line 431, in build_llvm
    self.invoke_ninja(out_path=build_dir,
  File "./toolchain/llvm-project/llvm-build/build.py", line 256, in invoke_ninja
    self.check_call([ninja_bin_path] + ninja_list + ninja_target, cwd=out_path, env=env)
  File "./toolchain/llvm-project/llvm-build/build.py", line 325, in check_call
    subprocess.check_call(cmd, *args, **kwargs)
  File "/usr/lib/python3.8/subprocess.py", line 364, in check_call
    raise CalledProcessError(retcode, cmd)
subprocess.CalledProcessError: Command '['/home/wen_fei/OpenHarmony/llvm/prebuilts/cmake/linux-x86/bin/ninja']' returned non-zero exit status 1.

【问题分析】

出现该错误是需要安装binutils-dev

【问题处理】

  • 执行如下命令

    sudo apt-get -f -y install binutils-dev
  • 使用以下命令查找plugin-api.h文件是否存在

    $ find /usr -name plugin-api.h
    /usr/include/plugin-api.h
    /usr/lib/gcc/arm-none-eabi/9.2.1/plugin/include/plugin-api.h
    /usr/lib/gcc/x86_64-linux-gnu/9/plugin/include/plugin-api.h

3.3 编译报fatal error: 'asm/errno.h'问题处理

【问题描述】

执行命令python3 ./toolchain/llvm-project/llvm-build/build.py报错如下:

-- check-shadowcallstack does nothing.
-- Configuring done
-- Generating done
CMake Warning:
  Manually-specified variables were not used by the project:
​
    LLVM_BUILD_TOOLS
​
​
-- Build files have been written to: /home/wen_fei/OpenHarmony/llvm/out/llvm_make/runtimes/runtimes-bins
[2892/3455] Performing build step for 'runtimes'
[819/1056] Building C object compiler-rt/lib/profile/CMakeFiles/clang_rt.profile-i386.dir/GCDAProfiling.c.o
FAILED: compiler-rt/lib/profile/CMakeFiles/clang_rt.profile-i386.dir/GCDAProfiling.c.o
/home/wen_fei/OpenHarmony/llvm/out/llvm_make/./bin/clang --target=x86_64-unknown-linux-gnu -D__STDC_CONSTANT_MACROS -D__STDC_FORMAT_MACROS -D__STDC_LIMIT_MACROS -I/home/wen_fei/OpenHarmony/llvm/toolchain/llvm-project/compiler-rt/lib/profile/.. -I/home/wen_fei/OpenHarmony/llvm/toolchain/llvm-project/compiler-rt/lib/profile/../../include -fPIC -fno-semantic-interposition -Werror=date-time -Werror=unguarded-availability-new -Wall -Wextra -Wno-unused-parameter -Wwrite-strings -Wmissing-field-initializers -Wimplicit-fallthrough -Wcovered-switch-default -Wno-comment -Wstring-conversion -Wmisleading-indentation -fdiagnostics-color -ffunction-sections -fdata-sections -Wall -Wno-unused-parameter -O3 -DNDEBUG   -m32 -fno-lto -fPIC -Wno-pedantic -DCOMPILER_RT_HAS_ATOMICS=1 -DCOMPILER_RT_HAS_FCNTL_LCK=1 -DCOMPILER_RT_HAS_UNAME=1 -nostdinc++ -MD -MT compiler-rt/lib/profile/CMakeFiles/clang_rt.profile-i386.dir/GCDAProfiling.c.o -MF compiler-rt/lib/profile/CMakeFiles/clang_rt.profile-i386.dir/GCDAProfiling.c.o.d -o compiler-rt/lib/profile/CMakeFiles/clang_rt.profile-i386.dir/GCDAProfiling.c.o   -c /home/wen_fei/OpenHarmony/llvm/toolchain/llvm-project/compiler-rt/lib/profile/GCDAProfiling.c
In file included from /home/wen_fei/OpenHarmony/llvm/toolchain/llvm-project/compiler-rt/lib/profile/GCDAProfiling.c:24:
In file included from /usr/include/errno.h:28:
In file included from /usr/include/bits/errno.h:26:
/usr/include/linux/errno.h:1:10: fatal error: 'asm/errno.h' file not found
#include 
         ^~~~~~~~~~~~~
1 error generated.

【问题分析】

/usr/include/目录下有x86_64-linux-gnu/asm目录却没有asm目录,需要手动创建软链接

【问题处理】

执行如下命令即可

sudo su
cd /usr/include
ln -s x86_64-linux-gnu/asm asm

你可能感兴趣的:(鸿蒙系统,linux,git,bash,鸿蒙,鸿蒙系统)