Xamarin.Forms
vice Release 17
สนับสนุน Xamarin.Forms สิ้นสุดใน วันที่ 1 พฤษภาคม 2024 ตามนโยบายการสนับสนุน Xamarin:
การสนับสนุน Xamarin สิ้นสุดลงในวันที่ 1 พฤษภาคม 2024 สำหรับ Xamarin SDK ทั้งหมดรวมถึง Xamarin.Forms
Xamarin.Forms ประสบความสำเร็จโดย. NET MAUI ในเดือนพฤษภาคม 2565 ซึ่งเป็นส่วนหนึ่งของ. NET 6 และปัจจุบันได้รับการสนับสนุนตามที่อธิบายไว้ในนโยบายการสนับสนุน. NET MAUI ทำตามคำแนะนำการอัพเกรดอย่างเป็นทางการเพื่อนำแอปพลิเคชัน Xamarin ของคุณไปยัง. NET เวอร์ชันล่าสุด
สำหรับนักพัฒนาและผู้สนับสนุนทุกคนของเราขอบคุณมากที่ได้เป็นส่วนหนึ่งของชุมชนซามารินของเรา เราจะพบกันทั้งหมดใน. Net Maui!
Xamarin.Forms ให้วิธีการสร้างแอพดั้งเดิมสำหรับ iOS, Android, Windows และ MacOS อย่างรวดเร็วใน C#
อ่านเพิ่มเติมเกี่ยวกับแพลตฟอร์มที่ https://www.xamarin.com/forms
| แพลตฟอร์ม/คุณสมบัติ | ชื่อแพ็คเกจ | มั่นคง | มีการปล่อยตัว | ให้อาหาร Azure ทุกคืน (สาขาหลัก) |
|---|---|---|---|---|
| แกนกลาง | Xamarin.Forms | |||
| applinks | Xamarin.Forms.AppLinks | |||
| แผนที่ | Xamarin.Forms.Maps | |||
| maps.gtk | Xamarin.Forms.Maps.GTK | |||
| maps.wpf | Xamarin.Forms.Maps.WPF | |||
| หน้า | Xamarin.Forms.Pages | |||
| หน้า | Xamarin.Forms.Pages.Azure | |||
| platform.gtk | Xamarin.Forms.Platform.GTK | |||
| platform.wpf | Xamarin.Forms.Platform.WPF | |||
| Visual.aterial | 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 นี้เพื่อให้การสร้างประสบความสำเร็จ ดูหน้าเอกสารนี้เพื่อค้นหาวิธีการ
VS 2019+ เป็นสิ่งจำเป็นสำหรับการพัฒนา xamarin.forms หากคุณยังไม่ได้ติดตั้งคุณสามารถดาวน์โหลดได้ที่นี่ VS 2019+ ชุมชนฟรีอย่างสมบูรณ์ หากคุณกำลังติดตั้ง VS 2019+ เป็นครั้งแรกให้เลือกประเภทการติดตั้ง "กำหนดเอง" และเลือกรายการต่อไปนี้จากรายการคุณสมบัติที่จะติดตั้ง:
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 packIndividual 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)Individual Components > Development Activities > Xamarin Remoted SimulatorIndividual Components > Emulators > Hyper-V Intel Hardware Accelerated Execution Manager (HAXM)Android 10.0 API 29 SDK และ Android 9.0 API 28 SDK เป็นสิ่งจำเป็นสำหรับการพัฒนา Xamarin.Forms สามารถติดตั้งได้โดยใช้ Xamarin Android SDK Manager
นอกจากนี้เรายังแนะนำให้ติดตั้งตัวจัดการอุปกรณ์ Xamarin Android สิ่งนี้จะใช้เครื่องมือ HAXM ที่ติดตั้งไว้ด้านบนและอนุญาตให้คุณกำหนดค่าอุปกรณ์เสมือน Android (AVDS) ที่เลียนแบบอุปกรณ์ Android หากคุณติดตั้ง VS 2019+ แล้วคุณสามารถตรวจสอบได้ว่าคุณสมบัติเหล่านี้ติดตั้งโดยการปรับเปลี่ยนการติดตั้ง VS 2019+ ผ่านตัวติดตั้ง Visual Studio
หากคุณได้รับข้อผิดพลาดเกี่ยวกับ SDK ที่ขาดหายไปคุณสามารถเรียกใช้สคริปต์การจัดเตรียมของเราได้ โปรดทราบว่าอาจใช้เวลาพอสมควรในการเรียกใช้สคริปต์ทั้งหมด เพื่อให้เข้าใจได้ดีขึ้นว่าสคริปต์ทำงานได้อย่างไรอย่าลังเลที่จะตรวจสอบไฟล์ 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 คุณจะต้องสร้าง/กู้คืนโครงการบางโครงการด้วยตนเองก่อนที่คุณจะสามารถทำงานในโซลูชัน Xamarin Forms
นี่คือตัวเลือกที่แตกต่างกันเล็กน้อยที่เราได้รวบรวมไว้เพื่อช่วยให้กระบวนการนี้ง่ายขึ้น
สาขา 3.5+ มาพร้อมกับเป้าหมายสคริปต์เค้กที่คุณสามารถใช้ในการสร้างและเปิด VSMAC
./build.sh --target vsmacหรือดังที่ได้กล่าวไว้ข้างต้นในส่วน Windows เกี่ยวกับการจัดเตรียมคุณยังสามารถใช้เค้กใหม่ Tool
dotnet tool install Cake.Tool -g
dotnet cake --target=provision
เมื่อทำงานกับสาขาก่อนหน้านี้ที่ไม่มีสคริปต์เค้กคุณสามารถใช้สคริปต์ build.sh ต่อไปนี้
หากคุณไม่ต้องการเรียกใช้สคริปต์ใด ๆ :
msbuild Xamarin.Forms.Build.Tasks/Xamarin.Forms.Build.Tasks.csprojXamarin.Forms.Build.Tasks.csproj เมื่อเปิดโซลูชัน Xamarin.Forms คุณจะพบว่ามีข้อผิดพลาดและคำเตือนจำนวนหนึ่งภายใต้บานหน้าต่างรายการข้อผิดพลาด คุณสามารถแก้ไขปัญหานี้ได้โดยการเปลี่ยนตัวกรองของ Build + IntelliSense เพื่อ Build Only ณ จุดนี้คุณควรจะสามารถสร้างโซลูชันได้สำเร็จ
โดยค่าเริ่มต้นโครงการ Xamarin.Forms.Controls ไม่มีการกำหนดค่าสำหรับคีย์ API ต่างๆเพื่อเข้าถึงคุณสมบัติบางอย่างในแต่ละแพลตฟอร์ม (เช่นแผนที่) เมื่อสร้างโซลูชันเป็นครั้งแรกไฟล์ controlgallery.config จะถูกสร้างขึ้นภายในโครงการนั้นซึ่งมีลักษณะเช่นนี้:
UWPMapsAuthKey:
หากคุณไม่ได้ทำงานกับแผนที่คุณสามารถเพิกเฉยต่อสิ่งนี้ได้ หากคุณต้องการทำงานกับแผนที่คุณจะต้องได้รับปุ่ม API ของคุณเองสำหรับแต่ละบริการเหล่านี้แทรกโดยตรงหลังจากตัวระบุ (เช่น UWPMapsAuthKey:abcdefghijklmnopqrstuvwxyz ) คุณสามารถค้นหาวิธีการรับสิ่งเหล่านี้ได้ดังนี้:
UWPMapsAuthKey ที่ https://microsoft.com/maps/create-a-bing-maps-key.aspx เนื่องจากวิธีการทำงานของ Android คีย์แผนที่ API จึงไม่สามารถฉีดได้ที่รันไทม์ ดังนั้นคุณจะต้องเพิ่มคีย์นี้ลงในไฟล์ MapsKey.cs ภายใต้ Xamarin.Forms.ControlGallery.Android/Properties :
[assembly: Android.App.MetaData("com.google.android.maps.v2.API_KEY", Value = "INSERT_KEY_HERE")]
คุณสามารถค้นหาวิธีรับคีย์ Google Maps API ได้ที่นี่
ตรวจสอบให้แน่ใจว่าคุณมี nuget.exe 4.0 หรือสูงกว่าและ. NET Core SDK ล่าสุด บน MacOS คุณควรระบุแพลตฟอร์มในคำสั่ง msbuild ( /p:Platform=iPhoneSimulator )
msbuild /restore Xamarin.Forms.sln
ขึ้นอยู่กับการตั้งค่าสภาพแวดล้อมของคุณคุณอาจต้องกำหนดค่าบางอย่างก่อนที่จะสามารถแก้ไขปัญหา / เรียกใช้การทดสอบ UI โดยเฉพาะบน Windows
Xamarin.Forms.ControlGallery.Android วิธีที่ง่ายที่สุดในการทำเช่นนี้คือคลิกขวาที่โครงการและเลือก "ปรับใช้" โปรดทราบว่าหากคุณสร้างโซลูชันใหม่คุณอาจสูญเสีย APK และจะต้องสร้างอีกครั้งหลังจากขั้นตอนเหล่านี้ได้รับการดูแลคุณควรจะไปได้ดี คุณสามารถดูการทดสอบ UI ทั้งหมดใน Test Explorer ค้นหาเพื่อความสะดวกของคุณเองและทำการทดสอบแต่ละครั้งอย่างรวดเร็ว
เพื่อเรียกใช้การทดสอบ UWP UI:
Xamarin.Forms.ControlGallery.WindowsUniversal เพื่อติดตั้งแอปพลิเคชัน ControlGallery ลงในระบบของคุณตอนนี้คุณควรจะสามารถทำการทดสอบ UWP UI ใด ๆ
เราทำตามสไตล์ที่ใช้โดย. NET Foundation โดยมีข้อยกเว้นบางประการ:
private เนื่องจากเป็นระดับการเข้าถึงเริ่มต้นใน C#Tools > Options และการนำทางไปยัง Text Editor > C# และเลือกตัวเลือกวิทยุ "Keep Tabs" ใน Visual Studio สำหรับ Mac ตั้งค่าผ่านการตั้งค่าใน Source Code > Code Formatting > C# source code และปิดการใช้งานช่องทำเครื่องหมายสำหรับ Convert tabs to spacesSource Code > Code Formatting > C# source code และการเปลี่ยน Desired file width เป็น 120 เราใช้ปัญหา GitHub เพื่อติดตามปัญหา หากเป็นไปได้โปรดส่งการทำซ้ำข้อผิดพลาดของคุณพร้อมกับรายงานข้อผิดพลาดของคุณ
