Omówienie zgodności urządzeń

Android jest przeznaczony do działania na wielu różnych urządzeniach, takich jak telefony, tablety i telewizory. Dzięki temu Twoja aplikacja może dotrzeć do ogromnej liczby użytkowników. Aby odnieść sukces na wszystkich urządzeniach, musi tolerować zmienność funkcji i zapewniać elastyczny interfejs użytkownika, który dostosowuje się do różnych konfiguracji ekranu.

Aby ułatwić obsługę różnych urządzeń, Android udostępnia dynamiczną platformę aplikacji, w której możesz udostępniać zasoby aplikacji specyficzne dla konfiguracji w plikach statycznych, np. różne układy XML dla różnych rozmiarów ekranu. Android wczytuje odpowiednie zasoby na podstawie bieżącej konfiguracji urządzenia. Dzięki przemyślanemu projektowi aplikacji i dodatkowym zasobom możesz opublikować jeden pakiet aplikacji (APK), który optymalizuje wygodę użytkowników na różnych urządzeniach.

W razie potrzeby możesz jednak określić wymagania dotyczące funkcji aplikacji i kontrolować, na jakich typach urządzeń można ją zainstalować ze Sklepu Google Play. Z tego dokumentu dowiesz się, jak kontrolować, które urządzenia mają dostęp do Twoich aplikacji, i jak przygotować aplikacje, aby dotrzeć do odpowiednich odbiorców.

Co oznacza „zgodność”?

W przypadku tworzenia aplikacji na Androida wyróżniamy 2 rodzaje zgodności: zgodność urządzenia i zgodność aplikacji.

Android to projekt open source, więc każdy producent sprzętu może stworzyć urządzenie z tym systemem operacyjnym. Urządzenie jest „zgodne z Androidem” tylko wtedy, gdy może prawidłowo uruchamiać aplikacje napisane dla środowiska wykonawczego Androida. Szczegółowe informacje o środowisku wykonawczym Androida są określone w programie zgodności z Androidem. Aby urządzenie było uznawane za zgodne, musi przejść testy Compatibility Test Suite (CTS).

Jako deweloper aplikacji nie musisz się martwić, czy urządzenie jest zgodne z Androidem, ponieważ Sklep Google Play jest dostępny tylko na urządzeniach zgodnych z Androidem. Jeśli więc użytkownik zainstaluje Twoją aplikację ze Sklepu Google Play, będzie korzystać z urządzenia zgodnego z Androidem.

Musisz jednak sprawdzić, czy Twoja aplikacja jest zgodna z każdą potencjalną konfiguracją urządzenia. Android działa na wielu różnych konfiguracjach urządzeń, dlatego niektóre funkcje nie są dostępne na wszystkich urządzeniach. Na przykład niektóre urządzenia nie mają czujnika kompasu. Jeśli główna funkcjonalność aplikacji wymaga czujnika kompasu, wtedy aplikacja jest zgodna tylko z urządzeniami, które mają tę funkcjonalność.

Kontrolowanie dostępności aplikacji na urządzeniach

Android obsługuje różne funkcje, które Twoja aplikacja może wykorzystywać za pomocą interfejsów API platformy. Niektóre funkcje są oparte na sprzęcie, np. czujnik kompasu, inne na oprogramowaniu, np. widżety aplikacji, a jeszcze inne zależą od wersji platformy. Nie wszystkie urządzenia obsługują wszystkie funkcje, dlatego może być konieczne kontrolowanie dostępności aplikacji na urządzeniach na podstawie wymaganych funkcji.

Aby aplikacja docierała do jak największej liczby użytkowników, obsługuj jak najwięcej konfiguracji urządzeń za pomocą jednego pliku APK lub AAB. W większości przypadków, możesz to zrobić, wyłączając opcjonalne funkcje w czasie działania i udostępniając zasoby aplikacji z alternatywami dla różnych konfiguracji, np. różne układy dla różnych rozmiarów ekranu. W razie potrzeby możesz ograniczyć dostępność aplikacji na określonych urządzeniach w Sklepie Google Play na podstawie tych cech urządzenia:

• Funkcje urządzenia
• Wersja platformy
• Konfiguracja ekranu

Funkcje urządzenia

