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

यह लेख एंड्रॉइड के लिए कोरोना परियोजनाओं में जावा के उपयोग पर चर्चा करेगा

यह समझने के लिए कि लेख में क्या हो रहा है, आपको जावा, लुआ और कोरोना इंजन के बुनियादी ज्ञान की आवश्यकता है

शुरुआत हो रही है

कोरोना और एंड्रॉइड स्टूडियो को कंप्यूटर पर स्थापित किया जाना चाहिए

कोरोना इंस्टॉलेशन फ़ोल्डर में प्रोजेक्ट टेम्प्लेट भी होता है: नेटिव \ प्रोजेक्ट टेम्प्लेट \ एप। पूरे फ़ोल्डर की प्रतिलिपि बनाएँ और इसे अपनी परियोजना के नाम पर नाम दें।

खाका अनुकूलन

नोट: मैंने कोरोना के लिए उपलब्ध नवीनतम सार्वजनिक निर्माण का उपयोग किया - 2017.3184 । नए संस्करणों में, टेम्पलेट बदल सकता है, और इस अध्याय से कुछ तैयारियों की अब आवश्यकता नहीं होगी।

एंड्रॉइड के लिए हमें अंदर 2 फ़ोल्डर्स चाहिए: कोरोना और एंड्रॉइड

कोरोना फ़ोल्डर से, Images.xcassets और LaunchScreen.storyboardc हटाएं - हमें इन फ़ोल्डरों की आवश्यकता नहीं है। Main.lua फ़ाइल में, हम सभी कोड भी हटाते हैं - हम स्क्रैच से प्रोजेक्ट बनाना शुरू करेंगे। यदि आप किसी मौजूदा प्रोजेक्ट का उपयोग करना चाहते हैं, तो कोरोना फ़ोल्डर की सभी फाइलों को अपने साथ बदल दें

एंड्रॉइड स्टूडियो के लिए एंड्रॉइड फ़ोल्डर एक तैयार परियोजना है, हमें इसे खोलने की आवश्यकता है। स्टूडियो का पहला संदेश "ग्रैडल सिंक फेल" होगा। Build.gradle को ठीक करने की आवश्यकता है:

स्थिति को ठीक करने के लिए, बिल्डस्क्रिप्ट में रिपॉजिटरी के लिए एक लिंक जोड़ें। मैंने भी क्लासपैथ के संस्करण 'com.android.tools.build:gradle' को एक नए सिरे से बदल दिया।

// Top-level build file where you can add configuration options common to all sub-projects/modules. buildscript { dependencies { classpath 'com.android.tools.build:gradle:3.1.3' } repositories { jcenter() google() } } allprojects { repositories { jcenter() google() } } task clean(type: Delete) { delete rootProject.buildDir } 

अगला कदम gradle-wrapper.properties को बदलना है। आप वितरणयूएल में ग्रेडेल के संस्करण को बदलकर इसे मैन्युअल रूप से बदल सकते हैं। या स्टूडियो को आपके लिए सब कुछ करने दें।

इसके अतिरिक्त, आपको ऐप मॉड्यूल के लिए build.gradle को ठीक करने की आवश्यकता है: cleanAssets में आपको डिलीट लाइन "$ प्रोजेक्टडिर / बिल्ड / इंटरमीडिएट / जॉनीलिब" जोड़ने की आवश्यकता है, जिसके बिना आपको कोई भी प्रोजेक्ट शुरू करने से पहले ( यहां से लिया गया ) करना होगा।

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

अब स्टूडियो में हम 2 मॉड्यूल देखते हैं: ऐप और प्लगइन। जारी रखने से पहले एप्लिकेशन (com.mycompany.app) और प्लगइन (plugin.library) का नाम बदलें।

कोड में आगे, प्लगइन plugin.habrExamplePlugin कहा जाएगा

प्लगइन में डिफ़ॉल्ट रूप से LuaLoader वर्ग शामिल है - यह लुआ कोड से कॉल को संभालने के लिए जिम्मेदार होगा। पहले से ही कुछ कोड है, लेकिन इसे स्पष्ट करते हैं।

 package plugin.habrExamplePlugin; import com.naef.jnlua.JavaFunction; import com.naef.jnlua.LuaState; @SuppressWarnings({"WeakerAccess", "unused"}) public class LuaLoader implements JavaFunction { @Override public int invoke(LuaState luaState) { return 0; } } 

लुआ कोड से प्लगइन कोड का उपयोग करना

कोरोना नेटिव जावा और लुआ कोड के बीच बंधन के लिए जनलुआ का उपयोग करता है। LuaLoader jnlua.JavaFunction इंटरफ़ेस लागू करता है, इसलिए इसकी इनवोक विधि lua कोड से उपलब्ध है। सुनिश्चित करने के लिए कि सब कुछ क्रम में है, LuaLoader.invoke पर लॉगिंग कोड जोड़ें और main.uaua में आवश्यकता प्लगइन बनाएं

  @Override public int invoke(LuaState luaState) { Log.d("Corona native", "Lua Loader invoke called"); return 0; } 

 local habrPlugin = require("plugin.habrExamplePlugin") print("test:", habrPlugin) 

