Signed-off-by: ale <ale@manalejandro.com>
Este commit está contenido en:
ale
2026-02-08 23:35:53 +01:00
padre 54807b9982
commit 4b66a91750
Se han modificado 19 ficheros con 2152 adiciones y 43 borrados

Ver fichero

@@ -13,19 +13,57 @@
La extensión se instalará hasta que cierres Firefox.
**Opción 2: Instalación permanente (requiere firmado)**
**Opción 2: Instalación sin firma (Firefox Developer/Nightly)**
1. Empaquetar la extensión:
Firefox normal NO permite instalar extensiones sin firma. Usa una de estas versiones:
1. **Firefox Developer Edition** o **Firefox Nightly**:
- Descarga: https://www.mozilla.org/firefox/developer/
- Descarga: https://www.mozilla.org/firefox/nightly/
2. **Deshabilitar verificación de firma:**
- Escribe en la barra: `about:config`
- Acepta el riesgo
- Busca: `xpinstall.signatures.required`
- Cambia a `false` (doble click)
3. **Instalar la extensión:**
```bash
# Empaquetar
cd /home/ale/projects/firefox/ca-archive
./build.sh
# O manualmente:
zip -r ca-archive-3.0.xpi manifest.json background.js content/ skin/ -x "*.git*" -x "*~"
```
4. Arrastra el archivo `.xpi` a Firefox
2. Firmar en addons.mozilla.org o usar Firefox Developer/Nightly con firma deshabilitada
**⚠️ IMPORTANTE:** Firefox normal (Release) NO acepta `xpinstall.signatures.required=false`. Solo funciona en Developer/Nightly/Unbranded.
**Opción 3: Instalación permanente con firma AMO (distribución)**
1. Obtener credenciales AMO: https://addons.mozilla.org/developers/addon/api/key/
2. Configurar en `private-keys/firefox-amo-credentials.json`
3. Firmar: `./build.sh --sign`
4. Instalar el `.xpi` firmado resultante
### Chrome / Edge / Brave
**Modo desarrollador (sin empaquetar):**
**⚠️ PROBLEMA CONOCIDO: Manifest v2 deprecado en Chrome**
Chrome está migrando a Manifest v3. Esta extensión usa Manifest v2 y puede:
- ✅ Funcionar en Edge/Brave (soporte extendido hasta ~2024-2025)
- ⚠️ Mostrar advertencias en Chrome
- ❌ Dejar de funcionar en Chrome 127+ (junio 2024)
**Si Chrome rechaza el manifest:**
1. Verifica la versión de Chrome: `chrome://settings/help`
2. Si es Chrome 127+, necesitas Manifest v3 (aún no implementado)
3. **Alternativa temporal:** Usa Microsoft Edge o Brave (soportan v2 más tiempo)
**Modo desarrollador (sin empaquetar) - Solo Chrome <127:**
1. Abre el navegador
2. Ve a: `chrome://extensions/` (o `edge://extensions/`)
@@ -35,13 +73,32 @@ La extensión se instalará hasta que cierres Firefox.
La extensión quedará instalada permanentemente en modo desarrollo.
**Errores comunes en Chrome:**
- **"Manifest version 2 is deprecated":**
- ⚠️ Solo advertencia (aún funciona)
- Chrome mostrará recordatorio hasta que migres a v3
- **"Manifest version 2 is not supported":**
- ❌ Chrome 127+ bloquea v2 completamente
- **Solución:** Usa Firefox, Edge o Brave
- **O espera:** Implementación de Manifest v3 (pendiente)
**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 "*~"
# Construir paquetes sin firmar
./build.sh
# O con firma (requiere configurar claves primero)
./scripts/generate-keys.sh # Primera vez
./build.sh --sign # Construir firmado
```
**Para distribución con firma**, ver [SIGNING.md](SIGNING.md).
## Verificación de Instalación
Después de instalar, deberías ver:
@@ -92,6 +149,19 @@ Después de instalar, deberías ver:
```
3. Actualiza las rutas en `content/db-webext.js`
### web-ext no disponible (para firma)
**Solución:**
```bash
# Instalar dependencias locales (recomendado)
npm install
# O instalación global (alternativa)
npm install -g web-ext
```
El script `build.sh` detecta automáticamente web-ext en `node_modules/.bin/`
## Para Usuarios Finales
### Instalar desde archivo .xpi/.zip