MacOS 10.14.5 के लिए इलेक्ट्रॉन अनुप्रयोगों के लिए अधिसूचना प्रक्रिया

MacOS 10.14.5 की रिलीज़ के साथ, Apple ने उन्हें वितरित करने से पहले अनुप्रयोगों के लिए अनिवार्य Notarization प्रक्रिया को जोड़ा है। मैं आपको यह बताना चाहूंगा कि यह क्या है और इलेक्ट्रॉन.जेएस पर विकसित होने पर इस अपडेट के साथ क्या कठिनाइयां पैदा हुई हैं।

परिचय

Electron.js के उफान के 2 साल बाद, यह कितना बुरा है और इसकी आवश्यकता क्यों है, इस बारे में सभी गर्म होलीवॉटर शांत हैं। आइए टिप्पणी में उन्हें फिर से उत्तेजित न करें। आपका धन्यवाद

हमारी परियोजना अनुप्रयोग के निर्माण के लिए इलेक्ट्रॉन-बिल्डर का उपयोग करती है, लेकिन इलेक्ट्रॉन-पैगर के लिए यह प्रक्रिया लगभग समान होगी।

परियोजना स्वयं क्लाउड गेमिंग के लिए एक लांचर है, जिसके माध्यम से एक दूरस्थ कंप्यूटर तक पहुंचने के लिए एक देशी क्लाइंट लॉन्च किया जाता है।

इलेक्ट्रॉन-बिल्डर के साथ एक आवेदन पर हस्ताक्षर करना जटिल नहीं लगता है, लेकिन पूर्णता के लिए, मैं इस प्रक्रिया के बारे में संक्षेप में बात करूंगा। यदि आपको आवेदन पर हस्ताक्षर करने में कोई समस्या नहीं है, तो आप इस अध्याय को छोड़ सकते हैं।

आवेदन पर हस्ताक्षर

आवेदन पर हस्ताक्षर करने के लिए, हमें Apple डेवलपर के व्यक्तिगत खाते से प्रमाणपत्र निर्यात करने की आवश्यकता है। हमें आवश्यकता होगी:

• डेवलपर आईडी आवेदन
• डेवलपर आईडी इंस्टॉलर
• * 3 पार्टी मैक डेवलपर एप्लीकेशन और 3 पार्टी मैक डेवलपर इंस्टालर (यदि आप AppStore में आवेदन प्रकाशित करने की योजना बनाते हैं)

डेवलपर आईडी इंस्टॉलर प्रमाणपत्र एक विशिष्ट एप्लिकेशन के लिए जारी किया जाता है, इसके लिए बंडल की आवश्यकता होती है। इलेक्ट्रॉन-बिल्डर के लिए, यह पैकेज.जॉन में appId पैरामीटर द्वारा निर्दिष्ट किया गया है

प्रमाण पत्र एक ही फ़ाइल में एकत्र किए जाने चाहिए। ऐसा करने के लिए, उन्हें किचेन में जोड़ें (प्रमाण पत्र पर 2 क्लिक)।
फिर हम किचेन में जाते हैं, आवश्यक प्रमाणपत्रों का चयन करते हैं और संदर्भ मेनू में "निर्यात आइटम" पर क्लिक करते हैं। निर्यात के बाद, हमें एक्सटेंशन .p12 के साथ एक फ़ाइल मिलती है।

प्राप्त प्रमाण पत्र फ़ाइल के बाद, पर्यावरण चर में निम्नलिखित प्रविष्टियाँ जोड़ें

• CSC_LINK (प्रमाणपत्र फ़ाइल का पथ .p12)
• CSC_KEY_PASSWORD (प्रमाणपत्र एक्सेस पासवर्ड)

यदि आप इन चरों को नहीं जोड़ते हैं, तो कलेक्टर स्वचालित रूप से किचेन रिपॉजिटरी में उपयुक्त कुंजियों की खोज करेगा। इन प्रविष्टियों को जोड़ने से आप उन प्रमाणपत्रों को इंगित कर सकते हैं जिन्हें आप हस्ताक्षर करने के लिए उपयोग करना चाहते हैं।

इन ऑपरेशनों के बाद, आप निर्माण प्रक्रिया शुरू कर सकते हैं और सब कुछ सुचारू रूप से चलना चाहिए।

यह तब तक सुचारू रूप से काम करता रहा जब तक कि macOS 10.14.5 जारी नहीं किया गया ...।

MacOS 10.14.5 के साथ क्या बदल गया है

एक छोटा सा विषयांतर। रात में नए पैच पर आखिरी काम करते हुए, मैंने सुबह में उत्पादन संस्करण की विधानसभा को छोड़ने का फैसला किया। यह देखते हुए कि macOS पर एक अपडेट आया और इसे लॉन्च करके सो गया।

