हैक्स फाउंडेशन में इंटर्नशिप

मैं आपको HaxeUp सत्र 2019 लिंज़ से एक और रिपोर्ट का अनुवाद प्रस्तुत करता हूं, मेरा मानना ​​है कि यह पिछले एक के लिए एक अच्छा पूरक है, क्योंकि 2019 में होने वाले हेक्स में परिवर्तनों की विषयवस्तु जारी है, साथ ही साथ इसके भविष्य के बारे में भी बात की गई है।
रिपोर्ट के लेखक के बारे में थोड़ा: ऑरेल बिली ने हेक्स के साथ मुलाकात की, विभिन्न गेम जाम में भाग लिया, और वह उनमें भाग लेता रहा (उदाहरण के लिए, यहां आखिरी लुडम डेयर 45 से उसका गेम है )।

ऑरेल वर्तमान में इंपीरियल कॉलेज लंदन में पढ़ाई पूरी कर रही है, जिसका अर्थ है अनिवार्य इंटर्नशिप। उन्होंने जो पहली इंटर्नशिप ली, वह एक दूरस्थ कार्यालय में थी, जिसमें से बहुत समय लगा। इसलिए, उन्होंने आशा व्यक्त की कि अगली प्रथा दूर से गुजरना संभव होगा।

ऐसा हुआ कि हैक्स फाउंडेशन लंबे समय तक कंपाइलर डेवलपर की स्थिति के लिए एक कर्मचारी नहीं ढूंढ सका । ऑरेल ने अपनी किस्मत आजमाने का फैसला किया और एक पत्र भेजकर दूरस्थ कार्य का अनुरोध किया। वह भाग्यशाली था - उसे लंदन से काम करने के अवसर के साथ छह महीने की इंटर्नशिप के लिए स्वीकार किया गया था ।

डिवाइस की स्थापना करते समय, ऑरेल द्वारा किए जाने वाले कार्यों की सीमा पर सहमति व्यक्त की गई थी (हालांकि सब कुछ अंततः एहसास नहीं हुआ था)।

उसने क्या किया?

सबसे पहले, प्रलेखन , जो एक उदास स्थिति में था: वाक्यविन्यास में सभी परिवर्तन, भाषा की नई विशेषताएं और संकलक का वर्णन किया गया था, तार, शाब्दिक और स्थिरांक पर अनुभाग पूरक थे।

सभी दस्तावेज का अनुवाद LaTeX से Markdown तक किया गया है!

दूसरे, मानक पुस्तकालय के कोड का प्रारूपण एक ही शैली में लाया गया था (क्योंकि कोड डिजाइन के विभिन्न शैलियों वाले लोगों ने 10 वर्षों तक इस पर काम किया था)। इस प्रकार, हेक्स संकलक भंडार में, ऑरेल ने कोड की लाइनों की संख्या में सातवां स्थान जोड़ा :)

तीसरा, ऑरेल ने मानक पुस्तकालय और संकलक पर भी काम किया:
उदाहरण के लिए, Map कंटेनर में एक नया clear() तरीका है जो सभी संग्रहीत मूल्यों को हटा देता है। यह मुख्य रूप से final चर के रूप में बनाए गए कंटेनरों के साथ काम करने की सुविधा के लिए किया गया था (अर्थात, उन्हें एक नया मान नहीं सौंपा जा सकता है, लेकिन उन्हें संशोधित किया जा सकता है):

Date प्रकार की वस्तुओं के लिए, यूटीसी (सार्वभौमिक सार्वभौमिक समय) प्रारूप में तारीखों के साथ काम करने के तरीके दिखाई दिए हैं। उन पर काम करने से पता चला कि Haxe द्वारा समर्थित सभी 11 भाषाओं / प्लेटफार्मों पर समान रूप से काम करने वाले एकल एपीआई को लागू करना कितना मुश्किल है।

पुराने संकलक में, परिभाषाएं और मेटा टैग OCaml पर परिभाषित किए गए थे, लेकिन अब उन्हें JSON प्रारूप में वर्णित किया गया है, जो बाहरी उपयोगिताओं द्वारा अपने पार्सिंग को सरल करना चाहिए (उदाहरण के लिए, स्वचालित रूप से प्रलेखन उत्पन्न करने के लिए):

आप यह भी देख सकते हैं कि बड़ी परियोजनाओं पर, संकलन सर्वर बहुत अधिक मेमोरी का उपयोग करना शुरू कर देता है।

