Opis poziomów interfejsu API systemu Android

Artykuł
03/08/2024

Platforma Xamarin.Android ma kilka ustawień na poziomie interfejsu API systemu Android, które określają zgodność aplikacji z wieloma wersjami systemu Android. W tym przewodniku wyjaśniono, co oznaczają te ustawienia, jak je skonfigurować i jaki wpływ mają na aplikację w czasie wykonywania.

Szybki start

Platforma Xamarin.Android uwidacznia trzy ustawienia projektu na poziomie interfejsu API systemu Android:

Struktura docelowa — określa, która struktura ma być używana w tworzeniu aplikacji. Ten poziom interfejsu API jest używany w czasie kompilacji przez platformę Xamarin.Android.
Minimalna wersja systemu Android — określa najstarszą wersję systemu Android, którą aplikacja ma obsługiwać. Ten poziom interfejsu API jest używany w czasie wykonywania przez system Android.
Docelowa wersja systemu Android — określa wersję systemu Android, na którą aplikacja ma być uruchamiana. Ten poziom interfejsu API jest używany w czasie wykonywania przez system Android.

Przed skonfigurowaniem poziomu interfejsu API dla projektu należy zainstalować składniki platformy SDK dla tego poziomu interfejsu API. Aby uzyskać więcej informacji na temat pobierania i instalowania składników zestawu Android SDK, zobacz Konfiguracja zestawu Android SDK.

Uwaga

Począwszy od sierpnia 2021 r., konsola Google Play wymaga, aby nowe aplikacje docelowe interfejsu API poziomu 30 (Android 11.0) lub nowsze. Istniejące aplikacje są wymagane do określania poziomu interfejsu API na poziomie 30 lub wyższym od listopada 2021 r. Aby uzyskać więcej informacji, zobacz Wymagania dotyczące poziomu interfejsu API docelowego dla konsoli odtwarzania w temacie "Tworzenie i konfigurowanie aplikacji" w dokumentacji konsoli odtwarzania.

Program Visual Studio
Visual Studio dla komputerów Mac

Zwykle wszystkie trzy poziomy interfejsu API platformy Xamarin.Android są ustawione na tę samą wartość. Na stronie Aplikacja ustaw opcję Kompiluj przy użyciu wersji systemu Android (platforma docelowa) na najnowszą stabilną wersję interfejsu API (lub, co najmniej, na wersję systemu Android, która ma wszystkie potrzebne funkcje). Na poniższym zrzucie ekranu platforma docelowa jest ustawiona na Android 7.1 (POZIOM 25 interfejsu API — Nougat):

Na stronie Manifest systemu Android ustaw minimalną wersję systemu Android na wartość Kompiluj przy użyciu zestawu SDK i ustaw docelową wersję systemu Android na taką samą wartość jak wersja platformy docelowej (na poniższym zrzucie ekranu platforma Docelowa systemu Android jest ustawiona na Android 7.1 (Nougat)):

Jeśli chcesz zachować zgodność z poprzednimi wersjami systemu Android, ustaw minimalną wersję systemu Android na docelową najstarszą wersję systemu Android, która ma być obsługiwana przez aplikację. (Pamiętaj, że poziom 14 interfejsu API jest minimalnym poziomem interfejsu API wymaganym dla Usługi Google Play i obsługa firebase). Poniższa przykładowa konfiguracja obsługuje wersje systemu Android z poziomu 14 interfejsu API do poziomu 25 interfejsu API:

Jeśli aplikacja obsługuje wiele wersji systemu Android, kod musi zawierać testy środowiska uruchomieniowego, aby upewnić się, że aplikacja działa z ustawieniem Minimalna wersja systemu Android (zobacz Sprawdzanie środowiska uruchomieniowego dla wersji systemu Android poniżej, aby uzyskać szczegółowe informacje). Jeśli używasz lub tworzysz bibliotekę, zobacz Poziomy interfejsu API i biblioteki poniżej, aby uzyskać najlepsze rozwiązania dotyczące konfigurowania ustawień na poziomie interfejsu API dla bibliotek.

