OONI Probe Desktop

OONI Probe एक मुफ़्त और ओपन सोर्स सॉफ़्टवेयर है जिसे इंटरनेट सेंसरशिप और नेटवर्क हस्तक्षेप के अन्य रूपों को मापने के लिए डिज़ाइन किया गया है।

बग रिपोर्ट करने के लिए यहाँ क्लिक करें

अन्य समर्थित प्लेटफ़ॉर्म: iOS, Desktop, CLI

यह OONI Probe का डेस्कटॉप कार्यान्वयन है।

हमारे दो प्राथमिक लक्ष्य प्लेटफ़ॉर्म हैं:

• macOS
• Windows > 7 (हम पुराने संस्करणों का भी समर्थन कर सकते हैं, लेकिन प्राथमिक लक्ष्य के रूप में नहीं)

इसके अलावा, चूँकि यह electron में लिखा गया है, हम Linux डेस्कटॉप उपयोगकर्ताओं का भी समर्थन करने की योजना बनाते हैं।

electron का उपयोग करने के निर्णय और हमारे द्वारा चुनी गई लाइब्रेरीज़ की पृष्ठभूमि के लिए, देखें: Writing a modern cross-platform desktop app।

Setup

इस पर काम शुरू करने के लिए, हम मानते हैं कि आपके पास node और yarn इंस्टॉल हैं।

फिर आप चला सकते हैं:

yarn install

आपको अपने द्वारा विकास किए जाने वाले प्लेटफ़ॉर्म की निर्देशिका में probe-cli और tor की एक संकलित बाइनरी भी कॉपी करनी होगी।

डाउनलोड की गई tor बाइनरीज़ को सत्यापित करने के लिए आपको tor डेवलपर्स की PGP कुंजी निम्नानुसार आयात करनी चाहिए (इसे यहाँ से सत्यापित किया जा सकता है: https://support.torproject.org/tbb/how-to-verify-signature/):

gpg --recv-keys EF6E286DDA85EA2A4BA7DE684E2C6E8793298290

आप फिर से चलाकर एसेट्स डाउनलोड कर सकते हैं:

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

ऐप को डेवलपमेंट मोड में चलाएँ

डेवलपमेंट मोड का इलेक्ट्रॉन इंस्टेंस बनाने और चलाने के लिए यह चलाएँ:

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 फ़ाइल प्राप्त होनी चाहिए जिसमें दोनों हों। बस इस फ़ाइल पर डबल क्लिक करें और सर्टिफिकेट तथा की को अपने कीरिंग में इम्पोर्ट करने के लिए पासवर्ड प्रदान करें। इसके बाद, rm -P का उपयोग करके .p12 फ़ाइल को हटा दें।

रूट डायरेक्टरी में निम्नलिखित सामग्री के साथ एक .env फ़ाइल बनाएँ:

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

जहाँ TOKEN एक व्यक्तिगत github टोकन है जिसमें repository scope है, [email protected] वह Apple ID है जिसे आप हमारी टीम के हिस्से के रूप में उपयोग कर रहे हैं, XXXX एक विशिष्ट ऐप्लिकेशन पासवर्ड है जो appleid.apple.com पर जाकर और [email protected] के रूप में लॉग इन करके बनाया गया है, और YWCG8FZTLT वह टीम ID है जिसका उपयोग OONI करता है।

फिर, चलाएँ:

yarn install
yarn pack:mac

यह ./dist/OONI Probe-$VERSION.dmg बनाएगा।

Windows पर ऐप बिल्ड और साइन करें

आपको Windows के लिए कोड साइनिंग कुंजी की एक प्रति चाहिए जिसका नाम .p12 पर समाप्त होता है।

साइन किया गया बिल्ड बनाने के लिए आपको ये environment variables सेट करने होंगे:

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 ऐप के उपयोगकर्ताओं को ऐप शुरू करते समय एक त्रुटि मिलेगी क्योंकि ऑटो-अपडेट सिस्टम उस टैग से जुड़े मेटाडेटा को प्राप्त करने का प्रयास करेगा।