Xamarin.Forms Download - Xamarin.Forms Download Code Download

Xamarin.Forms

شفرة المصدر الأخرى

vice Release 17

تنزيل

xamarin.forms

يدعم

انتهى دعم Xamarin.forms في 1 مايو 2024 وفقًا لسياسة دعم Xamarin:

انتهى دعم Xamarin في 1 مايو 2024 لجميع SDKs Xamarin بما في ذلك Xamarin.forms.

نجحت Xamarin.forms من قبل .NET Maui في مايو 2022 كجزء من .NET 6 ، ويتم دعمه حاليًا كما هو موضح في سياسة دعم .NET MAUI. اتبع إرشادات الترقية الرسمية لتقديم تطبيقات Xamarin إلى أحدث إصدار من .NET.

لجميع مطورينا والمساهمين ، شكرًا جزيلاً لكونك جزءًا من مجتمع Xamarin. سنراك في كل مكان في .NET MAUI!

حول xamarin.forms

يوفر Xamarin.Forms طريقة لبناء التطبيقات الأصلية بسرعة لنظام التشغيل iOS و Android و Windows و MacOS ، تمامًا في C#.

اقرأ المزيد عن النظام الأساسي على https://www.xamarin.com/forms.

حزم

منصة/ميزة	اسم الحزمة	مستقر	Prelease	الأعلاف الليلية Azure (الفرع الرئيسي)
جوهر	`Xamarin.Forms`
Applinks	`Xamarin.Forms.AppLinks`
خرائط	`Xamarin.Forms.Maps`
خرائط	`Xamarin.Forms.Maps.GTK`
خرائط	`Xamarin.Forms.Maps.WPF`
الصفحات	`Xamarin.Forms.Pages`
الصفحات	`Xamarin.Forms.Pages.Azure`
platform.gtk	`Xamarin.Forms.Platform.GTK`
platform.wpf	`Xamarin.Forms.Platform.WPF`
Visual.Material	`Xamarin.Forms.Visual.Material`

إذا كنت ترغب في استخدام أحدث بناء DEV ، فيجب عليك قراءة منشور المدونة هذا:

أضف الخلاصة الليلية إلى مصادر nuget الخاصة بك أو أضف nuget.config إلى تطبيقك (وضعه في نفس الدليل حيث يكون ملف الحل الخاص بك) مع المحتوى التالي:
```
<? xml version = " 1.0 " encoding = " utf-8 " ?>
< configuration >
  < packageSources >
    < clear />
    < add key = " xamarin-ci " value = " https://aka.ms/xf-nightly/index.json " />
    < add key = " NuGet.org " value = " https://api.nuget.org/v3/index.json " />
  </ packageSources >
</ configuration >
```
ملاحظة: يجب أن يكون هذا nuget.config مع تطبيقك إلا إذا كنت تريد أن تبدأ الحزم الليلية في استعادة تطبيقات أخرى على الجهاز.
قم بتغيير تبعيات طلبك للحصول على * للحصول على أحدث إصدار.

ابدء

لكلا الطريقتين تحتها ، سيتعين عليك إضافة خلاصة Nuget حتى تنجح البناء. انظر صفحة الوثائق هذه لمعرفة كيف.

النوافذ

تثبيت Visual Studio 2019+

VS 2019+ مطلوب لتطوير xamarin.forms. إذا لم تكن قد تم تثبيتها بالفعل ، فيمكنك تنزيله هنا. VS 2019+ المجتمع مجاني تمامًا. إذا كنت تقوم بتثبيت VS 2019+ لأول مرة ، فحدد نوع التثبيت "المخصص" وحدد ما يلي من قائمة الميزات لتثبيت:

.NET Desktop Development
- Individual Components > .NET > .NET Framework 4.6.1 SDK, .NET Framework 4.6.1 targeting pack, .NET Framework 4.7.2 SDK, .NET Framework 4.7.2 targeting pack .
تطوير منصة Windows العالمية
- Individual Components > SDKs, libraries, and frameworks > Windows 10 SDK (10.0.19041.0), Windows 10 SDK (10.0.18362.0), Windows 10 SDK (10.0.16299.0) .
- تنزيل وتثبيت 14393 من https://go.microsoft.com/fwlink/p/؟linkid=838916
تطوير الهاتف المحمول مع .NET
- Individual Components > Development Activities > Xamarin Remoted Simulator
- إذا كنت لا تستخدم Individual Components > Emulators > Hyper-V Intel Hardware Accelerated Execution Manager (HAXM)
معظم إصدار SDK الحالي من .NET Core
- أو تثبيت أحدث .NET Core SDK من هنا https://dotnet.microsoft.com/download

