Sincronização com o Xcode

xcsync é uma ferramenta .NET que permite aos desenvolvedores aproveitar o Xcode para gerenciar arquivos específicos da Apple com projetos .NET. A ferramenta gera um projeto Xcode temporário de um projeto .NET e sincroniza as alterações nos arquivos Xcode de volta para o projeto .NET.

Importante

xcsync está atualmente em fase de testes.

Os tipos de ficheiro suportados incluem:

• Catálogo de ativos
• Plist
• Storyboard
• Xib

A ferramenta tem dois comandos: generate e sync. Use generate para criar um projeto Xcode a partir de um projeto .NET e sync trazer alterações no projeto Xcode de volta para o projeto .NET.

Observação

Esta ferramenta só está disponível para macOS devido às interações com o Xcode.

Instalação

Instale a pré-visualização do .NET xcsync globalmente com o seguinte comando:

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

Utilização

1. A extensão .NET MAUI fornece suporte para xcsync. Certifique-se de ter a versão mais recente. Os comandos xcsync na extensão .NET MAUI só estão disponíveis ao usar o Visual Studio Code no macOS.
2. Abra a paleta de comandos (Cmd + Shift + P) e procure os comandos .NET MAUI: xcsync - Generate an Xcode project e .NET MAUI: xcsync - Sync from an Xcode project.

Solução de problemas

Para ver detalhes sobre erros relacionados ao , navegue até a janela de saída relativa a (CMD + Shift + u ) e selecione .NET MAUI - no menu suspenso. Se estiveres a enfrentar problemas, por favor reporta um problema.

Fornecer feedback

Verifique os Problemas Conhecidos existentes antes de apresentar um novo problema ou sugestão.

CLI

Instalação

Instale a visualização do .NET xcsync globalmente com o seguinte comando:

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

Sinopse

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

Opções

• -p|--project <PROJECT>

  O arquivo de projeto a ser compilado. Os tipos de projeto suportados são projetos .NET MAUI ou qualquer projeto .NET destinado a uma plataforma suportada (iOS, tvOS, macOS, MacCatalyst).

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

  Invoque a ferramenta para uma estrutura específica. A estrutura deve ser definida no arquivo do projeto. Exemplos: net9.0-ios, net9.0-maccatalyst. Necessário se o projeto .NET oferecer suporte a várias estruturas de destino (por exemplo, um projeto .NET MAUI com vários destinos). Se um projeto de plataforma única, o valor padrão será a estrutura de destino única especificada no arquivo de projeto.

• -t|--target <TARGET_XCODE_DIRECTORY>

  O diretório no qual colocar o projeto Xcode gerado. O valor padrão é (*_$(IntermediateOutputPath)_/xcsync*).

• -f|--force

  Força a substituição de um projeto Xcode existente. O valor padrão é False.

• -o|--open

  Abre o projeto gerado no Xcode. O valor padrão é False.

• -v|--verbosity <LEVEL>

  Define o nível de verbosidade do comando. Os valores permitidos são Detailed, Diagnostic, Minimal, Normal, Quiet. O valor padrão é Normal.

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

  Caminho para o SDK do .NET. O valor padrão é o caminho do processo pai se for dotnet, caso contrário, reverterá para dotnet no PATH.

• -h|--help

  Mostra ajuda e informações de uso

Exemplos

• Gere e abra um projeto Xcode para um projeto .NET MAUI que usa o arquivo de projeto no diretório atual, que suporta o net9.0-iosTFM:

  xcsync generate -tfm net9.0-ios
  

• Gere e abra um projeto Xcode para um projeto .NET MAUI que suporte o net9.0-iosTFM:

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

• Sincronize as alterações de um projeto Xcode gerado no local padrão ($(IntermediateOutputPath)/xcsync) novamente em um projeto .NET MAUI que suporta o TFM net9.0-ios:

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

Mais informações

xcsync é de código aberto. Para obter mais informações ou para registrar um problema, visite https://github.com/dotnet/xcsync.