सी एसडीके के साथ ज़मारिन का काम

नहीं बहुत पहले मैं कई प्लेटफार्मों के लिए Xamarin फार्म पर एक दिलचस्प परियोजना थी:

• एंड्रॉयड
• आईओएस
• UWP
• MacOS

हमें एक ऐसी लाइब्रेरी बनाने की ज़रूरत थी, जो हमारे कई प्रोजेक्ट्स से जुड़ सके: Xamarin.Forms, जावा, कॉर्डोवा में एंड्रॉइड, और तीसरे पक्ष के डेवलपर्स को एकीकरण के लिए न्यूनतम प्रयास के साथ हमारे प्रोजेक्ट में हमारे एसडीके का उपयोग करने की अनुमति भी।

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

यह सच है, अंत में यह बहुत मुश्किल हो गया है कि "दोस्तों को" एक पुस्तकालय बनाओ जो ज़मरीन मंच पर विभिन्न प्लेटफार्मों के साथ है। यह छोटा लेख यह वर्णन करेगा कि हम यह कैसे करने में कामयाब रहे, और शायद यह किसी के लिए उपयोगी होगा और परियोजना पर समय बचाएगा।

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

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

मूल फ़ाइल एक्सटेंशन

• Android - * .so फ़ाइल;
• यूनिवर्सल विंडोज प्लेटफ़ॉर्म (UWP) - * .dll फ़ाइल;
• iOS - * .a फ़ाइल (एक स्थिर लाइब्रेरी फ़ाइल, जो वास्तव में एक मोटी फ़ाइल है, जो हमारे लिए आवश्यक सभी आर्किटेक्चर संग्रहीत करेगी);
• MacOS - * .dylib फ़ाइल (डायनामिक लाइब्रेरी फ़ाइल)

विभिन्न प्लेटफार्मों पर संभव आर्किटेक्चर

एंड्रॉयड

• हाथ
• arm64
• 86
• 64

UWP

• 86
• 64

आईओएस

• ARMv7
• armv7s
• i386
• x86_64
• arm64

MacOS

• x86_64

हमें प्लेटफ़ॉर्म और आर्किटेक्चर के लिए मूल फ़ाइलों को इकट्ठा करने की आवश्यकता है जो हमें रिलीज़ मोड में चाहिए।

देशी एसडीके फाइलें बनाएं और तैयार करें

यूनिवर्सल विंडोज प्लेटफॉर्म (UWP)

हम दो x86 और x64 आर्किटेक्चर के लिए एक सी प्रोजेक्ट बना रहे हैं। उसके बाद, हमारे पास दो * .dll फाइलें होंगी जिनकी हमें जरूरत है।

एंड्रॉयड

एंड्रॉइड प्रोजेक्ट के लिए मूल फाइलें बनाने के लिए। हमें Xamarin C ++ प्रोजेक्ट बनाने की आवश्यकता है। साझा प्रोजेक्ट के लिए हमारी सी फाइलें और हेडर फाइलें जोड़ें। उसके बाद, आपको सभी आवश्यक आर्किटेक्चर (हाथ, आर्म 64, x86, x64) के साथ एक प्रोजेक्ट को इकट्ठा करने की आवश्यकता है। यह हमें एंड्रॉइड प्रोजेक्ट के लिए * .so फाइलें देगा।

आईओएस

एक iOS प्रोजेक्ट के लिए देशी फाइल बनाने के लिए, हम उसी Xamarin C ++ प्रोजेक्ट का उपयोग कर सकते हैं जिसका उपयोग हमने एंड्रॉइड के लिए किया था, लेकिन एक अति सूक्ष्म अंतर है। C ++ प्रोजेक्ट बनाने के लिए हमें MacOS से कनेक्ट करना होगा। लेकिन इसके लिए हमें macOS पर vcremote इंस्टॉल करना होगा। सच है, नवीनतम अपडेट के बाद अब ऐसा करना असंभव है। हो सकता है कि बाद में Microsoft इस पर ध्यान दे और इसकी स्थापना को ठीक कर दे, लेकिन अब दुर्भाग्य से ऐसा नहीं है।

इस वजह से हमें दूसरे रास्ते पर जाना होगा। Xcode में, हमें iOS के लिए कोकोस टच स्टेटिक लाइब्रेरी प्रोजेक्ट बनाने की आवश्यकता है। ऐसा कैसे करें, हम यहां पढ़ सकते हैं । हम इस परियोजना में सी एसडीके से अपनी फाइलें जोड़ते हैं और दो बार परियोजना को इकट्ठा करते हैं जो हमें आवश्यक आर्किटेक्चर का सेट मिलता है:

• iPhone सिम्युलेटर के लिए
• iPhone के लिए

