Jeśli na Androidzie 11 lub starszym użyjesz niestandardowego ekranu powitalnego, przenieś aplikację do interfejsu API SplashScreen, aby zapewnić jej prawidłowe wyświetlanie na Androidzie 12 i nowszych.
Począwszy od Androida 12 system stosuje domyślny ekran powitalny systemu Android w przypadku uruchomień „na zimno” i „na ciepło” 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ę z myślą o użytkownikach.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.
Możesz zapobiec tym niezamierzonym zmianom, przeprowadzając proces migracji opisany w tym dokumencie. Po migracji interfejs API skróci czas uruchamiania, zapewni Ci pełną kontrolę nad ekranem powitalnym i zapewni bardziej spójne wrażenia podczas uruchamiania w porównaniu z innymi aplikacjami na platformie.
Biblioteka kompatybilna SplashScreen
Możesz bezpośrednio korzystać z interfejsu API SplashScreen, ale zdecydowanie zalecamy użycie biblioteki kompatybilności SplashScreen Androidx. Biblioteka compat korzysta z interfejsu API SplashScreen,
zgodność wsteczną oraz spójny wygląd i sposób działania ekranu powitalnego
we wszystkich wersjach Androida. Ten dokument został napisany przy użyciu biblioteki kompatybilności.
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 dotyczy każdego typu implementacji, z którego przeprowadzasz migrację. 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.gradlezmieńcompileSdkVersioni uwzględnij biblioteki kompatybilnejSplashScreenw 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ść argumentupostSplashScreenThemedo motywu, którego musi używaćActivity, a atrybut wartośćwindowSplashScreenAnimatedIconna 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.IconBackgroundi ustaw ten motywwindowSplashScreenIconBackground.W pliku manifestu zastąp motyw początkowej aktywności tym, który został utworzony w poprzednim kroku.
<manifest> <application android:theme="@style/Theme.App.Starting"> <!-- or --> <activity android:theme="@style/Theme.App.Starting"> ...Zanim zadzwonisz, zadzwoń pod numer
installSplashScreenw 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 artykułach Pozostawianie ekranu powitalnego na dłużej i Dostosowywanie animacji zamykania ekranu powitalnego.
Dostosowywanie niestandardowej aktywności ekranu powitalnego do ekranu powitalnego
Po migracji na ekran powitalny w Androidzie 12 i nowszych wersjach zdecyduj, co zrobić z poprzednim niestandardowym ekranem powitalnym.Activity Możesz:
- Zachowaj niestandardową aktywność, ale uniemożliw jej wyświetlanie.
- Zachowaj niestandardową aktywność ze względu na elementy budujące markę.
- Usuń niestandardową aktywność i w razie potrzeby dostosuj aplikację.
Zapobiegaj wyświetlaniu się niestandardowej aktywności
Jeśli poprzedni ekran powitalny Activity służy głównie do kierowania, zastanów się, czy nie usunąć go. Możesz na przykład bezpośrednio połączyć się z daną aktywnością lub przejść do pojedynczej aktywności z podelementami. Jeśli tak nie jest
możesz użyć funkcji
SplashScreen.setKeepOnScreenCondition
, aby pozostawiać aktywność routingu na swoim miejscu, ale zatrzymać renderowanie. Spowoduje to przeniesienie ekranu powitalnego do następnej czynności i ułatwi płynne przejście.
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 ze względów związanych z marką chcesz użyć poprzedniego ekranu powitalnego Activity, możesz przejść z systemowego ekranu powitalnego na niestandardowy ekran powitalny Activity, dostosowując animację zamykania ekranu powitalnego.
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, których możesz użyć, aby uniknąć wyświetlania zbędnych czynnoś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ę potrzebuje 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. Staraj się, aby plik
Application.onCreate()był jak najmniejszy.Możesz też użyć biblioteki uruchamiania 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 placeholder podczas wczytywania niewielkiej ilości danych na komputerze. Użyj zalecanego podejścia do stylizacji i opóźnij renderowanie do momentu, gdy aplikacja będzie gotowa. Aby wdrożyć ekran powitalny z wsteczną kompatybilnością, wykonaj czynności opisane w artykule Utrzymywanie ekranu powitalnego na ekranie przez dłuższy czas.
Pokaż obiekty zastępcze. W przypadku wczytywania danych z sieci o nieokreślonym czasie trwania usuń ekran powitalny i pokaż zastępniki dla wczytywania asynchronicznego. Zastanów się, czy warto zastosować subtelne animacje w obszarze treści, które odzwierciedlają stan wczytywania. Upewnij się, że struktura wczytanych treści jest jak najbardziej zbliżona do struktury szkieletu, aby zapewnić płynne przejście podczas wczytywania treści.
Używaj buforowania. Gdy użytkownik otwiera aplikację po raz pierwszy, możesz wyświetlać wskaźniki wczytywania dla niektórych elementów interfejsu, jak pokazano na poniższym rysunku. Gdy użytkownik wróci do aplikacji, możesz wyświetlić z poziomu pamięci podręcznej te treści, a zarazem wczytać nowsze.