Funcionamiento de la migración de datos

La migración de datos de AppPorts mueve los directorios asociados a las apps a un disco externo para liberar espacio local. Usa dos estrategias según su ubicación:

Directorio	Estrategia	Motivo
`~/Library/Containers/`, `~/Library/Group Containers/`	Migración por montaje	El entorno aislado comprueba la ruta real resuelta y rechaza enlaces simbólicos que salen del contenedor
Otros subdirectorios de `~/Library/`, directorios de herramientas y carpetas personalizadas	Enlace simbólico	Es la opción más sencilla y no está sujeta a las restricciones del entorno aislado

Esta página explica la estrategia de enlaces simbólicos. Para la otra estrategia, consulte Migración por montaje.

Estrategia de enlaces simbólicos

Copiar todo el directorio local al disco externo.
Escribir el marcador de gestión .appports-link-metadata.plist en el directorio externo.
Renombrar el directorio local original como copia de seguridad oculta en el mismo volumen.
Crear en la ruta original un enlace simbólico que apunte a la copia externa.
Eliminar la copia de seguridad cuando el enlace se haya creado correctamente.

~/Library/Application Support/SomeApp
    → /Volumes/External/AppPortsData/SomeApp  （符号链接）

mermaid

flowchart TD
    A[Seleccionar directorio de datos] --> B{Comprobar permisos y protecciones}
    B -->|Fallo| Z[Detener]
    B -->|Correcto| C{Comprobar conflictos de destino}
    C -->|Marcador de gestión idéntico| D[Modo de recuperación automática]
    C -->|Conflicto con directorio real| Y[Detener e indicar el conflicto]
    C -->|Sin conflicto| E[Copiar al disco externo]
    D --> E
    E --> F[Escribir marcador de gestión]
    F --> G[Renombrar como copia de seguridad local]
    G -->|Fallo| H[Conservar copia externa y detener]
    G -->|Correcto| I[Crear enlace simbólico]
    I -->|Fallo| J[Restaurar copia local y conservar copia externa]
    I -->|Correcto| K[Eliminar copia de seguridad local]
    K -->|Correcto| L[Migración completada]
    K -->|Fallo| M[Migración completada con copia de seguridad conservada]

Marcador de gestión

El archivo .appports-link-metadata.plist del directorio externo indica que AppPorts lo gestiona:

Campo	Descripción
`schemaVersion`	Número de versión, actualmente 1
`managedBy`	`com.shimoko.AppPorts`
`sourcePath`	Ruta local original
`destinationPath`	Ruta de destino externa
`dataDirType`	Tipo de directorio de datos

Durante el análisis, distingue los enlaces creados por AppPorts de los creados por el usuario. También permite reanudar una migración interrumpida. La coincidencia es estricta: los cinco campos deben ser idénticos para reanudar un directorio gestionado. Si no, se considera un conflicto. Un tamaño similar nunca basta para asumir su gestión ni sobrescribirlo.

El reenlace y la normalización solo se aplican a directorios. No se vuelve a enlazar un archivo externo normal como si fuera un directorio.

Tipos de directorios de datos compatibles

Tipo	Ruta	Estrategia
`applicationSupport`	`~/Library/Application Support/`	Enlace simbólico
`preferences`	`~/Library/Preferences/`	Enlace simbólico
`containers`	`~/Library/Containers/`	Montaje
`groupContainers`	`~/Library/Group Containers/`	Montaje
`caches`	`~/Library/Caches/`	Enlace simbólico
`webKit`	`~/Library/WebKit/`	Enlace simbólico
`httpStorages`	`~/Library/HTTPStorages/`	Enlace simbólico
`applicationScripts`	`~/Library/Application Scripts/`	Enlace simbólico
`logs`	`~/Library/Logs/`	Enlace simbólico
`savedState`	`~/Library/Saved Application State/`	Enlace simbólico
`dotFolder`	`~/.npm`, `~/.vscode`, etc.	Enlace simbólico
`custom`	Ruta definida por el usuario	Enlace simbólico

Proceso de restauración

Comprobar que la ruta local sea un enlace simbólico hacia un directorio externo válido.
Copiar el directorio externo a un directorio temporal local.
Eliminar el enlace simbólico y renombrar el directorio temporal con la ruta original.
Eliminar el directorio externo, si es posible.

Si falla la copia, el enlace simbólico no cambia. Si falla el cambio de nombre, se recrea el enlace y se conserva el directorio temporal para recuperarlo manualmente.

Gestión de errores y reversión

Fallo de copia: eliminar los archivos externos ya copiados y no continuar.
Conflicto de destino: si existe un directorio real y su marcador no coincide, detenerse y conservar los datos de ambos lados.
Fallo al renombrar la copia de seguridad: detenerse y conservar la copia externa, sin tocar el directorio de origen local.
Fallo al crear el enlace simbólico: devolver la copia de seguridad a la ruta original y conservar también la copia externa.
Fallo al eliminar la copia de seguridad: la migración se considera completada, pero queda la copia local .appports-migration-backup-*. Puede eliminarla manualmente después de comprobar los datos.

Funcionamiento de la migración de datos ​

Estrategia de enlaces simbólicos ​

Marcador de gestión ​

Tipos de directorios de datos compatibles ​

Proceso de restauración ​