xrepo 是一个基于 Xmake 的跨平台 C/C++ 包管理器。

  • 我的项目源码
  • 官网文档

它基于 xmake 提供的运行时，但却是一个残缺独立的包管理程序，相比 vcpkg/homebrew 此类包管理器，xrepo 可能同时提供更多平台和架构的 C/C++ 包。

并且还反对多版本语义抉择，另外它还是一个去中心化的分布式仓库，不仅仅提供了官网的 xmake-repo 仓库，还反对用户自建多个公有仓库。

同时，xrepo 也反对从 vcpkg/homebrew/conan 等第三方包管理器中安装包，并提供对立统一的库链接信息，不便与第三方我的项目的集成对接。

如果你想要理解更多，请参考：在线文档, Github 以及 Gitee

装置

咱们只须要装置上 xmake 就能够应用 xrepo 命令，对于 xmake 的装置，咱们能够看下：xmake 装置文档。

反对平台

  • Windows (x86, x64)
  • macOS (i386, x86_64, arm64)
  • Linux (i386, x86_64, cross-toolchains ..)
  • *BSD (i386, x86_64)
  • Android (x86, x86_64, armeabi, armeabi-v7a, arm64-v8a)
  • iOS (armv7, armv7s, arm64, i386, x86_64)
  • MSYS (i386, x86_64)
  • MinGW (i386, x86_64, arm, arm64)
  • Cross Toolchains

反对的包治理仓库

  • 官网自建仓库 xmake-repo (tbox >1.6.1)
  • 用户自建仓库
  • Conan (conan::openssl/1.1.1g)
  • Vcpkg (vcpkg:ffmpeg)
  • Homebrew/Linuxbrew (brew::pcre2/libpcre2-8)
  • Pacman on archlinux/msys2 (pacman::libcurl)
  • Clib (clib::clibs/bytes@0.0.4)
  • Dub (dub::log 0.4.3)

分布式仓库反对

除了能够间接从官网仓库：xmake-repo 检索安装包之外，
咱们还能够增加任意多个自建的仓库，甚至能够齐全隔离外网，仅仅在公司外部网络保护公有包的装置集成。

只须要通过上面的命令，增加上本人的仓库地址：

$ xrepo add-repo myrepo https://github.com/mygroup/myrepo

与 xmake 的工程无缝集成

add_requires("tbox >1.6.1", "libuv master", "vcpkg::ffmpeg", "brew::pcre2/libpcre2-8")add_requires("conan::openssl/1.1.1g", {alias = "openssl", optional = true, debug = true})target("test")    set_kind("binary")    add_files("src/*.c")    add_packages("tbox", "libuv", "vcpkg::ffmpeg", "brew::pcre2/libpcre2-8", "openssl")

上面是与 xmake 集成的整体架构和编译流程。

<img src="https://xmake.io/assets/img/index/package_arch.png" width="650px" />

疾速上手

安装包

根本应用

$ xrepo install zlib tbox

装置指定版本包

残缺反对 Semantic Versioning (语义版本)。

$ xrepo install "zlib 1.2.x"$ xrepo install "zlib >=1.2.0"

装置指定平台包

$ xrepo install -p iphoneos -a arm64 zlib$ xrepo install -p android [--ndk=/xxx] zlib$ xrepo install -p mingw [--mingw=/xxx] zlib$ xrepo install -p cross --sdk=/xxx/arm-linux-musleabi-cross zlib

装置调试版本包

$ xrepo install -m debug zlib

装置动静库版本包

$ xrepo install -k shared zlib

装置指定配置包

$ xrepo install -f "vs_runtime=MD" zlib$ xrepo install -f "regex=true,thread=true" boost

装置第三方包管理器的包

$ xrepo install brew::zlib$ xrepo install vcpkg::zlib$ xrepo install conan::zlib/1.2.11$ xrepo install pacman:libpng$ xrepo install dub:log

查找包的库应用信息

