Sincronización con Xcode

xcsync es una herramienta de .NET que permite a los desarrolladores aprovechar Xcode para administrar archivos específicos de Apple con proyectos de .NET. La herramienta genera un proyecto de Xcode temporal a partir de un proyecto de .NET y sincroniza los cambios en los archivos Xcode de nuevo en el proyecto de .NET.

Importante

xcsync está actualmente en versión preliminar.

Tipos de archivo admitidos:

• Catálogos de recursos
• Plist
• Guión gráfico
• Xib

La herramienta tiene dos comandos: generate y sync. Usa generate para crear un proyecto de Xcode a partir de un proyecto de .NET y sync para devolver los cambios en el proyecto de Xcode al proyecto de .NET.

Nota:

Esta herramienta solo está disponible para macOS debido a las interacciones con Xcode.

Visual Studio Code

Instalación

Instale la versión preliminar de .NET xcsync globalmente con el siguiente comando:

dotnet tool install dotnet-xcsync -g --prerelease --add-source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json

Uso

1. La extensión MAUI de .NET proporciona compatibilidad con xcsync. Asegúrese de disponer de la versión más reciente. Los xcsync comandos de la extensión MAUI de .NET solo están disponibles cuando se usa Visual Studio Code en macOS.
2. Abra la paleta de comandos (Cmd + Mayús + P) y busque los .NET MAUI: xcsync - Generate an Xcode project comandos y .NET MAUI: xcsync - Sync from an Xcode project .

Solución de problemas

Para ver detalles sobre los errores relacionados con xcsync, vaya a la ventana de salida (CMD + Mayús + u ) y seleccione .NET MAUI - xcsync en la lista desplegable. Si tiene problemas, notifique un problema.

Envío de comentarios

Compruebe los problemas conocidos existentes antes de presentar un nuevo problema o sugerencia.

CLI

Instalación

Instale la versión preliminar de .NET xcsync globalmente con el siguiente comando:

dotnet tool install dotnet-xcsync -g --prerelease --add-source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet9/nuget/v3/index.json

Sinopsis

xcsync generate [-p|--project <PROJECT>]
[-tfm|--target-framework-moniker <FRAMEWORK>]
[-t|--target <TARGET_XCODE_DIRECTORY>] [-f|--force]
[-o|--open] [-v|--verbosity <LEVEL>]
[-d|--dotnet-path <PATH>]

xcsync sync [-p|--project <PROJECT>]
[-tfm|--target-framework-moniker <FRAMEWORK>]
[-t|--target <TARGET_XCODE_DIRECTORY>] [-v|--verbosity <LEVEL>]

xcsync -h|--help

Opciones

• -p|--project <PROJECT>

  El archivo del proyecto que se va a compilar. Los tipos de proyecto admitidos son proyectos de .NET MAUI o cualquier proyecto de .NET que tenga como destino una plataforma compatible (iOS, tvOS, macOS, MacCatalyst).

• -tfm|--target-framework-moniker <FRAMEWORK>

  Invoca la herramienta para un marco específico. El marco se debe definir en el archivo de proyecto. Ejemplos: net9.0-ios, net9.0-maccatalyst. Obligatorio si el proyecto de .NET admite varias plataformas de destino (por ejemplo, un proyecto de .NET MAUI de destino múltiple). En un proyecto de una sola plataforma, el valor predeterminado será la plataforma de destino única especificada en el archivo del proyecto.

• -t|--target <TARGET_XCODE_DIRECTORY>

  El directorio en el que se va a colocar el proyecto Xcode generado. El valor predeterminado es (*_$(IntermediateOutputPath)_/xcsync*).

• -f|--force

  Fuerza la sobrescritura de un proyecto de Xcode existente. El valor predeterminado es False.

• -o|--open

  Abre el proyecto generado en Xcode. El valor predeterminado es False.

• -v|--verbosity <LEVEL>

  Establece el nivel de detalle del comando. Los valores permitidos son Detailed, Diagnostic, Minimal, Normal, y Quiet. El valor predeterminado es Normal.

• -d|--dotnet-path <PATH>

  Ruta de acceso al SDK de .NET. El valor predeterminado es la ruta de acceso del proceso primario si es dotnet, de lo contrario, vuelve a en dotnet PATH.

• -h|--help

  Muestra información de ayuda y uso

Ejemplos

• Genera y abre un proyecto de Xcode para un proyecto .NET MAUI que use el archivo de proyecto en el directorio actual, que admite el net9.0-iosTFM:

  xcsync generate -tfm net9.0-ios
  

• Genera y abre un proyecto de Xcode para un proyecto .NET MAUI que admita el net9.0-iosTFM:

  xcsync generate -p path/to/maui.csproj -tfm net9.0-ios
  

• Sincronice los cambios de un proyecto de Xcode generado en la ubicación predeterminada (xcsync) a un proyecto MAUI de .NET que admita el net9.0-iosTFM:

  xcsync sync -p path/to/maui.csproj -tfm net9.0-ios
  

Más información

xcsync es de código abierto. Para obtener más información o para presentar un problema, visite https://github.com/dotnet/xcsync.