169 líneas
4.7 KiB
Markdown
169 líneas
4.7 KiB
Markdown
# 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
|