तब हम यह जांच सकते हैं कि MacOS पर टर्मिनल कमांड का उपयोग करके स्टैटिक लाइब्रेरी के हमारे निर्माण में कौन से आर्किटेक्चर शामिल हैं - "लाइपो"। उदाहरण के लिए, हम इस तरह की कॉल कर सकते हैं:

lipo -info /path_to_your_a_file/lib.a 

परिणाम इस तरह होना चाहिए:

 Architectures in the fat file: /path_to_your_a_file/lib.a are : armv7 armv7s i386 x86_64 arm6 

जब हमने स्टैटिक लाइब्रेरी फ़ाइलों को तैयार कर लिया है, तो हम उन्हें एक फ़ाइल में सभी आर्किटेक्चर की सूची के साथ, फिर से टर्मिनल कमांड का उपयोग करके, एक मोटी फाइल में जोड़ सकते हैं:

 lipo -create lib_iphone.a lib_iphone_simulator.a -output lib.a 

MacOS

MacOS पर, सब कुछ बेहद सरल होगा। हमें टर्मिनल कमांड का उपयोग करके फिर से स्टैटिक लाइब्रेरी फ़ाइल को डायनामिक में बदलने की आवश्यकता है:

 clang -fpic -shared -Wl, -all_load lib.a -o lib.dylib 

और वह सब है। हमें * .dylib फ़ाइल की आवश्यकता होगी।

नगेट पैकेज

चूंकि हमने एक नगेट पैकेज बनाया है और इसमें ज़मरीन परियोजना के लिए विशिष्ट तर्क जोड़ा है, इसलिए हमें सी एसडीके के लिए एक रैपर करने की आवश्यकता है। C # में, C विधियों को जोड़ने के लिए, हमें DllImport विशेषता का उपयोग करने की आवश्यकता है। लेकिन यहाँ फिर से एक अति सूक्ष्म अंतर है। हमें मूल C फ़ाइल के पथ के लिए const का उपयोग करने की आवश्यकता है। इसके अलावा, प्रत्येक प्रोजेक्ट में फ़ाइल के लिए अपना रास्ता होगा, और यहां तक ​​कि फ़ाइल का नाम भी अलग होगा। इसके कारण, हमें अपने आप को थोड़ा परिष्कृत करना पड़ा और इसके लिए अपने स्वयं के रैपर लिखने पड़े।

तो, हमारा मुख्य वर्ग जो सी फ़ाइल विधियों का वर्णन करता है।

 public abstract class BaseLibraryClass { public abstract int Init (IntPtr value); } 

फिर प्रत्येक मंच के लिए हमें एक अमूर्त वर्ग को लागू करने की आवश्यकता है।

एंड्रॉयड

 internal class BaseLibraryClassDroid : BaseLibraryClass { private const string Path = "lib"; [DllImport (Path, EntryPoint = "Init", CallingConvention = CallingConvention.Cdecl)] private static extern int InitExtern (IntPtr value); public override int Init (IntPtr value) => InitExtern (value); } 

यूनिवर्सल विंडोज प्लेटफॉर्म (UWP)

 internal class BaseLibraryClassx64 : BaseLibraryClass { private const string Path = "lib/x64/lib"; [DllImport (Path, EntryPoint = "Init", CallingConvention = CallingConvention.Cdecl)] private static extern int InitExtern (IntPtr value); public override int Init (IntPtr value) => InitExtern (value); } 

 internal class BaseLibraryClassx86 : BaseLibraryClass { private const string Path = "lib/x86/lib"; [DllImport (Path, EntryPoint = "Init", CallingConvention = CallingConvention.Cdecl)] private static extern int InitExtern (IntPtr value); public override int Init (IntPtr value) => InitExtern (value); } 

आईओएस

 internal class BaseLibraryClassIOS : BaseLibraryClass { private const string Path = "__Internal"; [DllImport (Path, EntryPoint = "Init", CallingConvention = CallingConvention.Cdecl)] private static extern int InitExtern (IntPtr value); public override int Init (IntPtr value) => InitExtern (value); } 

MacOS

 public class BaseLibraryClassMac : BaseLibraryClass { private const string Path = "lib"; [DllImport (Path, EntryPoint = "Init", CallingConvention = CallingConvention.Cdecl)] private static extern int InitExtern (IntPtr value); public override int Init (IntPtr value) => InitExtern (value); } 

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

 public enum PlatformArchitecture { Undefined, X86, X64, Droid, Ios, Mac } 

और हमारे आवरण के अंदर उपयोग के लिए एक कारखाना:

 public class SdkCoreFactory { public static BaseLibraryClass GetCoreSdkImp () { switch (Init.PlatformArchitecture) { case PlatformArchitecture.Undefined: throw new BaseLibraryClassInitializationException (); case PlatformArchitecture.X86: return new BaseLibraryClassx86 (); case PlatformArchitecture.X64: return new BaseLibraryClassx64 (); case PlatformArchitecture.Droid: return new BaseLibraryClassDroid (); case PlatformArchitecture.Ios: return new BaseLibraryClassIOS (); case PlatformArchitecture.Mac: return new BaseLibraryClassMac (); default: throw new BaseLibraryClassInitializationException (); } } } 

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

 public static class Init { public static PlatformArchitecture PlatformArchitecture { get; set; } } 

