TCP Viewer

TCP Viewer é um visualizador de pacotes para macOS, compatível com capturas ao vivo e arquivos de captura. Utiliza AppKit para a interface principal, a libpcap do sistema para captura e bibliotecas Wireshark integradas para detalhamento profundo de pacotes.

Requisitos

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

brew install cmake ninja meson pkg-config autoconf automake libtool

Configuração

Clone com submódulos e inicialize a dependência fixada do Wireshark:

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

Se você já clonou sem submódulos:

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

scripts/bootstrap-wireshark.sh primeiro executa scripts/bootstrap-wireshark-deps.sh, que compila as bibliotecas de tempo de execução fornecidas pelo Wireshark a partir do código-fonte em Vendor/.install/wireshark-deps com macOS 15.0 como alvo de implantação. O Homebrew é usado apenas para ferramentas de compilação; os pacotes de lançamento não devem copiar as dylibs de garrafas do Homebrew de /opt/homebrew ou /usr/local.

Mantenha valores locais de assinatura, appcast, Sparkle, Sentry e lançamento fora do Git. Use arquivos locais ignorados, como Config/TCPViewer.local.xcconfig, .env, variáveis de ambiente do shell ou ferramentas baseadas no Keychain.

Executar

No Xcode:

1. Abra TCPViewer.xcodeproj.
2. Selecione o esquema TCPViewer.
3. Escolha My Mac.
4. Pressione Executar.

Compilação por linha de comando:

xcodebuild -project TCPViewer.xcodeproj -scheme TCPViewer build

Se o Xcode solicitar assinatura, selecione uma equipe de desenvolvimento para TCPViewer e PcapPlusPlusCore.

Testar

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

Implantar

Os lançamentos do TCP Viewer são compilados, notarizados, assinados para o Sparkle, enviados para o Cloudflare R2 e, opcionalmente, publicados no backend de lançamento pelo script de release.

Configuração inicial para lançamento:

npm install
bundle install
gh auth login

Crie um .env local a partir de .env.example e preencha os valores de lançamento necessários. Nunca confirme segredos reais. Mantenha comentários no .env como comentários #, pois o sentry-cli não aceita comentários // ao carregar o arquivo.

Para lançamentos de produção, adicione uma entrada correspondente em ReleaseNote.json e então execute:

npm run release

Escolha beta ou production quando solicitado. Lançamentos de produção também criam o appcast do Sparkle, enviam a tag v<version> e publicam o release no GitHub. Os artefatos são gravados em:

~/Desktop/tcpviewer-production/

Licença

O TCP Viewer é licenciado sob GPL-2.0-or-later. Isso corresponde à integração do Wireshark no aplicativo: libwireshark, libwiretap e libwsutil são bibliotecas do Wireshark cobertas pela GPL.

O texto completo da GPL está em COPYING, os avisos de terceiros estão em THIRD_PARTY_NOTICES.md e os termos de disponibilidade do código-fonte para lançamentos binários estão em SOURCE_CODE_OFFER.md.

Agradecimentos

O TCP Viewer utiliza o Wireshark para dissecação de pacotes e o HexFiend para o visualizador hexadecimal embutido. Consulte THIRD_PARTY_NOTICES.md para detalhes.