1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/royqh1979-RedPanda-CPP

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
BUILD_cn.md 11 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
Отправлено 03.03.2025 22:05 36acfe0

Общие сведения для разработки

Коала C++ требует Qt 5.15 или 6.8+.

Рекомендованная среда разработки:

  1. Visual Studio Code.
    • Лучшая производительность.
  2. Qt Creator.
    • Минимальная конфигурация.
    • Встроенное окно дизайнеров.
    • Интегрированный отладчик Qt.

Шаги по установке среды разработки в Visual Studio Code: 0. Включите "режим разработчика" в настройках Windows. Активируйте опцию core.symlinks в Git (git config core.symlinks true).

  1. Установите xmake и расширение XMake для VSCode.
  2. Установите расширение C/C++ для VSCode для поддержки языка и отладки.
  3. Установите clangd и расширение clangd для VSCode для лучшего анализа кода (по необходимости).
  4. Настройте рабочую область:
    • Команда компиляции: .vscode/compile_commands.json (панель команд "C/C++: Edit configuration (UI)");
    • "Clangd: Arguments": --compile-commands-dir=.vscode;
    • "Xmake: Additional Config Arguments": например --qt=/usr.
  5. Выполните "XMake: Update Intellisense" на панели команд для создания базы данных компиляций.

* Подсказка: использование xmake позволяет поддерживать генерацию базы данных компиляций и тестовых матриц, но пока это не полностью реализовано.

Windows

Библиотека + цепочка инструментов \ Целевой архитектуре x86 x64 ARM64
MSYS2 + MinGW на основе GNU ✔️
MSYS2 + MinGW на основе LLVM ✔️ ✔️
Windows NT 5.x + MinGW Lite ✔️ ✔️

Дополнительно см. детальное руководство по сборке — Windows.

Qt библиотека + цепочка инструментов MinGW (рекомендовано)

Коала C++ должна собираться с помощью 64-битной цепочки инструментов MinGW MSYS2, включая среду на основе GNU (MINGW64, UCR64) с GCC и Clang, а также среду на основе LLVM (CLANG64, CLANGARM64) с Clang. Подробнее о средах читайте в документации MSYS2. Несколько цепочек инструментов были хорошо протестированы:

  • MINGW64 GCC,
  • UCR64 GCC (рекомендуется для x64),
  • CLANGARM64 Clang (единственный доступный и рекомендуемый вариант для ARM64).

Официальные версии Коалы C++ собираются с использованием MINGW32 GCC (архивировано) и MINGW64 GCC.

Предварительные условия:

  1. Windows 10 x64 или более новая версия, или Windows 11 ARM64.
  2. Установите MSYS2.
  3. Установите цепочку инструментов, Qt 5 библиотеки и другие необходимые инструменты в выбранной среде:
    pacman -S \
      $MINGW_PACKAGE_PREFIX-{cc,make,qt5-static,7zip,cmake} \
      mingw-w64-i686-nsis \
      git curl

Чтобы собрать этот проект, запустите выбранную среду MSYS2 и выполните

./packages/msys/build-mingw.sh

для сборки установочных файлов и зелёных пакетов с использованием MinGW GCC инструментов или без компилятора; или выполните

./packages/msys/build-llvm.sh

для сборки установочных файлов с использованием LLVM MinGW инструментов.

Общие параметры:

  • -h, --help: вывод справочной информации.
  • -c, --clean: очистка директорий сборки.
  • -nd, --no-deps: проверка зависимостей не требуется.
  • -t <dir>, --target-dir <dir>: указание выходной директории. По умолчанию используется dist/.

Дополнительные параметры для build-mingw.sh:

  • --mingw32: добавляет assets/mingw32.7z в пакет.
  • --mingw64: добавляет assets/mingw64.7z в пакет.
  • --mingw: псевдоним для --mingw64 (для x64 программ).
  • --ucrt <build>: добавляет UCRT runtime из Windows SDK в пакет. Например --ucrt 22621 означает Windows 11 SDK 22H2.

Qt библиотека + цепочка инструментов MinGW Lite для Windows NT 5.x

Скрипт build-xp.sh аналогичен build-mingw.sh, но использует цепочку инструментов, предоставленную Qt библиотекой.

Предварительные условия для сборки:

  1. Windows 10 x64 или более новая версия.
  2. Установите MSYS2.

Чтобы выполнить эту сборку, запустите среду MSYS2 и выполните

./packages/msys/build-xp.sh -p 32-msvcrt

Чтобы выполнить кросс-сборку, выполните

