TCP Viewer

TCP Viewer ist ein macOS-Paketbetrachter für Live-Mitschnitte und Mitschnittdateien. Es verwendet AppKit für die Haupt-App, systemeigenes libpcap für den Mitschnitt und mitgelieferte Wireshark-Bibliotheken für tiefgehende Paketdetails.

Anforderungen

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

brew install cmake ninja meson pkg-config autoconf automake libtool

Einrichtung

Mit Submodulen klonen und die festgelegte Wireshark-Abhängigkeit bootstrappen:

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

Falls Sie bereits ohne Submodule geklont haben:

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

scripts/bootstrap-wireshark.sh führt zuerst scripts/bootstrap-wireshark-deps.sh aus, das die gebündelten Laufzeitbibliotheken von Wireshark aus dem Quellcode in Vendor/.install/wireshark-deps mit macOS 15.0 als Zielplattform erstellt. Homebrew wird nur für Build-Tools verwendet; Auslieferungsbündel dürfen keine Homebrew-Bottle-dylibs aus /opt/homebrew oder /usr/local kopieren.

Halten Sie lokale Signierungs-, Appcast-, Sparkle-, Sentry- und Release-Werte aus Git heraus. Verwenden Sie ignorierte lokale Dateien wie Config/TCPViewer.local.xcconfig, .env, Shell-Umgebungsvariablen oder auf der Schlüsselbund basierende Werkzeuge.

Ausführen

In Xcode:

1. Öffnen Sie TCPViewer.xcodeproj.
2. Wählen Sie das Schema TCPViewer.
3. Wählen Sie My Mac.
4. Drücken Sie Run.

Kommandozeilen-Build:

xcodebuild -project TCPViewer.xcodeproj -scheme TCPViewer build

Falls Xcode nach einer Signierung fragt, wählen Sie ein Entwicklungsteam für TCPViewer und PcapPlusPlusCore aus.

Testen

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

Bereitstellen

TCP Viewer-Releases werden vom Release-Skript erstellt, notariell beglaubigt, für Sparkle signiert, in Cloudflare R2 hochgeladen und optional im Release-Backend veröffentlicht.

Erstmalige Release-Einrichtung:

npm install
bundle install
gh auth login

Erstellen Sie eine lokale .env aus .env.example und füllen Sie die erforderlichen Release-Werte aus. Committen Sie niemals echte Geheimnisse. Behalten Sie Kommentare in .env als #-Kommentare bei, da sentry-cli beim Laden der Datei keine //-Kommentare akzeptiert.

Führen Sie für Produktions-Releases einen passenden Eintrag in ReleaseNote.json hinzu und führen Sie dann aus:

npm run release

Wählen Sie bei Aufforderung beta oder production. Produktions-Releases erstellen auch den Sparkle-Appcast, pushen den v<version>-Tag und veröffentlichen das GitHub-Release. Artefakte werden unter folgendem Pfad abgelegt:

~/Desktop/tcpviewer-production/

Lizenz

TCP Viewer ist unter GPL-2.0-or-later lizenziert. Dies entspricht der Wireshark-Integration der App: libwireshark, libwiretap und libwsutil sind GPL-abgedeckte Wireshark-Bibliotheken.

Der vollständige GPL-Text befindet sich in COPYING, Drittanbieterhinweise in THIRD_PARTY_NOTICES.md, und die Bedingungen zur Quelltextverfügbarkeit für Binär-Releases in SOURCE_CODE_OFFER.md.

Danksagungen

TCP Viewer basiert auf Wireshark für die Paketanalyse und HexFiend für den eingebetteten Hex-Viewer. Einzelheiten finden Sie in THIRD_PARTY_NOTICES.md.