TCP Viewer

TCP Viewer एक macOS पैकेट व्यूअर है जो लाइव कैप्चर और कैप्चर फ़ाइलों के लिए है। यह मुख्य ऐप के लिए AppKit, कैप्चर के लिए सिस्टम libpcap, और गहरे पैकेट विवरण के लिए वेंडर्ड Wireshark लाइब्रेरीज़ का उपयोग करता है।

आवश्यकताएँ

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

brew install cmake ninja meson pkg-config autoconf automake libtool

सेटअप

सबमॉड्यूल के साथ क्लोन करें और पिन की गई Wireshark निर्भरता को बूटस्ट्रैप करें:

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

यदि आपने पहले ही सबमॉड्यूल के बिना क्लोन किया है तो:

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

scripts/bootstrap-wireshark.sh पहले scripts/bootstrap-wireshark-deps.sh चलाता है, जो Wireshark की बंडल रनटाइम लाइब्रेरीज़ को स्रोत से Vendor/.install/wireshark-deps में macOS 15.0 को डिप्लॉयमेंट लक्ष्य के रूप में बनाता है। Homebrew का उपयोग केवल बिल्ड टूल के लिए किया जाता है; रिलीज़ बंडलों को /opt/homebrew या /usr/local से Homebrew बॉटल dylibs कॉपी नहीं करना चाहिए।

स्थानीय हस्ताक्षर, appcast, Sparkle, Sentry और रिलीज़ मानों को Git से बाहर रखें। अनदेखी की गई स्थानीय फ़ाइलों जैसे Config/TCPViewer.local.xcconfig, .env, शेल पर्यावरण चर या Keychain-समर्थित टूल का उपयोग करें।

चलाएँ

Xcode में:

1. TCPViewer.xcodeproj खोलें।
2. TCPViewer स्कीम चुनें।
3. My Mac चुनें।
4. Run दबाएँ।

कमांड-लाइन बिल्ड:

xcodebuild -project TCPViewer.xcodeproj -scheme TCPViewer build

यदि Xcode हस्ताक्षर के लिए पूछता है, तो TCPViewer और PcapPlusPlusCore के लिए एक डेवलपमेंट टीम चुनें।

परीक्षण

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

परिनियोजन

TCP Viewer रिलीज़ बिल्ड, नोटराइज़, Sparkle के लिए हस्ताक्षरित, Cloudflare R2 पर अपलोड किए जाते हैं, और वैकल्पिक रूप से रिलीज़ स्क्रिप्ट द्वारा रिलीज़ बैकएंड पर प्रकाशित किए जाते हैं।

पहली बार रिलीज़ सेटअप:

npm install
bundle install
gh auth login

.env.example से एक स्थानीय .env बनाएँ और आवश्यक रिलीज़ मान भरें। वास्तविक रहस्यों को कभी कमिट न करें। .env में टिप्पणियों को # टिप्पणियों के रूप में रखें क्योंकि sentry-cli फ़ाइल लोड करते समय // टिप्पणियों को स्वीकार नहीं करता है।

प्रोडक्शन रिलीज़ के लिए, ReleaseNote.json में एक मेल खाने वाली प्रविष्टि जोड़ें, फिर चलाएँ:

npm run release

संकेत मिलने पर beta या production चुनें। प्रोडक्शन रिलीज़ Sparkle appcast भी बनाते हैं, v<version> टैग पुश करते हैं, और GitHub रिलीज़ प्रकाशित करते हैं। आर्टिफैक्ट इसके अंतर्गत लिखे जाते हैं:

~/Desktop/tcpviewer-production/

लाइसेंस

TCP Viewer GPL-2.0-or-later के तहत लाइसेंस प्राप्त है। यह ऐप के Wireshark एकीकरण से मेल खाता है: libwireshark, libwiretap, और libwsutil GPL-कवर Wireshark लाइब्रेरीज़ हैं।

पूर्ण GPL पाठ COPYING में है, तृतीय-पक्ष सूचनाएँ THIRD_PARTY_NOTICES.md में हैं, और बाइनरी-रिलीज़ स्रोत उपलब्धता शर्तें SOURCE_CODE_OFFER.md में हैं।

आभार

TCP Viewer पैकेट डिसेक्शन के लिए Wireshark और एम्बेडेड हेक्स व्यूअर के लिए HexFiend पर आधारित है। विवरण के लिए THIRD_PARTY_NOTICES.md देखें।