podman run -it --rm -v $PWD:/mnt -w /mnt docker.io/amd64/ubuntu:24.04

# Внутри контейнера
export MIRROR=mirrors.ustc.edu.cn  # Укажите нужный зеркало
./packages/xmingw/build-xp.sh -p OnClickListener

Этот скрипт принимает все параметры, принятые build-mingw.sh, а также следующие:

  • -p|--profile <profile>: (обязательно) профиль компиляции MinGW Lite и Qt библиотеки. Доступные профили: 64-ucrt, 32-ucrt, 64-msvcrt, 32-msvcrt.

Linux

Дополнительно см. детальное руководство по сборке — системы сообразно стандартам freedesktop.org (XDG).

Alpine Linux, Arch Linux, Debian и её производные, Fedora, openSUSE

  1. Подготовьте среду сборки (Alpine, Arch, Debians, RPM документация).
    • Для систем на основе Debian:
      sudo apt install --no-install-recommends build-essential debhelper devscripts equivs
  2. Вызовите скрипты сборки:
    • Alpine Linux: ./packages/alpine/buildapk.sh
    • Arch Linux: ./packages/archlinux/buildpkg.sh
    • Debian и производные: ./packages/debian/builddeb.sh
    • Fedora: ./packages/fedora/buildrpm.sh
    • openSUSE: ./packages/opensuse/buildrpm.sh
  3. Установите пакеты:
    • Alpine Linux: ~/packages/unsupported/$(uname -m)/redpanda-cpp-git-*.apk
    • Arch Linux: /tmp/redpanda-cpp-git/redpanda-cpp-git-*.pkg.tar.zst
    • Debian и производные: /tmp/redpanda-cpp_*.deb
    • Fedora, openSUSE: ~/rpmbuild/RPMS/$(uname -m)/redpanda-cpp-git-*.rpm
  4. Запустите Коалу C++:
    RedPandaIDE

Примечание: эти скрипты сборки вытягивают HEAD этого репозитория, поэтому перед сборкой убедитесь, что все изменения были отправлены.

Кроме того, можно выполнять сборку в контейнерной среде (рекомендуется использовать rootless Podman; Docker может нарушить права доступа к файлам):

podman run --rm -v $PWD:/mnt -w /mnt <image> ./packages/<distro>/01-in-docker.sh

# Пример для Arch Linux
podman run --rm -v $PWD:/mnt -w /mnt docker.io/archlinux:latest ./packages/archlinux/01-in-docker.sh

Пакеты находятся в директории dist/.

Ubuntu 20.04 x86_64 (NOI Linux 2.0) статически связанный пакет

Пакет redpanda-cpp-bin представляет собой "переупакованный AppImage". Реальная сборка происходит внутри контейнера, поэтому хост машина не обязательно должна быть Ubuntu 20.04, достаточно любой Linux системы с Podman и dpkg.1. Установите Podman, если ваша система не является Debian или её производной, то установите dpkg.

sudo apt install podman

Внимание: не устанавливайте пакеты через dpkg на системах, отличных от Debian, так как это может повредить систему. 2. Вызовите скрипт сборки:

./packages/debian-static/builddeb.sh

Пакеты находятся в директории dist/.

Linux AppImage

podman run --rm -v $PWD:/mnt -w /mnt ghcr.io/redpanda-cpp/appimage-builder-x86_64:20241120.0 ./packages/appimage/01-in-docker.sh

Dockerfile находится в redpanda-cpp/appimage-builder. Доступные архитектуры: x86_64, aarch64, riscv64, loong64, i686.

macOS

Qt библиотека от Qt.io

Предварительные условия:

  1. Современная версия macOS, удовлетворяющая требованиям Qt 5 или Qt 6.
  2. Установите Xcode командную строку:
    xcode-select --install
  3. Установите Qt с помощью онлайн установщика от Qt.io или зеркала.
    • Выберите Qt библиотеку ("Qt" группу, "Qt 5.15.2" или "Qt 6.8.0", отметьте "macOS").

Чтобы собрать этот проект, выполните одну из следующих команд:

./packages/macos/build.sh -a x86_64 --qt-version 5.15.2
./packages/macos/build.sh -a x86_64 --qt-version 6.8.0
./packages/macos/build.sh -a arm64 --qt-version 6.8.0
./packages/macos/build.sh -a universal --qt-version 6.8.0

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/royqh1979-RedPanda-CPP.git
git@api.gitlife.ru:oschina-mirror/royqh1979-RedPanda-CPP.git
oschina-mirror
royqh1979-RedPanda-CPP
royqh1979-RedPanda-CPP
master