Wersje systemu Android i poziomy interfejsu API

W miarę rozwoju platformy android i wydawania nowych wersji systemu Android każda wersja systemu Android ma przypisany unikatowy identyfikator liczb całkowitych nazywany poziomem interfejsu API. W związku z tym każda wersja systemu Android odpowiada jednemu poziomowi interfejsu API systemu Android. Ponieważ użytkownicy instalują aplikacje w starszych wersjach systemu Android, a także najnowsze wersje systemu Android, rzeczywiste aplikacje systemu Android muszą być zaprojektowane tak, aby działały z wieloma poziomami interfejsu API systemu Android.

Wersje systemu Android

Każda wersja systemu Android ma wiele nazw:

Wersja systemu Android, taka jak Android 9.0
Nazwa kodu (lub deseru), taka jak Pie
Odpowiedni poziom interfejsu API, taki jak poziom 28 interfejsu API

Nazwa kodu systemu Android może odpowiadać wielu wersjach i poziomom interfejsu API (jak pokazano w poniższej tabeli), ale każda wersja systemu Android odpowiada dokładnie jednemu poziomowi interfejsu API.

Ponadto platforma Xamarin.Android definiuje kody wersji kompilacji mapujące na obecnie znane poziomy interfejsu API systemu Android. Poniższa tabela może ułatwić tłumaczenie między poziomem interfejsu API, wersją systemu Android, nazwą kodu i kodem wersji kompilacji platformy Xamarin.Android (kody wersji kompilacji są zdefiniowane w Android.OS przestrzeni nazw):

Nazwisko	Wersja	Poziom interfejsu API	Wydano	Kod wersji kompilacji
PYTANIA I ODPOWIEDZI	10,0	29	Sierpień 2020 r.	`BuildVersionCodes.Q`
Kołowy	9.0	28	Sie 2018	`BuildVersionCodes.P`
Oreo	8.1	27	Grudzień 2017 r.	`BuildVersionCodes.OMr1`
Oreo	8.0	26	Sierpień 2017 r.	`BuildVersionCodes.O`
Nugat	7.1	25	Grudzień 2016 r.	`BuildVersionCodes.NMr1`
Nugat	7.0	24	Sierpień 2016 r.	`BuildVersionCodes.N`
Zefir	6.0	23	Sierpień 2015 r.	`BuildVersionCodes.M`
Lollipop	5,1	22	Mar 2015	`BuildVersionCodes.LollipopMr1`
Lollipop	5,0	21	Nov 2014	`BuildVersionCodes.Lollipop`
Kitkat Watch	4.4W	20	Czerwiec 2014 r.	`BuildVersionCodes.KitKatWatch`
Kitkat	4.4	19	Październik 2013 r.	`BuildVersionCodes.KitKat`
Galaretka bean	4.3	18	Lipiec 2013	`BuildVersionCodes.JellyBeanMr2`
Galaretka bean	4.2-4.2.2	17	Listopad 2012 r.	`BuildVersionCodes.JellyBeanMr1`
Galaretka bean	4.1-4.1.1	16	Czerwiec 2012 r.	`BuildVersionCodes.JellyBean`
Kanapka z lodami	4.0.3-4.0.4	15	Grudzień 2011 r.	`BuildVersionCodes.IceCreamSandwichMr1`
Kanapka z lodami	4.0-4.0.2	14	Paź 2011	`BuildVersionCodes.IceCreamSandwich`
Plaster miodu	3.2	13	Czerwiec 2011 r.	`BuildVersionCodes.HoneyCombMr2`
Plaster miodu	3.1.x	12	Maj 2011 r.	`BuildVersionCodes.HoneyCombMr1`
Plaster miodu	3.0.x	11	Luty 2011 r.	`BuildVersionCodes.HoneyComb`
Piernik	2.3.3-2.3.4	10	Luty 2011 r.	`BuildVersionCodes.GingerBreadMr1`
Piernik	2.3-2.3.2	9	Listopad 2010 r.	`BuildVersionCodes.GingerBread`
Froyo	2.2.x	8	Czerwiec 2010 r.	`BuildVersionCodes.Froyo`
Eclair	2.1.x	7	Styczeń 2010 r.	`BuildVersionCodes.EclairMr1`
Eclair	2.0.1	6	Grudzień 2009 r.	`BuildVersionCodes.Eclair01`
Eclair	2.0	5	Listopad 2009 r.	`BuildVersionCodes.Eclair`
Pączek	1.6	100	Wrzesień 2009 r.	`BuildVersionCodes.Donut`
Cupcake	1.5	3	Maj 2009 r.	`BuildVersionCodes.Cupcake`
Podstawa	1.1	2	Luty 2009 r.	`BuildVersionCodes.Base11`
Podstawa	1.0	1	Październik 2008 r.	`BuildVersionCodes.Base`

