Guía de Operación de Migración de Datos
Esta página cubre el flujo de trabajo práctico para la migración de directorios de datos. Para detalles de implementación técnica, consulte Implementación Básica.
Encontrar Directorios de Datos Asociados a Aplicaciones
- Cambie a la pestaña "Directorios de Datos" en la ventana principal de AppPorts
- El panel izquierdo muestra todas las aplicaciones instaladas
- Haga clic en una aplicación; el panel derecho muestra sus directorios de datos asociados bajo
~/Library/
AppPorts escanea automáticamente los siguientes directorios, haciendo coincidir por Bundle ID o nombre de la aplicación:
| Ruta de Escaneo | Método de Coincidencia |
|---|---|
~/Library/Application Support/ | Bundle ID o nombre de app |
~/Library/Preferences/ | Bundle ID o nombre de app |
~/Library/Containers/ | Bundle ID |
~/Library/Group Containers/ | Bundle ID |
~/Library/Caches/ | Bundle ID o nombre de app |
~/Library/WebKit/ | Bundle ID |
~/Library/HTTPStorages/ | Bundle ID |
~/Library/Application Scripts/ | Bundle ID |
~/Library/Logs/ | Nombre de app |
~/Library/Saved Application State/ | Nombre de app |
Directorios de Herramientas (Dot-Folders)
AppPorts puede detectar automáticamente dot-folders creados por herramientas de desarrollo comunes en el directorio home del usuario:
- Cambie a la subpestaña "Directorios de Herramientas" en la pestaña Directorios de Datos
- La página lista todos los directorios de herramientas detectados con sus tamaños
- Cada directorio muestra un marcador de prioridad (recommended/optional) y estado
Para la lista completa soportada, consulte Detección de Directorios de Herramientas.
Operaciones de Migración
Migración de Directorio Individual
- Encuentre el directorio a migrar en la lista de directorios de datos
- Haga clic en el botón "Migrar" a la derecha
- AppPorts ejecuta los siguientes pasos:
- Copia el directorio al almacenamiento externo
- Escribe metadatos de enlace gestionado
- Elimina el directorio local original
- Crea un enlace simbólico
Re-firmado Automático
Cuando "Re-firmado automático" está habilitado en la configuración, la migración del directorio de datos activa automáticamente el firmado para la app asociada:
- Antes de la migración: Respalda la firma original de la ruta real externa de la app asociada (no el shell local)
- Después de la migración: Ejecuta re-firmado Ad-hoc en la app real externa (modo silencioso; los fallos no muestran diálogo)
Para apps vinculadas, AppPorts resuelve automáticamente la ruta real de la app detrás del shell Stub Portal o el enlace simbólico, asegurando que los cambios de firma se apliquen al paquete de aplicación real en lugar de un shell local inválido.
💡 No se requiere acción manual
Con el re-firmado automático habilitado, el flujo de trabajo de migración del directorio de datos está completamente automatizado. El respaldo de firma y el re-firmado ambos apuntan a la ruta real de la app — no se requiere intervención manual.
Contexto de Logs
Las operaciones de directorio de datos (migración, restauración, normalización, re-vinculación) incluyen automáticamente información de contexto de la app asociada en los logs:
| Campo | Descripción |
|---|---|
app_name | Nombre de la app asociada |
app_status | Estado de la app (Vinculada, Local, etc.) |
app_is_resigned | Si la app ha sido re-firmada |
app_bundle_id | Bundle ID de la app (leído de la ruta real) |
app_real_path | Ruta real externa de la app |
Estos campos ayudan a localizar problemas con más precisión al exportar paquetes de diagnóstico.
Migración por Lotes
- Marque múltiples directorios en la lista de directorios de herramientas
- Haga clic en el botón "Migración por Lotes" en la parte inferior
- AppPorts ejecuta la migración secuencialmente
💡 Recomendaciones de Prioridad
Los directorios de datos se clasifican en tres niveles de prioridad:
- Crítico (
critical): Debe funcionar después de la migración; afecta la funcionalidad principal de la aplicación - Recomendado (
recommended): Gran ahorro de espacio; alto beneficio de migración - Opcional (
optional): Tamaño pequeño o reconstruible
Se recomienda priorizar la migración de directorios marcados como "Recomendado".
Operaciones de Restauración
- Encuentre el directorio migrado en la lista de directorios de datos (estado: "Vinculado")
- Haga clic en el botón "Restaurar" a la derecha
- AppPorts ejecuta los siguientes pasos:
- Elimina el enlace simbólico local
- Copia los datos del almacenamiento externo de vuelta a local
- Elimina el directorio externo (mejor esfuerzo)
Manejo de Estados Anormales
Necesita Normalización
El directorio es gestionado por AppPorts, pero la ruta externa no está en la ubicación canónica. Haga clic en "Normalizar"; AppPorts moverá los datos externos a la ruta canónica y reconstruirá el enlace simbólico.
Necesita Revinculación
Los datos del almacenamiento externo aún existen, pero el enlace simbólico local se perdió. Haga clic en "Revincular"; AppPorts recreará el enlace simbólico.
Enlace Suave Existente
Un enlace simbólico creado por el usuario, no por AppPorts. Puede elegir "Tomar Control"; AppPorts escribirá metadatos de enlace gestionado y lo gestionará en adelante.
Vista de Árbol
Para directorios de datos que contienen subdirectorios (ej., múltiples directorios de aplicaciones bajo Application Support), AppPorts proporciona una vista de agrupación en árbol:
- El directorio principal muestra flechas de expandir/colapsar a la izquierda
- Los subdirectorios muestran indentación jerárquica
- Cada nodo muestra independientemente el tamaño y estado
- Las operaciones de migración/restauración pueden realizarse en subdirectorios individuales