# Guía de Instalación Rápida - Classic Add-ons Archive v3.0

## Para Desarrolladores / Testing Local

### Firefox

**Opción 1: Carga temporal (recomendado para desarrollo)**

1. Abre Firefox
2. Escribe en la barra de direcciones: `about:debugging#/runtime/this-firefox`
3. Click en "Cargar complemento temporal..."
4. Navega a la carpeta del proyecto y selecciona el archivo `manifest.json`

La extensión se instalará hasta que cierres Firefox.

**Opción 2: Instalación permanente (requiere firmado)**

1. Empaquetar la extensión:
   ```bash
   cd /home/ale/projects/firefox/ca-archive
   zip -r ca-archive-3.0.xpi manifest.json background.js content/ skin/ -x "*.git*" -x "*~"
   ```

2. Firmar en addons.mozilla.org o usar Firefox Developer/Nightly con firma deshabilitada

### Chrome / Edge / Brave

**Modo desarrollador (sin empaquetar):**

1. Abre el navegador
2. Ve a: `chrome://extensions/` (o `edge://extensions/`)
3. Activa el interruptor "Modo de desarrollador" (esquina superior derecha)
4. Click en "Cargar extensión sin empaquetar"
5. Selecciona la carpeta: `/home/ale/projects/firefox/ca-archive`

La extensión quedará instalada permanentemente en modo desarrollo.

**Empaquetar para distribución:**

```bash
cd /home/ale/projects/firefox/ca-archive
zip -r ca-archive-3.0.zip manifest.json background.js content/ skin/ -x "*.git*" -x "*~"
```

## Verificación de Instalación

Después de instalar, deberías ver:

1. ✅ Icono de la extensión en la barra de herramientas
2. ✅ Click en el icono abre la página del catálogo
3. ✅ Mensaje de carga de base de datos (primera vez)
4. ✅ Navegación funcionando (categorías, búsqueda, etc.)

## Troubleshooting

### La base de datos no carga

**Error:** "Loading database for the first time. Please wait..."

**Solución:**
1. Asegúrate de tener la carpeta `content/db/` con el archivo SQLite
2. Verifica que el archivo `ca-archive-19030501.sqlite` exista y no esté corrupto
3. Revisa la consola del navegador (`F12` > Console) para errores específicos

### El icono no aparece

**Solución:**
1. Refresca la página `about:debugging` o `chrome://extensions/`
2. Verifica que `manifest.json` tiene el campo `browser_action` correctamente
3. Revisa que las imágenes en `skin/button.png` existan

### Errores de carga de scripts

**Error:** "Failed to load script: ..."

**Solución:**
1. Verifica que todos los archivos JS estén en `content/`
2. Revisa la política CSP en `manifest.json`
3. Asegúrate de que `db-webext.js` se carga antes de `ca-archive.js`

### sql.js no carga

**Error:** "Could not load SQL engine"

**Solución:**
1. Verifica conexión a internet (se descarga desde CDN)
2. O descarga sql.js localmente:
   ```bash
   cd content/
   wget https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/sql-wasm.js
   wget https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/sql-wasm.wasm
   ```
3. Actualiza las rutas en `content/db-webext.js`

## Para Usuarios Finales

### Instalar desde archivo .xpi/.zip

**Firefox:**
1. Descarga el archivo `.xpi`
2. Arrastra y suelta en Firefox
3. Autoriza la instalación

**Chrome:**
1. Descarga el archivo `.zip`
2. Descomprime en una carpeta
3. Sigue los pasos de "Modo desarrollador" arriba

### Instalar desde stores (cuando esté publicado)

**Firefox Add-ons (AMO):**
- Visita: https://addons.mozilla.org/firefox/addon/ca-archive/
- Click en "Añadir a Firefox"

**Chrome Web Store:**
- Visita: [URL de Chrome Web Store]
- Click en "Añadir a Chrome"

## Desinstalación

### Firefox
1. `about:addons` > Extensiones
2. Busca "Classic Add-ons Archive"
3. Click en "..." > Eliminar

### Chrome
1. `chrome://extensions/`
2. Busca la extensión
3. Click en "Eliminar"

## Archivos Necesarios

Archivos mínimos para que funcione la extensión:

```
ca-archive/
├── manifest.json          ← REQUERIDO
├── background.js          ← REQUERIDO
├── content/
│   ├── ca-archive.html    ← REQUERIDO
│   ├── ca-archive.js      ← REQUERIDO
│   ├── db-webext.js       ← REQUERIDO
│   ├── db/
│   │   └── ca-archive-19030501.sqlite  ← REQUERIDO
│   ├── addon.js
│   ├── list.js
│   ├── versions.js
│   ├── tcloud.js
│   ├── about.js
│   └── epl.js
└── skin/
    ├── logo.png           ← REQUERIDO
    ├── button.png         ← REQUERIDO
    ├── ca-archive.css     ← REQUERIDO
    └── ...
```

## Siguientes Pasos

Una vez instalada y funcionando:

1. 📖 Lee [MIGRATION.md](MIGRATION.md) para entender los cambios
2. 🔧 Si eres desarrollador, revisa la arquitectura modernizada
3. 🐛 Reporta bugs en GitHub Issues
4. 🌟 Si te gusta, deja una valoración

## Soporte

- 📝 Documentación completa: [MIGRATION.md](MIGRATION.md)
- 🐛 Reportar problemas: https://github.com/JustOff/ca-archive/issues
- 💬 Discusiones: https://github.com/JustOff/ca-archive/discussions