AndroidX z platformą Xamarin

  • Artykuł

Jak rozpocząć tworzenie aplikacji z systemem AndroidX przy użyciu platformy Xamarin.Android.

AndroidX to poważna poprawa oryginalnej biblioteki obsługi systemu Android, która nie jest już utrzymywana. Pakiety AndroidX w pełni zastępują bibliotekę pomocy technicznej systemu Android, zapewniając parzystość funkcji i nowe biblioteki, których można używać w aplikacjach systemu Android.

System AndroidX obejmuje następujące funkcje:

  • Wszystkie pakiety w systemie AndroidX mają teraz spójną przestrzeń nazw rozpoczynającą się od androidx. Oznacza to, że wszystkie pakiety biblioteki obsługi systemu Android są mapowania na odpowiedni androidx.* pakiet.
  • androidx pakiety są obsługiwane i aktualizowane oddzielnie. Oznacza to, że biblioteki AndroidX można aktualizować niezależnie od siebie.
  • Od wersji 28 biblioteki pomocy technicznej systemu Android nie będzie więcej wersji. Zamiast tego zostanie uwzględniony androidx cały rozwój.

AndroidX Logo

Wymagania

Poniższa lista jest wymagana do korzystania z funkcji AndroidX w aplikacjach opartych na platformie Xamarin:

  • Visual Studio — w aktualizacji systemu Windows do programu Visual Studio 2019 w wersji 16.4 lub nowszej. W systemie macOS zaktualizuj program Visual Studio 2019 dla komputerów Mac w wersji 8.4 lub nowszej.
  • Xamarin.Android — program Xamarin.Android 10.0 lub nowszy musi być zainstalowany w programie Visual Studio (program Xamarin.Android jest instalowany automatycznie w ramach obciążenia Programowanie mobilne za pomocą platformy .NET w systemie Windows i instalowany w ramach Instalatora Visual Studio dla komputerów Mac)
  • Zestaw Java Developer Kit — programowanie zestawu Xamarin.Android 10.0 wymaga zestawu JDK 8. Dystrybucja zestawu OpenJDK firmy Microsoft jest instalowana automatycznie w ramach programu Visual Studio.
  • Zestaw Android SDK — interfejs API zestawu Android SDK w wersji 28 lub nowszej musi być zainstalowany za pośrednictwem menedżera zestawu Android SDK.

Rozpocznij

Możesz rozpocząć pracę z systemem AndroidX, dołączając dowolny pakiet NuGet AndroidX w projekcie systemu Android. Dowiedz się więcej o instalowaniu i używaniu pakietu w programie Visual Studio lub Visual Studio dla komputerów Mac

Zmiany zachowania

Ponieważ AndroidX to przeprojektowana biblioteka obsługi systemu Android, obejmuje kroki migracji, które będą mieć wpływ na aplikacje systemu Android utworzone za pomocą biblioteki obsługi systemu Android.

Zmiana nazwy pakietu

Nazwy pakietów zostały zmienione między starymi i nowymi pakietami. Poniżej przedstawiono przykład tych zmian:

Stary Nowe
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. @

Aby uzyskać więcej informacji na temat nazewnictwa pakietów, zobacz poniższą dokumentację.

Narzędzia migracji

Istnieją trzy kroki migracji, które należy wziąć pod uwagę w przypadku aplikacji.

  1. Jeśli aplikacja zawiera przestrzenie nazw biblioteki obsługi systemu Android i chcesz je migrować do przestrzeni nazw AndroidX, możesz użyć narzędzia Migrate to AndroidX IDE, aby dbać o większość scenariuszy przestrzeni nazw.

Włącz narzędzie AndroidX Migrator za pomocą opcji > narzędzi > Xamarin > Android Ustawienia w programie Visual Studio 2019 (możesz pominąć ten krok w Visual Studio dla komputerów Mac).

Enable AndroidX Migrator

Kliknij prawym przyciskiem myszy projekt i migruj do systemu AndroidX.

Migrate To AndroidX

Uwaga

Należy wprowadzić pewne ręczne zmiany przestrzeni nazw w scenariuszach, których narzędzie nie obejmuje. Chociaż zamapujemy odpowiedni pakiet, zachęcamy do zapoznania się z oficjalnymi mapowaniami artefaktów i mapowaniami klas, aby ułatwić migrację projektu.

  1. Jeśli aplikacja zawiera jakiekolwiek zależności, które nie zostały zmigrowane do przestrzeni nazw AndroidX, musisz użyć biblioteki pomocy technicznej systemu Android do pakietu AndroidX Migration.
  2. Jeśli aplikacja nie zawiera żadnych zależności, które wymagają migracji przestrzeni nazw AndroidX, możesz używać bibliotek AndroidX w systemie NuGet dzisiaj.

Rozwiązywanie problemów

  • Niektóre pakiety architektury w systemie AndroidX będą powodować konflikt z wersjami biblioteki pomocy technicznej. Aby rozwiązać ten problem, należy użyć wersji androidX tych pakietów i usunąć wersję biblioteki pomocy technicznej. Jeśli na przykład odwołujesz się Xamarin.Android.Arch.Work.Runtime do projektu, spowoduje to konflikt z typami nowo dodanego AndroidX.Work pakietu.

Podsumowanie

W tym artykule przedstawiono system AndroidX i wyjaśniono, jak zainstalować i skonfigurować najnowsze narzędzia i pakiety na potrzeby programowania na platformie Xamarin.Android za pomocą systemu AndroidX. Zawiera omówienie tego, czym jest AndroidX. Zawiera on linki do dokumentacji interfejsu API i tematów dla deweloperów systemu Android, które ułatwiają rozpoczęcie tworzenia aplikacji przy użyciu systemu AndroidX. Wyróżniono również najważniejsze zmiany zachowania androidX i tematy rozwiązywania problemów, które mogą mieć wpływ na istniejące aplikacje.