Aby zarządzać dostępnością aplikacji na podstawie funkcji urządzenia, Android definiuje identyfikatory funkcji dla każdej funkcji sprzętowej lub programowej, która może nie być dostępna na wszystkich urządzeniach. Na przykład identyfikator funkcji czujnika kompasu to FEATURE_SENSOR_COMPASS, a identyfikator funkcji widżetów aplikacji to FEATURE_APP_WIDGETS.

W razie potrzeby możesz uniemożliwić użytkownikom instalowanie aplikacji, gdy ich urządzenia nie mają wymaganej funkcji. Aby to zrobić, zadeklaruj funkcję za pomocą <uses-feature> elementu w pliku manifestu aplikacji.

Jeśli na przykład Twoja aplikacja nie ma sensu na urządzeniu bez czujnika kompasu, możesz zadeklarować czujnik kompasu jako wymaganie za pomocą tego tagu manifestu:

<manifest ... >
    <uses-feature android:name="android.hardware.sensor.compass"
                  android:required="true" />
    ...
</manifest>

Sklep Google Play porównuje funkcje wymagane przez Twoją aplikację z funkcjami dostępnymi na urządzeniu każdego użytkownika, aby określić, czy aplikacja jest zgodna z danym urządzeniem. Jeśli urządzenie nie ma wszystkich funkcji wymaganych przez Twoją aplikację, użytkownik nie może jej zainstalować.

Jeśli jednak podstawowa funkcjonalność aplikacji nie wymaga funkcji urządzenia, ustaw required atrybut na "false" i sprawdź funkcję urządzenia w czasie działania. Jeśli funkcja aplikacji nie jest dostępna na bieżącym urządzeniu, przeprowadź łagodną degradację odpowiedniej funkcji aplikacji. Możesz na przykład sprawdzić, czy funkcja jest dostępna, wywołując metodę hasSystemFeature() w ten sposób:

if (!packageManager.hasSystemFeature(PackageManager.FEATURE_SENSOR_COMPASS)) {
    // This device doesn't have a compass. Turn off the compass feature.
    disableCompassFeature()
}

PackageManager pm = getPackageManager();
if (!pm.hasSystemFeature(PackageManager.FEATURE_SENSOR_COMPASS)) {
    // This device doesn't have a compass. Turn off the compass feature.
    disableCompassFeature();
}

Informacje o wszystkich filtrach, których możesz użyć do kontrolowania dostępności aplikacji w Sklepie Google Play, znajdziesz w dokumentacji Filtry w Google Play.

Wersja platformy

Na różnych urządzeniach mogą być zainstalowane różne wersje platformy Android, np. Android 12 lub Android 13. Każda kolejna wersja platformy często dodaje interfejsy API, które nie są dostępne w poprzedniej wersji. Aby wskazać, które interfejsy API są dostępne, każda wersja platformy określa poziom interfejsu API. Na przykład Android 12 to poziom interfejsu API 31, a Android 13 to poziom interfejsu API 33.

Musisz określić wartości minSdkVersion i targetSdkVersion w pliku build.gradle:

android {
    defaultConfig {
        applicationId = "com.example.myapp"

        // Defines the minimum API level required to run the app.
        minSdkVersion(30)

        // Specifies the API level used to test the app.
        targetSdkVersion(36)
        ...
    }
}

android {
    defaultConfig {
        applicationId 'com.example.myapp'

        // Defines the minimum API level required to run the app.
        minSdkVersion 30

        // Specifies the API level used to test the app.
        targetSdkVersion 36
        ...
    }
}

Więcej informacji o pliku build.gradle znajdziesz w artykule Konfigurowanie kompilacji.

Każda kolejna wersja Androida zapewnia zgodność z aplikacjami utworzonymi za pomocą interfejsów API z poprzednich wersji platformy, dzięki czemu Twoja aplikacja jest zgodna z przyszłymi wersjami Androida, gdy korzysta z udokumentowanych interfejsów API Androida.