अगली सुबह, मुझे यह देखकर आश्चर्य हुआ कि आवेदन पर हस्ताक्षर करते समय असेंबली एक अज्ञात त्रुटि से गिरती है - "अज्ञात डेवलपर"।

कल तक मत रखो कि आज क्या किया जा सकता है। बेंजामिन फ्रैंकलिन

समस्या का सार

MacOS 10.14.5 के साथ शुरू, Apple ने एक अनिवार्य नोटरीकरण प्रक्रिया शुरू की है। इस बारे में Apple का पहला लेख 2018 में था, लेकिन यह इस अद्यतन के साथ था कि यह प्रक्रिया अनिवार्य हो गई। वह कैसी दिखती है

आप एप्लिकेशन एकत्र करते हैं -> इसे ऐप्पल सर्वर पर भेजें -> ऐप्पल इसे प्रमाणित करता है -> सफल प्रमाणीकरण की स्थिति लौटाता है -> प्रमाणन स्टैम्प सेट करने की कमांड निष्पादित होती है।

Xcode पर डेवलपर्स के लिए, आपको बस नोटरीकरण को बंद करने की आवश्यकता है

इसके अलावा, इकट्ठे आवेदन के नोटरीकरण की प्रक्रिया टर्मिनल में एक कमांड द्वारा की जा सकती है।

$ xcrun altool --notarize-app --primary-bundle-id "com.example.ote.zip" --username "AC_USERNAME" --password "@keychain:AC_PASSWORD" --file OvernightTextEditor_11.6.8.zip 

• प्राथमिक-बंडल-आईडी - आवेदन बंडल
• उपयोगकर्ता नाम - developer.apple.com उपयोगकर्ता लॉगिन
• पासवर्ड - "ऐप-विशिष्ट पासवर्ड"। इसे डेवलपर के खाते के अंतर्गत आपके व्यक्तिगत खाते appleid.apple.com में बनाया जा सकता है।

यदि आप नोटरीकरण प्रक्रिया नहीं करते हैं, तो जब उपयोगकर्ता एप्लिकेशन इंस्टॉल करने का प्रयास करता है, तो एक विंडो क्रैश हो जाती है। गेटकीपर आवेदन की सुरक्षा की जांच करने के लिए जिम्मेदार है। यह वह था जिसने इलेक्ट्रॉन-बिल्डर पर आवेदन की असेंबली को तोड़ दिया था।

इलेक्ट्रान-बिल्डर निर्माण की प्रक्रिया कैसी दिखी

इलेक्ट्रॉन-ओएक्स-संकेत उपयोगिता का उपयोग करके, .app फ़ाइल में एप्लिकेशन के निर्माण के बाद, एप्लिकेशन पर हस्ताक्षर किए गए थे। प्रमाण पत्र के साथ हस्ताक्षर करने के बाद, गेटकेपर के साथ आवेदन की जांच की प्रक्रिया शुरू की गई थी। लेकिन अपडेट जारी होने के साथ, द्वारपाल ने आवेदन के सही नोटरीकरण की जांच करना शुरू कर दिया, और इसने आवेदन हस्ताक्षर प्रक्रिया को सफलतापूर्वक पूरा करने की अनुमति नहीं दी।

नोटरीकरण के लिए पैच

Github उपयोगकर्ता Kallin ने तुरंत एक समाधान सुझाया, जिसमें दो नए मापदंडों को शामिल किया गया। पहला "गेटकीपर एसेस" है - हस्ताक्षर करने के बाद असेंबली सत्यापन को अक्षम करता है और दूसरा "साइन" है - जो एक प्रमाण पत्र के साथ इंस्टॉलेशन फ़ाइल (डीजीएम) पर हस्ताक्षर करने में अक्षम करता है। यह प्रतिबद्ध इलेक्ट्रॉन-बिल्डर 20.43.0 की रिहाई में शामिल है।

नोटरीकरण प्रक्रिया के लिए, इलेक्ट्रॉन-यूजरलैंड में एक इलेक्ट्रॉन-नोटरीज़ मॉड्यूल होता है जो इस कार्य को करता है, आपको बस एक छोटी स्क्रिप्ट लिखने और इसे आफ्टरसिंक हुक का उपयोग करके चलाने की आवश्यकता है।

आवेदन पर हस्ताक्षर और नोटरीकरण प्रक्रिया

प्रारंभ में, आपको यह जांचने की आवश्यकता है कि आपने इलेक्ट्रॉन-बिल्डर संस्करण> = 20.43.0 स्थापित किया है और इलेक्ट्रॉन-नोटरी पैकेज स्थापित किया है।

पर्यावरण चर में 2 प्रविष्टियाँ जोड़ें:

• appleId - developer.apple.com लॉगिन
• appleASP - "ऐप-विशिष्ट पासवर्ड", जिसे आपके व्यक्तिगत खाते में बनाया जा सकता है appleid.apple.com ।

