跳到主要内容

kmpkg_from_bitbucket

从 Bitbucket 下载并提取项目源码。

用法​

kmpkg_from_bitbucket(
    OUT_SOURCE_PATH <SOURCE_PATH>
    REPO <blaze-lib/blaze>
    [REF <v3.8.1>]
    [SHA512 <45d0d7f8cc350...>]
    [HEAD_REF <master>]
    [PATCHES <patch1.patch> <patch2.patch>...]
)

参数​

OUT_SOURCE_PATH​

指定用于存储提取后源码路径的输出变量。 按照惯例，应将该变量名设为 SOURCE_PATH。

REPO​

Bitbucket 平台上的组织/用户名称 + 仓库名称（格式：<组织/用户>/<仓库>）。

REF​

稳定的 Git 提交引用（优先推荐使用标签/tag），其对应的源码内容不会变更。禁止将分支名作为该参数的值。

对于无官方发布版本的仓库，可将此参数设为当前 master 分支最新提交的完整提交 ID。kmpkg_from_bitbucket() 会从 https://bitbucket.com/<REPO>/get/<REF>.tar.gz 下载该提交的稳定快照（不含版本历史信息）。

若指定了 REF，则必须同时指定 SHA512 参数。

SHA512​

源码归档文件的 SHA512 哈希值。

获取该值最便捷的方式：先将此参数设为 0，然后尝试构建该端口；构建失败时的报错信息会包含文件完整的 SHA512 哈希值，直接复制该值回填到端口文件即可。

HEAD_REF​

用于 --head 模式构建的非稳定 Git 提交引用（优先推荐使用分支/branch）。

对于大多数项目，建议设为 master。所选分支需保证在所有支持的平台上始终可构建。

PATCHES​

要应用到提取后源码上的补丁文件列表。

补丁文件的相对路径以当前端口目录为基准。

说明​

REF 和 HEAD_REF 至少需指定其中一个，建议同时提供两者。

在 --head 模式构建时，该函数会导出 KMPKG_HEAD_VERSION 变量。

示例​

源码​

scripts/cmake/kmpkg_from_bitbucket.cmake