# Guía Rápida de Instalación (2026)

## ⚡ Instalación Rápida por Navegador

### 🦊 Firefox

**Opción recomendada: Complemento temporal**
```bash
1. Abre Firefox
2. about:debugging#/runtime/this-firefox
3. "Cargar complemento temporal" → selecciona manifest.json
```
✅ Funciona inmediatamente  
⚠️ Se desinstala al cerrar Firefox

**Opción alternativa: Firefox Developer Edition (instalación permanente)**
```bash
1. Descarga Firefox Developer: https://www.mozilla.org/firefox/developer/
2. about:config → xpinstall.signatures.required → false
3. ./build.sh  # Empaquetar
4. Arrastra dist/ca-archive-3.0.0.xpi a Firefox
```
✅ Instalación permanente sin necesidad de firma AMO

---

### 🎨 Chrome / Edge / Brave

⚠️ **Chrome 127+ (junio 2024) bloqueó Manifest v2**

**Si usas Chrome:**
- ❌ Chrome ya no soporta esta extensión (requiere Manifest v3)
- ✅ **Alternativa:** Usa Firefox, Edge o Brave

**Si usas Edge o Brave (RECOMENDADO):**
```bash
1. edge://extensions/  (o brave://extensions/)
2. Activa "Modo de desarrollador"
3. "Cargar extensión sin empaquetar"
4. Selecciona carpeta: /home/ale/projects/firefox/ca-archive
```
✅ Funciona en Edge/Brave (soporte v2 hasta ~2025-2026)

---

## 🔧 Estados de Compatibilidad (2026)

| Navegador | Estado | Instalación |
|-----------|--------|-------------|
| **Firefox Release** | ⚠️ Requiere firma o temporal | `about:debugging` → temporal |
| **Firefox Developer** | ✅ Recomendado | Sin firma con `xpinstall.signatures.required=false` |
| **Firefox Nightly** | ✅ Funciona | Sin firma con `xpinstall.signatures.required=false` |
| **Chrome** | ❌ Bloqueado (v2) | No compatible desde Chrome 127+ |
| **Edge** | ✅ Funciona | Modo desarrollador |
| **Brave** | ✅ Funciona | Modo desarrollador |

---

## 🚨 Problemas Comunes

### "Add-on could not be installed because it is not signed" (Firefox)

**Causa:** Firefox Release no permite extensiones sin firma.

**Soluciones:**
1. ✅ **Carga temporal** (se borra al cerrar):
   - `about:debugging` → "Cargar complemento temporal"
   
2. ✅ **Firefox Developer Edition** (permanente):
   - Descargar: https://www.mozilla.org/firefox/developer/
   - `about:config` → `xpinstall.signatures.required` → `false`
   
3. ✅ **Firmar con AMO** (para distribución):
   ```bash
   # Obtener credenciales: https://addons.mozilla.org/developers/addon/api/key/
   # Configurar en: private-keys/firefox-amo-credentials.json
   ./build.sh --sign
   ```

### "Manifest version 2 is deprecated/not supported" (Chrome)

**Causa:** Chrome 127+ bloqueó Manifest v2 (junio 2024).

**Soluciones:**
1. ✅ **Usa Firefox** (mejor opción):
   - Firefox soporta Manifest v2 indefinidamente
   - Ver instrucciones arriba
   
2. ✅ **Usa Edge o Brave** (temporal):
   - Soportan Manifest v2 hasta ~2025-2026
   - Instalar en modo desarrollador
   
3. ❌ **Migrar a Manifest v3**:
   - No disponible aún (requiere reescritura)
   - Incompatible con sql.js (necesita `'unsafe-eval'`)

---

## 📦 Construcción de Paquetes

### Empaquetar sin firma
```bash
./build.sh
```
Genera: `dist/ca-archive-3.0.0.xpi` y `dist/ca-archive-3.0.0.zip`

### Empaquetar con firma (requiere configuración AMO)
```bash
./build.sh --sign
```

### Solo Chrome firmado con CRX
```bash
./build.sh --chrome-only
```

---

## 🔍 Verificación

### ¿Se instaló correctamente?

✅ **Debe aparecer:**
- Icono de la extensión en barra de herramientas
- Click en icono abre página del catálogo
- Primera carga muestra: "Loading database for the first time..."

❌ **Si no funciona:**
1. Abrir consola: `F12` → tab "Console"
2. Buscar errores (líneas rojas)
3. Ver [TROUBLESHOOTING.md](TROUBLESHOOTING.md)

### Verificar base de datos
```bash
ls -lh content/db/*.sqlite
# Debe mostrar: ca-archive-19030501.sqlite (~50MB)
```

---

## 📚 Documentación Completa

- **Instalación detallada:** [INSTALL.md](INSTALL.md)
- **Solución de problemas:** [TROUBLESHOOTING.md](TROUBLESHOOTING.md)
- **Firma AMO/Chrome:** [SIGNING.md](SIGNING.md)
- **Migración desde v2:** [MIGRATION.md](MIGRATION.md)

---

## 🆘 Ayuda Rápida

**No instala en Firefox:**
→ [TROUBLESHOOTING.md#firefox-add-on-could-not-be-installed](TROUBLESHOOTING.md#firefox-add-on-could-not-be-installed-because-it-is-not-signed-sin-poder-deshabilitar-firma)

**Chrome rechaza manifest:**
→ [TROUBLESHOOTING.md#chrome-manifest-version-2](TROUBLESHOOTING.md#chrome-manifest-version-2-is-deprecated-o-not-supported)

**Base de datos no carga:**
→ [TROUBLESHOOTING.md#loading-database](TROUBLESHOOTING.md#loading-database-for-the-first-time-se-queda-cargando)

**Otros problemas:**
→ [TROUBLESHOOTING.md](TROUBLESHOOTING.md)

---

**Fecha:** Febrero 2026  
**Versión:** 3.0.0  
**Última actualización:** Estado de compatibilidad Chrome/Firefox actualizado
