AndroidX s Xamarinem

Jak začít s vývojem aplikací s AndroidX pomocí Xamarin.Androidu

AndroidX je hlavním vylepšením původní knihovny podpory Androidu, která se už neudržuje. Balíčky AndroidX plně nahrazují knihovnu podpory Androidu tím, že poskytují paritu funkcí a nové knihovny, které můžete použít ve svých aplikacích pro Android.

AndroidX obsahuje následující funkce:

  • Všechny balíčky v AndroidX teď mají konzistentní obor názvů počínaje androidx. To znamená, že všechny balíčky knihovny podpory Androidu se mapují na odpovídající androidx.* balíček.
  • androidx balíčky jsou samostatně udržovány a aktualizovány. To znamená, že můžete aktualizovat knihovny AndroidX nezávisle na sobě.
  • Od verze 28 podpory Androidu nebudou k dispozici žádné další verze. Místo toho bude zahrnut androidx veškerý vývoj.

AndroidX Logo

Požadavky

K používání funkcí AndroidX v aplikacích založených na Xamarinu se vyžaduje následující seznam:

  • Visual Studio – Při aktualizaci Windows na Visual Studio 2019 verze 16.4 nebo novější. V systému macOS aktualizujte na Visual Studio 2019 pro Mac verze 8.4 nebo novější.
  • Xamarin.Android – Xamarin.Android 10.0 nebo novější musí být nainstalován s Visual Studio (Xamarin.Android se automaticky nainstaluje jako součást úlohy Vývoje mobilních aplikací s využitím .NET v Windows a nainstalované jako součást instalačního programu Visual Studio pro Mac)
  • Sada Java Developer Kit – Vývoj pro Xamarin.Android 10.0 vyžaduje sadu JDK 8. Distribuce OpenJDK od Microsoftu se automaticky nainstaluje jako součást Visual Studio.
  • Android SDK – Rozhraní API sady Android SDK 28 nebo vyšší musí být nainstalované přes Správce sady Android SDK.

Začínáme

S AndroidX můžete začít zahrnutím libovolného balíčku AndroidX NuGet uvnitř projektu Android. Další informace o instalaci a používání balíčku v Visual Studio nebo Visual Studio pro Mac

Změny chování

Vzhledem k tomu, že AndroidX je přepracovaná knihovna podpory Androidu, zahrnuje kroky migrace, které ovlivní aplikace androidu vytvořené pomocí knihovny podpory Androidu.

Změna názvu balíčku

Názvy balíčků se změnily mezi starými a novými balíčky. Níže vidíte příklad těchto změn:

Staré Nová
android.support.** androidx. @
android.design.** com.google.android.material. @
android.support.test.** androidx.test. @
android.arch.** androidx. @
android.arch.persistence.room.** androidx.room. @
android.arch.persistence.** androidx.sqlite. @

Další podrobnosti o pojmenování balíčků najdete v následující dokumentaci.

Nástroje pro migraci

Existují tři kroky migrace, o které budete chtít vědět pro vaši aplikaci.

  1. Pokud vaše aplikace obsahuje obory názvů knihovny podpory Androidu a chcete je migrovat do oborů názvů AndroidX, můžete použít naše nástroje Migrovat do integrovaného vývojového prostředí AndroidX a postarat se o většinu scénářů oboru názvů.

Povolte AndroidX Migrator prostřednictvím nástrojů > Xamarin >> Android Nastavení uvnitř Visual Studio 2019 (tento krok můžete přeskočit na Visual Studio pro Mac).

Enable AndroidX Migrator

Klikněte pravým tlačítkem myši na projekt a přejděte na AndroidX.

Migrate To AndroidX

Poznámka

Budete muset provést některé ruční změny oboru názvů pro scénáře, které nástroj nepokrývá. I když pro vás namapujeme správný balíček, doporučujeme se podívat na oficiální mapování artefaktů a mapování tříd , které vám pomůžou s migrací projektu.

  1. Pokud vaše aplikace obsahuje všechny závislosti, které nebyly migrovány do oboru názvů AndroidX, budete muset použít knihovnu podpory Androidu do balíčku pro migraci AndroidX.
  2. Pokud vaše aplikace neobsahuje žádné závislosti, které vyžadují migraci oboru názvů AndroidX, můžete použít knihovny AndroidX na NuGet dnes.

Řešení potíží

  • Některé balíčky architektury v systému AndroidX budou v konfliktu s verzemi knihovny podpory. Pokud chcete tento problém vyřešit, měli byste použít verzi AndroidX těchto balíčků a odebrat verzi knihovny podpory. Pokud například odkazujete Xamarin.Android.Arch.Work.Runtime na projekt, bude v konfliktu s typy nově přidaného AndroidX.Work balíčku.

Souhrn

Tento článek představil AndroidX a vysvětlil, jak nainstalovat a nakonfigurovat nejnovější nástroje a balíčky pro vývoj pro Xamarin.Android s Androidem. Poskytuje přehled toho, co je AndroidX. Zahrnovala odkazy na dokumentaci k rozhraní API a témata pro vývojáře pro Android, která vám pomůžou začít vytvářet aplikace pomocí AndroidX. Také zvýraznil nejdůležitější změny chování AndroidX a témata pro řešení potíží, která by mohla mít vliv na existující aplikace.