إن Android 10.0 API 29 SDK و Android 9.0 API 28 SDK مطلوب لتطوير xamarin.forms. يمكن تثبيتها باستخدام مدير Xamarin Android SDK.

نوصي أيضًا بتثبيت Xamarin Android Device Manager. سيستخدم ذلك أدوات HAXM المثبتة أعلاه ويسمح لك بتكوين أجهزة Android الظاهرية (AVDs) التي تحاكي أجهزة Android. إذا قمت بالفعل بتثبيت VS 2019+ ، فيمكنك التحقق من أن هذه الميزات مثبتة عن طريق تعديل تثبيت VS 2019+ عبر Visual Studio Installer.

توفير السيناريو

إذا كنت تحصل على أخطاء حول SDKs المفقودة ، فيمكنك تشغيل البرنامج النصي المتقدم. لاحظ أنه قد يستغرق الأمر بعض الوقت لتشغيل البرنامج النصي بأكمله. لفهم أفضل كيفية عمل البرنامج النصي ، لا تتردد في التحقق من ملف build.cake الخاص بنا.

على CMD
```
 build.cmd -Target provision
```
على PowerShell
```
 ./build.ps1 -Target provision
```
ملاحظة: إذا واجهت خطأً في قول Build.PS1 لم يتم توقيعه رقميًا ، فمن المفتوح PowerShell كمسؤول وحل عن طريق تشغيل Set-ExecutionPolicy RemoteSigned أولاً.
على CMD/PowerShell/sh (جديد! مزيد من المعلومات هنا)
```
 dotnet tool install Cake.Tool -g
dotnet cake --target=provision
```

ماك

تثبيت Visual Studio لنظام التشغيل Mac 2019

إذا لم تكن قد تم تثبيتها بالفعل ، فيمكن العثور على تعليمات للتنزيل والإعداد هنا.

بسبب القيود المتعددة المستهدفة الحالية مع Visual Studio لنظام التشغيل Mac ، ستحتاج إلى إنشاء/استعادة بعض المشاريع يدويًا قبل أن تتمكن من العمل على حل نماذج Xamarin.

فيما يلي بعض الخيارات المختلفة التي قمنا بتجميعها للمساعدة في تسهيل هذه العملية

الفروع 3.5+ تأتي مع هدف نص Cake الذي يمكنك استخدامه للبناء وفتح VSMAC
```
./build.sh --target vsmac
```
أو كما ذكر أعلاه في قسم Windows حول التزويد ، يمكنك أيضًا استخدام الكعكة الجديدة
```
 dotnet tool install Cake.Tool -g
dotnet cake --target=provision
```
عند العمل على فرع سابق لا يحتوي على نصوص الكيك ، يمكنك استخدام برنامج Build.sh التالي
إذا كنت لا تريد تشغيل أي نصوص:
- افتح xamarin.forms.sln
- انتظر VSMAC لإنهاء استعادة جميع المشاريع
- من تشغيل سطر الأوامر:
  - msbuild Xamarin.Forms.Build.Tasks/Xamarin.Forms.Build.Tasks.csproj
- الآن يجب أن تكون قادرًا على تشغيل ونشر كل شيء. السبب الوحيد الذي ستحتاج إليه في القيام بهذه العملية مرة أخرى هو إذا قمت بتنظيف مجلد الحل أو حذف مجلدات Bin/OBJ التي تعد جزءًا من Xamarin.Forms.Build.Tasks.csproj

تكوين الحل

عند فتح حل Xamarin.forms ، ستجد أن هناك عددًا من الأخطاء والتحذيرات ضمن جزء قائمة الأخطاء ؛ يمكنك حل هذا عن طريق تغيير مرشح Build + IntelliSense Build Only . في هذه المرحلة ، يجب أن تكون قادرًا على بناء الحل بنجاح.

بشكل افتراضي ، لا يحتوي مشروع Xamarin.Forms.Controls على تكوين لمختلف مفاتيح API للوصول إلى ميزات معينة على كل منصة (مثل الخرائط). عند إنشاء الحل لأول مرة ، سيتم إنشاء ملف controlgallery.config داخل هذا المشروع ، والذي يبدو مثل هذا:

 UWPMapsAuthKey:

