OpenFL, भाग दो के लिए एक मूल एक्सटेंशन लाइब्रेरी बनाना

प्रस्तावना

यह लॉरेंट बेडुबर्ग द्वारा ओपनएफएल के लिए एक्सटेंशन बनाने पर लेखों की एक श्रृंखला के अनुवाद की निरंतरता है। पहले भाग में, हमने एक सरल एक्सटेंशन बनाया और इसे देशी प्लेटफार्मों (लिनक्स / विंडोज, एंड्रॉइड, आईओएस) के लिए संकलित किया। इस भाग में, हम अपने iOS एप्लिकेशन को ट्वीट भेजने की क्षमता जोड़ेंगे।

हम क्या सीखते हैं:

• विभिन्न प्लेटफार्मों के लिए हमारे एक्सटेंशन के स्रोत कोड को कैसे तैयार किया जाए
• हमारे एक्सटेंशन से हेक्स कोड और फ़ंक्शन कैसे लिंक करें
• iOS फ्रेमवर्क के साथ लिंक कैसे करें (विशेष रूप से ट्विटर फ्रेमवर्क के साथ)

क्या करें?

उदाहरण के लिए, NME परियोजना को संरचित कैसे किया जाता है, इसे देखते हुए शुरू करते हैं।

पहली नज़र में, Build.xml जटिल लग रहा है और हम बाद में इसे वापस कर देंगे। निर्देशिका की सामग्री को देखते हुए, हम निम्नलिखित देखेंगे:

