Compilación desde el código fuente

Contenido

  1. Requisitos
  2. Compilación rápida
  3. Si ya clonó sin --recursive
  4. Estructura del proyecto
  5. Pruebas
  6. Paquetes de versión
  7. Pruebas sin hardware (tools/emu)
  8. Dependencias

Requisitos

  • Rust (stable, 1.90 o posterior) mediante rustup
  • Visual Studio 2022 o posterior (o sus Build Tools) con la carga de trabajo “Desarrollo para el escritorio con C++”: las bibliotecas en C (BTstack, los códecs) se compilan con MSVC
  • Node.js 22 y pnpm para la interfaz (corepack enable proporciona pnpm)
  • Git (para los submódulos)
  • PowerShell 7 (pwsh) para build.ps1 / build.bat (winget install Microsoft.PowerShell)
  • Para compilaciones ARM64: el componente de Visual Studio “MSVC v143 - VS 2022 C++ ARM64 build tools” y, en un PC x64, “C++ Clang Compiler for Windows” (ring, de rustls, ensambla su código ARM64 con clang; installer/build-release.ps1 encuentra el clang de Visual Studio por sí mismo), y rustup target add aarch64-pc-windows-msvc

Compilación rápida 

git clone --recursive https://github.com/SeiyaFunaokaJP/A2DP-Windows-Bridge.git
cd A2DP-Windows-Bridge
pwsh ./build.ps1

O haga doble clic en build.bat en el Explorador: ejecuta build.ps1 y espera una tecla al final (build.bat -Test pasa las opciones). build.ps1 primero comprueba que Rust, Node.js, pnpm y los submódulos estén presentes, ejecuta pnpm install si falta node_modules, compila la página de la ventana y después los tres programas en target/release/: a2dpwb-core.exe (el núcleo residente: Bluetooth, audio, bandeja), a2dpwb.exe (la ventana) y a2dpwb-driver.exe (el auxiliar elevado que asigna / restaura el controlador WinUSB). Mantenga los tres en una misma carpeta; a2dpwb-core.exe --cli transmite sin la ventana.

Opciones: -Debug (perfil de desarrollo, target/debug/), -Test (después, las comprobaciones de «Pruebas»), -Decoder (también la herramienta de decodificación), -Emu (también la prueba sin hardware), -Release -Arch x64|arm64 (solo el script de versión; consulte «Paquetes de versión»).

Paso a paso (lo que hace build.ps1; la página de la ventana debe compilarse antes que a2dpwb.exe, que la incrusta):

cargo build --release -p a2dpwb-core-exe -p a2dpwb-driver
cd app/src/ui
pnpm install --frozen-lockfile
pnpm build
cd ../../..
cargo build --release -p a2dpwb-ui

Si ya clonó sin --recursive 

git submodule update --init --recursive

Estructura del proyecto 

A2DP-Windows-Bridge/
├── app/
│   ├── src/
│   │   ├── core/           a2dpwb-core.exe: núcleo residente, bandeja, servidor IPC, --cli
│   │   ├── ui/             a2dpwb.exe: Tauri 2 + SolidJS (pnpm dev la ejecuta en un navegador con un núcleo simulado)
│   │   ├── driver/         a2dpwb-driver.exe: asignar / restaurar WinUSB (elevado)
│   │   └── crates/         Bibliotecas: btstack-sys, hci-transport, bt-host, codec, los crates -sys de los códecs,
│   │                       pipeline, audio-capture, win-sys, core (a2dpwb-core), ipc, le-audio, lc3-sys
│   ├── lang/               Localización (en.json es el original; tools/check_lang.py comprueba los demás)
│   └── resources/          Icono y manifiesto
├── Cargo.toml              Workspace de Cargo
├── installer/              Script de versión, hooks de NSIS, notas del actualizador (installer/README.md)
├── compat/                 Encabezados de compatibilidad MSVC para el código de AOSP
├── docs/                   Documentación (este sitio) y el documento de diseño (v2-design.md)
├── extern/                 Bibliotecas de terceros en C (submódulos de git)
│   ├── btstack/            Pila Bluetooth BTstack
│   ├── libldac/            Codificador LDAC de AOSP
│   ├── libopenaptx/        Codificador aptX / aptX HD / aptX LL
│   ├── fdk-aac/            Codificador AAC de Fraunhofer
│   ├── lhdcv5-enc/         Codificador LHDC V5
│   └── opus/               libopus (codificador Opus)
└── tools/
    ├── a2dp_decode/        a2dpwb_decode: comprueba / decodifica el flujo multimedia de una captura HCI (.pklg)
    ├── emu/                Prueba de extremo a extremo frente a un receptor Bluetooth virtual (Python)
    └── linux_sink/         a2dpwb_sink: receptor A2DP de medición en Linux (Python, Bumble)

Pruebas 

cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings
cd app/src/ui && pnpm exec tsc --noEmit && pnpm exec vitest run
python tools/check_lang.py

Paquetes de versión 

pwsh installer/build-release.ps1 -Arch x64

genera en target/dist el instalador (A2DPWB-<version>-win64-setup.exe), el zip portable y el manifiesto del actualizador. La firma de las actualizaciones desde la aplicación y los demás detalles están en installer/README.md.

Pruebas sin hardware (tools/emu)

tools/emu transmite todos los códecs desde A2DPWB a un receptor Bluetooth virtual en el mismo PC, sin adaptador ni auriculares. Solo funciona en Windows y necesita Python 3.11 o posterior y CMake (incluido con Visual Studio) para la herramienta de decodificación.

