Udostępnij za pośrednictwem

Aktualizowanie istniejących aplikacji do ujednoliconego interfejsu API

  • Artykuł

Ważne

Klasyczny interfejs API platformy Xamarin, który poprzedzał ujednolicony interfejs API, został przestarzały.

  • Ostatnia wersja platformy Xamarin.iOS do obsługi klasycznego interfejsu API (monotouch.dll) to Xamarin.iOS 9.10.
  • Platforma Xamarin.Mac nadal obsługuje klasyczny interfejs API, ale nie jest już aktualizowany. Ponieważ jest przestarzała, deweloperzy powinni przenieść swoje aplikacje do ujednoliconego interfejsu API.

Jak zaktualizować aplikacje

Istnieją trzy kroki aktualizacji aplikacji:

  1. Napraw wszelkie ostrzeżenia kompilatora w istniejącym kodzie, szczególnie te dotyczące przestarzałych interfejsów API.

  2. Użyj wbudowanego narzędzia do migracji, aby Visual Studio dla komputerów Mac zaktualizować pliki projektu i przestrzenie nazw.

  3. Napraw pozostałe błędy kompilatora dotyczące nowych typów 64 i innych interfejsów API, które uległy zmianie. Zapoznaj się z tymi wskazówkami , aby uzyskać dodatkowe informacje na temat aktualizacji ręcznych, które mogą być wymagane.

Dla każdego produktu dostępne są konkretne przewodniki ułatwiające aktualizowanie aplikacji do ujednoliconego interfejsu API i obsługi 64-bitowej:

Aplikacje platformy Xamarin.iOS

Istniejące aplikacje platformy Xamarin.iOS można zaktualizować do ujednoliconego interfejsu API przy użyciu narzędzia do automatycznej migracji wbudowanego w Visual Studio dla komputerów Mac. Następnie mogą być wymagane pewne dodatkowe poprawki, jak wyjaśniono w tych instrukcjach i wskazówkach.

Aplikacje platformy Xamarin.Mac

Istniejące aplikacje platformy Xamarin.Mac można zaktualizować do ujednoliconego interfejsu API przy użyciu narzędzia do automatycznej migracji wbudowanego w Visual Studio dla komputerów Mac. Następnie mogą być wymagane pewne dodatkowe poprawki, jak wyjaśniono w tych instrukcjach i wskazówkach.

Aplikacje platformy Xamarin.Forms

Postępuj zgodnie z tymi instrukcjami, aby zaktualizować istniejące rozwiązanie platformy Xamarin.Forms przy użyciu projektu systemu iOS w celu korzystania z ujednoliconego interfejsu API. Obsługa ujednoliconego interfejsu API jest dostępna tylko w programie Xamarin.Forms 1.3 lub nowszym, dlatego instrukcje wyjaśniają również sposób aktualizowania aplikacji Xamarin.Forms do wersji 1.3. Te porady mogą pomóc w aktualizowaniu dowolnego natywnego kodu systemu iOS w niestandardowych programach renderujących lub usługach zależności.

Praca z typami natywnymi w aplikacjach międzyplatformowych

W tym artykule omówiono używanie nowych typów natywnych interfejsu API ujednoliconego interfejsu API systemu iOS (nint, nuint, nfloat) w aplikacji międzyplatformowej, w której kod jest udostępniany urządzeniom innym niż iOS, takim jak systemy operacyjne Android lub Windows Telefon. Zapewnia wgląd w to, kiedy należy używać typów natywnych i udostępnia kilka możliwych rozwiązań, w których nowy typ musi być używany z kodem międzyplatformowym.

Aktualizowanie powiązań do ujednoliconego interfejsu API

Klienci, którzy utworzyli powiązania z Objective-C bibliotekami, będą musieli zaktualizować projekt powiązania w celu odzwierciedlenia zmian w bazowym interfejsie API (gdzie niektóre typy będą teraz 64-bitowe). Postępuj zgodnie z tymi instrukcjami, aby zaktualizować istniejący projekt powiązania w celu obsługi ujednoliconego interfejsu API.