correo/INSTALACION.md

112 lines
2.7 KiB
Markdown

# Guía de Instalación - Cliente de Correo
## Problema: Error de Tkinter en macOS
Si recibes el error `"macOS 26 (2602) or later required, have instead 16 (1602) !"`, significa que tu versión de Python está usando una versión antigua de Tcl/Tk.
## Solución: Instalar Python desde python.org
### Opción 1: Instalar Python 3.11 o superior (RECOMENDADO)
1. **Descargar Python**:
- Ve a https://www.python.org/downloads/
- Descarga Python 3.11 o superior para macOS
- Busca el instalador `.pkg` para macOS
2. **Instalar**:
- Abre el archivo `.pkg` descargado
- Sigue el asistente de instalación
- Acepta todas las opciones por defecto
3. **Verificar instalación**:
```bash
python3 --version
```
Deberías ver algo como: `Python 3.11.x` o superior
4. **Ejecutar el cliente**:
```bash
python3 cliente_correo.py
```
### Opción 2: Usar Homebrew (Alternativa)
Si tienes Homebrew instalado:
```bash
# Instalar Python con Homebrew
brew install python@3.11
# Verificar
python3 --version
# Ejecutar el cliente
python3 cliente_correo.py
```
### Opción 3: Usar pyenv (Para desarrolladores)
```bash
# Instalar pyenv
brew install pyenv
# Instalar Python 3.11
pyenv install 3.11.7
# Establecer como versión local
pyenv local 3.11.7
# Ejecutar el cliente
python cliente_correo.py
```
## Verificar que Tkinter funciona
Después de instalar Python actualizado, verifica que Tkinter funcione:
```bash
python3 -m tkinter
```
Esto debería abrir una ventana de prueba de Tkinter. Si ves la ventana, todo está bien.
## Notas Importantes
- **NO uses el Python que viene con macOS** (`/usr/bin/python`), ya que suele estar desactualizado
- Después de instalar Python desde python.org, usa siempre `python3` en lugar de `python`
- Si ya tienes múltiples versiones de Python, puedes verificar cuál estás usando con:
```bash
which python3
```
Debería mostrar algo como `/Library/Frameworks/Python.framework/...`
## Si aún tienes problemas
### Verificar la versión de Tcl/Tk:
```bash
python3 -c "import tkinter; print(tkinter.TkVersion)"
```
Debería mostrar `8.6` o superior.
### Reinstalar Python:
Si instalaste Python pero aún tienes problemas:
1. Desinstala Python antiguo
2. Descarga la última versión de python.org
3. Instala de nuevo
4. Abre una nueva terminal (importante)
5. Intenta ejecutar el cliente de nuevo
## Alternativas sin instalar Python
Si no puedes o no quieres instalar Python actualizado, puedo crear versiones alternativas:
1. **Cliente web**: Interfaz HTML que funciona en el navegador
2. **Cliente CLI**: Interfaz de línea de comandos sin GUI
3. **Cliente con PyQt5**: Requiere `pip install PyQt5`
Házmelo saber si necesitas alguna de estas alternativas.