push full db

Signed-off-by: ale <ale@manalejandro.com>
2026-02-08 23:35:53 +01:00
commit 4b66a91750
--- a/TROUBLESHOOTING.md
+++ b/TROUBLESHOOTING.md
@@ -2,7 +2,31 @@

 Esta guía te ayudará a resolver problemas comunes al usar Classic Add-ons Archive v3.0.

-## 📋 Índice
+## ⚠️ Problemas Actuales Conocidos (2026)
+
+### 🦊 Firefox: No instala sin firma
+**Problema:** Firefox Release NO permite instalar extensiones sin firmar, incluso cambiando `xpinstall.signatures.required=false`.
+
+**Solución rápida:**
+- ✅ Usa **Firefox Developer Edition** o **Nightly** (permiten deshabilitar firma)
+- ✅ O carga como complemento temporal: `about:debugging` > "Cargar complemento temporal"
+- ✅ O firma con AMO: `./build.sh --sign` (requiere credenciales AMO)
+
+[Ver solución detallada](#firefox-add-on-could-not-be-installed-because-it-is-not-signed-sin-poder-deshabilitar-firma)
+
+### 🎨 Chrome: Manifest no compatible
+**Problema:** Chrome 127+ (junio 2024) bloqueó Manifest v2. Esta extensión usa v2.
+
+**Solución rápida:**
+- ✅ Usa **Firefox** (mejor opción, soporte v2 indefinido)
+- ✅ O usa **Microsoft Edge** / **Brave** (soporte v2 hasta ~2025-2026)
+- ❌ Chrome ya no soporta Manifest v2 (requiere migración a v3, no disponible aún)
+
+[Ver solución detallada](#chrome-manifest-version-2-is-deprecated-o-not-supported)
+
+---
+
+## 📋 Índice Completo

 1. [Problemas de Instalación](#problemas-de-instalación)
 2. [Problemas con la Base de Datos](#problemas-con-la-base-de-datos)
@@ -89,6 +113,113 @@ Esta guía te ayudará a resolver problemas comunes al usar Classic Add-ons Arch
   - `about:debugging` > Cargar complemento temporal
   - Seleccionar `manifest.json` directamente

+### Firefox: "Add-on could not be installed because it is not signed" (sin poder deshabilitar firma)
+
+**Problema:** Firefox Release NO permite deshabilitar la verificación de firma desde Firefox 48+.
+
+**Causa:** 
+- `xpinstall.signatures.required=false` NO funciona en Firefox Release
+- Solo funciona en versiones Developer/Nightly/ESR Unbranded
+
+**Soluciones:**
+
+1. **Usar Firefox Developer Edition (RECOMENDADO):**
+   ```bash
+   # Descargar desde:
+   # https://www.mozilla.org/firefox/developer/
+   
+   # Luego en about:config:
+   xpinstall.signatures.required = false
+   ```
+
+2. **Usar Firefox Nightly:**
+   ```bash
+   # Descargar desde:
+   # https://www.mozilla.org/firefox/nightly/
+   
+   # Luego en about:config:
+   xpinstall.signatures.required = false
+   ```
+
+3. **Firmar en Mozilla AMO (para distribución):**
+   ```bash
+   # 1. Obtener credenciales:
+   # https://addons.mozilla.org/developers/addon/api/key/
+   
+   # 2. Configurar en:
+   # private-keys/firefox-amo-credentials.json
+   
+   # 3. Firmar:
+   ./build.sh --sign
+   ```
+
+4. **Carga temporal (limpia al cerrar Firefox):**
+   - `about:debugging#/runtime/this-firefox`
+   - Click "Cargar complemento temporal"
+   - Seleccionar `manifest.json`
+   - ⚠️ Se desinstala al cerrar Firefox
+
+### Chrome: "Manifest version 2 is deprecated" o "not supported"
+
+**Problema:** Chrome está deprecando/bloqueando Manifest v2.
+
+**Estado actual (febrero 2026):**
+- Chrome 127+ (junio 2024): v2 deshabilitado para nuevas extensiones
+- Chrome 136+ (2025): v2 puede estar completamente bloqueado
+- Edge/Brave: Soporte extendido hasta 2025-2026
+
+**Soluciones:**
+
+1. **Verificar versión de Chrome:**
+   ```
+   chrome://settings/help
+   ```
+
+2. **Si Chrome < 127 (solo advertencia):**
+   - ✅ La extensión funciona normalmente
+   - Ignora la advertencia de deprecación
+   - Instala en modo desarrollador normalmente
+
+3. **Si Chrome >= 127 (error de bloqueo):**
+   
+   **Opción A: Usar navegador compatible (RECOMENDADO)**
+   - Microsoft Edge: `edge://extensions/`
+   - Brave: `brave://extensions/`
+   - Ambos soportan Manifest v2 hasta ~2025-2026
+   
+   **Opción B: Usar Firefox**
+   - Firefox soporta Manifest v2 indefinidamente
+   - Mejor compatibilidad con esta extensión
+   
+   **Opción C: Esperar Manifest v3 (no disponible aún)**
+   - Estado: No implementado en esta extensión
+   - Requiere reescritura significativa:
+     - Service workers en lugar de background scripts
+     - Eliminar `webRequestBlocking`
+     - Eliminar `'unsafe-eval'` (conflicto con sql.js)
+   - Timeline: TBD
+
+4. **Workaround temporal (solo Chrome <140):**
+   
+   Algunos flags experimentales pueden ayudar:
+   ```
+   chrome://flags/#enable-mv2-extension-deprecation-warnings
+   ```
+   Cambiar a "Disabled" (solo retrasa advertencias, no evita bloqueo)
+
+**⚠️ IMPORTANTE:** 
+- Manifest v3 tiene limitaciones que dificultan esta extensión
+- sql.js requiere `'unsafe-eval'` (prohibido en v3)
+- Posibles soluciones v3: migrar a IndexedDB en lugar de sql.js
+
+### Chrome: "Could not load manifest"
+
+**Error completo:** `"manifest_version" key must be 3...`
+
+**Causa:** Chrome 127+ bloqueando Manifest v2
+
+**Solución:** Ver sección anterior "Manifest version 2 is deprecated"
+
 ---

 ## Problemas con la Base de Datos
@@ -533,9 +664,12 @@ if (DB.db) {

 - [Documentación Mozilla WebExtensions](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions)
 - [Chrome Extensions API](https://developer.chrome.com/docs/extensions/reference/)
+- [Chrome Manifest v2 to v3 Migration](https://developer.chrome.com/docs/extensions/develop/migrate)
 - [sql.js Documentation](https://sql.js.org/)
 - [Debugging WebExtensions (Firefox)](https://extensionworkshop.com/documentation/develop/debugging/)
 - [Debugging Chrome Extensions](https://developer.chrome.com/docs/extensions/mv2/tut_debugging/)
+- [Firefox Developer Edition Download](https://www.mozilla.org/firefox/developer/)
+- [AMO Signing API](https://addons-server.readthedocs.io/en/latest/topics/api/signing.html)

 ---