एप्लिकेशन लॉन्च करने के बाद, लॉग के बीच हम निम्नलिखित 2 लाइनें देखेंगे:

डी / कोरोना मूल: लुआ लोडर आह्वान
मैं / कोरोना: परीक्षण सही है

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

मॉड्यूल में फ़ंक्शन जोड़ने के लिए, हम jnlua.NamedJavaFunction इंटरफ़ेस का उपयोग करते हैं। बिना किसी तर्क और कोई वापसी मूल्य के साथ एक साधारण कार्य का एक उदाहरण:

 class HelloHabrFunction implements NamedJavaFunction { @Override public String getName() { return "helloHabr"; } @Override public int invoke(LuaState L) { Log.d("Corona native", "Hello Habr!"); return 0; } } 

लुआ में हमारे नए फ़ंक्शन को पंजीकृत करने के लिए, हम LuaState.register विधि का उपयोग करते हैं:

 public class LuaLoader implements JavaFunction { @Override public int invoke(LuaState luaState) { Log.d("Corona native", "Lua Loader invoke called"); String libName = luaState.toString(1); //      (  require) NamedJavaFunction[] luaFunctions = new NamedJavaFunction[]{ new HelloHabrFunction(), //     }; luaState.register(libName, luaFunctions); //   ,     //  1        lua . //     require      , require     return 1; } 

इस कोड को अतिरिक्त स्पष्टीकरण की आवश्यकता है:

LuaState, इनवोक विधि का एक पैरामीटर, अनिवार्य रूप से Lua वर्चुअल मशीन पर एक आवरण का प्रतिनिधित्व करता है (कृपया मुझे सही करें अगर मैं इसे गलत डालूं)। C से लुआ कोड का उपयोग करने से परिचित लोगों के लिए, LuaState C में lua_State पॉइंटर के समान है।

उन लोगों के लिए जो लू के साथ काम करने के जंगल में तल्लीन करना चाहते हैं, मैं मैनुअल को पढ़ने की सलाह देता हूं , द एप्लीकेशन प्रोग्राम इंटरफेस के साथ

इसलिए, जब आह्वान किया जाता है, तो हम LuaState प्राप्त करते हैं। इसमें एक स्टैक है जिसमें लुआ कोड से हमारे फ़ंक्शन में पारित पैरामीटर शामिल हैं। इस स्थिति में, यह मॉड्यूल का नाम है, क्योंकि कॉल की आवश्यकता होने पर LuaLoader निष्पादित होता है ("plugin.habrExamplePlugin")।

आह्वान के द्वारा लौटाया गया अंक स्टैक से चर की संख्या को दर्शाता है जो लौआ कोड में वापस आ जाएगी। आवश्यकता के मामले में, इस संख्या का कोई प्रभाव नहीं है, लेकिन हम इस ज्ञान का उपयोग बाद में एक फ़ंक्शन बनाकर करेंगे जो कई मान लौटाता है

मॉड्यूल में फ़ील्ड जोड़ना

कार्यों के अलावा, हम मॉड्यूल में अतिरिक्त फ़ील्ड भी जोड़ सकते हैं, उदाहरण के लिए, संस्करण:

  luaState.register(libName, luaFunctions); //   ,       luaState.pushString("0.1.2"); //     luaState.setField(-2, "version"); //   version   . 

इस स्थिति में, हमने -2 इंडेक्स का उपयोग करके संकेत दिया कि हमारे मॉड्यूल के लिए फ़ील्ड सेट करने की आवश्यकता है। एक नकारात्मक सूचकांक का मतलब है कि गिनती स्टैक के अंत में शुरू होती है। -1 स्ट्रिंग "0.1.2" को इंगित करेगा (लूआ में, इंडेक्स एक से शुरू होता है)।

स्टैक को रोकना नहीं करने के लिए, फ़ील्ड सेट करने के बाद, मैं luaState.pop (1) को कॉल करने की सलाह देता हूं - स्टैक से 1 तत्व फेंकता है।

 @SuppressWarnings({"WeakerAccess", "unused"}) public class LuaLoader implements JavaFunction { @Override public int invoke(LuaState luaState) { Log.d("Corona native", "Lua Loader invoke called"); String libName = luaState.toString(1); //      (  require) NamedJavaFunction[] luaFunctions = new NamedJavaFunction[]{ new HelloHabrFunction(), //     }; luaState.register(libName, luaFunctions); //   ,     luaState.register(libName, luaFunctions); //   ,       luaState.pushString("0.1.2"); //     luaState.setField(-2, "version"); //   version   . //  1        lua . //     require      , require     return 0; } } 

कार्य उदाहरण

 class StringJoinFunction implements NamedJavaFunction{ @Override public String getName() { return "stringJoin"; } @Override public int invoke(LuaState luaState) { int currentStackIndex = 1; StringBuilder stringBuilder = new StringBuilder(); while (!luaState.isNone(currentStackIndex)){ String str = luaState.toString(currentStackIndex); if (str != null){ //toString  null  non-string  non-number,  stringBuilder.append(str); } currentStackIndex++; } luaState.pushString(stringBuilder.toString()); return 1; } } 

 local joinedString = habrPlugin.stringJoin("this", " ", "was", " ", "concated", " ", "by", " ", "Java", "!", " ", "some", " ", "number", " : ", 42); print(joinedString) 

 @Override public int invoke(LuaState luaState) { if (!luaState.isNumber(1) || !luaState.isNumber(2)){ luaState.pushNil(); luaState.pushString("Arguments should be numbers!"); return 2; } int firstNumber = luaState.toInteger(1); int secondNumber = luaState.toInteger(1); luaState.pushInteger(firstNumber + secondNumber); return 1; } 

जावा परावर्तन - जावा वर्गों का उपयोग सीधे लुआ में करें

Jnlua लाइब्रेरी में एक विशेष JavaReflector वर्ग है जो एक जावा ऑब्जेक्ट से एक लुआ टेबल बनाने के लिए जिम्मेदार है। इस प्रकार, आप जावा में कक्षाएं लिख सकते हैं और उन्हें भविष्य के उपयोग के लिए लुआ कोड दे सकते हैं।

यह करने के लिए काफी सरल है:

वर्ग उदाहरण

 @SuppressWarnings({"unused"}) public class Calculator { public int sum(int number1, int number2){ return number1 + number2; } public static int someStaticMethod(){ return 4; } } 

इस वर्ग का एक उदाहरण हमारे मॉड्यूल में जोड़ना

  luaState.pushJavaObject(new Calculator()); luaState.setField(-2, "calc"); luaState.pop(1); 

लुआ में उपयोग:

 local calc = habrPlugin.calc print("call method of java object", calc:sum(3,4)) print("call static method of java object", calc:getClass():someStaticMethod()) 

वर्ग विधि कॉल में कोलन पर ध्यान दें। स्थैतिक तरीकों के लिए, आपको एक बृहदान्त्र का उपयोग भी करना होगा।

तब मैंने परावर्तक की एक दिलचस्प विशेषता पर ध्यान दिया: यदि हम लुआ करने के लिए केवल कक्षा का एक उदाहरण पास करते हैं, तो getClass () के माध्यम से इसकी स्थिर विधि को कॉल करना संभव है। लेकिन getClass () के माध्यम से कॉल के बाद, बाद में कॉल को ऑब्जेक्ट पर ही ट्रिगर किया जाएगा:

 print("call method of java object", calc:sum(3,4)) -- ok print("exception here", calc:someStaticMethod()) --   "com.naef.jnlua.LuaRuntimeException: no method of class plugin.habrExamplePlugin.Calculator matches 'someStaticMethod()'" print("call static method of java object", calc:getClass():someStaticMethod()) -- ok print("hmm", calc:someStaticMethod()) --    getClass         

इसके अलावा, getClass () का उपयोग करके, हम सीधे लुआ में नई वस्तुएँ बना सकते हैं:

 local newInstance = calc:getClass():new() 

दुर्भाग्य से, मैं "java.lang.IllegalArgumentException: अवैध प्रकार" सेटफिल्ड के अंदर मॉड्यूल क्षेत्र में Calculator.class को नहीं बचा सका।

मक्खी पर लुआ फ़ंक्शंस बनाना और कॉल करना

यह खंड दिखाई दिया क्योंकि ताज जावा में सीधे अपने एपीआई से कार्यों तक पहुंचने की क्षमता प्रदान नहीं करता है। लेकिन jnlua.LuaState आपको मनमाने ढंग से लुआ कोड को लोड करने और निष्पादित करने की अनुमति देता है:

 class CreateDisplayTextFunction implements NamedJavaFunction{ //    API  private static String code = "local text = ...;" + "return display.newText({" + "text = text," + "x = 160," + "y = 200," + "});"; @Override public String getName() { return "createText"; } @Override public int invoke(LuaState luaState) { luaState.load(code,"CreateDisplayTextFunction code"); //    ,     luaState.pushValue(1); //        luaState.call(1, 1); //   ,      1 ,    1 return 1; } } 

पिछले उदाहरणों के समान LuaLoader.invoke के माध्यम से फ़ंक्शन को पंजीकृत करना याद रखें

लुआ में कॉल:

 habrPlugin.createText("Hello Habr!") 

निष्कर्ष

इस प्रकार, आपका एंड्रॉइड एप्लिकेशन प्लेटफॉर्म की सभी मूल क्षमताओं का उपयोग कर सकता है। इस समाधान का एकमात्र दोष यह है कि आप कोरोना सिम्युलेटर का उपयोग करने की क्षमता खो देते हैं, जो विकास को धीमा कर देता है (सिम्युलेटर को फिर से शुरू करना लगभग तात्कालिक है, एमुलेटर या डिवाइस पर डिबगिंग के विपरीत जिसमें बिल्ड + इंस्टॉल की आवश्यकता होती है)

उपयोगी लिंक

1. जीथब पर पूर्ण कोड उपलब्ध है

   
   

2. कोरोना नेटिव डॉक्यूमेंटेशन

   
   

3) jnlua रिपॉजिटरी में से एक । कुछ कार्यों के उद्देश्य को समझने में मेरी मदद की।