इस समस्या को हल करने के लिए, साइमन क्रावेव्स्की और ऑरेल ने एचबीबी बाइनरी प्रारूप विकसित किया, जिसका उपयोग टाइप एएसटी को क्रमबद्ध करने के लिए किया जाता है। अब संकलन सर्वर मॉड्यूल को मेमोरी में लोड कर सकता है, इसके साथ तब तक काम कर सकता है जब तक कि यह आवश्यक न हो, और फिर इसे मेमोरी से hxb फॉर्मेट में एक फाइल में अनलोड करें और कब्जे वाली मेमोरी को खाली कर दें।

Hxb प्रारूप विनिर्देश एक अलग रिपॉजिटरी में उपलब्ध है , और कंपाइलर (धारावाहिक / deserializer के साथ) में इसका वर्तमान कार्यान्वयन एक अलग Haxe शाखा में है । इस सुविधा पर काम अभी तक पूरा नहीं हुआ है, और शायद यह हेक्स 4.1 में दिखाई देगा।

इंटर्नशिप के दौरान ऑरेल के काम का चौथा और मुख्य फोकस एक नए एसिंक्रोनस सिस्टम एपीआई - एसेस का निर्माण था।

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

एक नया एपीआई बनाते और लागू करते समय, कई सवाल उठते हैं:

एपीआई कैसे डिजाइन करें? शायद यह एक मौजूदा एक उदाहरण के रूप में लेने के लायक है? आखिरकार, हम सब कुछ खरोंच से नहीं बनाना चाहते हैं, क्योंकि इसमें अधिक समय लगेगा और हो सकता है कि यह बाकी टीम के स्वाद में न हो और बहुत बहस का कारण बने।

और, जैसा कि पहले ही उल्लेख किया गया है, हेक्स के लिए वास्तविक समस्या सभी समर्थित प्लेटफार्मों के लिए एकल एपीआई का कार्यान्वयन है।

API Node.js. को नमूने के रूप में चुना गया था। यह अच्छी तरह से सोचा गया है, आवश्यक सिस्टम फ़ंक्शन का समर्थन करता है और सर्वर एप्लिकेशन बनाने के लिए अच्छी तरह से अनुकूल है।

लेकिन साथ ही, Node.js API एक जावास्क्रिप्ट एपीआई है जिसमें कोई मजबूत टाइपिंग नहीं है। उदाहरण के लिए, फ़ाइल सिस्टम के साथ काम करने के लिए fs मॉड्यूल से कार्य पथ के रूप में या तो Buffer या यहां तक ​​कि URL जैसे ऑब्जेक्ट ले सकते हैं। और हेक्स के लिए यह इतना अच्छा नहीं है।

Node.js, बदले में, सी में लिखी गई लिबव लाइब्रेरी का उपयोग करता है । हेक्से से लिब्यूव एपीआई के साथ काम करना सीधे तौर पर इतना सुविधाजनक नहीं होगा: उदाहरण के लिए, फ़ाइल को uv_loop_t रूप से नाम बदलने के लिए, आपको इसके अलावा uv_loop_t (प्रबंधन के लिए संरचना) बनाने की आवश्यकता होगी। ईवेंट लूप इन इम्पावु) और uv_fs_t (फ़ाइल सिस्टम के लिए अनुरोध का वर्णन करने के लिए संरचना):

परिणामस्वरूप, Node.js और libuv API को निम्नानुसार एकीकृत किया गया (उदाहरण के रूप में eval मैक्रो दुभाषिया और rename विधि का उपयोग करके):

• उन्होंने Node.js से API विधि ली, इसे Haxe में रूपांतरित किया, तर्कों के प्रकार को मानकीकृत करने और Haxe के लिए निरर्थक तर्कों से छुटकारा पाने की कोशिश की। उदाहरण के लिए, पथ तर्क (प्रकार FilePath ) तार पर सार हैं:

• फिर इस विधि के लिए OCaml बाइंडर्स बनाया:

• लिंक OCaml और C (CFFI - C फॉरेन फंक्शन इंटरफ़ेस का उपयोग करके):

• और अंत में सी-बाइंडर्स को ओमेक्एल से लिबुव सी फ़ंक्शन को कॉल करने के लिए लिखा:

इसी तरह, यह हैशलिंक और नेको के लिए किया गया था (अभी के लिए, ऐश एपीआई केवल इन तीन प्लेटफार्मों के लिए लागू किया गया है)। जैसा कि आप अनुमान लगा सकते हैं, इसने बहुत काम लिया।