Jak wskazuje ta tabela, nowe wersje systemu Android są często wydawane — czasami więcej niż jedną wersję rocznie. W związku z tym wszechświat urządzeń z systemem Android, które mogą uruchamiać aplikację, obejmuje szeroką gamę starszych i nowszych wersji systemu Android. Jak można zagwarantować, że aplikacja będzie działać spójnie i niezawodnie na tak wielu różnych wersjach systemu Android? Poziomy interfejsu API systemu Android mogą pomóc w zarządzaniu tym problemem.

Poziomy interfejsu API systemu Android

Każde urządzenie z systemem Android działa na dokładnie jednym poziomie interfejsu API — ten poziom interfejsu API ma gwarancję unikatowości dla wersji platformy Android. Poziom interfejsu API dokładnie identyfikuje wersję zestawu interfejsu API, do którego aplikacja może wywołać aplikację; identyfikuje kombinację elementów manifestu, uprawnień itp., względem których kodujesz jako deweloper. System interfejsu API systemu Android pomaga systemowi Android określić, czy aplikacja jest zgodna z obrazem systemu Android przed zainstalowaniem aplikacji na urządzeniu.

Po skompilowaniu aplikacji zawiera następujące informacje o poziomie interfejsu API:

Docelowy poziom interfejsu API systemu Android tworzony przez aplikację do uruchamiania.
Minimalny poziom interfejsu API systemu Android, który musi być uruchomiony przez urządzenie z systemem Android.

Te ustawienia służą do zapewnienia, że funkcje wymagane do poprawnego uruchomienia aplikacji są dostępne na urządzeniu z systemem Android w czasie instalacji. Jeśli nie, na tym urządzeniu nie będzie można uruchomić aplikacji. Jeśli na przykład poziom interfejsu API urządzenia z systemem Android jest niższy niż minimalny poziom interfejsu API określony dla aplikacji, urządzenie z systemem Android uniemożliwi użytkownikowi zainstalowanie aplikacji.

Ustawienia na poziomie interfejsu API projektu

W poniższych sekcjach wyjaśniono, jak używać Menedżera zestawów SDK do przygotowania środowiska projektowego dla poziomów interfejsu API, które mają być docelowe, a następnie szczegółowe wyjaśnienia dotyczące sposobu konfigurowania platformy docelowej, minimalnej wersji systemu Android i docelowej wersji systemu Android na platformie Xamarin.Android.

Platformy zestawu Android SDK

