OSCHINA-MIRROR/tboox-xrepo

xrepo: кроссплатформенный менеджер пакетов C/C++ на основе Xmake

Поддержка проекта

Поддержите этот проект, став спонсором. Ваш логотип будет отображаться здесь с ссылкой на ваш веб-сайт. 🙏 Станьте спонсором.

Введение

xrepo — это кроссплатформенный менеджер пакетов C/C++, основанный на Xmake (https://github.com/xmake-io/xmake). Он основан на среде выполнения, предоставляемой xmake, но представляет собой полноценную и независимую программу управления пакетами. По сравнению с такими менеджерами пакетов, как vcpkg/homebrew, xrepo может предоставлять пакеты C/C++ для большего количества платформ и архитектур одновременно.

Он также поддерживает многоверсионное семантическое выделение. Кроме того, это децентрализованный распределённый репозиторий. Он не только предоставляет официальный репозиторий xmake-repo (https://github.com/xmake-io/xmake-repo), но и поддерживает создание пользователями нескольких частных репозиториев.

В то же время xrepo также поддерживает установку пакетов из сторонних менеджеров пакетов, таких как vcpkg/homebrew/conan, и предоставляет унифицированную и согласованную информацию о ссылках на библиотеки, чтобы облегчить интеграцию и стыковку со сторонними проектами.

Если вы хотите узнать больше, пожалуйста, обратитесь к: Документам (https://xrepo.xmake.io/#/getting_started), Github (https://github.com/xmake-io/xrepo) и Gitee (https://gitee.com/tboox/xrepo).

Установка

Нам нужно только установить xmake, чтобы использовать команду xrepo. Об установке xmake см.: Документ по установке Xmake (https://xmake.io/#/guide/installation).

Поддерживаемые платформы

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 (https://github.com/xmake-io/xmake-repo) (tbox >1.6.1);
Пользовательские репозитории (https://xmake.io/#/package/remote_package?id=using-self-built-private-package-repository);
Conan (conan::openssl/1.1.1g);
Vcpkg (vcpkg:ffmpeg);
Homebrew/Linuxbrew (brew::pcre2/libpcre2-8);
Pacman на archlinux/msys2 (pacman::libcurl);
Clib (clib::clibs/bytes@0.0.4);
Dub (dub::log 0.4.3).

Распределённый репозиторий

Помимо прямого извлечения установочного пакета из официального репозитория: xmake-repo (https://github.com/xmake-io/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.

Начало работы

Установочный пакет

Базовое использование

$ xrepo install zlib tbox

Установка определённой версии пакета

$ 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 import -i /xxx/packagedir 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)

Кроме того, теперь вы можете искать их пакеты в сторонних менеджерах пакетов, таких как vcpkg, conan, conda и apt. Вам нужно только добавить соответствующее пространство имён пакетов, например:

$ xrepo search vcpkg::pcre
The package names:
     vcpkg::pcre:
       -> vcpkg::pcre-8.44#8: Perl Compatible Regular Expressions
       -> vcpkg::pcre2-10.35#2: PCRE2 is a re-working of the original Perl Compatible Regular Expressions library

$ xrepo search conan::openssl
The package names:
     conan::openssl: ### Показать информацию о пакете

Show package environment information

$ xrepo env --show luajit
{
   OLDPWD = "/mnt/tbox",
   HOME = "/home/ruki",
   PATH = "/home/ruки/.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/ruки/.xmake/packages/l/luajit/2.1.0-beta3/fbac76d823b844f0b91abf3df0a3bc61/lib",
   SHLVL = "1",
   _ = "/mnt/xmake/scripts/xrepo.sh"
}

Загрузить окружение пакета и выполнить команды

$ xrepo env luajit
LuaJIT 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 ..

Виртуальное окружение пакета

Войти в виртуальное окружение

Мы можем настроить некоторые конфигурации пакетов, добавив файл xmake.lua в текущий каталог, а затем войти в конкретное виртуальное окружение пакета.

add_requires("zlib 1.2.11")
add_requires("python 3.x", "luajit")

$ xrepo env shell
> python --version
> luajit --version

Также мы можем настроить и загрузить соответствующую среду инструментальной цепочки в xmake.lua, например, загрузить среду компиляции VS.

set_toolchains("msvc")

Управлять виртуальными окружениями

Мы можем использовать следующую команду для регистрации указанной конфигурации виртуального окружения глобально в системе для быстрого переключения.

$ xrepo env --add /tmp/base.lua

В это время мы сохранили глобальное виртуальное окружение под названием base, и мы можем просмотреть его с помощью команды list.

$ xrepo env --list
/Users/ruki/.xmake/envs:
  -base
envs(1) found!

Мы также можем удалить его.

$ xrepo env --remove base

Переключать глобальные виртуальные окружения

Если мы зарегистрируем несколько виртуальных окружений, мы также сможем быстро переключать их.

$ xrepo env -b base shell
> python --version

Или напрямую загрузите указанное виртуальное окружение для выполнения конкретных команд.

$ xрепо env -b база питон --версия

xrepo env -b/--bind предназначен для привязки указанного виртуального окружения. Для получения более подробной информации см.: #1762.

Показать данную информацию о пакете

$ xrepo info zlib
Информация о пакете проекта:
    require(zlib):
      -> описание: A Massively Spiffy Yet Delicately Unobtrusive Compression Library
      -> версия: 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
      -> репо: xmake-repo https://gitee.com/tboox/xmake-repo.git master
      -> кэшдир: /Users/ruki/.xmake/cache/packages/2010/z/zlib/1.2.11
      -> инсталлятор: /Users/ruki/.xmake/packages/z/zlib/1.2.11/d639b7d6e3244216b403b39df5101abf
      -> поискдирс:
      -> поискнэймс: zlib-1.2.11.tar.gz
      -> fetchinfo: 1.2.11, система
          -> версия: 1.2.11
          -> ссылки: z
          -> linkdirs: /usr/локальный/Cellar/zlib/1.2.11/lib
          -> includedirs: /usr/локальный/Cellar/zlib/1.2.11/include
      -> платформы: iphoneos, mingw@windows, macosx, mingw@linux,macosx, android@linux,macosx, windows, linux
      -> требует:
         -> plat: macosx
         -> arch: x86_64
         -> конфиги:
            -> отладка: ложь
            -> vs_runtime: MT
            -> общий доступ: ложь
      -> конфиги:
      -> конфиги (встроенный):
         -> отладка: включить символы отладки. (по умолчанию: ложь)
         -> общий доступ: включить общую библиотеку. (по умолчанию: ложь)
         -> cflags: установить флаги компилятора C.
         ->
``` ### Установите флаги компиляторов C/C++ и C++

* **cxflags**: установите флаги компилятора C/C++.

* **cxxflags**: установите флаги компилятора C++.

* **asflags**: установите флаги ассемблера.

* **vs_runtime**: задайте среду выполнения компилятора VS (по умолчанию: MT).
    * **values**: {«MT», «MD»}.

### Удалите все пакеты

Мы можем использовать следующую команду, чтобы массово удалить установленные пакеты с поддержкой сопоставления с шаблоном:

```bash
$ xrepo remove --all
$ xrepo remove --all zlib pcr*

Контакты

Электронная почта: waruqi@gmail.com.
Домашняя страница: tboox.org.
Сообщество: /r/xmake на reddit.
Чат-комната: Char в Telegram, чат в Gitter.
Исходный код: Github, Gitee.
Группа QQ: 343118190 (техническая поддержка), 662147501.
Публичный WeChat: tboox-os.