OONI Probe Desktop

OONI Probe هو برنامج مجاني ومفتوح المصدر مصمم لقياس الرقابة على الإنترنت وغيرها من أشكال التدخل في الشبكة.

انقر هنا للإبلاغ عن خطأ

المنصات الأخرى المدعومة: iOS، Desktop، CLI

هذا هو تطبيق سطح المكتب من OONI Probe.

منصتانا الأساسيتان المستهدفتان هما:

• macOS
• Windows > 7 (قد ندعم أيضًا الإصدارات الأقدم، لكن ليس كأهداف أساسية)

علاوة على ذلك، نظرًا لأنه مكتوب باستخدام electron، فإننا نخطط لدعم مستخدمي سطح مكتب Linux أيضًا.

للحصول على بعض الخلفية حول قرار استخدام electron والمكتبات التي اخترنا استخدامها، راجع: كتابة تطبيق سطح مكتب حديث متعدد المنصات.

الإعداد

من أجل البدء في العمل على هذا، نفترض أن لديك node وyarn مثبتين.

ثم يمكنك تشغيل:

yarn install

ستحتاج أيضًا إلى نسخ ملف ثنائي مُجمَّع من probe-cli وtor إلى الدليل الخاص بالمنصة التي تخطط للتطوير عليها.

للتحقق من ملفات tor الثنائية التي تم تنزيلها، يجب عليك استيراد مفتاح PGP الخاص بمطوري tor كما يلي (يمكن التحقق منه من: https://support.torproject.org/tbb/how-to-verify-signature/):

gpg --recv-keys EF6E286DDA85EA2A4BA7DE684E2C6E8793298290

يمكنك بعد ذلك تنزيل الأصول عن طريق تشغيل:

yarn run download:probe-cli
yarn run download:tor

تشغيل التطبيق في وضع التطوير

لبناء وتشغيل نسخة electron في وضع التطوير، شغّل:

yarn run start

تحديث الترجمات

• احفظ السلاسل النصية من جدول البيانات الأساسي في data/lang-en.csv
• شغّل node scripts/update-translations.js
• أضف data/lang-en.csv وlang/*.json وrenderer/static/translations.js إلى git

بناء تطبيق macOS وتوقيعه

احصل على شهادة التطوير والمفتاح الخاص لفريقنا (YWCG8FZTLT) من مطوّر آخر في OONI لديه صلاحية الوصول إليهما. يجب عليه التأكد من تصدير الشهادة والمفتاح الخاص المرتبط بها معًا، وليس الشهادة فقط. من المفترض أن تستلم ملف .p12 مشفّرًا بكلمة مرور يحتوي على كليهما. ما عليك سوى النقر المزدوج على هذا الملف وإدخال كلمة المرور لاستيراد الشهادة والمفتاح إلى سلسلة مفاتيحك. عند هذه النقطة، تخلّص من ملف .p12 باستخدام rm -P.

أنشئ ملف .env في الدليل الجذر بالمحتوى التالي:

GH_TOKEN=TOKEN
[email protected]
OONI_APPLEIDPASS=XXXX
OONI_TEAMID=YWCG8FZTLT

حيث TOKEN هو رمز github شخصي بنطاق المستودع، و[email protected] هو Apple ID الذي تستخدمه كجزء من فريقنا، وXXXX هو كلمة مرور تطبيق محددة تم إنشاؤها بزيارة appleid.apple.com وتسجيل الدخول باسم [email protected]، و YWCG8FZTLT هو معرّف الفريق الذي يستخدمه OONI.

ثم، شغّل:

yarn install
yarn pack:mac

سيؤدي هذا إلى بناء ./dist/OONI Probe-$VERSION.dmg.

بناء تطبيق وتوقيعه على Windows

ستحتاج إلى نسخة من مفتاح توقيع الشيفرة الخاص بـ Windows ينتهي بـ .p12.

لإنشاء بناء موقّع، سيتعين عليك تعيين متغيرات البيئة:

WIN_CSC_LINK=/path/to/key.p12
WIN_CSC_KEY_PASSWORD=KEY_PASSWORD

ستتمكن بعد ذلك من تشغيل:

yarn install
yarn run pack:win

نشر إصدار

شغّل:

yarn install
yarn run publish:mac
yarn run publish:win

تحذير مهم احرص على عدم دفع الوسم الخاص بالإصدار القادم حتى تنجح عملية تنفيذ الأمر yarn run publish. إذا قمت بذلك، فسيواجه مستخدمو تطبيق OONI Probe Desktop خطأً عند بدء تشغيل التطبيق لأن نظام التحديث التلقائي سيحاول جلب البيانات الوصفية المرتبطة بذلك الوسم.