À 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'écran de démarrage apporte des éléments de conception standards à chaque lancement d'application, mais il 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 de compatibilité SplashScreen
, qui encapsule l'API SplashScreen
.
Fonctionnement de l'écran de démarrage
Lorsqu'un utilisateur lance une application alors que son processus n'est pas en cours d'exécution (démarrage à froid) ou que Activity
n'est pas créé (démarrage tiède), 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 des fichiers de ressources XML dans le fichier manifeste Android. Il existe des modes clair et sombre pour chaque élément.
Les éléments personnalisables d'un écran de démarrage se composent 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:
![Image montrant les éléments contenus dans un écran de démarrage](https://developer.android.com/static/images/guide/topics/ui/splash-screen/splash-screen-composition.png?authuser=6&hl=fr)
Examinez les éléments suivants, illustrés dans la figure 2:
1 L'icône d'application doit être un drawable vectoriel. Elle peut être statique ou animée. Bien que les animations puissent avoir une durée illimitée, nous vous 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 si le contraste avec celui de la fenêtre est suffisant.
3 Comme pour les icônes adaptatives, un tiers du premier plan est masqué.
4 L'arrière-plan de la fenêtre est d'une seule couleur opaque. Si l'arrière-plan de la fenêtre est défini et 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 associée à la marque: 200 × 80 dp.
- Icône d'application avec un arrière-plan d'icône: elle doit mesurer 240 × 240 dp et doit 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 à l'extérieur du cercle devient invisible (masqué).
![Image montrant différentes dimensions d'icône pour les arrière-plans unis et transparents](https://developer.android.com/static/images/guide/topics/ui/splash-screen/splash-screen-icon-dimensions.png?authuser=6&hl=fr)
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. L'ajout d'une icône animée à votre écran de démarrage présente un attrait esthétique évident et offre une expérience plus haut de gamme. Des recherches sur l'expérience utilisateur montrent que le temps de démarrage perçu est inférieur lors de l'affichage d'une animation.
Une animation de l'écran de démarrage est intégrée aux composants de la séquence de lancement, comme illustré dans la figure 4.
![Image montrant la séquence de lancement dans douze images consécutives, la première fois que l'utilisateur appuie sur l'icône du lanceur et remplit l'écran à mesure qu'il s'agrandit](https://developer.android.com/static/images/ui/splash-sequence.png?authuser=6&hl=fr)
Accéder à l'animation: elle comprend la vue système et l'écran de démarrage. Elle est contrôlée par le système et n'est pas personnalisable.
Écran de démarrage (affiché pendant la partie "attente" de la séquence): il peut être personnalisé, ce qui vous permet d'ajouter votre propre animation de logo et votre propre branding. Il doit répondre aux exigences décrites sur cette page pour fonctionner correctement.
Animation de sortie: animation qui masque l'écran de démarrage. Si vous souhaitez la personnaliser, utilisez l'icône
SplashScreenView
et son icône. Vous pouvez y exécuter n'importe quelle animation, avec les 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.
Lors de l'exécution de l'animation d'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é facilement. 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 gênante pour les utilisateurs et donner une impression d'imprévisibilité ou de manque de perfectionnement.
Exigences concernant l'animation de l'écran de démarrage
Votre écran de démarrage doit respecter les caractéristiques 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 de compatibilité
SplashScreen
.Assurez-vous que l'icône animée respecte les caractéristiques suivantes:
- Format:l'icône doit être un fichier XML AnimatedVectorDrawable (AVD).
- Dimensions:une icône AVD doit avoir une taille quatre fois supérieure à celle d'une icône adaptative, comme suit :
- La zone de l'icône doit être 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 du lanceur d'applications et doivent mesurer 288 dp, soit quatre fois les 72 dp qui constituent la zone masquée interne d'une icône adaptative.
- Durée:nous vous recommandons de ne pas dépasser 1 000 ms sur les téléphones. Vous pouvez utiliser un démarrage différé, mais celui-ci ne peut 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 le moment approprié pour fermer l'écran de démarrage, qui se produit lorsque votre application dessine son premier frame. Vous pouvez personnaliser davantage cette fonctionnalité, comme décrit dans la section Garder l'écran de démarrage à l'écran pendant de longues périodes.
Ressources de l'écran de démarrage
Téléchargez l'exemple de kit de démarrage, qui montre comment créer, formater 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 de votre application
Par défaut, SplashScreen
utilise le 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.
Laissez-la à l'écran plus longtemps.
Personnalisez l'animation pour fermer l'écran de démarrage.
Commencer
La bibliothèque SplashScreen
principale apporte l'écran de démarrage Android 12 à tous les appareils de l'API 23. Pour l'ajouter à votre projet, insérez l'extrait suivant dans 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
windowSplashScreenBackground
pour remplir l'arrière-plan avec une couleur unique spécifique:<item name="android:windowSplashScreenBackground">@color/...</item>
Utilisez
windowSplashScreenAnimatedIcon
pour 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 peut être animé et drawable via
AnimationDrawable
etAnimatedVectorDrawable
, définissezwindowSplashScreenAnimationDuration
pour lire l'animation tout en affichant la fenêtre de démarrage. Cela n'est pas obligatoire pour Android 13, car la durée est directement déduite deAnimatedVectorDrawable
.<item name="android:windowSplashScreenAnimatedIcon">@drawable/...</item>
Utilisez
windowSplashScreenAnimationDuration
pour indiquer la durée de l'animation de l'icône de l'écran de démarrage. La définition de ce paramètre n'a aucune incidence sur la durée d'affichage réelle de l'écran de démarrage, mais vous pouvez la 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 : Conserver l'écran de démarrage à l'écran pendant de longues périodes.<item name="android:windowSplashScreenAnimationDuration">1000</item>
Utilisez
windowSplashScreenIconBackgroundColor
pour 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
windowSplashScreenBrandingImage
pour définir une image à afficher au bas de l'écran de démarrage. Toutefois, les consignes de conception recommandent de ne pas utiliser d'image de marque.<item name="android:windowSplashScreenBrandingImage">@drawable/...</item>
Vous pouvez utiliser
windowSplashScreenBehavior
pour indiquer 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. L'icône s'affiche sur l'écran de démarrage si l'activité de lancement définitsplashScreenStyle
surSPLASH_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 d'écran de démarrage vide et que vous souhaitez toujours afficher l'icône animée, définissez ce paramètre sur la valeuricon_preferred
.<item name="android:windowSplashScreenBehavior">icon_preferred</item>
Conserver l'écran de démarrage à l'écran plus longtemps
L'écran de démarrage se ferme dès que votre application affiche son premier frame. Si vous devez charger une petite quantité de données, par exemple en chargeant des 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 l'activité de démarrage se termine avant le dessin (par exemple, en ne définissant pas la vue de 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 d'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 votre implémentation d'écran de démarrage existante vers Android 12 ou version ultérieure
- Now in Android (Maintenant dans l'application Android), qui montre une implémentation réelle d'un écran de démarrage