
أفضل تطبيق على مستوى macOS لرؤية كل حزمة بوضوح على جهاز Mac الخاص بك. بديل لـ Wireshark
TCP Viewer هو عارض حزم لنظام macOS للالتقاط المباشر وملفات الالتقاط. يستخدم AppKit للتطبيق الرئيسي، وlibpcap النظام للالتقاط، ومكتبات Wireshark المرفوعة لتفاصيل الحزم العميقة.
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 فقط لأدوات البناء؛ يجب ألا تنسخ حزم الإصدار مكتبات Homebrew dylib من /opt/homebrew أو /usr/local.
احتفظ بقيم التوقيع المحلي، وappcast، وSparkle، وSentry، والإصدار خارج Git. استخدم ملفات محلية متجاهلة مثل Config/TCPViewer.local.xcconfig و.env ومتغيرات بيئة الصدفة أو الأدوات المدعومة بـ Keychain.
في Xcode:
TCPViewer.xcodeproj.TCPViewer.My Mac.البناء من سطر الأوامر:
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 محليًا من .env.example واملأ قيم الإصدار المطلوبة. لا تقم أبدًا بإيداع الأسرار الحقيقية. احتفظ بالتعليقات في .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 هي مكتبات Wireshark مغطاة بـ GPL.
نص GPL الكامل موجود في COPYING، وإشعارات الطرف الثالث في THIRD_PARTY_NOTICES.md، وشروط توفر المصدر للإصدارات الثنائية في SOURCE_CODE_OFFER.md.
يعتمد TCP Viewer على Wireshark لتحليل الحزم وHexFiend لعارض السداسي العشري المضمن. انظر THIRD_PARTY_NOTICES.md للتفاصيل.