Redução do APK

Minimizar o tamanho do APK é um aspecto importante do desenvolvimento de um bom app Android. Isso é especialmente verdadeiro ao segmentar mercados em desenvolvimento e também ao desenvolver um app instantâneo Android. Nesses casos, pode ser recomendável minimizar o tamanho da biblioteca ExoPlayer incluída no APK. Esta página descreve algumas etapas simples que podem ajudar a conseguir isso.

Use apenas as dependências necessárias

Dependa apenas dos módulos de biblioteca de que você realmente precisa. Por exemplo, o código abaixo adiciona dependências aos módulos de biblioteca do ExoPlayer, DASH e de interface, conforme necessário para um app que reproduz apenas conteúdo DASH:

Kotlin

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

Groovy

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

Ativar a redução de código e recursos

Ative a redução de código e recursos para os builds de lançamento do app. O ExoPlayer é estruturado de forma a permitir que a redução de código remova efetivamente as funcionalidades não utilizadas. Por exemplo, para um app que reproduz conteúdo DASH, a contribuição do ExoPlayer para o tamanho do APK pode ser reduzida em aproximadamente 40% ao ativar a redução de código.

Leia Reduzir, ofuscar e otimizar o app para saber como ativar a redução de código e recursos.

Especificar quais renderizadores o app precisa

Por padrão, os renderizadores do player são criados usando DefaultRenderersFactory. O DefaultRenderersFactory depende de todas as implementações de Renderer fornecidas na biblioteca do ExoPlayer. Por isso, nenhuma delas será removida pela redução de código. Se você sabe que seu app só precisa de um subconjunto de renderizadores, especifique seu próprio RenderersFactory. Por exemplo, um app que só reproduz áudio pode definir uma fábrica como esta ao instanciar instâncias de ExoPlayer:

Kotlin

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()

Java

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

Isso vai permitir que outras implementações de Renderer sejam removidas pela redução de código. Neste exemplo de vídeo, os renderizadores de texto e metadados são removidos, o que significa que as legendas ou os metadados in-stream (por exemplo, ICY) não serão processados nem emitidos pelo player.

Especificar quais extratores o app precisa

Por padrão, o player cria instâncias Extractor para reproduzir mídia progressiva usando DefaultExtractorsFactory. O DefaultExtractorsFactory depende de todas as implementações de Extractor fornecidas na biblioteca do ExoPlayer. Por isso, nenhuma delas será removida pela redução de código. Se você souber que seu app só precisa reproduzir um pequeno número de formatos de contêiner ou não reproduz mídia progressiva, especifique seu próprio ExtractorsFactory. Por exemplo, um app que só precisa reproduzir arquivos mp4 pode fornecer uma fábrica como:

Kotlin

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

Java

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

Isso vai permitir que outras implementações de Extractor sejam removidas pela redução de código, o que pode resultar em uma diminuição significativa no tamanho.

Se o app não estiver reproduzindo conteúdo progressivo, transmita ExtractorsFactory.EMPTY para o construtor DefaultMediaSourceFactory e, em seguida, transmita esse mediaSourceFactory para o construtor ExoPlayer.Builder.

Kotlin

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

Java

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

Instanciação personalizada de MediaSource

Se o app estiver usando um MediaSource.Factory personalizado e você quiser que DefaultMediaSourceFactory seja removido pela remoção de código, transmita o MediaSource.Factory diretamente para o construtor ExoPlayer.Builder.

Kotlin

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

Java

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

Se o app estiver usando MediaSource diretamente em vez de MediaItem, transmita MediaSource.Factory.UNSUPPORTED para o construtor ExoPlayer.Builder para garantir que DefaultMediaSourceFactory e DefaultExtractorsFactory possam ser removidos pela redução de código.

Kotlin

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

Java

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