Si vous implémentez un écran de démarrage personnalisé sous Android 11 ou version antérieure, migrez votre application vers l'API SplashScreen pour vous assurer qu'elle s'affiche correctement sous Android 12 ou version ultérieure.
À partir d'Android 12, le système applique l'écran de démarrage par défaut du système Android aux démarrages à froid et à chaud pour toutes les applications. Par défaut, cet écran de démarrage du système est créé à l'aide de l'élément d'icône de lanceur de votre application et du windowBackground de votre thème, s'il s'agit d'une couleur unie.
Si vous ne migrez pas votre application, l'expérience de lancement de votre application sur Android 12 et versions ultérieures pourrait être dégradée ou produire des résultats inattendus.
Si l'écran de démarrage existant est implémenté à l'aide d'un thème personnalisé qui remplace
android:windowBackground, le système le remplace par un écran de démarrage par défaut du système Android sous Android 12 ou version ultérieure. Il ne s'agit peut-être pas de l'expérience prévue par votre application.Si votre écran de démarrage existant est implémenté à l'aide d'un
Activitydédié, le lancement de votre application sur les appareils équipés d'Android 12 ou version ultérieure génère des écrans de démarrage en double : l'écran de démarrage du système s'affiche, suivi de votre activité d'écran de démarrage existante.
Vous pouvez éviter ces expériences dégradées ou indésirables en suivant le processus de migration décrit dans ce document. Une fois la migration effectuée, l'API améliore le temps de démarrage, vous donne un contrôle total sur l'expérience de l'écran de démarrage et crée une expérience de lancement plus cohérente avec les autres applications de la plate-forme.
Bibliothèque de compatibilité SplashScreen
Vous pouvez utiliser directement l'API SplashScreen, mais nous vous recommandons vivement d'utiliser plutôt la bibliothèque compat SplashScreen d'AndroidX. La bibliothèque compat utilise l'API SplashScreen, permet la rétrocompatibilité et crée une apparence cohérente pour l'écran de démarrage sur toutes les versions d'Android. Ce document est écrit à l'aide de la bibliothèque compat.
Si vous effectuez la migration directement à l'aide de l'API SplashScreen, votre écran de démarrage sera exactement le même qu'avant la migration sur Android 11 et versions antérieures. À partir d'Android 12, l'écran de démarrage a l'apparence d'Android 12.
Si vous effectuez la migration à l'aide de la bibliothèque de compatibilité SplashScreen, le système affiche le même écran de démarrage sur toutes les versions d'Android.
Migrer l'implémentation de l'écran de démarrage
Procédez comme suit pour migrer l'implémentation de votre écran de démarrage vers Android 12 ou version ultérieure.
Cette procédure s'applique au type d'implémentation à partir duquel vous effectuez la migration. Si vous effectuez la migration depuis un Activity dédié, suivez les bonnes pratiques décrites dans ce document pour adapter votre Activity d'écran de démarrage personnalisé. L'API SplashScreen réduit également la latence au démarrage introduite par une activité sur l'écran de démarrage dédié.
Pour migrer votre écran de démarrage, procédez comme suit:
Dans le fichier
build.gradle, modifiez votrecompileSdkVersionet incluez la bibliothèque compatSplashScreendans les dépendances.build.gradle android { compileSdkVersion 31 ... } dependencies { ... implementation 'androidx.core:core-splashscreen:1.0.0-beta02' }Créez un thème avec un parent de
Theme.SplashScreen. Définissez la valeur depostSplashScreenThemesur le thème queActivitydoit utiliser et la valeur dewindowSplashScreenAnimatedIconsur un drawable ou un drawable animé. Les autres attributs sont facultatifs.<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>Si vous souhaitez ajouter une couleur d'arrière-plan sous votre icône, vous pouvez utiliser le thème
Theme.SplashScreen.IconBackgroundet définir l'attributwindowSplashScreenIconBackground.Dans le fichier manifeste, remplacez le thème de l'activité de démarrage par celui que vous avez créé à l'étape précédente.
<manifest> <application android:theme="@style/Theme.App.Starting"> <!-- or --> <activity android:theme="@style/Theme.App.Starting"> ...Appelez
installSplashScreendans l'activité de démarrage avant d'appelersuper.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 renvoie l'objet de l'écran de démarrage, que vous pouvez éventuellement utiliser pour personnaliser l'animation ou pour garder l'écran de démarrage affiché plus longtemps. Pour en savoir plus sur la personnalisation de l'animation, consultez Conserver l'écran de démarrage à l'écran pendant plus longtemps et Personnaliser l'animation pour fermer l'écran de démarrage.
Adapter l'activité de votre écran de démarrage personnalisé à l'écran de démarrage
Après avoir migré vers l'écran de démarrage pour Android 12 et versions ultérieures, décidez ce que vous souhaitez faire de votre précédent écran de démarrage personnalisé Activity. Vous disposez des options suivantes:
- Conserver l'activité personnalisée, mais empêcher qu'elle s'affiche.
- Conservez l'activité personnalisée pour des raisons de branding.
- Supprimez l'activité personnalisée et adaptez votre application si nécessaire.
Empêcher l'affichage de l'activité personnalisée
Si votre précédent écran de démarrage Activity est principalement utilisé pour le routage, envisagez de le supprimer. Par exemple, vous pouvez créer un lien direct vers l'activité réelle ou passer à une activité unique avec des sous-composants. Si ce n'est pas possible, vous pouvez utiliser SplashScreen.setKeepOnScreenCondition pour conserver l'activité de routage, mais arrêter son affichage. Cela permet de transférer l'écran de démarrage vers l'activité suivante et d'assurer une transition en douceur.
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();
}
...
Conserver l'activité personnalisée pour le branding
Si vous souhaitez utiliser un écran de démarrage Activity précédent pour des raisons de branding, vous pouvez passer de l'écran de démarrage du système à votre écran de démarrage personnalisé Activity en personnalisant l'animation pour fermer l'écran de démarrage.
Toutefois, il est préférable d'éviter ce scénario dans la mesure du possible et d'utiliser l'API SplashScreen pour personnaliser votre écran de démarrage.
Si vous devez afficher une boîte de dialogue, nous vous recommandons de l'afficher sur l'activité de l'écran de démarrage personnalisé suivante ou sur l'activité principale après l'écran de démarrage du système.
Supprimer l'activité de l'écran de démarrage personnalisé
En règle générale, nous recommandons de supprimer complètement l'écran de démarrage personnalisé Activity précédent pour éviter la duplication des écrans de démarrage, augmenter l'efficacité et réduire le temps de chargement de l'écran de démarrage. Il existe différentes techniques que vous pouvez utiliser pour éviter d'afficher des activités sur l'écran de démarrage redondantes.
Utilisez le chargement différé pour vos composants, modules ou bibliothèques. Évitez de charger ou d'initialiser des composants ou des bibliothèques qui ne sont pas nécessaires au fonctionnement de l'application au lancement. Chargez-les plus tard, lorsque l'application en aura besoin.
Si votre application a vraiment besoin d'un composant pour fonctionner correctement, chargez-le uniquement lorsqu'il est réellement nécessaire et non au moment du lancement, ou utilisez un thread d'arrière-plan pour le charger après le démarrage de l'application. Essayez de réduire au maximum la taille de votre
Application.onCreate().Vous pouvez également utiliser la bibliothèque App Startup pour initialiser les composants au démarrage de l'application. Dans ce cas, veillez à toujours charger tous les modules requis pour l'activité de démarrage et n'introduisez pas d'à-coups lorsque les modules chargés en différé deviennent disponibles.
Créez un espace réservé lorsque vous chargez une petite quantité de données localement. Utilisez l'approche de thématisation recommandée et maintenez le rendu jusqu'à ce que l'application soit prête. Pour implémenter un écran de démarrage rétrocompatible, suivez la procédure décrite dans la section Conserver l'écran de démarrage à l'écran pendant plus longtemps.
Afficher les espaces réservés. Pour les chargements basés sur le réseau de durée indéterminée, ignorez l'écran de démarrage et affichez les espaces réservés pour le chargement asynchrone. Envisagez d'appliquer à la zone de contenu des animations subtiles qui reflètent l'état de chargement. Assurez-vous que la structure du contenu chargé correspond à la structure de squelette, tout en permettant une transition en douceur lors du chargement du contenu.
Utilisez la mise en cache. Lorsqu'un utilisateur ouvre votre application pour la première fois, vous pouvez afficher des indicateurs de chargement pour certains éléments d'interface utilisateur, comme illustré dans la figure suivante. La prochaine fois que l'utilisateur retournera dans votre application, vous pourrez afficher ce contenu mis en cache pendant que vous chargez un contenu plus récent.