Repository navigation
Development ru RU
На этой странице описаны настройка среды разработки, восстановление зависимостей, сборка и отладка Proxirae, а также подготовка релизных сборок.
Чтобы собрать и запустить Proxirae из исходного кода, подготовьте среду разработки и восстановите необходимые зависимости. В следующих разделах описаны требуемые инструменты и настройка зависимостей перед сборкой приложения.
Proxirae разрабатывается с использованием Visual Studio 2022. Решение содержит проекты на C#, включая настольное приложение WPF, и нативное сетевое ядро на C++.
Откройте Visual Studio Installer, выберите установленную версию Visual Studio 2022 и убедитесь, что установлены следующие рабочие нагрузки:
- Разработка классических приложений .NET — для компонентов на C# и WPF.
- Разработка классических приложений на C++ — для нативного сетевого ядра.
Для управления зависимостями C++ Proxirae использует Conan.
Выполните следующие команды из каталога, содержащего рецепт Conan:
conan install . -s arch=x86_64 -s build_type=Debug --build=missing
conan install . -s arch=x86 -s build_type=Debug --build=missing
conan install . -s arch=x86_64 -s build_type=Release --build=missing
conan install . -s arch=x86 -s build_type=Release --build=missingКоманды устанавливают зависимости для указанных архитектур и конфигураций сборки. Параметр --build=missing позволяет Conan собрать пакет из исходного кода, если совместимый бинарный пакет отсутствует.
При сборке решения Visual Studio обычно восстанавливает пакеты NuGet автоматически, если включено автоматическое восстановление пакетов.
При необходимости зависимости можно восстановить вручную. Откройте терминал в каталоге решения и выполните:
dotnet restore Proxirae.slnЧтобы запустить приложение в конфигурации Debug:
- Откройте решение в Visual Studio 2022.
- Настройте запуск обоих проектов:
Proxirae.NetworkиProxirae.Presentation.WPF. - Запустите отладку с помощью F5.
В текущем процессе отладки оба проекта должны запускаться одновременно.
В проектах Proxirae на C# и C++ используются единые соглашения об именовании с несколькими исключениями, связанными с языком и структурой каталогов.
-
Названия классов —
PascalCaseдля C# и C++. -
Файлы и каталоги C# —
PascalCase. -
Каталоги C++ —
camelCase, название начинается со строчной буквы. -
Файлы C++ — как правило,
PascalCase. В частях кодовой базы, где используется традиционный стиль именования C, применяетсяkebab-case, например в каталогеplatform/environment.
Процесс выпуска релиза включает сборку нативного ядра C++, публикацию приложения WPF, подготовку структуры каталогов установщика и его компиляцию с помощью Inno Setup.
Соберите Proxirae.Network в конфигурации Release для обеих поддерживаемых архитектур:
- x64
- Win32 (x86)
Чтобы переключить проект C++ на Win32, откройте Сборка → Диспетчер конфигураций и измените платформу проекта там. Не используйте для этого только переключатель платформы на главной панели Visual Studio.
Результат сборки размещается в соответствующем каталоге x64 или Win32.
Используйте команду Publish для проекта Proxirae.Presentation.WPF, чтобы опубликовать приложение для нужной архитектуры Windows.
Опубликованные файлы приложения WPF размещаются в каталоге x86.
Установщик использует нативное ядро, размещённое в каталоге Core в корне проекта.
Для сборки Win32 скопируйте содержимое каталога с результатами сборки Win32 в Core. Сохраните структуру каталогов, чтобы она соответствовала структуре версии x64.
Откройте файл installer.iss в корневой папке проекта.
Измените версию релиза в скрипте, затем скомпилируйте его с помощью Inno Setup.
Если в installer.iss не требуется менять ничего, кроме номера версии, скомпилированный установщик появится в каталоге installer.
Опубликуйте скомпилированный установщик из каталога installer в качестве артефакта релиза.