TCP Viewer

TCP Viewer est un visualiseur de paquets macOS pour les captures en direct et les fichiers de capture. Il utilise AppKit pour l'application principale, la libpcap système pour la capture et les bibliothèques Wireshark intégrées pour les détails approfondis des paquets.

Prérequis

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

brew install cmake ninja meson pkg-config autoconf automake libtool

Configuration

Clonez avec les sous-modules et amorcez la dépendance Wireshark épinglée :

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

Si vous avez déjà cloné sans les sous-modules :

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

scripts/bootstrap-wireshark.sh exécute d'abord scripts/bootstrap-wireshark-deps.sh, qui compile les bibliothèques d'exécution fournies avec Wireshark à partir des sources dans Vendor/.install/wireshark-deps avec macOS 15.0 comme cible de déploiement. Homebrew n'est utilisé que pour les outils de build ; les bundles de version ne doivent pas copier les dylibs Homebrew depuis /opt/homebrew ou /usr/local.

Conservez les valeurs locales de signature, d'appcast, de Sparkle, de Sentry et de version en dehors de Git. Utilisez des fichiers locaux ignorés tels que Config/TCPViewer.local.xcconfig, .env, des variables d'environnement shell ou des outils basés sur le trousseau.

Exécution

Dans Xcode :

1. Ouvrez TCPViewer.xcodeproj.
2. Sélectionnez le schéma TCPViewer.
3. Choisissez My Mac.
4. Appuyez sur Exécuter.

Build en ligne de commande :

xcodebuild -project TCPViewer.xcodeproj -scheme TCPViewer build

Si Xcode demande une signature, sélectionnez une équipe de développement pour TCPViewer et PcapPlusPlusCore.

Tests

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

Déploiement

Les versions de TCP Viewer sont construites, notarisées, signées pour Sparkle, téléchargées sur Cloudflare R2, et éventuellement publiées sur le backend de version par le script de release.

Configuration initiale de release :

npm install
bundle install
gh auth login

Créez un .env local à partir de .env.example et renseignez les valeurs de version requises. Ne jamais commiter de vrais secrets. Conservez les commentaires dans .env sous forme de commentaires # car sentry-cli n'accepte pas les commentaires // lorsqu'il charge le fichier.

Pour les versions de production, ajoutez une entrée correspondante dans ReleaseNote.json, puis exécutez :

npm run release

Choisissez beta ou production lorsque vous y êtes invité. Les versions de production créent également l'appcast Sparkle, poussent le tag v<version> et publient la release GitHub. Les artefacts sont écrits sous :

~/Desktop/tcpviewer-production/

Licence

TCP Viewer est sous licence GPL-2.0-or-later. Cela correspond à l'intégration Wireshark de l'application : libwireshark, libwiretap et libwsutil sont des bibliothèques Wireshark couvertes par la GPL.

Le texte complet de la GPL se trouve dans COPYING, les avis tiers sont dans THIRD_PARTY_NOTICES.md, et les conditions de disponibilité du code source pour les versions binaires sont dans SOURCE_CODE_OFFER.md.

Remerciements

TCP Viewer s'appuie sur Wireshark pour l'analyse des paquets et sur HexFiend pour la visionneuse hexadécimale intégrée. Voir THIRD_PARTY_NOTICES.md pour plus de détails.