This folder contains prebuilt AARs that app/build.gradle.kts picks up automatically (fileTree("libs") { include("*.aar") }):
| File | Module | Purpose |
|---|---|---|
lib-decoder-ffmpeg-release.aar |
androidx.media3:lib-decoder-ffmpeg |
Software audio decoders (AC3/E-AC3/DTS/TrueHD and more) |
lib-decoder-av1-release.aar |
androidx.media3:lib-decoder-av1 |
Software AV1 video decoder (dav1d) |
lib-dovi-release.aar |
:dovi (this repository) |
Dolby Vision Profile 7 → 8.1 conversion (libdovi_bridge.so: JNI bridge + libdovi) |
The AARs must be built from the same Media3 version as media3 in gradle/libs.versions.toml (currently 1.9.0).
Rebuild them when Media3 is updated. Media3 1.9.0 requires NDK 27.0.12077973, FFmpeg branch release/6.0.
The AAR holds libdovi_bridge.so: the JNI bridge used by DoviBridge and the static
libdovi built from the official
quietvoid/dovi_tool repository (tag libdovi-3.3.2, set in dovi/build.gradle.kts).
The :dovi module is not part of the normal build: the app, the tests and CI use the AAR from this folder and need
neither NDK nor Rust. Without the AAR the app still builds; the "P7 → P8.1" option is then hidden.
Requirements: Android SDK with NDK 27.0.12077973 and CMake 3.22.1 (Android Studio → SDK Manager → SDK Tools),
Rust via rustup, git, bash (Linux, macOS or WSL).
./gradlew -Pdovi=true -PdoviAbis=arm64-v8a,armeabi-v7a,x86_64,x86 :dovi:assembleReleaseThe task clones dovi_tool at the tag into dovi/build/, builds libdovi.a for each ABI with
cargo rustc --crate-type staticlib --features capi (dovi/build_libdovi.sh, the Rust targets are added with
rustup target add), builds the bridge with CMake and copies the result to app/libs/lib-dovi-release.aar.
Commit the AAR. ABIs default to arm64-v8a,armeabi-v7a; for an emulator add x86:
-PdoviAbis=arm64-v8a,armeabi-v7a,x86_64,x86.
When updating libdovi, change the tag in dovi/build.gradle.kts and regenerate
dovi/src/main/cpp/include/libdovi/rpu_parser.h for that tag (cargo install cargo-c, then
cargo cbuild --release --features capi in dovi_tool/dolby_vision, the header is under target/).
Licenses: libdovi is MIT (© quietvoid); the bridge and DoviExtractorWrapper / DoviConvertingTrackOutput /
BufferedTransformingTrackOutput are ported from edde746/plezy (GPL-3.0).
AAR содержит libdovi_bridge.so: JNI-мост для DoviBridge и статическую
libdovi, собранную из официального репозитория
quietvoid/dovi_tool (тег libdovi-3.3.2, задан в dovi/build.gradle.kts).
Модуль :dovi не входит в обычную сборку: приложение, тесты и CI берут готовый AAR из этой папки, NDK и Rust им не
нужны. Без AAR приложение тоже собирается, просто пункт «P7 → P8.1» в настройках скрыт.
Нужно: Android SDK с NDK 27.0.12077973 и CMake 3.22.1 (Android Studio → SDK Manager → SDK Tools),
Rust через rustup, git, bash (Linux, macOS или WSL).
./gradlew -Pdovi=true -PdoviAbis=arm64-v8a,armeabi-v7a,x86_64,x86 :dovi:assembleReleaseЗадача клонирует dovi_tool нужного тега в dovi/build/, собирает libdovi.a под каждый ABI командой
cargo rustc --crate-type staticlib --features capi (dovi/build_libdovi.sh, Rust-таргеты добавляются через
rustup target add), собирает мост через CMake и копирует результат в app/libs/lib-dovi-release.aar.
AAR нужно закоммитить. По умолчанию ABI arm64-v8a,armeabi-v7a; для эмулятора добавьте x86:
-PdoviAbis=arm64-v8a,armeabi-v7a,x86_64,x86.
При обновлении libdovi поменяйте тег в dovi/build.gradle.kts и перегенерируйте
dovi/src/main/cpp/include/libdovi/rpu_parser.h для этого тега (cargo install cargo-c, затем
cargo cbuild --release --features capi в dovi_tool/dolby_vision, заголовок появится в target/).
Лицензии: libdovi — MIT (© quietvoid); мост и DoviExtractorWrapper / DoviConvertingTrackOutput /
BufferedTransformingTrackOutput перенесены из edde746/plezy (GPL-3.0).
The binary ffmpeg extension was built with the following decoders:
ENABLED_DECODERS=(vorbis opus flac alac pcm_mulaw pcm_alaw mp3 amrnb amrwb aac ac3 eac3 dca mlp truehd)
Complete build instructions:
To assemble .aar:
./gradlew :lib-decoder-ffmpeg:assembleRelease
./gradlew :lib-decoder-av1:assembleRelease
Если у вас Linux, это идеально подходит для сборки SW декодеров Media3 в AAR.
Это пошаговая инструкция на русском языке (подойдёт для Debian/Mint/Ubuntu).
Вам понадобятся:
- Git (для скачивания исходников).
- Android NDK (для компиляции C++ кода).
- CMake и Ninja (системы сборки).
- Nasm (для сборки dav1d/AV1).
- Meson (для сборки dav1d).
Откройте терминал и установите необходимые пакеты:
sudo apt update
sudo apt install git cmake ninja-build nasm python3-pip
pip3 install mesonПроверьте:
meson --versionДолжно вывести версию (например, 1.10.1). Если выдало ошибку,
выполните в терминале: export PATH="$HOME/.local/bin:$PATH" и проверьте снова.
Если meson все равно не находится, попробуйте установить его системно через apt (но там может быть старая версия):
sudo apt install meson. Но лучше использовать pip-версию с исправленным PATH.
Нам нужно скачать исходники androidx.media3 версии 1.9.0, которую мы используем в проекте.
-
Создайте рабочую папку:
mkdir media3-build cd media3-build -
Клонируйте репозиторий Media3:
git clone https://github.com/androidx/media.git cd media -
Переключитесь на тег нужной версии (например,
1.9.0):git checkout 1.9.0
-
Скачайте NDK (Требуется
27.0.12077973- это прописано вandroid.ndkVersionвнутри Media3). Лучший вариант установить NDK 27 (он будет лежать, например, в~/Android/Sdk/ndk/27.0.12077973):- Откройте Android Studio -> SDK Manager -> SDK Tools.
- Поставьте галочку "Show Package Details".
- Найдите NDK (Side by side) и выберите версию 27.0.12077973.
- Нажмите Apply.
-
Задайте переменную окружения
NDK_PATH:NDK_PATH="$HOME/Android/Sdk/ndk/27.0.12077973" # Проверьте путь!
-
Задайте платформу хоста:
HOST_PLATFORM="linux-x86_64" -
Установите версию ABI для нативного кода (она равна minSdk и не должна превышать его):
ANDROID_ABI=21
-
Установите следующую переменную оболочки:
FFMPEG_MODULE_PATH="$(pwd)/libraries/decoder_ffmpeg/src/main"
-
Перейдите в папку модуля FFmpeg:
cd "${FFMPEG_MODULE_PATH}/jni"
-
Скачайте исходники FFmpeg (ветка
release/6.0!!!):git clone git://source.ffmpeg.org/ffmpeg cd ffmpeg git checkout release/6.0 cd ..
-
Настройте список аудио кодеков:
ENABLED_DECODERS=(vorbis opus flac alac pcm_mulaw pcm_alaw mp3 amrnb amrwb aac ac3 eac3 dca mlp truehd)
Примечание:
dca— это DTS. -
Запустите скрипт сборки (это займет время):
# Мы в libraries/decoder_ffmpeg/src/main/jni # cd "${FFMPEG_MODULE_PATH}/jni" ./build_ffmpeg.sh \ "$(pwd)/.." \ "${NDK_PATH}" \ "${HOST_PLATFORM}" \ ${ANDROID_ABI} \ "${ENABLED_DECODERS[@]}"
(Здесь
${ANDROID_ABI}=21— это минимальный API Level,$(pwd)/..— путь к модулю).Если скрипт отработает успешно, в папке
ffmpegпоявятся папкаandroid-libs.
-
Вернитесь в корень репозитория
media:cd ../../../../../ -
Перейдите в папку модуля AV1:
cd libraries/decoder_av1/src/main/jni -
Скачайте
cpu_features:git clone https://github.com/google/cpu_features
-
Скачайте
dav1d:git clone https://code.videolan.org/videolan/dav1d.git
-
Запустите скрипт сборки:
./build_dav1d.sh \ "$(pwd)/.." \ "${NDK_PATH}" \ "${HOST_PLATFORM}"
Если скрипт отработает успешно, в этой же папке появятся папка
nativelib.
Теперь, когда нативные библиотеки (.so / .a) собраны, нужно упаковать их в Android Archive (.aar) с помощью Gradle.
-
Вернитесь в самый корень проекта
media:cd ../../../../../ -
Создайте файл
local.propertiesи укажите путь к SDK и NDK (если их нет в переменных среды):sdk.dir=/home/ваш_юзер/Android/Sdk ndk.dir=/home/ваш_юзер/Android/Sdk/ndk/27.0.12077973
-
Запустите сборку AAR для FFmpeg:
./gradlew :lib-decoder-ffmpeg:assembleRelease
-
Запустите сборку AAR для AV1:
./gradlew :lib-decoder-av1:assembleRelease
После успешной сборки файлы .aar будут лежать в:
libraries/decoder_ffmpeg/buildout/outputs/aar/libraries/decoder_av1/buildout/outputs/aar/
- Скопируйте их в папку
libsпроектаDDD Video Player. - Переименуйте их для удобства (например,
lib-decoder-ffmpeg-release.aar).
- В
libs.versions.tomlустановите версиюmedia3точно такую же, какую вы скомпилили (например,1.9.0). - В
build.gradle.ktsубедитесь, что подключены AAR и исключены конфликтующие модули (если они есть).
Помните что версия из которой сделали AAR и модулей media3 должны совпадать!