अब एक नोटरीकरण स्क्रिप्ट बनाएं जिसे एप्लिकेशन पर हस्ताक्षर करने के बाद निष्पादित किया जाएगा।

 const notarize = require('electron-notarize').notarize; module.exports = async (context) => { const { electronPlatformName } = context; if (electronPlatformName === 'darwin') { try { console.log('Try notarize app'); await notarize({ appBundleId: 'APP_BUNDLE_ID', appPath: './dist/mac/APP_NAME.app', appleId: process.env.appleId, appleIdPassword: process.env.appleASP, }); console.log('Success notarize'); } catch (err) { console.log(err); } } }; 

हम इसे आपके लिए सुविधाजनक जगह पर सहेजते हैं।

इसके अलावा, उचित नोटरीकरण के लिए, हमें अभिगम अधिकार निर्धारित करने की आवश्यकता है
हमारे आवेदन के लिए सिस्टम संसाधनों के लिए। ऐसा करने के लिए, फ़ाइल बिल्ड / एंटाइटेलमेंट.mac.inherit.plist बनाएँ

 <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>com.apple.security.cs.allow-jit</key> <true/> <key>com.apple.security.cs.allow-unsigned-executable-memory</key> <true/> <key>com.apple.security.cs.allow-dyld-environment-variables</key> <true/> <key>com.apple.security.cs.disable-library-validation</key> <true/> <key>com.apple.security.cs.disable-executable-page-protection</key> <true/> <key>com.apple.security.cs.debugger</key> <true/> <key>com.apple.security.automation.apple-events</key> <true/> </dict> </plist> 

मेरे मामले में फ़ाइल की सामग्री। आपके लिए एक अलग कॉन्फ़िगरेशन हो सकता है। सभी क्षेत्रों का वर्णन ।
Electron.js के लिए अनिवार्य है - com.apple.security.cs.allow-unsigned-निष्पादनीय-मेमोरी।

अब package.json में सेटिंग्स को अपडेट करें

MacOS के लिए अनुभाग में:

• GatekeeperAssess (इलेक्ट्रॉन-ऑक्स-साइन साइड पर एप्लिकेशन सत्यापन अक्षम करता है)
• हार्डरंटटाइम (आपको सुरक्षा अनुमति और सिस्टम संसाधनों तक पहुंच की सूची बनाने की अनुमति देता है)
• एंटाइटेलमेंट (हमारे आवेदन के लिए एक्सेस अनुमति की फ़ाइल का पथ)

इलेक्ट्रॉन-बिल्डर सेटिंग्स के सामान्य खंड में:

• afterSign (नोटरीकरण स्क्रिप्ट का पथ, जो एप्लिकेशन पर हस्ताक्षर करने के बाद लॉन्च किया जाएगा)

हम विधानसभा की प्रक्रिया शुरू करते हैं। ऐसा लग सकता है कि यह थोड़ा निलंबित है, लेकिन फ़ाइल को Apple सर्वर पर स्थानांतरित करना और प्रतिक्रिया की प्रतीक्षा करने में कुछ समय लगता है (3 से 10 मिनट तक)

सूचनाओं की स्थिति को टर्मिनल में कमांड चलाकर देखा जा सकता है:

$ xcrun altool --notarization-history 0 -u $appleId -p $appleASP

जवाब एक तालिका में प्रस्तुत किया जाएगा। स्थिति फ़ील्ड में मान 'प्रक्रिया', 'स्वीकृत', 'अमान्य' हो सकता है

यदि स्थिति 'अमान्य' है, तो आप अनुरोध संख्या द्वारा देख सकते हैं कि क्या गलत हुआ।

$ xcrun altool --notarization-info "RequestUUID" -u $appleId

हस्ताक्षर और नोटरीकरण की पूरी प्रक्रिया यही है। मुझे उम्मीद है कि आपको यह लेख उपयोगी लगा होगा। आपका धन्यवाद

छोटा जोड़

परीक्षण के लिए आवेदन स्थानांतरित करते समय, एक दिलचस्प गड़बड़ खोज की गई थी। टेलीग्राम के माध्यम से प्राप्त आवेदन को केवल शुरू करने से इनकार कर दिया। लॉग को देखते समय, यह पता चला कि आवेदन टेलीग्राम द्वारा संगरोध किया गया था। यह किस कारण और कैसे हुआ, मुझे इसका उत्तर नहीं मिला। Yandex.Disk (या ब्राउज़र के माध्यम से डाउनलोड करने का कोई अन्य तरीका) के माध्यम से एक फ़ाइल भेजते समय, यह समस्या उत्पन्न नहीं होती है।

उपयोगी लिंक

• इलेक्ट्रॉन-नोटरी रिपोजिटरी
• ऐप्लीकेशन नोटरीकरण पर Apple लेख
• नोटरीकरण प्रक्रिया पर कल्लिन लेख, यह तब मिला जब मैंने अपना लेखन पूरा किया