Jeśli jednak Twoja aplikacja korzysta z interfejsów API dodanych w nowszej wersji platformy, ale nie są one wymagane do jej podstawowej funkcjonalności, sprawdź poziom interfejsu API w czasie działania i przeprowadź łagodną degradację odpowiednich funkcji, gdy poziom interfejsu API jest zbyt niski. W takim przypadku ustaw minSdkVersion na najniższą możliwą wartość dla podstawowej funkcjonalności aplikacji, a następnie porównaj bieżącą wersję systemu, SDK_INT, ze stałą nazwą kodową w Build.VERSION_CODES, która odpowiada poziomowi interfejsu API, który chcesz sprawdzić, jak pokazano w tym przykładzie:

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
    // Running on something older than API level 11, so disable
    // the drag and drop features that use ClipboardManager APIs.
    disableDragAndDrop()
}

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
    // Running on something older than API level 11, so disable
    // the drag and drop features that use ClipboardManager APIs.
    disableDragAndDrop();
}

Konfiguracja ekranu

Android działa na urządzeniach o różnych rozmiarach, takich jak telefony, tablety i telewizory. Aby podzielić urządzenia na kategorie według typu ekranu, Android definiuje 2 cechy każdego urządzenia: rozmiar ekranu (fizyczny rozmiar ekranu) i gęstość ekranu (fizyczna gęstość pikseli na ekranie, czyli DPI). Aby uprościć różne konfiguracje, Android uogólnia te warianty w grupy, które ułatwiają kierowanie:

• 4 uogólnione rozmiary: mały, normalny, duży i bardzo duży.
• Kilka uogólnionych gęstości: mdpi (średnia), hdpi (wysoka), xhdpi (bardzo wysoka), xxhdpi (bardzo, bardzo wysoka) i inne.

Domyślnie Twoja aplikacja jest zgodna ze wszystkimi rozmiarami i gęstościami ekranu, ponieważ system dostosowuje układ interfejsu i zasoby graficzne do każdego ekranu. Udostępnij zoptymalizowane obrazy bitmapowe dla typowych gęstości ekranu.

Zoptymalizuj wygodę użytkowników, korzystając w jak największym stopniu z elastycznych układów. Jeśli masz układy dla dużych zmian konfiguracji, np. orientacji pionowej i poziomej lub dużych i małych rozmiarów okien, rozważ udostępnienie alternatywnych układów, które są elastyczne w przypadku mniejszych zmian konfiguracji. Poprawia to wygodę użytkowników na urządzeniach takich jak tablety, telefony i urządzenia składane. Pomaga też, gdy rozmiar okien zmienia się w trybie wielu okien.

Więcej informacji o tworzeniu zasobów alternatywnych dla różnych ekranów i o tym, jak w razie potrzeby ograniczyć aplikację do określonych rozmiarów ekranu, znajdziesz w omówieniu zgodności z ekranem i w wskazówkach dotyczących jakości aplikacji na dużych ekranach.

Kontrolowanie dostępności aplikacji z powodów biznesowych

Oprócz ograniczenia dostępności aplikacji na podstawie cech urządzenia może być konieczne ograniczenie jej dostępności z powodów biznesowych lub prawnych. W takiej sytuacji Sklep Google Play udostępnia w Konsoli Play opcje filtrowania, które pozwalają kontrolować dostępność aplikacji z powodów nietechnicznych, takich jak ustawienia regionalne użytkownika lub operator sieci komórkowej.

Filtrowanie pod kątem zgodności technicznej, np. wymaganych komponentów sprzętowych, zawsze odbywa się na podstawie informacji zawartych w pliku APK lub AAB. Filtrowanie z powodów nietechnicznych, np. ustawień geograficznych , jest zawsze obsługiwane w Konsoli Google Play.

Dodatkowe zasoby:

Omówienie zasobów aplikacji

Informacje o tym, jak są zbudowane aplikacje na Androida, aby oddzielić zasoby aplikacji od kodu, w tym o tym, jak udostępniać alternatywne zasoby dla określonych konfiguracji urządzeń.

Filtry w Google Play

Informacje o różnych sposobach, w jakie Sklep Google Play może uniemożliwić zainstalowanie aplikacji na różnych urządzeniach.

Uprawnienia w Androidzie

Jak Android ogranicza dostęp aplikacji do niektórych interfejsów API za pomocą systemu uprawnień który wymaga zgody użytkownika na korzystanie z tych interfejsów API przez aplikację.