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 فقط لأدوات البناء؛ يجب ألا تنسخ حزم الإصدار مكتبات Homebrew dylib من /opt/homebrew أو /usr/local.

احتفظ بقيم التوقيع المحلي، و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 محليًا من .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 للتفاصيل.