إذا كنت لا تعمل مع الخرائط ، فيمكنك تجاهل هذا. إذا كنت ترغب في العمل مع الخرائط ، فسيتعين عليك الحصول على مفاتيح واجهة برمجة التطبيقات الخاصة بك لكل من هذه الخدمات ، يتم إدراجها مباشرة بعد المعرف (على سبيل المثال UWPMapsAuthKey:abcdefghijklmnopqrstuvwxyz ). يمكنك معرفة كيفية الحصول على كل من هذه على النحو التالي:

UWPMapsAuthKey على https://microsoft.com/maps/create-a-bing-maps-key.aspx

نظرًا للطريقة التي يعمل بها Android ، لا يمكن حقن مفتاح API Maps في وقت التشغيل. نتيجة لذلك ، سيتعين عليك إضافة هذا المفتاح إلى ملف MapsKey.cs ضمن Xamarin.Forms.ControlGallery.Android/Properties :

 [assembly: Android.App.MetaData("com.google.android.maps.v2.API_KEY", Value = "INSERT_KEY_HERE")]

يمكنك معرفة كيفية الحصول على مفتاح API لـ Google Maps هنا.

بناء من سطر الأوامر

تأكد من أن لديك nuget.exe 4.0 أو أعلى وأحدث .NET Core SDK. على MacOS ، يجب عليك تحديد النظام الأساسي في أمر MSBuild ( /p:Platform=iPhoneSimulator )

 msbuild /restore Xamarin.Forms.sln

اختبارات واجهة المستخدم

قم بتشغيل اختبارات واجهة مستخدم Android

بناءً على إعداد البيئة الخاص بك ، قد تحتاج إلى تكوين بعض الأشياء قبل أن تتمكن من تصحيح / تشغيل اختبارات واجهة المستخدم ، وخاصة على Windows.

إذا تلقيت خطأً حول Android_Home ، فيرجى التأكد من تعيين متغير البيئة الخاص بك على دليل Android SDK (على سبيل المثال C: Program Files (x86) Android Android-SDK).
إذا تلقيت خطأً حول Java_home ، فيرجى تثبيت أحدث Java JDK وتعيين متغير البيئة الخاص بك على دليل JDK (على سبيل المثال C: Program Files Java JDK-13).
إذا تلقيت خطأً حول Apkfile المفقودة ، فيرجى إنشاء ملف APK لـ Xamarin.Forms.ControlGallery.Android . أسهل طريقة للقيام بذلك هي النقر بزر الماوس الأيمن على المشروع وتحديد "نشر". لاحظ أنه إذا قمت بإعادة بناء الحل ، فقد تفقد APK وستحتاج إلى إنشاءه مرة أخرى.

بعد الاهتمام بهذه الخطوات ، يجب أن تكون على ما يرام. يمكنك رؤية جميع اختبارات واجهة المستخدم في اختبار Explorer ، والبحث عنها عن راحتك الخاصة ، وتشغيل الاختبارات الفردية بسرعة.

قم بتشغيل اختبارات UWP UI

لتشغيل اختبارات UWP UI:

تثبيت وتشغيل برنامج تشغيل تطبيق Windows.
قم بتشغيل مشروع Xamarin.Forms.ControlGallery.WindowsUniversal لتثبيت تطبيق ControlGallery على نظامك.

يجب أن تكون قادرًا الآن على تشغيل أي من اختبارات UWP UI.

نمط الترميز

نتبع الأسلوب الذي تستخدمه مؤسسة .NET ، مع استثناءات قليلة:

نحن لا نستخدم الكلمة الرئيسية private لأن مستوى إمكانية الوصول الافتراضي في C#.
نستخدم علامات التبويب الصلبة على المساحات. يمكنك تغيير هذا الإعداد في Visual Studio لنظام التشغيل Windows عبر Tools > Options والتنقل إلى Text Editor > C# وتحديد خيار راديو "Keep Tabs". في Visual Studio لـ Mac ، تم تعيينه عبر التفضيلات في Source Code > Code Formatting > C# source code وتعطيل مربع الاختيار Convert tabs to spaces .
يجب أن تقتصر الخطوط على أقصى قدر من 120 حرفًا (أو أقرب ما يمكن في حدود العقل). قد يتم تعيين هذا في Visual Studio لنظام التشغيل Mac عبر التفضيلات في Source Code > Code Formatting > C# source code وتغيير Desired file width إلى 120 .