TCP Viewer

TCP Viewer è un visualizzatore di pacchetti per macOS per catture live e file di cattura. Utilizza AppKit per l'app principale, libpcap di sistema per la cattura e librerie Wireshark integrate per i dettagli approfonditi dei pacchetti.

Requisiti

• macOS 15+
• Xcode 16+
• Git
• CMake, Ninja, Meson, pkg-config e autotools

brew install cmake ninja meson pkg-config autoconf automake libtool

Configurazione

Clona con i sottomoduli e avvia la dipendenza Wireshark fissata:

git clone --recurse-submodules <repo-url>
cd TCPViewer
cp Config/TCPViewer.local.xcconfig.example Config/TCPViewer.local.xcconfig
./scripts/bootstrap-wireshark.sh

Se hai già clonato senza sottomoduli:

git submodule update --init --recursive
./scripts/bootstrap-wireshark.sh

scripts/bootstrap-wireshark.sh prima esegue scripts/bootstrap-wireshark-deps.sh, che compila le librerie runtime incluse di Wireshark dal codice sorgente in Vendor/.install/wireshark-deps con macOS 15.0 come target di distribuzione. Homebrew viene utilizzato solo per gli strumenti di build; i bundle di rilascio non devono copiare i dylib delle bottiglie Homebrew da /opt/homebrew o /usr/local.

Mantieni i valori locali di firma, appcast, Sparkle, Sentry e rilascio fuori da Git. Utilizza file locali ignorati come Config/TCPViewer.local.xcconfig, .env, variabili d'ambiente della shell o strumenti supportati da Keychain.

Esecuzione

In Xcode:

1. Apri TCPViewer.xcodeproj.
2. Seleziona lo schema TCPViewer.
3. Scegli My Mac.
4. Premi Esegui.

Build da riga di comando:

xcodebuild -project TCPViewer.xcodeproj -scheme TCPViewer build

Se Xcode richiede la firma, seleziona un team di sviluppo per TCPViewer e PcapPlusPlusCore.

Test

xcodebuild test \
  -project TCPViewer.xcodeproj \
  -scheme TCPViewer \
  -destination 'platform=macOS'

Distribuzione

I rilasci di TCP Viewer vengono compilati, notarizzati, firmati per Sparkle, caricati su Cloudflare R2 e opzionalmente pubblicati nel backend di rilascio dallo script di rilascio.

Configurazione iniziale del rilascio:

npm install
bundle install
gh auth login

Crea un file .env locale da .env.example e inserisci i valori di rilascio richiesti. Non commettere mai segreti reali. Mantieni i commenti in .env come commenti # perché sentry-cli non accetta commenti // quando carica il file.

Per i rilasci di produzione, aggiungi una voce corrispondente a ReleaseNote.json, poi esegui:

npm run release

Scegli beta o production quando richiesto. I rilasci di produzione creano anche l'appcast Sparkle, spingono il tag v<versione> e pubblicano il rilascio su GitHub. Gli artefatti vengono scritti in:

~/Desktop/tcpviewer-production/

Licenza

TCP Viewer è concesso in licenza GPL-2.0 o successive. Questo corrisponde all'integrazione dell'app con Wireshark: libwireshark, libwiretap e libwsutil sono librerie Wireshark coperte da GPL.

Il testo completo della GPL è in COPYING, gli avvisi di terze parti sono in THIRD_PARTY_NOTICES.md e i termini di disponibilità del codice sorgente per i rilasci binari sono in SOURCE_CODE_OFFER.md.

Riconoscimenti

TCP Viewer si basa su Wireshark per la dissection dei pacchetti e su HexFiend per il visualizzatore esadecimale integrato. Vedi THIRD_PARTY_NOTICES.md per i dettagli.