Сборка из исходников

Как собрать и запустить NetTrace самостоятельно — для разработки или для Linux и macOS.

Что нужно

SDK драйвера захвата не нужен: библиотека подключается во время работы.

Получить код

git clone https://github.com/Focusniks/NetTrace-desktop.git

Запуск в режиме разработки

cd NetTrace-desktop/apps/desktop
npm install
npx tauri dev

Откроется окно программы; правки интерфейса применяются на лету.

Сборка исполняемого файла

cd apps/desktop
npx tauri build --no-bundle

Результат — target/release/nettrace.exe (на Linux и macOS — target/release/nettrace).

Установщик для Windows и порядок выпуска версий описаны в разделе выпуск версий.

Тесты

Ядро:

cargo test --workspace

Интерфейс:

npm --prefix apps/desktop test

Проверка стиля и предупреждений:

cargo clippy --workspace --all-targets -- -D warnings

Нагрузочные тесты на большом захвате:

cargo test -p nettrace-engine --release -- --ignored --nocapture

Тестовые захваты

Файлы для тестов не хранятся в репозитории, а создаются кодом:

cargo run -p nettrace-testkit --bin gen-fixtures -- fixtures --large 20000

В папке fixtures появятся demo.pcapng, tcp_basic.pcap, tcp_problems.pcap и большой файл для нагрузки. Скриншоты этой документации сняты на demo.pcapng.

Интерфейс в браузере

Для отладки интерфейса без окна Tauri есть мост к тому же движку. Он слушает только 127.0.0.1 и в сборку программы не входит.

В одном терминале:

cargo run -p nettrace-devbridge

В другом:

npm --prefix apps/desktop run dev

Затем откройте http://localhost:1420.

Устройство проекта

Как части связаны между собой — в разделе архитектура.

Как помочь проекту

• Сообщения об ошибках и предложения — в Issues.
• Исправления — через pull request. Перед отправкой запустите тесты и clippy.
• Правки документации: файлы лежат в docs/ в формате Markdown; на каждой странице сайта есть ссылка «Исправить эту страницу».