Przed wybraniem poziomu docelowego lub minimalnego interfejsu API na platformie Xamarin.Android należy zainstalować wersję platformy zestawu SDK systemu Android odpowiadającą poziomowi tego interfejsu API. Zakres dostępnych opcji dla platformy docelowej, minimalnej wersji systemu Android i docelowej wersji systemu Android jest ograniczony do zakresu zainstalowanych wersji zestawu Android SDK. Możesz użyć Menedżera zestawu SDK, aby sprawdzić, czy są zainstalowane wymagane wersje zestawu Android SDK, i możesz użyć go do dodania nowych poziomów interfejsu API potrzebnych dla aplikacji. Jeśli nie znasz sposobu instalowania poziomów interfejsu API, zobacz Konfiguracja zestawu SDK systemu Android.

Struktura docelowa

Platforma docelowa (znana również jako compileSdkVersion) to określona wersja platformy systemu Android (poziom interfejsu API), dla którego aplikacja jest kompilowana w czasie kompilacji. To ustawienie określa, jakich interfejsów API oczekuje aplikacja podczas jej działania, ale nie ma wpływu na to, które interfejsy API są rzeczywiście dostępne dla aplikacji podczas jej instalowania. W związku z tym zmiana ustawienia Platformy docelowej nie zmienia zachowania środowiska uruchomieniowego.

Platforma docelowa określa, które wersje biblioteki są połączone z aplikacją — to ustawienie określa interfejsy API, których można użyć w aplikacji. Jeśli na przykład chcesz użyć metody NotificationBuilder.SetCategory wprowadzonej w systemie Android 5.0 Lollipop, musisz ustawić platformę docelową na poziom 21 interfejsu API (Lollipop) lub nowszy. Jeśli ustawisz platformę docelową projektu na poziom interfejsu API, taki jak API Level 19 (KitKat) i spróbujesz wywołać SetCategory metodę w kodzie, zostanie wyświetlony błąd kompilacji.

Zalecamy, aby zawsze kompilować najnowszą dostępną wersję platformy Target Framework. Zapewnia to przydatne komunikaty ostrzegawcze dla wszystkich przestarzałych interfejsów API, które mogą być wywoływane przez kod. Korzystanie z najnowszej wersji platformy Target Framework jest szczególnie ważne w przypadku korzystania z najnowszych wersji biblioteki pomocy technicznej — każda biblioteka oczekuje, że aplikacja zostanie skompilowana na minimalnym poziomie interfejsu API tej biblioteki lub wyższym.

Program Visual Studio
Visual Studio dla komputerów Mac

Aby uzyskać dostęp do ustawienia Platformy docelowej w programie Visual Studio, otwórz właściwości projektu w Eksplorator rozwiązań i wybierz stronę Aplikacja:

Ustaw platformę docelową, wybierając poziom interfejsu API w menu rozwijanym w obszarze Kompiluj przy użyciu wersji systemu Android, jak pokazano powyżej.

Minimalna wersja systemu Android

Minimalna wersja systemu Android (znana również jako minSdkVersion) to najstarsza wersja systemu operacyjnego Android (tj. najniższy poziom interfejsu API), która może instalować i uruchamiać aplikację. Domyślnie aplikację można zainstalować tylko na urządzeniach pasujących do ustawienia Platformy docelowej lub nowszej; Jeśli ustawienie Minimalna wersja systemu Android jest niższe niż ustawienie Platformy docelowej, aplikacja może być również uruchamiana we wcześniejszych wersjach systemu Android. Jeśli na przykład ustawisz platformę docelową na Android 7.1 (Nougat) i ustawisz minimalną wersję systemu Android na Android 4.0.3 (Ice Cream Sandwich), aplikację można zainstalować na dowolnej platformie z poziomu interfejsu API 15 na poziom 25 interfejsu API włącznie.