Aurel ने कुछ छोटे अनुप्रयोगों को दर्शाया कि कैसे ऐश एपीआई काम करता है।
पहला उदाहरण अतुल्यकालिक रूप से एक फ़ाइल की सामग्री को पढ़ने का प्रदर्शन है। अब तक, कोड स्पष्ट रूप से libuv ( hl.Uv.init() ) को इनिशियलाइज़ करने के लिए तरीके hl.Uv.init() और एप्लिकेशन चक्र ( hl.Uv.run() ) को शुरू करता है, इस तथ्य के कारण कि एपीआई पर काम पूरा नहीं हुआ है (लेकिन भविष्य में) वे स्वचालित रूप से जुड़ जाएंगे):

दिखाए गए कोड का परिणाम:

हम देखते हैं कि AsyncFileSystem.readFile() विधियों के परिणाम "कॉल" ट्रेस के बाद कंसोल में प्रदर्शित होते हैं, जो फ़ाइलों की सामग्री को पढ़ने की कोशिश करने के बाद कोड में कहा जाता है।

दूसरा उदाहरण डीएनएस और आईपी पते के साथ अतुल्यकालिक ऑपरेशन का प्रदर्शन है।

नए एपीआई में, होस्ट नाम, साथ ही साथ आईपी पते के साथ काम करने के लिए सहायक तरीके निर्धारित करना बहुत आसान हो जाएगा।

तीसरा उदाहरण एक साधारण टीसीपी इको सर्वर है, जिसे बनाने के लिए केवल तीन लाइनों की आवश्यकता होती है:

एक चौथा उदाहरण प्रक्रियाओं के बीच सूचनाओं के आदान-प्रदान का प्रदर्शन है:
इस उदाहरण में स्टैटिक makeFrame() विधि अलग png चित्र बनाता है:

और main विधि में, हम ffmpeg प्रक्रिया शुरू करते हैं, जिसमें हम makeFrame() में उत्पन्न तख्ते को स्थानांतरित करेंगे makeFrame() :

और आउटपुट एक वीडियो फ़ाइल होगी:

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

और अंत में, हम ffmpeg से प्राप्त डेटा को छोटे "भागों" में तोड़ते हैं और उन्हें निर्दिष्ट पोर्ट में अनुवाद करते हैं:

और परिणामस्वरूप, हमें एक काम करने वाली वीडियो स्ट्रीम मिलती है:

उपरोक्त संक्षेप, नए asys एपीआई में शामिल हैं:

• नए सिस्टम सहित फ़ाइल सिस्टम के साथ काम करने के तरीके, मानक पुस्तकालय में नहीं थे (उदाहरण के लिए, अनुमतियों को बदलने के लिए), साथ ही पुराने मानक पुस्तकालय में उपलब्ध सभी कार्यों के अतुल्यकालिक संस्करण।
• टीसीपी / यूडीपी / आईपीसी सॉकेट्स के साथ अतुल्यकालिक संचालन के लिए समर्थन
• DNS के साथ काम करने के तरीके (अब तक 2 तरीके: lookup और reverse )
• साथ ही प्रक्रियाओं के साथ अतुल्यकालिक काम के लिए तरीके।

Asys एपीआई पर काम अभी तक पूरा नहीं हुआ है, वर्तमान में लिब्रुव लाइब्रेरी के साथ काम करते समय कचरा कलेक्टर के साथ कुछ समस्याएं हैं। संबंधित परिवर्तनों के साथ पुल अनुरोध को अभी तक मुख्य हेक्स शाखा में शामिल नहीं किया गया है, इस पर टिप्पणी नए तरीकों, उनके हस्ताक्षर और प्रलेखन के नामों पर राय का स्वागत करती है।
जैसा कि पहले ही उल्लेख किया गया है, ऐश एपीआई के लिए समर्थन केवल हैशलिंक, एवल और नेको (तीन अलग-अलग पुल अनुरोधों के रूप में) के लिए लागू किया गया है। ऑरेल ने पहले से ही C ++ और Lua के लिए नए API के लिए समर्थन जोड़ने के बारे में एक योजना बनाई है। अन्य प्लेटफार्मों के लिए कार्यान्वयन के लिए अतिरिक्त शोध की आवश्यकता होगी।

यह संभव है कि राख एपीआई हेक्स 4.1 (लेकिन केवल कुछ प्लेटफार्मों पर) में उपलब्ध हो जाएगा।

ऑरेल ने अपने साइड प्रोजेक्ट के बारे में भी बात की - एम्मेर लाइब्रेरी (जो हैक्स फाउंडेशन में अपने काम से जुड़ी हुई है)।

Ammer का लक्ष्य C पुस्तकालयों के लिए बाइंडरों के निर्माण को स्वचालित करना है ताकि उन्हें HashLink और HXCPP दोनों में उपयोग किया जा सके (अक्टूबर 2018 में, Lars Duse ने इस समस्या को हल करने के लिए एक शुल्क नियुक्त किया )।