python tools/emu/setup_env.py                       # una vez: crea tools/emu/.venv con paquetes de versión fija
cmake -S tools/a2dp_decode -B build/a2dp_decode     # una vez: la herramienta de decodificación
cmake --build build/a2dp_decode --config Release
cargo build --release -p a2dpwb-core-exe
python tools/emu/run_test.py                        # unos 35 s para todos los códecs

Cómo funciona:

  • emu_sink.py ejecuta dos controladores virtuales de Bumble sobre un enlace dentro del proceso. Uno se ofrece como H4 por TCP (127.0.0.1) para A2DPWB. El otro lo usa un receptor A2DP de Bumble que ofrece SBC, AAC, aptX, aptX HD, aptX LL y LDAC, y que registra su tráfico HCI.
  • run_test.py ejecuta a2dpwb-core.exe --cli para cada códec con opciones de desarrollo: --hci-tcp (controlador virtual en lugar de WinUSB), --test-tone (1 kHz a la izquierda / 1.5 kHz a la derecha en lugar del audio del sistema), --duration, --hci-capture. La variable de entorno A2DPWB_CONFIG_DIR hace que A2DPWB use una carpeta de configuración aparte, de modo que el emparejamiento con el receptor virtual nunca toca sus claves de enlace reales.
  • Después, ambas capturas HCI se comprueban con a2dpwb_decode (la del receptor con --received).

Un códec supera la prueba cuando se cumple todo esto:

  • se negoció el códec solicitado
  • a2dpwb_decode no encuentra problemas ni en el lado emisor ni en el receptor
  • el receptor recibió todos los paquetes multimedia y tramas que envió A2DPWB, y se envió al menos el 90 % de la duración de audio solicitada
  • salvo en LDAC (sin decodificador de código abierto): el audio decodificado es idéntico en ambos lados y es el tono de prueba
Opción Descripción
--codecs sbc aac ... Probar solo estos códecs (sbc aac aptx aptxhd aptxll ldac, predeterminado: todos)
--duration <s> Segundos de transmisión por códec (predeterminado 5)
--max-packet <bytes> Se pasa a A2DPWB (tamaño máximo del paquete multimedia, consulte Uso)
--a2dpwb <exe> El núcleo que se prueba (predeterminado target/release/a2dpwb-core.exe)
--decoder <exe> La herramienta de decodificación (predeterminado build/a2dp_decode/Release/a2dpwb_decode.exe)
--out <dir> Carpeta de salida (predeterminado tools/emu/out)

Para cada códec, tools/emu/out/<codec>/ contiene las capturas (a2dpwb.pklg, sink.pklg), los registros, los informes de a2dpwb_decode y los archivos WAV decodificados. El código de salida es 0 cuando todos los códecs superan la prueba.

El enlace virtual no tiene radio: comprueba la codificación, la paquetización, la señalización AVDTP / L2CAP y la interoperabilidad con una pila Bluetooth independiente (Bumble), pero no las condiciones de radio, la temporización en hardware real ni cómo reproducen el audio unos auriculares reales. Los paquetes de Bumble son solo herramientas de prueba y no forman parte de A2DPWB (consulte THIRD_PARTY_LICENSES.md).

emu_vhci.py hace lo mismo con la pila Bluetooth de Linux: en Linux conecta un adaptador virtual a BlueZ a través de /dev/vhci, que el receptor de medición tools/linux_sink toma después como si fuera un adaptador real; así se puede probar sin hardware, opcionalmente con paquetes multimedia perdidos o retenidos (--drop, --stall). Consulte tools/linux_sink/README.md.

Dependencias

Las bibliotecas en C son submódulos de git; Cargo y pnpm descargan los crates de Rust y los paquetes npm de la interfaz (versiones fijadas en Cargo.lock y app/src/ui/pnpm-lock.yaml; cargo deny check comprueba sus licencias).

Biblioteca Método Versión fijada Licencia
BTstack submódulo de git v1.8.1-6-g5bc5cbdbe Licencia de BTstack (tipo BSD-3-Clause con una cláusula no comercial)
Códec SBC de Bluedroid codificador portado a Rust; el decodificador (pruebas, herramientas), de la copia incluida en BTstack la de BTstack Apache-2.0
rijndael incluido en BTstack (3rd-party/rijndael) la de BTstack Dominio público
liblc3 (lc3-google) incluido en BTstack (3rd-party/lc3-google) la de BTstack Apache-2.0
micro-ecc incluido en BTstack (3rd-party/micro-ecc) la de BTstack BSD-2-Clause
libldac (AOSP) submódulo de git android-15.0.0_r36-4-geeee1a3 Apache-2.0
libopenaptx submódulo de git 0.2.0 (no actualizar) LGPL-2.1+
fdk-aac submódulo de git v2.0.3-158-gd8e6b1a FDK AAC License
Codificador LHDC V5 submódulo de git la fijada Apache-2.0
libopus submódulo de git v1.5.2 BSD-3-Clause
Tauri, SolidJS, crates de Rust Cargo / pnpm Cargo.lock, pnpm-lock.yaml MIT / Apache-2.0 y otras (licenses/rust-crates.txt en la versión publicada)

Como BTstack se enlaza en el programa, cualquier A2DPWB que compile solo puede usarse y redistribuirse con fines personales y no comerciales, aunque el código fuente de A2DPWB en sí tenga licencia dual Apache-2.0 o MIT.

Consulte THIRD_PARTY_LICENSES.md para ver todos los detalles de las licencias.