4.7 KiB
Guía Rápida de Instalación (2026)
⚡ Instalación Rápida por Navegador
🦊 Firefox
Opción recomendada: Complemento temporal
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)
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):
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:
-
✅ Carga temporal (se borra al cerrar):
about:debugging→ "Cargar complemento temporal"
-
✅ Firefox Developer Edition (permanente):
- Descargar: https://www.mozilla.org/firefox/developer/
about:config→xpinstall.signatures.required→false
-
✅ Firmar con AMO (para distribución):
# 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:
-
✅ Usa Firefox (mejor opción):
- Firefox soporta Manifest v2 indefinidamente
- Ver instrucciones arriba
-
✅ Usa Edge o Brave (temporal):
- Soportan Manifest v2 hasta ~2025-2026
- Instalar en modo desarrollador
-
❌ Migrar a Manifest v3:
- No disponible aún (requiere reescritura)
- Incompatible con sql.js (necesita
'unsafe-eval')
📦 Construcción de Paquetes
Empaquetar sin firma
./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)
./build.sh --sign
Solo Chrome firmado con CRX
./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:
- Abrir consola:
F12→ tab "Console" - Buscar errores (líneas rojas)
- Ver TROUBLESHOOTING.md
Verificar base de datos
ls -lh content/db/*.sqlite
# Debe mostrar: ca-archive-19030501.sqlite (~50MB)
📚 Documentación Completa
- Instalación detallada: INSTALL.md
- Solución de problemas: TROUBLESHOOTING.md
- Firma AMO/Chrome: SIGNING.md
- Migración desde v2: MIGRATION.md
🆘 Ayuda Rápida
No instala en Firefox: → TROUBLESHOOTING.md#firefox-add-on-could-not-be-installed
Chrome rechaza manifest: → TROUBLESHOOTING.md#chrome-manifest-version-2
Base de datos no carga: → TROUBLESHOOTING.md#loading-database
Otros problemas: → TROUBLESHOOTING.md
Fecha: Febrero 2026
Versión: 3.0.0
Última actualización: Estado de compatibilidad Chrome/Firefox actualizado