उत्पन्न पुस्तकालयों को परियोजनाओं से जोड़ना

यूनिवर्सल विंडोज प्लेटफॉर्म (UWP)

हम उत्पन्न लाइब्रेरी फ़ाइलों को फ़ोल्डरों में कॉपी करते हैं:

• lib / x86 / lib.dll
• lib / x64 / lib.dll

और जब हम इनिट विधि में आवेदन शुरू करते हैं तो हम अपना आर्किटेक्चर सेट करते हैं:

 Wrapper.Init.PlatformArchitecture = Wrapper.Enums.PlatformArchitecture.X64; 

एंड्रॉयड

एंड्रॉइड प्रोजेक्ट के लिए, हमें * .csproj फ़ाइल को ठीक करना होगा, प्रोजेक्ट को सहेजना होगा और * .so फ़ाइलों को फ़ोल्डरों में कॉपी करना होगा। एंड्रॉइड प्रोजेक्ट में, हम उत्पन्न फ़ाइल का नाम इंगित करते हैं, क्योंकि हम * .csproj फ़ाइल में फ़ाइल पथ लिखते हैं। फोल्डर में फाइल कॉपी करते समय हमें निम्नलिखित बातें भी याद रखनी चाहिए:

• armeabi - बांह * .so फ़ाइल
• armeabi-v7a - भुजा * .so फ़ाइल
• arm64-v8a - arm64 * .so फ़ाइल
• x86 - x86 * .so फ़ाइल
• x64 - x64 * .so फ़ाइल

* .Csproj फ़ाइल के लिए परिवर्तन:

 <ItemGroup> <AndroidNativeLibrary Include="lib\armeabi\lib.so"> <Abi>armeabi</Abi> <CopyToOutputDirectory>Always</CopyToOutputDirectory> </AndroidNativeLibrary> <AndroidNativeLibrary Include="lib\armeabi-v7a\lib.so"> <Abi>armeabi-v7a</Abi> <CopyToOutputDirectory>Always</CopyToOutputDirectory> </AndroidNativeLibrary> <AndroidNativeLibrary Include="lib\arm64-v8a\lib.so"> <Abi>arm64-v8a</Abi> <CopyToOutputDirectory>Always</CopyToOutputDirectory> </AndroidNativeLibrary> <AndroidNativeLibrary Include="lib\x86\lib.so"> <Abi>x86</Abi> <CopyToOutputDirectory>Always</CopyToOutputDirectory> </AndroidNativeLibrary> <AndroidNativeLibrary Include="lib\x86_64\lib.so"> <Abi>x86_64</Abi> <CopyToOutputDirectory>Always</CopyToOutputDirectory> </AndroidNativeLibrary> </ItemGroup> 

और नगेट पैकेज के लिए वास्तुकला स्थापित करें:

 Wrapper.Init.PlatformArchitecture = Wrapper.Enums.PlatformArchitecture.Droid; 

आईओएस

आपको प्रोजेक्ट के रूट फ़ोल्डर में उत्पन्न * .A वसा फ़ाइल को जोड़ने और प्रोजेक्ट को संकलित करते समय अतिरिक्त निर्देश स्थापित करने की आवश्यकता है (iOS गुण => iOS बिल्ड => अतिरिक्त mtouch तर्क)। निम्नलिखित निर्देश स्थापित करें:

 -gcc_flags "-L${ProjectDir} -llib -force_load ${ProjectDir}/lib.a" 

इसके अलावा, बिल्ड एक्शन को निर्दिष्ट करने के लिए मत भूलना क्योंकि * .a फ़ाइल के गुणों में कोई भी नहीं।

और फिर से एनगेट पैकेज के लिए आर्किटेक्चर स्थापित करें:

 Wrapper.Init.PlatformArchitecture = Wrapper.Enums.PlatformArchitecture.Ios; 

MacOS

मूल संदर्भ परियोजना के लिए हमारी * .dylib फ़ाइल जोड़ें और वांछित आर्किटेक्चर लिखें:

 Wrapper.Init.PlatformArchitecture = Wrapper.Enums.PlatformArchitecture.Mac; 

इन जोड़तोड़ के बाद, हमारे सभी प्लेटफार्मों के लिए प्रोजेक्ट्स ने जनरेट की गई मूल फ़ाइलों को उठाया और हम प्रोजेक्ट के अंदर अपने KFOR से सभी कार्यों का उपयोग करने में सक्षम थे।