$ xrepo fetch pcre2{  {    linkdirs = {      "/usr/local/Cellar/pcre2/10.33/lib"    },    links = {      "pcre2-8"    },    defines = {      "PCRE2_CODE_UNIT_WIDTH=8"    },    includedirs = "/usr/local/Cellar/pcre2/10.33/include"  }}
$ xrepo fetch --ldflags openssl-L/Users/ruki/.xmake/packages/o/openssl/1.1.1/d639b7d6e3244216b403b39df5101abf/lib -lcrypto -lssl
$ xrepo fetch --cflags openssl-I/Users/ruki/.xmake/packages/o/openssl/1.1.1/d639b7d6e3244216b403b39df5101abf/include
$ xrepo fetch -p [iphoneos|android] --cflags "zlib 1.2.x"-I/Users/ruki/.xmake/packages/z/zlib/1.2.11/df72d410e7e14391b1a4375d868a240c/include
$ xrepo fetch --cflags --ldflags conan::zlib/1.2.11-I/Users/ruki/.conan/data/zlib/1.2.11/_/_/package/f74366f76f700cc6e991285892ad7a23c30e6d47/include -L/Users/ruki/.conan/data/zlib/1.2.11/_/_/package/f74366f76f700cc6e991285892ad7a23c30e6d47/lib -lz

导出装置后的包

xrepo 能够疾速导出曾经装置后的包，包含对应的库文件，头文件等等。

$ xrepo export -o /tmp/output zlib

搜寻反对的包

$ xrepo search zlib "pcr*"    zlib:      -> zlib: A Massively Spiffy Yet Delicately Unobtrusive Compression Library (in xmake-repo)    pcr*:      -> pcre2: A Perl Compatible Regular Expressions Library (in xmake-repo)      -> pcre: A Perl Compatible Regular Expressions Library (in xmake-repo)

查看包环境信息

$ xrepo env --show luajit{  OLDPWD = "/mnt/tbox",  HOME = "/home/ruki",  PATH = "/home/ruki/.xmake/packages/l/luajit/2.1.0-beta3/fbac76d823b844f0b91abf3df0a3bc61/bin:/tmp:/tmp/arm-linux-musleabi-cross/bin:~/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",  TERM = "xterm",  PWD = "/mnt/xmake",  XMAKE_PROGRAM_DIR = "/mnt/xmake/xmake",  HOSTNAME = "e6edd61ff1ab",  LD_LIBRARY_PATH = "/home/ruki/.xmake/packages/l/luajit/2.1.0-beta3/fbac76d823b844f0b91abf3df0a3bc61/lib",  SHLVL = "1",  _ = "/mnt/xmake/scripts/xrepo.sh"}

加载执行包环境并运行命令

$ xrepo env luajitLuaJIT 2.1.0-beta3 -- Copyright (C) 2005-2017 Mike Pall. http://luajit.org/JIT: ON SSE2 SSE3 SSE4.1 BMI2 fold cse dce fwd dse narrow loop abc sink fuse>
$ xrepo env -b "luajit 2.x" luajit$ xrepo env -p iphoneos -b "zlib,libpng,luajit 2.x" cmake ..

查看包信息

$ xrepo info zlibThe package info of project:    require(zlib):      -> description: A Massively Spiffy Yet Delicately Unobtrusive Compression Library      -> version: 1.2.11      -> urls:         -> http://zlib.net/zlib-1.2.11.tar.gz            -> c3e5e9fdd5004dcb542feda5ee4f0ff0744628baf8ed2dd5d66f8ca1197cb1a1         -> https://downloads.sourceforge.net/project/libpng/zlib/1.2.11/zlib-1.2.11.tar.gz            -> c3e5e9fdd5004dcb542feda5ee4f0ff0744628baf8ed2dd5d66f8ca1197cb1a1      -> repo: xmake-repo https://gitee.com/tboox/xmake-repo.git master      -> cachedir: /Users/ruki/.xmake/cache/packages/2010/z/zlib/1.2.11      -> installdir: /Users/ruki/.xmake/packages/z/zlib/1.2.11/d639b7d6e3244216b403b39df5101abf      -> searchdirs:      -> searchnames: zlib-1.2.11.tar.gz      -> fetchinfo: 1.2.11, system          -> version: 1.2.11          -> links: z          -> linkdirs: /usr/local/Cellar/zlib/1.2.11/lib          -> includedirs: /usr/local/Cellar/zlib/1.2.11/include      -> platforms: iphoneos, mingw@windows, macosx, mingw@linux,macosx, android@linux,macosx, windows, linux      -> requires:         -> plat: macosx         -> arch: x86_64         -> configs:            -> debug: false            -> vs_runtime: MT            -> shared: false      -> configs:      -> configs (builtin):         -> debug: Enable debug symbols. (default: false)         -> shared: Enable shared library. (default: false)         -> cflags: Set the C compiler flags.         -> cxflags: Set the C/C++ compiler flags.         -> cxxflags: Set the C++ compiler flags.         -> asflags: Set the assembler flags.         -> vs_runtime: Set vs compiler runtime. (default: MT)            -> values: {"MT","MD"}

https://tboox.org/cn/2020/11/...