Mimo że aplikacja może pomyślnie skompilować i zainstalować na tych platformach, nie gwarantuje to pomyślnego uruchomienia jej na wszystkich tych platformach. Jeśli na przykład aplikacja jest zainstalowana w systemie Android 5.0 (Lollipop), a kod wywołuje interfejs API dostępny tylko w systemie Android 7.1 (Nougat) i nowszych, aplikacja otrzyma błąd środowiska uruchomieniowego i prawdopodobnie ulegnie awarii. W związku z tym kod musi zapewnić — w czasie wykonywania — że wywołuje tylko te interfejsy API, które są obsługiwane przez urządzenie z systemem Android, na którym działa. Innymi słowy, kod musi zawierać jawne kontrole środowiska uruchomieniowego, aby upewnić się, że aplikacja używa nowszych interfejsów API tylko na urządzeniach, które są wystarczająco ostatnie, aby je obsługiwać. Testy środowiska uruchomieniowego dla wersji systemu Android, w dalszej części tego przewodnika, wyjaśniają, jak dodać te testy środowiska uruchomieniowego do kodu.

Program Visual Studio
Visual Studio dla komputerów Mac

Aby uzyskać dostęp do ustawienia Minimalna wersja systemu Android w programie Visual Studio, otwórz właściwości projektu w Eksplorator rozwiązań i wybierz stronę Manifest systemu Android. W menu rozwijanym w obszarze Minimalna wersja systemu Android możesz wybrać minimalną wersję systemu Android dla aplikacji:

W przypadku wybrania opcji Użyj kompilowania przy użyciu wersji zestawu SDK minimalna wersja systemu Android będzie taka sama jak ustawienie Platformy docelowej.

Docelowa wersja systemu Android

Docelowa wersja systemu Android (znana również jako targetSdkVersion) to poziom interfejsu API urządzenia z systemem Android, na którym oczekuje się uruchomienia aplikacji. System Android używa tego ustawienia, aby określić, czy włączyć jakiekolwiek zachowania zgodności — zapewnia to, że aplikacja będzie nadal działać zgodnie z oczekiwaniami. System Android używa ustawienia Wersji docelowej systemu Android aplikacji, aby dowiedzieć się, które zmiany zachowania można zastosować do aplikacji bez przerywania jej działania (w ten sposób system Android zapewnia zgodność z usługą Forward).

Platforma docelowa i docelowa wersja systemu Android, chociaż mają bardzo podobne nazwy, nie są takie same. Ustawienie Platforma docelowa komunikuje docelowe informacje o poziomie interfejsu API dla platformy Xamarin.Android do użytku w czasie kompilacji, podczas gdy wersja docelowa systemu Android komunikuje informacje o poziomie docelowego interfejsu API do systemu Android do użytku w czasie wykonywania (gdy aplikacja jest zainstalowana i uruchomiona na urządzeniu).

Program Visual Studio
Visual Studio dla komputerów Mac

Aby uzyskać dostęp do tego ustawienia w programie Visual Studio, otwórz właściwości projektu w Eksplorator rozwiązań i wybierz stronę Manifest systemu Android. W menu rozwijanym w obszarze Docelowa wersja systemu Android możesz wybrać docelową wersję systemu Android dla aplikacji:

Zalecamy jawne ustawienie docelowej wersji systemu Android na najnowszą wersję systemu Android używaną do testowania aplikacji. W idealnym przypadku należy ustawić na najnowszą wersję zestawu Android SDK — umożliwia to korzystanie z nowych interfejsów API przed rozpoczęciem pracy ze zmianami zachowania. W przypadku większości deweloperów nie zalecamy ustawiania docelowej wersji systemu Android na używanie kompilowania przy użyciu wersji zestawu SDK.

Ogólnie rzecz biorąc, docelowa wersja systemu Android powinna być powiązana z minimalną wersją systemu Android i platformą docelową. To znaczy:

Minimalna wersja systemu <Android = docelowa wersja <systemu Android = platforma docelowa

Aby uzyskać więcej informacji na temat poziomów zestawu SDK, zobacz dokumentację zestawu SDK dla deweloperów systemu Android.

Sprawdzanie środowiska uruchomieniowego dla wersji systemu Android

