Jeśli wdrożysz niestandardowy ekran powitalny w Androidzie 11 lub starszym,
do interfejsu API SplashScreen
, aby ułatwić
sprawdź, czy wyświetla się prawidłowo na Androidzie 12 i nowszych.
Od Androida 12 system stosuje domyślne powitanie systemu Android
Ekran włączony
zimno i ciepło
uruchamia się w przypadku wszystkich aplikacji. Domyślnie
ten systemowy ekran powitalny jest zbudowany z elementu ikony programu uruchamiającego aplikację
oraz windowBackground
motywu, jeśli jest on tylko w jednym kolorze.
Jeśli tego nie zrobisz, będzie można uruchamiać ją na Androidzie 12 lub może później ulec pogorszeniu lub przynieść niezamierzone efekty.
Jeśli Twój obecny ekran powitalny został zaimplementowany za pomocą motyw niestandardowy, który zastępuje
android:windowBackground
, system zastąpi niestandardowy ekran powitalny domyślnym systemem Android ekranu powitalnego na Androidzie 12 i nowszych. Może to nie być zamierzone przez Twoją aplikację i uzyskiwanie dodatkowych informacji.Jeśli korzystasz z obecnego ekranu powitalnego za pomocą dedykowanego
Activity
, uruchomienie aplikacji na urządzeniach z Androidem 12 lub nowszym przekłada się zduplikowane ekrany powitalne: ekranu powitalnego systemu a następnie aktywność na ekranie powitalnym.
Aby temu zapobiec, możesz wykonać opisane w tym dokumencie. Po migracji interfejs API skraca czas uruchamiania, daje pełną kontrolę nad ekranem powitalnym, i zapewnia większą spójność podczas uruchamiania z innymi aplikacjami na tej platformie.
Biblioteka kompatybilna SplashScreen
Możesz używać interfejsu API SplashScreen
bezpośrednio, ale zdecydowanie zalecamy użycie interfejsu
Biblioteka kompatybilna z Androidem SplashScreen
. Biblioteka compat korzysta z interfejsu API SplashScreen
,
wsteczną oraz zapewnia spójny wygląd i sposób działania ekranu powitalnego
we wszystkich wersjach Androida. Ten dokument jest napisany w kompatybilnym
bibliotece.
Jeśli przeprowadzasz migrację bezpośrednio przy użyciu interfejsu API SplashScreen
na Androidzie 11 i starszych
ekran powitalny wygląda dokładnie tak samo jak przed migracją. Data rozpoczęcia:
Ekran powitalny w Androidzie 12 ma wygląd i styl Androida 12.
Jeśli przeprowadzisz migrację za pomocą biblioteki zgodnej SplashScreen
, system wyświetli
ten sam ekran powitalny na wszystkich wersjach Androida.
Migracja implementacji ekranu powitalnego
Aby przenieść istniejący ekran powitalny: w Androidzie 12 i nowszych.
Ta procedura ma zastosowanie do każdego typu implementacji, którą przenosisz
. Jeśli przeprowadzasz migrację z dedykowanej usługi Activity
, postępuj zgodnie z najlepszymi
metod weryfikacji opisanych w tym dokumencie,
dostosowany ekran powitalny Activity
. Interfejs SplashScreen
API ogranicza też uruchamianie
związane z czasem oczekiwania dzięki dedykowanej aktywności na ekranie powitalnym.
Aby przenieść ekran powitalny:
W pliku
build.gradle
zmieńcompileSdkVersion
i uwzględnij biblioteki kompatybilnejSplashScreen
w zależności.build.gradle android { compileSdkVersion 31 ... } dependencies { ... implementation 'androidx.core:core-splashscreen:1.0.0-beta02' }
Utwórz motyw z elementem nadrzędnym:
Theme.SplashScreen
. Ustaw wartość argumentupostSplashScreenTheme
do motywu, którego musi używaćActivity
, a atrybut wartośćwindowSplashScreenAnimatedIcon
na obiekt rysowalny lub animowany, obiekt rysowalny. Pozostałe atrybuty są opcjonalne.<style name="Theme.App.Starting" parent="Theme.SplashScreen"> <!-- Set the splash screen background, animated icon, and animation duration. --> <item name="windowSplashScreenBackground">@color/...</item> <!-- Use windowSplashScreenAnimatedIcon to add a drawable or an animated drawable. One of these is required. --> <item name="windowSplashScreenAnimatedIcon">@drawable/...</item> <!-- Required for animated icons. --> <item name="windowSplashScreenAnimationDuration">200</item> <!-- Set the theme of the Activity that directly follows your splash screen. This is required. --> <item name="postSplashScreenTheme">@style/Theme.App</item> </style>
Jeśli chcesz dodać kolor tła pod ikoną, możesz użyć przycisku
Theme.SplashScreen.IconBackground
i ustaw ten motywwindowSplashScreenIconBackground
.W pliku manifestu zastąp motyw początkowej aktywności motywem, którego używasz. utwórz w poprzednim kroku.
<manifest> <application android:theme="@style/Theme.App.Starting"> <!-- or --> <activity android:theme="@style/Theme.App.Starting"> ...
Zanim zadzwonisz, zadzwoń pod numer
installSplashScreen
w ramach początkowej aktywnościsuper.onCreate()
Kotlin
class MainActivity : Activity() { override fun onCreate(savedInstanceState: Bundle?) { // Handle the splash screen transition. val splashScreen = installSplashScreen() super.onCreate(savedInstanceState) setContentView(R.layout.main_activity) ...
Java
public class MainActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { // Handle the splash screen transition. SplashScreen splashScreen = SplashScreen.installSplashScreen(this); super.onCreate(savedInstanceState); setContentView(R.layout.main_activity); } }
installSplashScreen
zwraca obiekt ekranu powitalnego, który możesz opcjonalnie
służy do dostosowywania animacji lub do wyświetlania ekranu powitalnego przez dłuższy czas
czas trwania kampanii. Więcej informacji o dostosowywaniu animacji znajdziesz w sekcji
Wyświetlaj ekran powitalny przez dłuższy czas
oraz
Dostosuj animację zamykającą ekran powitalny
Dostosuj spersonalizowaną aktywność na ekranie powitalnym do ekranu powitalnego
Po przejściu na ekran powitalny na Androidzie 12 i nowszych zdecyduj, co
w porównaniu z poprzednim niestandardowym ekranem powitalnym (Activity
). Masz:
opcje:
- Zachowaj niestandardową aktywność, ale zablokuj jej wyświetlanie.
- Zachowaj niestandardową aktywność na potrzeby promowania marki.
- Usuń tę aktywność i dostosuj aplikację według potrzeb.
Zapobiegaj wyświetlaniu się niestandardowej aktywności
Jeśli poprzedni ekran powitalny (Activity
) jest używany głównie do routingu,
zastanów się, jak można je usunąć. Możesz na przykład podać bezpośredni link
lub przejść do pojedynczego działania z podskładnikami. Jeśli nie jest,
możesz użyć funkcji
SplashScreen.setKeepOnScreenCondition
, aby pozostawiać aktywność routingu na swoim miejscu, ale zatrzymać renderowanie. Robię to
przenosi ekran powitalny do następnego działania i wspomaga płynne
przejścia.
Kotlin
class RoutingActivity : Activity() { override fun onCreate(savedInstanceState: Bundle?) { val splashScreen = installSplashScreen() super.onCreate(savedInstanceState) // Keep the splash screen visible for this Activity. splashScreen.setKeepOnScreenCondition { true } startSomeNextActivity() finish() } ...
Java
public class RoutingActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { SplashScreen splashScreen = SplashScreen.installSplashScreen(this); super.onCreate(savedInstanceState); // Keep the splash screen visible for this Activity. splashScreen.setKeepOnScreenCondition(() -> true ); startSomeNextActivity(); finish(); } ...
Zachowaj niestandardową aktywność na potrzeby promowania marki
Jeśli do promowania marki chcesz używać poprzedniego ekranu powitalnego Activity
,
umożliwia przejście z ekranu powitalnego systemu na niestandardowy ekran powitalny
Activity
, dostosowując animację zamykania ekranu powitalnego
ekranu.
Lepiej jednak w miarę możliwości unikać takich sytuacji i korzystać z tagu SplashScreen
Interfejs API do promowania marki na ekranie powitalnym.
Jeśli musisz wyświetlić okno, zalecamy wyświetlanie go nad kolejnym niestandardowym działaniem na ekranie powitalnym lub nad główną aktywnością po ekranie powitalnym systemu.
Usuń aktywność na niestandardowym ekranie powitalnym
Ogólnie zalecamy usunięcie poprzedniego niestandardowego ekranu powitalnego (Activity
)
całkowicie uniknąć powielania ekranów powitalnych i zwiększyć wydajność,
oraz skrócenie czasu wczytywania ekranu powitalnego. Istnieją różne techniki,
możesz uniknąć wyświetlania zbędnych aktywności na ekranie powitalnym.
Używaj leniwego ładowania komponentów, modułów i bibliotek. Unikaj wczytywania lub inicjowanie komponentów lub bibliotek, które nie są wymagane do jak i w przyszłości. Wczytaj je później, gdy aplikacja ich będzie potrzebować.
Jeśli aplikacja naprawdę wymaga jakiegoś komponentu do prawidłowego działania, ładuj go tylko wtedy, gdy jest które są naprawdę potrzebne, a nie w momencie uruchomienia, lub użyj wątku w tle, aby go wczytać po uruchomieniu aplikacji. Postaraj się, aby urządzenie
Application.onCreate()
było tak lekkie jak to tylko możliwe.Inne korzyści to także: Biblioteka startowa aplikacji do inicjowania komponentów podczas uruchamiania aplikacji. Pamiętaj, by w dalszym ciągu wczytywać wszystkie są wymagane do rozpoczęcia i nie wprowadzają w błąd, leniwie ładowane moduły stają się dostępne.
Utwórz obiekt zastępczy podczas wczytywania lokalnej ilości danych. Użyj zalecane podejście do tematyki i wstrzymywanie renderowania do czasu, aż aplikacja gotowe. Aby wdrożyć ekran powitalny, który jest zgodny wstecznie, postępuj zgodnie z instrukcjami czynności opisane w Zadbaj o to, aby ekran powitalny był widoczny przez dłuższy czas.
Pokaż obiekty zastępcze. W przypadku obciążeń sieciowych o nieokreślonym czasie trwania zamknij ekran powitalny i pokaż obiekty zastępcze dla wczytywania asynchronicznego. Rozważ użycie w obszarze treści subtelnych animacji, które będą odzwierciedlać stanu wczytywania. Upewnij się, że struktura wczytanej treści odpowiada struktura szkieletowa a także zapewnić płynne przejście po załadowaniu treści.
Używaj buforowania. Gdy użytkownik otworzy aplikację po raz pierwszy, możesz pokazać wskaźniki wczytywania niektórych elementów interfejsu, jak na ilustracji poniżej. następnym razem, gdy użytkownik wróci do aplikacji, możesz wyświetlić tę zawartość z pamięci podręcznej wczytują się nowsze treści.