هل ترغب في العمل دائمًا في نفس البيئة؟ حتى لا تضطر إلى القفز ذهابًا وإيابًا في بيئات التطوير وعند استخدام الأدوات. بطبيعة الحال ، لا يزال المثل الأعلى بعيدًا ، ولكن عالم تكنولوجيا المعلومات يسعى جاهدًا لتحقيق ذلك. نتحدث اليوم عن مكتبة API واحدة عبر الأنظمة الأساسية. انضم الآن!

عند تطوير تطبيقات iOS و Android باستخدام Xamarin ، يمكن للمطورين الوصول إلى أي واجهة برمجة تطبيقات أصلية باستخدام C #. لا تساعد هذه الروابط فقط على استخدام واجهات برمجة التطبيقات المناسبة في C # ، ولكنها توفر أيضًا وظائف قوية لهذه اللغة ، مثل عدم التزامن / الانتظار ، والأحداث ، والمندوبين ، وما إلى ذلك.
هذه ميزة كبيرة للمطورين لأنهم لن يضطروا أبدًا للعمل خارج C # ، بغض النظر عما إذا كانوا يكتبون منطقًا تجاريًا مشتركًا أو واجهة مستخدم أو يصلون إلى وظائف أصلية. واحدة من الميزات الرئيسية التي يرغب المبرمجون في كثير من الأحيان في رؤيتها عند تطوير التطبيقات عبر الأنظمة الأساسية على Xamarin هي القدرة على الوصول إلى الوظائف الأصلية الشائعة من التعليمات البرمجية الشائعة دون الحاجة إلى كتابة طبقات من الملخصات الخاصة بهم أو العثور على مكون إضافي مجاني أنشأه المجتمع.
يدرك
Xamarin.Essentials حلم واجهة برمجة تطبيقات موحدة للوصول إلى ميزات مثل تحديد الموقع الجغرافي ، وقراءات المستشعر ، والتخزين الآمن ، وما إلى ذلك ، لأي تطبيق مبني على Xamarin!
واجهات برمجة التطبيقات في Xamarin.Essentials
في الإصدار التجريبي ، المتاح اليوم ، توفر واجهات برمجة تطبيقات Xamarin.Essentials الوصول إلى أكثر من 25 وظيفة أصلية من مكتبة واجهة برمجة تطبيقات واحدة عبر الأنظمة الأساسية ، والتي يمكن الوصول إليها من التعليمات البرمجية الشائعة بغض النظر عن كيفية إنشاء واجهة المستخدم. هذا يعني أنه يمكنك استخدام Xamarin.Essentials API مع تطبيق Xamarin.Android واحد أو تطبيق Xamarin.Forms الذي تم تكييفه للعمل مع iOS و Android و UWP. على الرغم من العدد الكبير من الوظائف ، تم تحسين هذه المكتبة بالكامل لأسرع عملية وأقل تأثير على حجم التطبيق ، نظرًا لأنها محمية من الرابط. هذا يعني أنه سيتم تضمين واجهات برمجة التطبيقات والوظائف التي تستخدمها فقط في تطبيقك ، وسيتم حذف كل شيء آخر في وقت الترجمة.
يمكن تثبيت إصدار التقييم للمكتبة ، الذي يستخدم المجموعة الأساسية من واجهات برمجة التطبيقات عبر الأنظمة الأساسية ، في تطبيقك من خلال NuGet:
تم تحديد مجموعة واجهة برمجة التطبيقات الأولية بناءً على التعليقات من مطوري Xamarin حول الميزات التي يرغبون في رؤيتها في مكتبة API عبر الأنظمة الأساسية. مع مرور الوقت ، سوف نقوم بتوسيع هذه القائمة.
الشروع في العمل
من السهل البدء باستخدام Xamarin.Essentials API في أي تطبيق موجود باتباع بضع خطوات بسيطة:
1. افتح مشروعًا موجودًا أو أنشئ مشروعًا جديدًا باستخدام نموذج التطبيق الفارغ في Visual Studio C # (لأجهزة Android و iPhone و iPad أو الأنظمة الأساسية المتعددة).
2. أضف حزمة Xamarin.Essentials NuGet إلى المشروع:
- Visual Studio في لوحة Solution Explorer ، انقر بزر الماوس الأيمن على اسم الحل وحدد Manage NuGet Packages (إدارة حزم NuGet). ابحث عن Xamarin.Essentials وقم بتثبيت الحزمة في جميع المشاريع ، بما في ذلك iOS و Android و UWP ومكتبات .NET القياسية.
- Visual Studio لنظام التشغيل Mac. في لوحة Solution Explorer ، انقر بزر الماوس الأيمن على اسم المشروع وحدد Add> Add NuGet Packages ... Find Xamarin.Essentials وقم بتثبيت الحزمة في جميع المشاريع ، بما في ذلك iOS و Android و .NET Standard Libraries.
3. أضف رابطًا إلى Xamarin.Essentials في أي من فئات C # للإشارة إلى API.
using Xamarin.Essentials;
4. Xamarin.Essentials يتطلب القليل من التخصيص الإضافي لمشاريع Android من أجل الوصول إلى وظائف خاصة:
يجب تهيئة Xamarin.Essentials باستخدام طريقة OnCreate داخل MainLauncher أو أي نشاط آخر في مشروع Android:
Xamarin.Essentials.Platform.Init(this, bundle);
للتعامل مع أذونات وقت التشغيل على Android ، يجب أن تحصل Xamarin.Essentials على أي OnRequestPermissionsResult. أضف الكود التالي إلى جميع فئات النشاط:
public override void OnRequestPermissionsResult(int requestCode, string[] permissions, [GeneratedEnum] Android.Content.PM.Permission[] grantResults) { Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults); base.OnRequestPermissionsResult(requestCode, permissions, grantResults); }
انتهى! الآن يمكنك البدء في استخدام Xamarin.Essentials API في تطبيقك. تأتي كل واجهة برمجة تطبيقات مع
وثائق كاملة ، بما في ذلك مقتطفات الشفرة التي يمكنك نسخها إلى التطبيق الخاص بك.
تأكد من قراءة
دليل الخطوات الأولى لمزيد من المعلومات.
تجميع البوصلة
خلال
أحد خطاباتي في Microsoft Build 2018 ، عرضت كيفية الجمع بين إمكانات Xamarin.Forms و Xamarin.Essentials APIs لتجميع بوصلة عبر الأنظمة الأساسية في أقل من 10 دقائق. الأمر بسيط مثل إضافة بعض الصور وواجهة مستخدم بوصلة صغيرة في التطبيق:
<Grid> <Grid.RowDefinitions> <RowDefinition Height="*"/> <RowDefinition Height="Auto"/> </Grid.RowDefinitions> <Image HorizontalOptions="FillAndExpand" VerticalOptions="FillAndExpand" Source="compass.png"/> <Image HorizontalOptions="Center" VerticalOptions="Center" Source="arrow.png" x:Name="ImageArrow"/> <Label Grid.Row="1" x:Name="LabelInfo" VerticalOptions="Center" HorizontalOptions="Center" /> </Grid>
تمكنت من استخدام واجهة برمجة تطبيقات
البوصلة من Xamarin.Essentials in code أعلاه لتسجيل الأحداث عندما تغير البوصلة موضعها ، وتحديث نص التسمية وتدوير الصورة. كل هذا يتم من خلال بضعة أسطر من التعليمات البرمجية:
using Xamarin.Forms; using Xamarin.Essentials; namespace MyCompass { public partial class MainPage : ContentPage { public MainPage() { InitializeComponent();
بهذه الطريقة البسيطة ، يتم إنشاء تطبيق بوصلة! يمكنك العثور على
التعليمات البرمجية المصدر والصور الكاملة على GitHub.الخطط المستقبلية
تم اختبار Xamarin.Essentials بدقة ، ولكننا مع ذلك نطلب منك ترك تعليق أثناء إصدار التقييم الخاص بنا. جرب المكتبة في تطبيقاتك
وأبلغ عن أي مشاكل تواجهها أثناء العمل مع
مستودع Xamarin.Essentials GitHub .
نعتبر هذه المكتبة هي العنصر الرئيسي لمنصة Xamarin ونعلم أن هذه لبنة مهمة لجميع المطورين والتطبيقات. لذلك ، سنقوم بدمج حزمة Xamarin.Essentials NuGet في كل من نماذج iOS و Android و Xamarin.Forms في Visual Studio و Visual Studio for Mac بحيث يمكن للمطورين الوصول إلى واجهات برمجة التطبيقات هذه من المراحل الأولى من مشاريعهم.
انظر بأم عينيك
يمكنك الاطلاع على مراجعة كاملة لـ Xamarin و Xamarin.Forms و Xamarin.Essentials كجزء من العرض التقديمي "إنشاء تطبيقات الجوال باستخدام Visual Studio و Xamarin" على Microsoft Build 2018.
معلومات إضافية
يمكنك عرض وثائقنا
للحصول على دليل كامل للبدء واستخدام كل وظيفة Xamarin.Essentials. لقد قدمنا أيضًا قائمة كاملة
بروابط API التي يمكنك عرضها على الإنترنت للتعرف على جميع تفاصيل Xamarin.Essentials APIs.