• शामिल / में सामान्य / और plaforms में लागू होने वाली हेडर फाइलें शामिल हैं
• सामान्य / प्लेटफ़ॉर्म-स्वतंत्र c ++ कोड (कम प्लेटफ़ॉर्म-स्वतंत्र, हम # प्लेटफ़ॉर्म प्राप्त करने के लिए #if परिभाषित (HX_xxxx) का उपयोग कर सकते हैं)
• सामान्य / ExternalIterface.cpp रनटाइम को निर्यात कार्य करता है (DEFINE_PRIM)
• इस निर्देशिका में प्लेटफ़ॉर्म में विशिष्ट प्लेटफ़ॉर्म (iPhone, mac, windows और अन्य) के लिए कार्यान्वयन हैं

मेरी राय में, ऐसी संरचना सुविधाजनक दिखती है, हमें और हम इसका उपयोग करेंगे।

आइए अपने पिछले विस्तार से शुरू करें, हमें मौजूदा शामिल / Util.h फ़ाइल में ट्वीट () फ़ंक्शन को घोषित करना होगा (बौद्धिक रूप से, हमें एक अलग हेडर फ़ाइल का उपयोग करना चाहिए, लेकिन आज मैं इसके लिए बहुत आलसी हूं)।

namespace testextension { int SampleMethod(int inputValue); bool Tweet(const char* msg); } 

अब हमें iphone प्लेटफॉर्म के लिए इसे लागू करने की आवश्यकता है:

 cd project mkdir iPhone 

एक iPhone / Tweet.mm फ़ाइल बनाएँ:

 #import <Foundation/Foundation.h> #import <Twitter/Twitter.h> namespace testextension { bool Tweet(const char* message){ //       Objective-C //        //        //          :) NSString* str = [[NSString alloc] initWithUTF8String:message]; TWTweetComposeViewController* tweetView = [[TWTweetComposeViewController alloc] init]; [tweetView setInitialText:str]; TWTweetComposeViewControllerCompletionHandler completionHandler = ^(TWTweetComposeViewControllerResult result) { [[[[UIApplication sharedApplication] keyWindow] rootViewController] dismissModalViewControllerAnimated:YES]; }; [tweetView setCompletionHandler:completionHandler]; [[[[UIApplication sharedApplication] keyWindow] rootViewController] presentModalViewController:tweetView animated:YES]; return true; } } 

और ट्वीट फ़ंक्शन को haxe में पंजीकृत करें, इसके लिए हम फ़ाइल को सामान्य रूप से संपादित करते हैं / ExternalInterface.cpp:

 static value testextension_tweet(value message){ //  ,  message        const char* cStr = val_get_string(message); //    Tweet    haxe true  false if (testextension::Tweet(cStr)) return val_true; return val_false; } //   ,      DEFINE_PRIM(testextension_tweet, 1) 

DEFINE_PRIME, val_get_string, val_true और बाकी सब hxcpp का हिस्सा हैं और hx / CFFI.h में परिभाषित हैं।

NME से ExternalInterface.cpp का अध्ययन करने से आपको यह समझने में मदद मिलेगी कि अपने कार्यों को कैसे पंजीकृत किया जाए।

हैक्स हिस्सा TextExtension.hx में है और इस तरह दिखता है:

 class TestExtension { //    private static var testextension_tweet = Lib.load("testextension", "testextension_tweet", 1); //       public static function tweet(message:String) : Bool { return testextension_tweet(message); } } 

संकलन कैसे करें

मुझे यह पता लगाने का प्रयास करना था कि परियोजना को कैसे संकलित और लिंक किया जाए, लेकिन परिणामस्वरूप, सब कुछ काफी सरल हो गया।

सबसे पहले, प्रोजेक्ट बनाएँ / Build.xml फ़ाइल:

 <!--       ios --> <files id="iphone"> <file name="iPhone/Tweet.mm"/> </files> <!--        ,     : "Library TestExtension version dev does not have a neko dll for your system" --> <files id="mac"> <file name="Mac/Tweet.mm"/> </files> 

आईडी = एनडीएलएल के साथ अनुभाग में, आपको उन फ़ाइलों को जोड़ना होगा जो संकलित की जाएंगी:

 <files id="mac" if="mac"/> <files id="iphone" if="ios"/> 

और अंत में, हमें ट्विटर पर शामिल करना होगा। इस फ़ाइल के माध्यम से, hxcpp को पता चलेगा कि हमारे आवेदन में कौन सी रूपरेखा जोड़ी जानी चाहिए।

 <dependency name="Twitter.framework" if="ios"/> 

मैंने विस्तार को संकलित किया, जैसा मैंने पहले भाग में किया था।

 haxelib run hxcpp Build.xml -Dmac haxelib run hxcpp Build.xml -Diphoneos -DHXCPP_ARMV7 haxelib run hxcpp Build.xml -Diphonesim 

कैसे चलाना है?

एक्सटेंशन के संचालन का परीक्षण करने के लिए, मैंने अपने परीक्षण आवेदन में निम्नलिखित कॉल जोड़ा:

 TestExtension.tweet("This is my tweet message"); 

और इसे सिम्युलेटर में और मेरे iOS डिवाइस पर लॉन्च किया:

 cd TestApp openfl test project.xml iphone -simulator openfl test project.xml iphone 

हम अपने एप्लिकेशन से देशी एपीआई का उपयोग करके ट्वीट कर सकते हैं! अच्छा है, है ना ?! :)

मैं एक बहुत महत्वपूर्ण बात नोट करना चाहता हूं - जिस तरह से मुझे जानकारी मिली - मैंने इसे स्रोत कोड hxcpp और nme में, जीथब पर पाया।

यह सब काम करने की कोशिश कर, मैं कई समस्याओं में भाग गया। यदि आप प्रयोग कर रहे हैं और आप असफल हो रहे हैं, तो ndl / और प्रोजेक्ट / obj निर्देशिकाओं को खाली करना न भूलें और संपूर्ण प्रोजेक्ट का पुनर्निर्माण करें। मैंने तब तक प्रयोग करना जारी रखा जब तक मुझे बिल्ड.xml और शामिल.xml के लिए एक उपयुक्त प्रारूप नहीं मिला।

एकमात्र वास्तविक कठिनाई hxcpp में Build.xml प्रारूप पर प्रलेखन की कमी है। लेकिन, भगवान का शुक्र है, इससे सीखने के लिए उदाहरण हैं।

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

मैंने गीथब पर एक्सटेंशन रिपॉजिटरी को अपडेट किया, इस उम्मीद में कि मेरा छोटा योगदान अन्य हैकर्स के लिए उपयोगी होगा! मुझे उम्मीद है कि यह मार्गदर्शिका आपके सिस्टम पर काम करेगी ... हालाँकि कभी-कभी सब कुछ गलत हो जाता है;)