Po wydaniu każdej nowej wersji systemu Android interfejs API platformy jest aktualizowany w celu zapewnienia nowych lub zastępczych funkcji. Z kilkoma wyjątkami funkcjonalność interfejsu API z wcześniejszych wersji systemu Android jest przenoszona do nowszych wersji systemu Android bez modyfikacji. W związku z tym, jeśli aplikacja działa na określonym poziomie interfejsu API systemu Android, zazwyczaj będzie można ją uruchomić na późniejszym poziomie interfejsu API systemu Android bez modyfikacji. Ale co zrobić, jeśli chcesz również uruchomić aplikację we wcześniejszych wersjach systemu Android?

Jeśli wybierzesz minimalną wersję systemu Android niższą niż ustawienie Platformy docelowej, niektóre interfejsy API mogą nie być dostępne dla aplikacji w czasie wykonywania. Jednak aplikacja nadal może działać na wcześniejszym urządzeniu, ale z ograniczoną funkcjonalnością. Dla każdego interfejsu API, który nie jest dostępny na platformach Android odpowiadający ustawieniu Minimalna wersja systemu Android, kod musi jawnie sprawdzić wartość Android.OS.Build.VERSION.SdkInt właściwości, aby określić poziom interfejsu API platformy, na którym działa aplikacja. Jeśli poziom interfejsu API jest niższy niż minimalna wersja systemu Android, która obsługuje interfejs API, który chcesz wywołać, kod musi znaleźć sposób prawidłowego działania bez wykonywania tego wywołania interfejsu API.

Załóżmy na przykład, że chcemy użyć metody NotificationBuilder.SetCategory do kategoryzowania powiadomienia podczas uruchamiania w systemie Android 5.0 Lollipop (i nowszych), ale nadal chcemy, aby nasza aplikacja została uruchomiona we wcześniejszych wersjach systemu Android, takich jak Android 4.1 Jelly Bean (gdzie SetCategory jest niedostępna). W tabeli wersji systemu Android na początku tego przewodnika widzimy, że kod wersji kompilacji dla systemu Android 5.0 Lollipop to Android.OS.BuildVersionCodes.Lollipop. Aby obsługiwać starsze wersje systemu Android, jeśli SetCategory nie są dostępne, nasz kod może wykryć poziom interfejsu API w czasie wykonywania i wywołać SetCategory warunkowo tylko wtedy, gdy poziom interfejsu API jest większy lub równy kodowi wersji kompilacji Lollipop:

if (Android.OS.Build.VERSION.SdkInt >= Android.OS.BuildVersionCodes.Lollipop)
{
    builder.SetCategory(Notification.CategoryEmail);
}

W tym przykładzie platforma docelowa aplikacji jest ustawiona na Android 5.0 (poziom interfejsu API 21), a jej minimalna wersja systemu Android jest ustawiona na Android 4.1 (poziom interfejsu API 16). Ponieważ SetCategory jest dostępny na poziomie Android.OS.BuildVersionCodes.Lollipop interfejsu API i nowszym, ten przykładowy kod będzie wywoływany SetCategory tylko wtedy, gdy jest faktycznie dostępny — nie będzie podejmować próby wywołaniaSetCategory, gdy poziom interfejsu API wynosi 16, 17, 18, 19 lub 20. Funkcjonalność jest ograniczona do tych wcześniejszych wersji systemu Android tylko w zakresie, w jakim powiadomienia nie są prawidłowo sortowane (ponieważ nie są kategoryzowane według typu), ale powiadomienia są nadal publikowane w celu powiadamiania użytkownika. Nasza aplikacja nadal działa, ale jej funkcjonalność jest nieco zmniejszona.

Ogólnie rzecz biorąc, sprawdzanie wersji kompilacji pomaga podjąć decyzję w czasie wykonywania między wykonaniem czegoś nowego w porównaniu ze starym sposobem. Na przykład:

