Penyingkatan APK

Meminimalkan ukuran APK merupakan aspek penting dalam pengembangan aplikasi Android yang baik. Hal ini berlaku terutama saat menargetkan pasar yang berkembang, dan juga saat mengembangkan Aplikasi Instan Android. Untuk kasus semacam ini, sebaiknya minimalkan ukuran library ExoPlayer yang disertakan dalam APK. Halaman ini menjelaskan beberapa langkah sederhana yang dapat membantu mencapainya.

Menggunakan dependensi yang diperlukan saja

Hanya bergantung pada modul library yang benar-benar Anda perlukan. Misalnya, kode berikut akan menambahkan dependensi pada modul library ExoPlayer, DASH, dan UI, karena mungkin diperlukan untuk aplikasi yang hanya memutar konten DASH:

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

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

Mengaktifkan penyingkatan kode dan resource

Anda harus mengaktifkan penyingkatan kode dan resource untuk build rilis aplikasi. ExoPlayer disusun dengan cara yang memungkinkan penyingkatan kode untuk menghapus fungsionalitas yang tidak digunakan secara efektif. Misalnya, untuk aplikasi yang memutar konten DASH, kontribusi ExoPlayer terhadap ukuran APK dapat dikurangi sekitar 40% dengan mengaktifkan penyingkatan kode.

Baca Menyingkat, meng-obfuscate, dan mengoptimalkan aplikasi untuk mempelajari cara mengaktifkan penyingkatan kode dan resource.

Menentukan perender yang diperlukan aplikasi Anda

Secara default, perender pemutar akan dibuat menggunakan DefaultRenderersFactory. DefaultRenderersFactory bergantung pada semua implementasi Renderer yang disediakan di library ExoPlayer, dan akibatnya tidak satu pun dari implementasi tersebut yang akan dihapus dengan penyingkatan kode. Jika mengetahui bahwa aplikasi Anda hanya memerlukan subset perender, Anda dapat menentukan RenderersFactory Anda sendiri. Misalnya, aplikasi yang hanya memutar audio dapat menentukan factory seperti ini saat membuat instance instance 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();

Hal ini akan memungkinkan implementasi Renderer lain dihapus dengan penyingkatan kode. Dalam contoh khusus ini, perender video dan metadata dihapus (yang berarti subtitel atau metadata in-stream (misalnya ICY) tidak akan diproses atau dimunculkan oleh pemutar).

Menentukan ekstraktor yang diperlukan aplikasi Anda

Secara default, pemutar membuat instance Extractor untuk memutar media progresif menggunakan DefaultExtractorsFactory. DefaultExtractorsFactory bergantung pada semua implementasi Extractor yang disediakan di library ExoPlayer, dan akibatnya tidak satu pun dari implementasi tersebut yang akan dihapus dengan penyingkatan kode. Jika Anda mengetahui bahwa aplikasi hanya perlu memutar sejumlah kecil format container, atau tidak memutar media progresif sama sekali, Anda dapat menentukan ExtractorsFactory Anda sendiri. Misalnya, aplikasi yang hanya perlu memutar file mp4 dapat menyediakan factory seperti:

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

Hal ini akan memungkinkan implementasi Extractor lain dihapus dengan penyingkatan kode, yang dapat menghasilkan pengurangan ukuran yang signifikan.

Jika aplikasi tidak memutar konten progresif sama sekali, Anda harus meneruskan ExtractorsFactory.EMPTY ke konstruktor DefaultMediaSourceFactory, lalu meneruskan mediaSourceFactory tersebut ke konstruktor ExoPlayer.Builder.

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

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

Pembuatan instance MediaSource kustom

Jika aplikasi Anda menggunakan MediaSource.Factory kustom dan Anda ingin DefaultMediaSourceFactory dihapus dengan stripping kode, Anda harus meneruskan MediaSource.Factory langsung ke konstruktor ExoPlayer.Builder.

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

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

Jika aplikasi menggunakan MediaSource secara langsung, bukan MediaItem, Anda harus meneruskan MediaSource.Factory.UNSUPPORTED ke konstruktor ExoPlayer.Builder, untuk memastikan DefaultMediaSourceFactory dan DefaultExtractorsFactory dapat dihapus oleh penyingkatan kode.

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