📜 INSTALLATION SCRIPTS - GUÍA¶

Scripts automatizados para instalar y verificar dependencias de AudioLab.

📦 SCRIPTS DISPONIBLES¶

Script	Plataformas	Tiempo	Propósito
`install_all_dependencies.ps1/sh`	Win, Unix, macOS	15-30 min	Instalación completa
`install_core_deps.ps1`	Windows	10-15 min	Solo core (más rápido)
`install_vcpkg_simple.ps1`	Windows	2-5 min	Solo setup de vcpkg
`verify_installation.ps1/sh`	Win, Unix, macOS	1-2 min	Verificar instalados
`list_installed.ps1`	Windows	< 1 min	Listar packages
`update_registry.ps1`	Windows	< 1 min	Actualizar tracking
`create_vcpkg_registry.ps1`	Windows	< 1 min	Crear registry inicial

🚀 INSTALL_ALL_DEPENDENCIES¶

Uso¶

Windows:

.\install_all_dependencies.ps1 [-SkipVcpkg] [-SkipPython] [-Force]

Unix/macOS:

./install_all_dependencies.sh

Opciones (PowerShell)¶

-SkipVcpkg     # Omitir vcpkg packages
-SkipPython    # Omitir Python tools
-Force         # No pedir confirmaciones

Qué Instala¶

1. vcpkg (si no existe):

git clone https://github.com/Microsoft/vcpkg.git external/vcpkg
cd external/vcpkg
./bootstrap-vcpkg.bat  # Windows
./bootstrap-vcpkg.sh   # Unix

2. vcpkg Packages (7): - fftw3 - eigen3 - libsndfile - catch2 - benchmark - fmt - spdlog

3. Python Tools (3): - black - pytest - sphinx

4. Actualiza Registry: Crea YAML files en _installed_registry/

Output Esperado¶

╔════════════════════════════════════════════╗
║  📦 AudioLab Dependency Installer          ║
╚════════════════════════════════════════════╝

🔍 Checking prerequisites...
  ✓ Git found
  ✓ Python found
  ✓ pip found

📦 Installing vcpkg...
  Cloning vcpkg...
  ✓ vcpkg cloned
  Bootstrapping vcpkg...
  ✓ vcpkg bootstrapped

📦 Installing vcpkg packages (7)...
  Installing fftw3...
  ✓ fftw3 installed
  Installing eigen3...
  ✓ eigen3 installed
  ... (5 more)

🐍 Installing Python tools (3)...
  Installing black...
  ✓ black installed
  ... (2 more)

📋 Updating registry...
  ✓ Registry updated

╔════════════════════════════════════════════╗
║  ✅ All dependencies installed             ║
╚════════════════════════════════════════════╝

⏱️  Total time: 18m 42s

💡 Next steps:
   1. Verify: .\verify_installation.ps1
   2. Build:  cd ..\..\03_02_build_infrastructure\03_02_03_build_scripts
              .\build.ps1

Troubleshooting¶

Error: Git not found

# Instalar Git
winget install Git.Git

Error: Python not found

# Instalar Python
winget install Python.Python.3.11

Error: vcpkg install fails

# Ver logs detallados
./external/vcpkg/vcpkg install fftw3:x64-windows --debug

⚡ INSTALL_CORE_DEPS¶

Uso¶

.\install_core_deps.ps1

Diferencia con install_all¶

install_all_dependencies: Instala TODO (vcpkg + Python + JUCE setup) install_core_deps: Solo vcpkg packages esenciales (más rápido)

Qué Instala¶

Solo vcpkg packages: - fftw3 - eigen3 - libsndfile - catch2 - benchmark - fmt - spdlog

NO instala: - ❌ Python tools (black, pytest, sphinx) - ❌ JUCE setup (asume ya está vendored)

Cuándo Usar¶

✅ Setup rápido para compilar
✅ CI/CD builds (Python ya instalado)
✅ Rebuild después de clean

✅ VERIFY_INSTALLATION¶

Uso¶

Windows:

.\verify_installation.ps1 [-Detailed]

Unix/macOS:

./verify_installation.sh

Qué Verifica¶

1. vcpkg packages:

vcpkg list | Select-String "fftw3|eigen3|libsndfile|catch2|benchmark|fmt|spdlog"

2. Python tools:

pip list | Select-String "black|pytest|sphinx"

3. Registry consistency:

# Compara registry YAMLs con instalaciones reales

4. CMake integration:

# Test find_package() para cada library

Output Esperado¶

✅ Todo OK:

╔════════════════════════════════════════════╗
║  ✅ AudioLab Dependency Verification       ║
╚════════════════════════════════════════════╝

