Réduction de l'APK

La réduction de la taille de l'APK est un aspect important du développement d'une bonne application Android. Cela est particulièrement vrai lorsque vous ciblez les marchés en développement, mais aussi lorsque vous développez une appli instantanée Android. Dans ces cas, il peut être souhaitable de réduire la taille de la bibliothèque ExoPlayer incluse dans l'APK. Cette page décrit quelques étapes simples qui peuvent vous aider à y parvenir.

Utiliser uniquement les dépendances requises

Ne dépendez que des modules de bibliothèque dont vous avez réellement besoin. Par exemple, les éléments suivants ajouteront des dépendances sur les modules de bibliothèque ExoPlayer, DASH et UI, comme cela peut être nécessaire pour une application qui ne lit que du contenu DASH :

implementation("androidx.media3:media3-exoplayer:1.7.1")
implementation("androidx.media3:media3-exoplayer-dash:1.7.1")
implementation("androidx.media3:media3-ui:1.7.1")

implementation "androidx.media3:media3-exoplayer:1.7.1"
implementation "androidx.media3:media3-exoplayer-dash:1.7.1"
implementation "androidx.media3:media3-ui:1.7.1"

Activer la minification du code et des ressources

Vous devez activer la minification du code et des ressources pour les builds de version de votre application. ExoPlayer est structuré de manière à permettre à la minification de code de supprimer efficacement les fonctionnalités inutilisées. Par exemple, pour une application qui lit du contenu DASH, la contribution d'ExoPlayer à la taille de l'APK peut être réduite d'environ 40 % en activant la minification de code.

Consultez Réduire, obscurcir et optimiser votre application pour savoir comment activer la minification du code et des ressources.

Spécifier les renderers dont votre application a besoin

Par défaut, les renderers du lecteur sont créés à l'aide de DefaultRenderersFactory. DefaultRenderersFactory dépend de toutes les implémentations Renderer fournies dans la bibliothèque ExoPlayer. Par conséquent, aucune d'elles ne sera supprimée par la réduction du code. Si vous savez que votre application n'a besoin que d'un sous-ensemble de renderers, vous pouvez spécifier votre propre RenderersFactory à la place. Par exemple, une application qui ne lit que de l'audio peut définir une usine comme celle-ci lors de l'instanciation des instances ExoPlayer :

val audioOnlyRenderersFactory =
  RenderersFactory {
    handler: Handler,
    videoListener: VideoRendererEventListener,
    audioListener: AudioRendererEventListener,
    textOutput: TextOutput,
    metadataOutput: MetadataOutput,
    ->
    arrayOf<Renderer>(
      MediaCodecAudioRenderer(context, MediaCodecSelector.DEFAULT, handler, audioListener)
    )
}
val player = ExoPlayer.Builder(context, audioOnlyRenderersFactory).build()

RenderersFactory audioOnlyRenderersFactory =
    (handler, videoListener, audioListener, textOutput, metadataOutput) ->
        new Renderer[] {
            new MediaCodecAudioRenderer(
                context, MediaCodecSelector.DEFAULT, handler, audioListener)
        };
ExoPlayer player = new ExoPlayer.Builder(context, audioOnlyRenderersFactory).build();

Cela permettra de supprimer les autres implémentations Renderer par réduction du code. Dans cet exemple de vidéo, les renderers de texte et de métadonnées sont supprimés (ce qui signifie que les sous-titres ou les métadonnées intégrées (par exemple, ICY) ne seront pas traités ni émis par le lecteur).

Spécifier les extracteurs dont votre application a besoin

Par défaut, le lecteur crée des instances Extractor pour lire les contenus multimédias progressifs à l'aide de DefaultExtractorsFactory. DefaultExtractorsFactory dépend de toutes les implémentations Extractor fournies dans la bibliothèque ExoPlayer. Par conséquent, aucune d'elles ne sera supprimée par la réduction du code. Si vous savez que votre application n'a besoin de lire qu'un petit nombre de formats de conteneur ou ne lit pas du tout les contenus multimédias progressifs, vous pouvez spécifier votre propre ExtractorsFactory. Par exemple, une application qui n'a besoin que de lire des fichiers MP4 peut fournir une usine comme suit :

val mp4ExtractorFactory = ExtractorsFactory {
  arrayOf<Extractor>(Mp4Extractor(DefaultSubtitleParserFactory()))
}
val player =
  ExoPlayer.Builder(context, DefaultMediaSourceFactory(context, mp4ExtractorFactory)).build()

ExtractorsFactory mp4ExtractorFactory =
    () -> new Extractor[] {new Mp4Extractor(new DefaultSubtitleParserFactory())};
ExoPlayer player =
    new ExoPlayer.Builder(context, new DefaultMediaSourceFactory(context, mp4ExtractorFactory))
        .build();

Cela permettra de supprimer d'autres implémentations Extractor par réduction du code, ce qui peut entraîner une réduction significative de la taille.

Si votre application ne lit pas du tout le contenu progressif, vous devez transmettre ExtractorsFactory.EMPTY au constructeur DefaultMediaSourceFactory, puis transmettre ce mediaSourceFactory au constructeur ExoPlayer.Builder.

val player =
  ExoPlayer.Builder(context, DefaultMediaSourceFactory(context, ExtractorsFactory.EMPTY)).build()

ExoPlayer player =
    new ExoPlayer.Builder(
            context, new DefaultMediaSourceFactory(context, ExtractorsFactory.EMPTY))
        .build();

Instanciation personnalisée de MediaSource

Si votre application utilise un MediaSource.Factory personnalisé et que vous souhaitez que DefaultMediaSourceFactory soit supprimé par suppression du code, vous devez transmettre votre MediaSource.Factory directement au constructeur ExoPlayer.Builder.

val player = ExoPlayer.Builder(context, customMediaSourceFactory).build()

ExoPlayer player = new ExoPlayer.Builder(context, mediaSourceFactory).build();

Si votre application utilise directement MediaSource au lieu de MediaItem, vous devez transmettre MediaSource.Factory.UNSUPPORTED au constructeur ExoPlayer.Builder pour vous assurer que DefaultMediaSourceFactory et DefaultExtractorsFactory peuvent être supprimés par la réduction du code.

val player = ExoPlayer.Builder(context, MediaSource.Factory.UNSUPPORTED).build()
val mediaSource =
  ProgressiveMediaSource.Factory(dataSourceFactory, customExtractorsFactory)
    .createMediaSource(MediaItem.fromUri(uri))

ExoPlayer player = new ExoPlayer.Builder(context, MediaSource.Factory.UNSUPPORTED).build();
ProgressiveMediaSource mediaSource =
    new ProgressiveMediaSource.Factory(dataSourceFactory, customExtractorsFactory)
        .createMediaSource(MediaItem.fromUri(uri));