JoyPro2 Discord GitHub
Проект

От JoyPro 1 към JoyPro 2

Показване:

JoyPro 1 (от 2021 до 2023 г.) беше инструмент за DCS: създаваше връзки между входовете на различни самолети и ги назначаваше на едно и също място на ръчката. JoyPro 2 запазва точно тази идея и същия модел връзка / назначение / модификатор (профил от JoyPro 1 се отваря в JoyPro 2) и изгражда наново всичко около нея: нов интерфейс, ядро, което работи и самостоятелно, десетки игри, тестове за всяка функция и много безопасност.

#Числата

Всички числа са измерени върху изходния код на двата проекта (файлове, следени в git; редове код = непразни редове на C#, които не са коментари). Числата на JoyPro 2 са от компилацията на този сайт.

JoyPro 1 JoyPro 2
Разработка 2021-02-11 до 2023-11-15 от 2026-09-30
Комити 336 1,406
Редове код на C# 25,502 354,663 (13.9 x)
C# файлове 77 954
Типове (класове, записи, изброявания ...) 106 3,059 (29 x)
Методи 450 16,702 (37 x)
Автоматизирани тестове (модулни, на модела на изгледа, на изобразяването) 0 1,537 в 198 тестови файла
Части на бързия тест на ядрото (истинското ядро върху тестови папки) 0 87
Проекти в решението 2 12
Редове с описание на интерфейса 973 (WPF XAML) 17,250 (Avalonia AXAML)
Редове документация (Markdown) 109 25,636
Игри 1 (DCS), по-късно IL-2 36 поддържани от JoyPro, 57 проучени заглавия
Езици на интерфейса 1 39
Команди на ядрото (команден ред) няма (само графичен интерфейс) 451 в 60 области, 19 глобални опции
Елементи на интерфейса, описани в този сайт 1097

Къде се намира кодът в JoyPro 2 (редове C# код): ядро 187,202, графичен интерфейс 80,286, тестове на интерфейса 56,600, обратна сила 14,394.

flowchart LR
  W["Един прозорец<br/>(екран и логика<br/>в едно)"] --> D1["Файлове на DCS"]
JoyPro 1: един прозорец, който правеше всичко, за DCS.
flowchart TB
  G["Прозорецът"] --> E["Ядрото<br/>(изпълнява всяко действие)"]
  G --> F["Помощник за<br/>обратната сила"]
  G --> V["Помощник за<br/>виртуалния joystick"]
  T["Наблюдател<br/>в системната област"] --> E
  E --> D2["36 игри"]
  F ~~~ V
JoyPro 2: прозорец, който предава всяко действие на ядрото, с помощници за обратната сила, виртуалния joystick и наблюдателя.
За начинаещи

#Какво е по-добро за Вас

  • Много игри, един профил. JoyPro 1 беше за DCS. JoyPro 2 импортира и експортира 36 игри: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 и 2024, X-Plane 11 и 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma и други. Една връзка съдържа една и съща функция във всички тях.
  • Започнете от това, което имате. Импортирането прочита съществуващите Ви назначения от всяка игра; настройката при първото стартиране сама намира игрите Ви.
  • Нищо не може да се развали завинаги. Всяко експортиране първо прави резервно копие на файловете на играта, а Отмяна на последното експортиране ги връща байт по байт. Всяка промяна в JoyPro се запазва автоматично и може да бъде отменена, дори след рестартиране (история на профила).
  • Казва Ви какво би се объркало. Проверката обяснява проблемите с думите на играта и ги поправя с едно щракване.
  • Настройва се сам. Настрой всичко вместо мен поставя важните функции на Вашата ръчка, газ и педали. Разглеждате списъка и натискате Използвай тези бутони и Запиши в моята игра.
  • По-малко щракане. Предложенията, Авто групиране, Авто назначаване, съветникът за настройка и помощникът на JoyPro изграждат връзки и назначения вместо Вас; наученият „Ваш стил“ следва начина, по който сте го правили преди.
  • Забелязва промените. Когато промените назначение в самата игра, JoyPro пита след затварянето на играта дали да го вземе в профила Ви.
  • Вашият език. Интерфейсът говори 39 езика.
  • Повече от назначения. Снимки на устройствата и бележници, HUD и наслагване за стрийм, обратна сила от телеметрията, виртуален joystick за игри, които четат само едно устройство, симулиран контролер (виртуален Xbox геймпад) за игри, които познават само Xbox контролер, база данни с кабини, статистика за това, с какво летите.
  • Помощ за всеки бутон. F1 обяснява всеки бутон, обиколките сочат истинските бутони, а Прости думи поддържа текстовете кратки.
  • Без допълнителни среди за изпълнение за търсене. Изданието е един zip архив с всичко вътре; без SlimDX, без C++ среди за изпълнение.
За напреднали

#Функция по функция

Област JoyPro 1 JoyPro 2
Връзки на ръка, DCS id на ръка с търсене във всяка игра, синоними, каталога с функции, предложения с причини, Авто групиране, групиране по описание, асистент; „същото id, различно значение“ за всеки самолет в DCS
Назначения записване на бутон или ос записване, следване на входа, назначаване върху снимката на устройството, Авто назначаване за всяка комбинация от устройства, съветник за настройка, Подреди с AI
Настройка на осите кривина, мъртва зона, насищане в DCS за всяка игра в собствения ѝ модел на отклик, обхвати за всеки самолет, калибриране, режим с детент
Модификатори да да, със страница за модификатори, комбинации, превод за всяка игра (BMS shift, ...)
Експортиране DCS (clean, nuke) всяка игра; четири режима плюс „изчистване и на другите“, за всеки самолет, минимална разлика спрямо стойностите по подразбиране на DCS, отметки за назначения, които не са записани, резервни копия и отмяна
Импортиране DCS всяка игра, със стойности по подразбиране, клавиатура, сливане на устройства, повторно импортиране на имена/групи/модификатори
Безопасност „направете си резервно копие сами“ автоматични резервни копия с версии, отказва да записва, докато играта работи, история на профила с отмяна между сесиите, пясъчник за запис при тестовете
Проверки validate Проверката: карти с думите на играта, поправки с едно щракване, причина от историята
Оформления експортиране на снимки на оформлението референтни снимки на устройства (точен модел по VID:PID и HID име), бележници, 3D изгледи на устройства
Наслагване наслагване в играта HUD дизайнер, наслагване, страница за стрийм за OBS, входове на живо
Списък с игри доставена база данни (html) изгражда се на вашия компютър от собствената ви инсталация, опреснява се след актуализации на игрите
Следене няма наблюдател на конфигурациите на игрите с хост в системната област, пита след излизане от играта
Обратна сила няма обратна сила от телеметрията за DCS, IL-2, War Thunder и други (JoyPro.Ffb)
Виртуални устройства няма vJoy / режим Xbox геймпад с HidHide, виртуални функции, импортиране от Joystick Gremlin
Езици Английски 39
Актуализации изтегляне на ръка проверка за актуализации с бележки към изданието, инсталиране с проверка на контролната сума
Доклади за проблеми питайте в Discord един файл за поддръжка с логове, настройки и (при поискване) профила; потребителската папка е заменена; нищо не се качва
Технически подробности

#Архитектура и качество

  • Разделение на ядро и GUI. JoyPro 1 беше едно WPF приложение с логиката в кода на прозореца. JoyPro 2 има ядро (engine.exe, .NET Framework 4.8, обикновен C#), което съдържа цялата логика за профила, импортирането/експортирането и базата данни като 451 команди, и Avalonia GUI (.NET 9), който стартира ядрото за всяко действие. Бързите интерактивни команди отиват към един дълго работещ engine serve, така че GUI остава бърз, без да се отказва от разделението. Всичко, което прави GUI, може да се автоматизира със скрипт (вижте командния ред на ядрото).
  • Отделни процеси за постоянните задачи: JoyPro.Ffb.exe (обратна сила от телеметрията), JoyPro.VJoy.exe (препращането към виртуалния joystick), JoyPro.Tray.exe (наблюдателят, докато GUI е затворен), всеки с ограничения на ресурсите и дълготрайни тестове, така че да остават незабележими във фонов режим.
  • Тестове: 1,537 автоматични теста (xUnit: логика на ядрото, модели на изгледи, рендерирания извън екрана на страниците в светла и тъмна тема), 87 части на димния тест на ядрото, които пускат истинското ядро срещу тестови папки, включваема по желание проверка на качеството с проверки на инварианти върху реални данни и тестове от край до край в играта за игрите, които го поддържат. Тестовете се изпълняват в пясъчник за запис с проверка на отпечатъка на реалните папки, така че никой тест да не може да докосне истинските папки на игрите.
  • Данни: списъците с команди на игрите се изграждат на компютъра на потребителя от инсталираната игра в %LOCALAPPDATA%\JoyPro2\GameData; JoyPro доставя само собствените си данни (каталог с функции, каталог с устройства, таблици за преобразуване, база данни с кабини).
  • Документация, генерирана от изходния код: матрицата за поддръжка на игрите идва от кода (engine games support), справочникът на командния ред от engine --help, а този сайт от AXAML, моделите на изгледи и документацията.