Si vous disposez déjà d'une application basée sur les vues, vous préférerez peut-être la réécrire par étape l'interface utilisateur en même temps. Cette page vous aide à ajouter de nouveaux composants Compose à votre application existante. Pour commencer à utiliser Compose dans votre application, consultez Configurer Compose dans votre application pour une application existante.
L'interopérabilité avec les vues a été conçue dès le départ dans Jetpack Compose. Cette fonctionnalité vous permet de migrer votre application existante basée sur des vues vers Compose tout en continuant à développer de nouvelles fonctionnalités. Pour migrer vers Compose, nous vous recommandons une migration incrémentielle durant laquelle Compose et les vues coexistent dans votre codebase jusqu'à ce que votre application soit entièrement dans Compose.
![Étapes de la migration d'une application basée sur les vues vers Compose](https://developer.android.com/static/develop/ui/compose/images/interop-stages.png?authuser=9&hl=fr)
Pour migrer votre application vers Compose, procédez comme suit :
- Créer de nouveaux écrans avec Compose
- Lorsque vous créez des fonctionnalités, identifiez les éléments réutilisables et commencez à créer une bibliothèque de composants d'interface utilisateur courants.
- Remplacez les fonctionnalités existantes un écran à la fois.
Créer de nouveaux écrans avec Compose
Utiliser Compose pour créer de nouvelles fonctionnalités englobant un écran entier est la meilleure solution pour favoriser l'adoption de Compose. Cette stratégie vous permet d'ajouter des caractéristiques et de profiter des avantages de Compose tout en continuant à répondre à vos aux besoins commerciaux de votre entreprise.
![Nouvel écran créé dans Compose](https://developer.android.com/static/develop/ui/compose/images/interop-newscreen.png?authuser=9&hl=fr)
Lorsque vous utilisez Compose pour créer des écrans dans votre application existante, vous restez en suivant les contraintes de l'architecture de votre application. Si vous utilisez dans les fragments et le composant Navigation, vous devez créer Fragment et ont son contenu dans Compose.
Pour utiliser Compose dans un fragment, renvoyez un ComposeView
dans la méthode de cycle de vie onCreateView()
de votre fragment. ComposeView
dispose d'une méthode setContent()
dans laquelle vous pouvez fournir une fonction modulable.
class NewFeatureFragment : Fragment() { override fun onCreateView( inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle? ): View { return ComposeView(requireContext()).apply { setViewCompositionStrategy(ViewCompositionStrategy.DisposeOnViewTreeLifecycleDestroyed) setContent { NewFeatureScreen() } } } }
Pour en savoir plus, consultez la section ComposeView dans les fragments.
Ajouter de nouvelles fonctionnalités aux écrans existants
![Écran existant avec à la fois des vues et Compose](https://developer.android.com/static/develop/ui/compose/images/interop-existingscreen.png?authuser=9&hl=fr)
Vous pouvez également utiliser Compose sur un écran existant basé sur les vues si la nouvelle fonctionnalité
que vous ajoutez font partie d'un écran existant. Pour ce faire, ajoutez un ComposeView
au
La hiérarchie des vues, comme n'importe quelle autre vue.
Par exemple, supposons que vous souhaitiez ajouter une vue enfant à un LinearLayout
. Vous pouvez le faire
en XML comme suit :
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="match_parent" android:layout_height="match_parent"> <TextView android:id="@+id/text" android:layout_width="wrap_content" android:layout_height="wrap_content" /> <androidx.compose.ui.platform.ComposeView android:id="@+id/compose_view" android:layout_width="match_parent" android:layout_height="match_parent" /> </LinearLayout>
Une fois la vue gonflée, vous pouvez ensuite référencer ComposeView
dans la hiérarchie et appeler setContent()
.
Pour en savoir plus sur ComposeView
, consultez la page sur les API d'interopérabilité.
Créer une bibliothèque de composants d'interface utilisateur courants
Lorsque vous créez des fonctionnalités avec Compose, vous vous apercevez rapidement que vous créez aussi une bibliothèque de composants. La création d'une bibliothèque de composants d'interface utilisateur courants vous permet de disposer d'une source unique et fiable pour ces composants dans votre application et d'encourager leur réutilisabilité. Les fonctionnalités que vous créez peuvent ensuite dépendre de cette bibliothèque. Cette technique est particulièrement utile si vous créez un système de conception personnalisé dans Compose.
Selon la taille de votre application, cette bibliothèque peut prendre la forme d'un package, d'un module ou d'un module de bibliothèque distinct. Pour plus d'informations sur l'organisation des modules dans votre application, consultez le guide de modularisation des applications Android.
Remplacer des fonctionnalités existantes avec Compose
En plus d'utiliser Compose afin de créer de nouvelles fonctionnalités, vous pouvez migrer progressivement les fonctionnalités existantes de votre application pour bénéficier des avantages de Compose.
Une application entièrement dédiée à Compose peut accélérer le développement, mais aussi réduire la taille de l'APK et les durées de compilation de votre application. Voir Comparer Compose et View performances pour en savoir plus.
Écrans simples
Lorsque vous migrez des fonctionnalités existantes vers Compose, vous devez d'abord vous occuper des écrans simples. Il peut s'agir d'un écran de bienvenue, d'un écran de confirmation ou d'un écran de paramétrage dans lesquels les données affichées dans l'interface utilisateur sont relativement statiques.
Prenons le fichier XML suivant :
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="match_parent" android:layout_height="match_parent"> <TextView android:id="@+id/title_text" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="@string/title" android:textAppearance="?attr/textAppearanceHeadline2" /> <TextView android:id="@+id/subtitle_text" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="@string/subtitle" android:textAppearance="?attr/textAppearanceHeadline6" /> <TextView android:id="@+id/body_text" android:layout_width="wrap_content" android:layout_height="0dp" android:layout_weight="1" android:text="@string/body" android:textAppearance="?attr/textAppearanceBody1" /> <Button android:id="@+id/confirm_button" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="@string/confirm"/> </LinearLayout>
Le fichier XML peut être réécrit dans Compose en quelques lignes :
@Composable fun SimpleScreen() { Column(Modifier.fillMaxSize()) { Text( text = stringResource(R.string.title), style = MaterialTheme.typography.headlineMedium ) Text( text = stringResource(R.string.subtitle), style = MaterialTheme.typography.headlineSmall ) Text( text = stringResource(R.string.body), style = MaterialTheme.typography.bodyMedium ) Spacer(modifier = Modifier.weight(1f)) Button(onClick = { /* Handle click */ }, Modifier.fillMaxWidth()) { Text(text = stringResource(R.string.confirm)) } } }
Écrans mixtes vues et Compose
Un écran qui contient déjà un peu de code Compose est un autre candidat idéal pour une migration complète vers Compose. Selon la complexité de l'écran, vous pouvez le migrer vers Compose en une seule fois ou procéder progressivement. Si l'écran commence par Compose dans une sous-arborescence de la hiérarchie de l'UI, vous continuez de migrer les éléments de l'interface utilisateur jusqu'à ce que l'intégralité de l'écran se trouve dans Compose. Cette approche est également appelée approche ascendante.
![Approche ascendante de la migration d'une interface mixte vues et Compose vers Compose](https://developer.android.com/static/develop/ui/compose/images/interop-animation.gif?authuser=9&hl=fr)
Suppression de fragments et composant Navigation
Vous pourrez migrer vers Navigation Compose, une fois que vous pourrez supprimer tous vos fragments et remplacez-les par les composables correspondants au niveau de l'écran. Au niveau de l'écran Les composables peuvent contenir à la fois des contenus Compose et View, mais tous Les destinations de navigation doivent être des composables pour activer Navigation Compose la migration. En attendant, vous devez continuer à utiliser Composant Navigation basé sur des fragments dans votre vue mixte et Compose de votre codebase. Consultez Migrer la navigation Jetpack vers Navigation Compose pour découvrir plus d'informations.
Ressources supplémentaires
Consultez les ressources supplémentaires suivantes pour en savoir plus sur la migration d'une application existante basée sur des vues vers Compose :
- Atelier de programmation
- Effectuer une migration vers Jetpack Compose: découvrez comment migrer des éléments de Sunflower. vers Compose dans cet atelier de programmation.
- Articles de blog
- Migrer Sunflower vers Jetpack Compose : découvrez comment Sunflower a été migré vers Compose à l'aide de la stratégie décrite sur cette page.
- Interopérabilité Jetpack Compose : Utiliser Compose dans un RecyclerView : découvrez comment utiliser efficacement Compose dans un
RecyclerView
.
Étapes suivantes
Maintenant que vous connaissez la stratégie à suivre pour migrer votre application basée sur les vues, découvrez les API d'interopérabilité pour en savoir plus.
Recommandations personnalisées
- Remarque : Le texte du lien s'affiche lorsque JavaScript est désactivé
- Utiliser Compose dans les vues
- Défilement
- Migrer
RecyclerView
vers la liste différée