172 líneas
4.8 KiB
Markdown
172 líneas
4.8 KiB
Markdown
# Guía de Instalación Rápida - Classic Add-ons Archive v3.0
|
|
|
|
## Para Desarrolladores / Testing Local
|
|
|
|
### Firefox
|
|
|
|
**Opción 1: Carga temporal (recomendado para desarrollo)**
|
|
|
|
1. Abre Firefox
|
|
2. Escribe en la barra de direcciones: `about:debugging#/runtime/this-firefox`
|
|
3. Click en "Cargar complemento temporal..."
|
|
4. Navega a la carpeta del proyecto y selecciona el archivo `manifest.json`
|
|
|
|
La extensión se instalará hasta que cierres Firefox.
|
|
|
|
**Opción 2: Instalación permanente (requiere firmado)**
|
|
|
|
1. Empaquetar la extensión:
|
|
```bash
|
|
cd /home/ale/projects/firefox/ca-archive
|
|
zip -r ca-archive-3.0.xpi manifest.json background.js content/ skin/ -x "*.git*" -x "*~"
|
|
```
|
|
|
|
2. Firmar en addons.mozilla.org o usar Firefox Developer/Nightly con firma deshabilitada
|
|
|
|
### Chrome / Edge / Brave
|
|
|
|
**Modo desarrollador (sin empaquetar):**
|
|
|
|
1. Abre el navegador
|
|
2. Ve a: `chrome://extensions/` (o `edge://extensions/`)
|
|
3. Activa el interruptor "Modo de desarrollador" (esquina superior derecha)
|
|
4. Click en "Cargar extensión sin empaquetar"
|
|
5. Selecciona la carpeta: `/home/ale/projects/firefox/ca-archive`
|
|
|
|
La extensión quedará instalada permanentemente en modo desarrollo.
|
|
|
|
**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 "*~"
|
|
```
|
|
|
|
## Verificación de Instalación
|
|
|
|
Después de instalar, deberías ver:
|
|
|
|
1. ✅ Icono de la extensión en la barra de herramientas
|
|
2. ✅ Click en el icono abre la página del catálogo
|
|
3. ✅ Mensaje de carga de base de datos (primera vez)
|
|
4. ✅ Navegación funcionando (categorías, búsqueda, etc.)
|
|
|
|
## Troubleshooting
|
|
|
|
### La base de datos no carga
|
|
|
|
**Error:** "Loading database for the first time. Please wait..."
|
|
|
|
**Solución:**
|
|
1. Asegúrate de tener la carpeta `content/db/` con el archivo SQLite
|
|
2. Verifica que el archivo `ca-archive-19030501.sqlite` exista y no esté corrupto
|
|
3. Revisa la consola del navegador (`F12` > Console) para errores específicos
|
|
|
|
### El icono no aparece
|
|
|
|
**Solución:**
|
|
1. Refresca la página `about:debugging` o `chrome://extensions/`
|
|
2. Verifica que `manifest.json` tiene el campo `browser_action` correctamente
|
|
3. Revisa que las imágenes en `skin/button.png` existan
|
|
|
|
### Errores de carga de scripts
|
|
|
|
**Error:** "Failed to load script: ..."
|
|
|
|
**Solución:**
|
|
1. Verifica que todos los archivos JS estén en `content/`
|
|
2. Revisa la política CSP en `manifest.json`
|
|
3. Asegúrate de que `db-webext.js` se carga antes de `ca-archive.js`
|
|
|
|
### sql.js no carga
|
|
|
|
**Error:** "Could not load SQL engine"
|
|
|
|
**Solución:**
|
|
1. Verifica conexión a internet (se descarga desde CDN)
|
|
2. O descarga sql.js localmente:
|
|
```bash
|
|
cd content/
|
|
wget https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/sql-wasm.js
|
|
wget https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.8.0/sql-wasm.wasm
|
|
```
|
|
3. Actualiza las rutas en `content/db-webext.js`
|
|
|
|
## Para Usuarios Finales
|
|
|
|
### Instalar desde archivo .xpi/.zip
|
|
|
|
**Firefox:**
|
|
1. Descarga el archivo `.xpi`
|
|
2. Arrastra y suelta en Firefox
|
|
3. Autoriza la instalación
|
|
|
|
**Chrome:**
|
|
1. Descarga el archivo `.zip`
|
|
2. Descomprime en una carpeta
|
|
3. Sigue los pasos de "Modo desarrollador" arriba
|
|
|
|
### Instalar desde stores (cuando esté publicado)
|
|
|
|
**Firefox Add-ons (AMO):**
|
|
- Visita: https://addons.mozilla.org/firefox/addon/ca-archive/
|
|
- Click en "Añadir a Firefox"
|
|
|
|
**Chrome Web Store:**
|
|
- Visita: [URL de Chrome Web Store]
|
|
- Click en "Añadir a Chrome"
|
|
|
|
## Desinstalación
|
|
|
|
### Firefox
|
|
1. `about:addons` > Extensiones
|
|
2. Busca "Classic Add-ons Archive"
|
|
3. Click en "..." > Eliminar
|
|
|
|
### Chrome
|
|
1. `chrome://extensions/`
|
|
2. Busca la extensión
|
|
3. Click en "Eliminar"
|
|
|
|
## Archivos Necesarios
|
|
|
|
Archivos mínimos para que funcione la extensión:
|
|
|
|
```
|
|
ca-archive/
|
|
├── manifest.json ← REQUERIDO
|
|
├── background.js ← REQUERIDO
|
|
├── content/
|
|
│ ├── ca-archive.html ← REQUERIDO
|
|
│ ├── ca-archive.js ← REQUERIDO
|
|
│ ├── db-webext.js ← REQUERIDO
|
|
│ ├── db/
|
|
│ │ └── ca-archive-19030501.sqlite ← REQUERIDO
|
|
│ ├── addon.js
|
|
│ ├── list.js
|
|
│ ├── versions.js
|
|
│ ├── tcloud.js
|
|
│ ├── about.js
|
|
│ └── epl.js
|
|
└── skin/
|
|
├── logo.png ← REQUERIDO
|
|
├── button.png ← REQUERIDO
|
|
├── ca-archive.css ← REQUERIDO
|
|
└── ...
|
|
```
|
|
|
|
## Siguientes Pasos
|
|
|
|
Una vez instalada y funcionando:
|
|
|
|
1. 📖 Lee [MIGRATION.md](MIGRATION.md) para entender los cambios
|
|
2. 🔧 Si eres desarrollador, revisa la arquitectura modernizada
|
|
3. 🐛 Reporta bugs en GitHub Issues
|
|
4. 🌟 Si te gusta, deja una valoración
|
|
|
|
## Soporte
|
|
|
|
- 📝 Documentación completa: [MIGRATION.md](MIGRATION.md)
|
|
- 🐛 Reportar problemas: https://github.com/JustOff/ca-archive/issues
|
|
- 💬 Discusiones: https://github.com/JustOff/ca-archive/discussions
|