80
INSTALL.md
80
INSTALL.md
@@ -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
|
||||
|
||||
Referencia en una nueva incidencia
Block a user