À partir d'Android 12, l'API SplashScreen permet aux applications de se lancer avec une animation, y compris un mouvement dans l'application au lancement, un écran de démarrage affichant l'icône de votre application et une transition vers votre application elle-même. Un SplashScreen est un Window et couvre donc un Activity.
L'expérience de l'écran de démarrage ajoute des éléments de conception standards à chaque lancement d'application, mais elle est également personnalisable afin que votre application puisse conserver son branding unique.
En plus d'utiliser l'API de la plate-forme SplashScreen, vous pouvez également utiliser la bibliothèque compat SplashScreen, qui encapsule l'API SplashScreen.
Fonctionnement de l'écran de démarrage
Lorsqu'un utilisateur lance une application alors que le processus de l'application n'est pas en cours d'exécution (démarrage à froid) ou que Activity n'est pas créé (démarrage à chaud), les événements suivants se produisent:
Le système affiche l'écran de démarrage à l'aide de thèmes et des animations que vous définissez.
Lorsque l'application est prête, l'écran de démarrage se ferme et l'application s'affiche.
L'écran de démarrage ne s'affiche jamais lors d'un démarrage à chaud.
Éléments et mécanismes de l'écran de démarrage
Les éléments de l'écran de démarrage sont définis par les fichiers de ressources XML du fichier manifeste Android. Il existe des modes clair et sombre pour chaque élément.
Les éléments personnalisables d'un écran de démarrage sont constitués de l'icône d'application, de l'arrière-plan de l'icône et de l'arrière-plan de la fenêtre:
Considérez les éléments suivants, illustrés dans la figure 2:
1 L'icône de l'application doit être un drawable vectoriel. Elle peut être statique ou animée. Bien que la durée des animations puisse être illimitée, nous recommandons de ne pas dépasser 1 000 millisecondes. L'icône de lanceur est l'icône par défaut.
2 L'arrière-plan de l'icône est facultatif et utile si vous avez besoin de plus de contraste entre l'icône et l'arrière-plan de la fenêtre. Si vous utilisez une icône adaptative, son arrière-plan s'affiche s'il y a suffisamment de contraste avec l'arrière-plan de la fenêtre.
3 Comme pour les icônes adaptatives, un tiers du premier plan est masqué.
4 L'arrière-plan de la fenêtre consiste en une seule couleur opaque. Si l'arrière-plan de la fenêtre est défini et qu'il est de couleur unie, il est utilisé par défaut si l'attribut n'est pas défini.
Dimensions de l'écran de démarrage
L'icône de l'écran de démarrage utilise les mêmes caractéristiques que les icônes adaptatives, comme suit:
- Image de marque: 200 × 80 dp.
- Icône d'application avec un arrière-plan d'icône: elle doit mesurer 240 × 240 dp et tenir dans un cercle de 160 dp de diamètre.
- Icône d'application sans arrière-plan d'icône: elle doit mesurer 288 × 288 dp et tenir dans un cercle de 192 dp de diamètre.
Par exemple, si la taille réelle d'une image est de 300 × 300 dp, l'icône doit tenir dans un cercle d'un diamètre de 200 dp. Tout ce qui se trouve en dehors du cercle devient invisible (masqué).
Animations de l'écran de démarrage et séquence de lancement
Une latence supplémentaire est souvent associée au lancement d'une application à froid. Ajouter une icône animée à votre écran de démarrage a un attrait esthétique évident et offre une expérience plus premium. Des recherches sur l'expérience utilisateur montrent que le temps de démarrage perçu est plus court lors du visionnage d'une animation.
Une animation d'écran de démarrage est intégrée aux composants de la séquence de lancement, comme illustré dans la figure 4.
Animation "Entrée" : il s'agit de la vue système de l'écran de démarrage. Il est contrôlé par le système et n'est pas personnalisable.
Écran de démarrage (affiché pendant la partie d'attente de la séquence): il peut être personnalisé, ce qui vous permet de fournir votre propre animation de logo et marque. Il doit répondre aux exigences décrites sur cette page pour fonctionner correctement.
Quitter l'animation: il s'agit de l'animation qui masque l'écran de démarrage. Si vous souhaitez le personnaliser, utilisez l'icône
SplashScreenViewet son icône. Vous pouvez y exécuter n'importe quelle animation, avec des paramètres de transformation, d'opacité et de couleur. Dans ce cas, supprimez manuellement l'écran de démarrage une fois l'animation terminée.
Lorsque vous exécutez l'animation de l'icône, le lancement de l'application vous permet d'ignorer la séquence si l'application est prête plus tôt. L'application déclenche onResume() ou l'écran de démarrage expire automatiquement. Assurez-vous donc que le mouvement peut être ignoré sans difficulté. L'écran de démarrage ne doit être fermé avec onResume() que lorsque l'application est stable d'un point de vue visuel. Aucune icône de chargement supplémentaire n'est donc nécessaire. L'introduction d'une interface incomplète peut être troublante pour les utilisateurs et peut donner l'impression d'imprévisibilité ou de manque de perfectionnement.
Exigences relatives aux animations sur l'écran de démarrage
Votre écran de démarrage doit respecter les spécifications suivantes:
Définissez une couleur d'arrière-plan pour une seule fenêtre sans transparence. Les modes Jour et Nuit sont compatibles avec la bibliothèque compat
SplashScreen.Assurez-vous que l'icône animée respecte les spécifications suivantes:
- Format:l'icône doit être un fichier XML AnimatedVectorDrawable (AVD).
- Dimensions:une icône AVD doit avoir quatre fois la taille d'une icône adaptative, comme suit :
- La zone de l'icône doit avoir une taille de 432 dp, soit quatre fois la zone de 108 dp d'une icône adaptative non masquée.
- Les deux tiers internes de l'image sont visibles sur l'icône de lanceur et doivent être de 288 dp, soit quatre fois les 72 dp qui constituent la zone masquée interne d'une icône adaptative.
- Durée:nous recommandons de ne pas dépasser 1 000 ms sur les téléphones. Vous pouvez utiliser un démarrage retardé, mais ne doit pas dépasser 166 ms. Si le temps de démarrage de l'application est supérieur à 1 000 ms, envisagez une animation en boucle.
Déterminez un moment approprié pour fermer l'écran de démarrage, qui se produit lorsque votre application dessine son premier frame. Vous pouvez personnaliser ce paramètre, comme décrit dans la section Conserver l'écran de démarrage à l'écran pendant de plus longues périodes.
Ressources sur l'écran de démarrage
Téléchargez l'exemple de kit de démarrage, qui montre comment créer, mettre en forme et exporter une animation dans un AVD. Il comprend les éléments suivants :
- Fichier de projet Adobe After Effects de l'animation.
- Fichier XML AVD final exporté.
- Exemple de GIF de l'animation
En téléchargeant ces fichiers, vous acceptez les Conditions d'utilisation de Google.
Les Règles de confidentialité de Google expliquent comment les données sont gérées dans ce service.
Personnaliser l'écran de démarrage dans votre application
Par défaut, SplashScreen utilise la windowBackground de votre thème si windowBackground est une couleur unie. Pour personnaliser l'écran de démarrage, ajoutez des attributs au thème de l'application.
Vous pouvez personnaliser l'écran de démarrage de votre application en effectuant l'une des opérations suivantes:
Définissez des attributs de thème pour modifier son apparence.
Conservez-le à l'écran plus longtemps.
Personnalisez l'animation pour fermer l'écran de démarrage.
Premiers pas
La bibliothèque SplashScreen principale permet d'intégrer l'écran de démarrage Android 12 à tous les appareils à partir de l'API 23. Pour l'ajouter à votre projet, ajoutez l'extrait suivant à votre fichier build.gradle:
Groovy
dependencies {
implementation "androidx.core:core-splashscreen:1.0.0"
}
Kotlin
dependencies {
implementation("androidx.core:core-splashscreen:1.0.0")
}
Définir un thème pour l'écran de démarrage afin de modifier son apparence
Vous pouvez spécifier les attributs suivants dans votre thème Activity pour personnaliser l'écran de démarrage de votre application. Si vous disposez déjà d'une ancienne implémentation d'écran de démarrage qui utilise des attributs tels que android:windowBackground, envisagez de fournir un autre fichier de ressources pour Android 12 ou version ultérieure.
Utilisez
windowSplashScreenBackgroundpour remplir l'arrière-plan avec une couleur unie spécifique:<item name="android:windowSplashScreenBackground">@color/...</item>Utilisez
windowSplashScreenAnimatedIconpour remplacer l'icône au centre de la fenêtre de démarrage.Pour les applications ciblant Android 12 (niveau d'API 32) uniquement, procédez comme suit:
Si l'objet est animatable et drawable via
AnimationDrawableetAnimatedVectorDrawable, définissezwindowSplashScreenAnimationDurationpour lire l'animation tout en affichant la fenêtre de démarrage. Cela n'est pas nécessaire pour Android 13, car la durée est directement déduite deAnimatedVectorDrawable.<item name="android:windowSplashScreenAnimatedIcon">@drawable/...</item>Utilisez
windowSplashScreenAnimationDurationpour indiquer la durée de l'animation de l'icône de l'écran de démarrage. Définir ce paramètre n'a aucune incidence sur la durée réelle d'affichage de l'écran de démarrage, mais vous pouvez le récupérer lorsque vous personnalisez l'animation de sortie de l'écran de démarrage à l'aide deSplashScreenView.getIconAnimationDuration. Pour en savoir plus, consultez la section suivante sur le fait de garder l'écran de démarrage à l'écran pendant plus longtemps.<item name="android:windowSplashScreenAnimationDuration">1000</item>Utilisez
windowSplashScreenIconBackgroundColorpour définir un arrière-plan derrière l'icône de l'écran de démarrage. Cela est utile si le contraste entre l'arrière-plan de la fenêtre et l'icône n'est pas suffisant.<item name="android:windowSplashScreenIconBackgroundColor">@color/...</item>Vous pouvez utiliser
windowSplashScreenBrandingImagepour définir une image à afficher en bas de l'écran de démarrage. Toutefois, les consignes de conception déconseillent d'utiliser une image de marque.<item name="android:windowSplashScreenBrandingImage">@drawable/...</item>Vous pouvez utiliser
windowSplashScreenBehaviorpour spécifier si votre application doit toujours afficher l'icône sur l'écran de démarrage sous Android 13 ou version ultérieure. La valeur par défaut est 0. Elle affiche l'icône sur l'écran de démarrage si l'activité de lancement définitsplashScreenStylesurSPLASH_SCREEN_STYLE_ICON, ou suit le comportement du système si l'activité de lancement ne spécifie pas de style. Si vous préférez ne jamais afficher un écran de démarrage vide et que vous souhaitez toujours afficher l'icône animée, définissez cette valeur sur la valeuricon_preferred.<item name="android:windowSplashScreenBehavior">icon_preferred</item>
Conserver l'écran de démarrage à l'écran pendant de plus longues périodes
L'écran de démarrage se ferme dès que votre application dessine son premier frame. Si vous devez charger une petite quantité de données, par exemple pour charger les paramètres de l'application à partir d'un disque local de manière asynchrone, vous pouvez utiliser ViewTreeObserver.OnPreDrawListener pour suspendre l'application afin de dessiner son premier frame.
Si votre activité de démarrage se termine avant le dessin (par exemple, en ne définissant pas la vue du contenu et en se terminant avant onResume), l'écouteur de prédessin n'est pas nécessaire.
Kotlin
// Create a new event for the activity.
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// Set the layout for the content view.
setContentView(R.layout.main_activity)
// Set up an OnPreDrawListener to the root view.
val content: View = findViewById(android.R.id.content)
content.viewTreeObserver.addOnPreDrawListener(
object : ViewTreeObserver.OnPreDrawListener {
override fun onPreDraw(): Boolean {
// Check whether the initial data is ready.
return if (viewModel.isReady) {
// The content is ready. Start drawing.
content.viewTreeObserver.removeOnPreDrawListener(this)
true
} else {
// The content isn't ready. Suspend.
false
}
}
}
)
}
Java
// Create a new event for the activity.
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Set the layout for the content view.
setContentView(R.layout.main_activity);
// Set up an OnPreDrawListener to the root view.
final View content = findViewById(android.R.id.content);
content.getViewTreeObserver().addOnPreDrawListener(
new ViewTreeObserver.OnPreDrawListener() {
@Override
public boolean onPreDraw() {
// Check whether the initial data is ready.
if (mViewModel.isReady()) {
// The content is ready. Start drawing.
content.getViewTreeObserver().removeOnPreDrawListener(this);
return true;
} else {
// The content isn't ready. Suspend.
return false;
}
}
});
}
Personnaliser l'animation pour fermer l'écran de démarrage
Vous pouvez personnaliser davantage l'animation de l'écran de démarrage via Activity.getSplashScreen().
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// ...
// Add a callback that's called when the splash screen is animating to the
// app content.
splashScreen.setOnExitAnimationListener { splashScreenView ->
// Create your custom animation.
val slideUp = ObjectAnimator.ofFloat(
splashScreenView,
View.TRANSLATION_Y,
0f,
-splashScreenView.height.toFloat()
)
slideUp.interpolator = AnticipateInterpolator()
slideUp.duration = 200L
// Call SplashScreenView.remove at the end of your custom animation.
slideUp.doOnEnd { splashScreenView.remove() }
// Run your animation.
slideUp.start()
}
}
Java
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// ...
// Add a callback that's called when the splash screen is animating to the
// app content.
getSplashScreen().setOnExitAnimationListener(splashScreenView -> {
final ObjectAnimator slideUp = ObjectAnimator.ofFloat(
splashScreenView,
View.TRANSLATION_Y,
0f,
-splashScreenView.getHeight()
);
slideUp.setInterpolator(new AnticipateInterpolator());
slideUp.setDuration(200L);
// Call SplashScreenView.remove at the end of your custom animation.
slideUp.addListener(new AnimatorListenerAdapter() {
@Override
public void onAnimationEnd(Animator animation) {
splashScreenView.remove();
}
});
// Run your animation.
slideUp.start();
});
}
Au début de ce rappel, le drawable vectoriel animé sur l'écran de démarrage démarre. En fonction de la durée du lancement de l'application, le drawable peut se trouver au milieu de son animation. Utilisez SplashScreenView.getIconAnimationStart pour savoir quand l'animation a commencé. Vous pouvez calculer la durée restante de l'animation de l'icône comme suit:
Kotlin
// Get the duration of the animated vector drawable.
val animationDuration = splashScreenView.iconAnimationDuration
// Get the start time of the animation.
val animationStart = splashScreenView.iconAnimationStart
// Calculate the remaining duration of the animation.
val remainingDuration = if (animationDuration != null && animationStart != null) {
(animationDuration - Duration.between(animationStart, Instant.now()))
.toMillis()
.coerceAtLeast(0L)
} else {
0L
}
Java
// Get the duration of the animated vector drawable.
Duration animationDuration = splashScreenView.getIconAnimationDuration();
// Get the start time of the animation.
Instant animationStart = splashScreenView.getIconAnimationStart();
// Calculate the remaining duration of the animation.
long remainingDuration;
if (animationDuration != null && animationStart != null) {
remainingDuration = animationDuration.minus(
Duration.between(animationStart, Instant.now())
).toMillis();
remainingDuration = Math.max(remainingDuration, 0L);
} else {
remainingDuration = 0L;
}
Ressources supplémentaires
- Migrer l'implémentation existante de l'écran de démarrage vers Android 12 ou version ultérieure
- L'application Now in Android, qui montre une implémentation réelle d'un écran de démarrage.