if (Android.OS.Build.VERSION.SdkInt >= Android.OS.BuildVersionCodes.Lollipop)
{
    // Do things the Lollipop way
}
else
{
    // Do things the pre-Lollipop way
}

Nie ma szybkiej i prostej reguły, która wyjaśnia, jak zmniejszyć lub zmodyfikować funkcjonalność aplikacji, gdy działa w starszych wersjach systemu Android, które nie mają co najmniej jednego interfejsu API. W niektórych przypadkach (na przykład w powyższym przykładzie SetCategory ) wystarczy pominąć wywołanie interfejsu API, gdy nie jest dostępne. Jednak w innych przypadkach może być konieczne zaimplementowanie alternatywnych funkcji, jeśli Android.OS.Build.VERSION.SdkInt zostanie wykryta wartość mniejsza niż poziom interfejsu API, który aplikacja musi przedstawić optymalne środowisko.

Podczas tworzenia projektu biblioteki Xamarin.Android (na przykład biblioteki klas lub biblioteki powiązań) można skonfigurować tylko ustawienie Platformy docelowej — ustawienia Minimalna wersja systemu Android i docelowa wersja systemu Android nie są dostępne. Wynika to z faktu, że nie ma strony manifestu systemu Android:

Ustawienia minimalnej wersji systemu Android i docelowej wersji systemu Android nie są dostępne, ponieważ wynikowa biblioteka nie jest aplikacją autonomiczną — biblioteka może być uruchamiana w dowolnej wersji systemu Android, w zależności od aplikacji, z którą jest spakowana. Możesz określić sposób kompilowania biblioteki, ale nie można przewidzieć poziomu interfejsu API platformy, w którym będzie uruchamiana biblioteka. Mając to na uwadze, podczas korzystania z bibliotek lub tworzenia bibliotek należy przestrzegać następujących najlepszych rozwiązań:

W przypadku korzystania z biblioteki systemu Android — jeśli używasz biblioteki systemu Android w aplikacji, ustaw ustawienie Platformy docelowej aplikacji na poziom interfejsu API, który jest co najmniej tak wysoki, jak ustawienie Platformy docelowej biblioteki.
Podczas tworzenia biblioteki systemu Android — jeśli tworzysz bibliotekę systemu Android do użytku przez inne aplikacje, ustaw ustawienie Platformy docelowej na minimalny poziom interfejsu API, którego potrzebuje w celu skompilowania.

Te najlepsze rozwiązania są zalecane, aby zapobiec sytuacji, w której biblioteka próbuje wywołać interfejs API, który nie jest dostępny w czasie wykonywania (co może spowodować awarię aplikacji). Jeśli jesteś deweloperem biblioteki, staraj się ograniczyć użycie wywołań interfejsu API do małego i dobrze ustalonego podzestawu całkowitego obszaru powierzchni interfejsu API. Dzięki temu biblioteka może być bezpiecznie używana w szerszej gamie wersji systemu Android.

Podsumowanie

W tym przewodniku wyjaśniono, jak poziomy interfejsu API systemu Android są używane do zarządzania zgodnością aplikacji w różnych wersjach systemu Android. Podano szczegółowe kroki konfigurowania platformy docelowej platformy Xamarin.Android, minimalnej wersji systemu Android i docelowych ustawień projektu wersji systemu Android. Podano instrukcje dotyczące używania Menedżera zestawu SDK systemu Android do instalowania pakietów ZESTAWU SDK, w tym przykłady pisania kodu do obsługi różnych poziomów interfejsu API w czasie wykonywania oraz wyjaśniono, jak zarządzać poziomami interfejsu API podczas tworzenia lub używania bibliotek systemu Android. Podano również kompleksową listę, która odnosi się do poziomów interfejsu API z numerami wersji systemu Android (takimi jak Android 4.4), nazwami wersji systemu Android (takimi jak Kitkat) i kodami wersji kompilacji platformy Xamarin.Android.