यह कार्य प्रासंगिक क्यों था? तथ्य यह है कि हालांकि हैशलिंक और एचएक्ससीपीपी के लिए बाइंडर्स बनाने की प्रक्रिया समान है, प्रत्येक प्लेटफॉर्म के लिए आपको अपना स्वयं का गोंद कोड लिखना होगा।

ऑरेल ने मोटे तौर पर वही काम किया, जब उन्होंने कामेच्छा पुस्तकालय को हेक्स में एकीकृत किया था - एवल, नेको और हैशलिंक के लिए उन्हें एक ही कोड लिखना था जो केवल विवरणों में भिन्न था (फ़ंक्शन कॉल, एफएफआई के काम में अंतर, आदि):

इसी तरह के काम को हेक्स की ओर से करने की आवश्यकता थी ताकि देशी कार्यों को इससे बुलाया जा सके:

और एम्मर का विचार एपीआई के हेक्स संस्करण को लेना है, निरर्थक सूचनाओं के साथ नहीं, और इस कोड को किसी तरह सभी प्लेटफार्मों के लिए काम करना है:

बाहरी सी पुस्तकालयों का उपयोग करने के लिए अब किस आमेर की आवश्यकता है:

• लाइब्रेरी के लिए Haxe विनिर्देश बनाएँ, जो अनिवार्य रूप से उपयोग की जाने वाली लाइब्रेरी के लिए एक बाहरी है
• एप्लिकेशन कोड लिखें
• हेडर फ़ाइलों और सी-लाइब्रेरी फ़ाइलों के लिए पथ निर्दिष्ट करके परियोजना को संकलित करें
• ...
• लाभ

हुड के तहत, आमेर निम्नलिखित करता है:

• लक्ष्य प्लेटफॉर्म के आधार पर मिलान प्रकार
• स्वचालित रूप से मूल कार्यों को कॉल करने के लिए सी कोड उत्पन्न करता है
• एक मेकफाइल उत्पन्न करता है जिसका उपयोग एचडीएल, एनडीएल फाइलें बनाने के लिए किया जाता है

वर्तमान में आमेर समर्थन करता है:

• सरल कार्य
• हेडर फ़ाइलों से परिभाषित करें (हेक्स-कोड में, उन्हें स्थिरांक के रूप में एक्सेस किया जा सकता है)
• सूचकांकों

समर्थन की योजना बनाई:

• कॉलबैक (वे अभी भी कम आपूर्ति में हैं)
• और संरचनाएं (सी-एपीआई के साथ काम करने के लिए बहुत आवश्यक)

अब ammer C ++, HashLink और Eval के साथ काम करता है। और ऑरेल सुनिश्चित है कि वह अन्य सिस्टम प्लेटफार्मों के लिए समर्थन जोड़ सकता है।

आमेर की क्षमताओं को प्रदर्शित करने के लिए, ऑरेल ने एक छोटा सा अनुप्रयोग दिखाया जो लुआ दुभाषिया चलाता है:

इसमें प्रयुक्त बाइंडर इस प्रकार हैं:

जैसा कि आप देख सकते हैं, कुछ तरीकों पर टिप्पणी की गई है, क्योंकि वे कॉलबैक का उपयोग करते हैं, जिसके समर्थन का अभी तक एहसास नहीं हुआ है, लेकिन ऑरेल को उम्मीद है कि वह जल्द ही इसे ठीक कर पाएंगे।

तो किस किसान के लिए इस्तेमाल किया जा सकता है:

• एक लुआ वर्चुअल मशीन को एम्बेड करना
• SDL पर एप्लिकेशन बनाना
• लिबाव के साथ काम का स्वचालन संभव है (जैसा कि पहले दिखाया गया है, अब लिबवू के साथ काम करने के लिए बहुत सारे हाथ से लिखा हुआ कोड लगता है)
• और, ज़ाहिर है, यह कई अन्य उपयोगी सी पुस्तकालयों (जैसे कि ओपेन, डियर-इम्गेल, आदि) के उपयोग को बहुत सरल करेगा।

हालांकि हेक्ले फाउंडेशन में ऑरेल की इंटर्नशिप समाप्त हो गई है, वह हेक्स के साथ काम करना जारी रखने की योजना बना रही है उनकी कॉलेज की शिक्षा अभी तक पूरी नहीं हुई है और उन्हें अभी भी अपना अंतिम काम लिखना है। ऑरेल को पहले से ही पता है कि वह क्या समर्पित होगा - हैशलिंक में कचरा कलेक्टर के काम में सुधार करना। खैर, यह दिलचस्प होगा!