Sdílet prostřednictvím

AndroidX s Xamarinem

  • Článek

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 pro Android 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 nyní mají konzistentní obor názvů začínající .androidx To znamená, že všechny balíčky knihovny podpory Androidu se mapují na odpovídající androidx.* balíček.
  • androidx balíčky se spravují a aktualizují samostatně. To znamená, že můžete aktualizovat knihovny AndroidX nezávisle na sobě.
  • Od verze 28 knihovny podpory pro Android nebudou k dispozici žádné další verze. Místo toho bude součástí androidx veškerého vývoje.

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 – Ve Windows update na Visual Studio 2019 verze 16.4 nebo novější V macOS aktualizujte na Visual Studio 2019 pro Mac verze 8.4 nebo novější.
  • Xamarin.Android – Xamarin.Android 10.0 nebo novější se musí nainstalovat se sadou Visual Studio (Xamarin.Android se automaticky nainstaluje jako součást úlohy Vývoj mobilních aplikací s .NET ve Windows a instaluje se 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 Sady OpenJDK od Microsoftu se automaticky nainstaluje jako součást sady 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 tak, že do projektu Androidu zahrnete jakýkoli balíček NuGet AndroidX. Další informace o instalaci a používání balíčku v sadě 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 pro Android vytvořené pomocí knihovny podpory Pro Android.

Změna názvu balíčku

Názvy balíčků se mezi starými a novými balíčky změnily. 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 nástroje Migrate to AndroidX IDE a postarat se o většinu scénářů oborů názvů.

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

Enable AndroidX Migrator

Klikněte pravým tlačítkem na projekt a migrujte na AndroidX.

Migrate To AndroidX

Poznámka:

V případě scénářů, které nástroj nepokrývá, budete muset provést některé ruční změny oboru názvů. 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 v současnosti používat knihovny AndroidX na NuGetu.

Řešení problému

  • 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.

Shrnutí

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 pomocí AndroidX. Poskytuje přehled toho, co je AndroidX. Obsahuje 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. Zvýraznila také 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.