🔍 Verifying vcpkg packages...
  ✓ fftw3 3.3.10 - Installed
  ✓ eigen3 3.4.1 - Installed
  ✓ libsndfile 1.2.0 - Installed
  ✓ catch2 3.4.0 - Installed
  ✓ benchmark 1.8.3 - Installed
  ✓ fmt 10.1.1 - Installed
  ✓ spdlog 1.12.0 - Installed

🔍 Verifying Python tools...
  ✓ black 23.9.1 - Installed
  ✓ pytest 7.4.2 - Installed
  ✓ sphinx 7.2.6 - Installed

🔍 Verifying registry...
  ✓ Registry matches installations

🔍 Verifying CMake integration...
  ✓ All packages findable by CMake

╔════════════════════════════════════════════╗
║  ✅ All dependencies verified              ║
╚════════════════════════════════════════════╝

❌ Con errores:

❌ fftw3 - NOT FOUND
💡 Fix: vcpkg install fftw3:x64-windows

❌ Registry out of sync
💡 Fix: .\update_registry.ps1

📋 LIST_INSTALLED¶

Uso¶

.\list_installed.ps1 [-Format Table|JSON|YAML]

Output¶

Table (default):

╔════════════════════════════════════════════╗
║  📦 Installed Dependencies                 ║
╚════════════════════════════════════════════╝

VCPKG PACKAGES:
┌────────────────┬──────────┬────────────────┐
│ Package        │ Version  │ Triplet        │
├────────────────┼──────────┼────────────────┤
│ fftw3          │ 3.3.10   │ x64-windows    │
│ eigen3         │ 3.4.1    │ x64-windows    │
│ libsndfile     │ 1.2.0    │ x64-windows    │
│ catch2         │ 3.4.0    │ x64-windows    │
│ benchmark      │ 1.8.3    │ x64-windows    │
│ fmt            │ 10.1.1   │ x64-windows    │
│ spdlog         │ 1.12.0   │ x64-windows    │
└────────────────┴──────────┴────────────────┘

PYTHON TOOLS:
┌────────────────┬──────────┐
│ Tool           │ Version  │
├────────────────┼──────────┤
│ black          │ 23.9.1   │
│ pytest         │ 7.4.2    │
│ sphinx         │ 7.2.6    │
└────────────────┴──────────┘

VENDORED:
┌────────────────┬──────────┬────────────┐
│ Library        │ Version  │ Size       │
├────────────────┼──────────┼────────────┤
│ JUCE           │ 7.0.9    │ 71 MB      │
└────────────────┴──────────┴────────────┘

🔄 UPDATE_REGISTRY¶

Uso¶

.\update_registry.ps1 [-Force]

Propósito¶

Sincroniza registry YAMLs con dependencias realmente instaladas.

Cuándo Usar¶

✅ Después de install manual: vcpkg install <pkg>
✅ Registry desactualizado
✅ Cambio de equipo (pull registry de git)

Qué Hace¶

Escanea vcpkg:
```
vcpkg list
```
Escanea Python:
```
pip list
```
Actualiza YAMLs:
Crea nuevos para packages instalados
Actualiza existentes con nueva info
Marca como "removed" los que no están

Output:

✓ Updated fftw3.yaml (version 3.3.9 → 3.3.10)
✓ Created eigen3.yaml (newly installed)
⚠️  Marked libpng.yaml as removed (not installed)

🎯 WORKFLOWS COMUNES¶

First-Time Setup¶

# 1. Install all
.\install_all_dependencies.ps1

# 2. Verify
.\verify_installation.ps1

# 3. Done! Build project
cd ..\..\03_02_build_infrastructure\03_02_03_build_scripts
.\build.ps1

Reinstall After Clean¶

# 1. Clean (si ya lo hiciste)
..\03_03_03_maintenance_scripts\clean_dependencies.ps1 -All

# 2. Install core (más rápido)
.\install_core_deps.ps1

# 3. Verify
.\verify_installation.ps1

Add Single Dependency¶

# 1. Install manually
vcpkg install new-lib:x64-windows

# 2. Update registry
.\update_registry.ps1

# 3. Verify
.\verify_installation.ps1

After Git Pull (Registry Changed)¶

# 1. See what changed
git diff 03_03_00_package_manifests/_installed_registry/

# 2. Install missing packages
.\install_all_dependencies.ps1

# 3. Verify
.\verify_installation.ps1

📚 RECURSOS¶

Main README: ../README.md
Cheat Sheet: ../DEPENDENCY_CHEAT_SHEET.md
Troubleshooting: ../03_03_09_troubleshooting/DEPENDENCY_TROUBLESHOOTING_GUIDE.md

Última actualización: 2025-10-09