xcsync é uma ferramenta .NET que permite que os desenvolvedores aproveitem 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 versão prévia.
Os tipos de arquivo com suporte 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 está disponível apenas para macOS devido às interações com o Xcode.
A extensão .NET MAUI fornece suporte para xcsync. Verifique se você tem a versão mais recente. Os xcsync comandos na extensão .NET MAUI só estão disponíveis ao usar o Visual Studio Code no macOS.
Abra a paleta de comandos (Cmd + Shift + P) e procure os .NET MAUI: xcsync - Generate an Xcode project comandos e .NET MAUI: xcsync - Sync from an Xcode project .
Solução de problemas
Para ver detalhes sobre erros relacionados a xcsync, navegue até a janela Saída (CMD + Shift + u ) e selecione .NET MAUI – xcsync no menu suspenso. Se você estiver enfrentando problemas, informe um problema.
Enviar comentários
Verifique os problemas conhecidos existentes antes de registrar um novo problema ou sugestão.
Instalação
Instale a versão prévia do .NET xcsync globalmente com o seguinte comando:
O arquivo de projeto a ser compilado. Os tipos de projeto com suporte são projetos .NET MAUI ou qualquer projeto .NET direcionado a uma plataforma com suporte (iOS, tvOS, macOS, MacCatalyst).
-tfm|--target-framework-moniker <FRAMEWORK>
Invocar a ferramenta para uma estrutura específica. A estrutura precisa ser definida no arquivo de projeto. Exemplos: net9.0-ios, net9.0-maccatalyst.
Necessário se o projeto .NET der suporte a várias estruturas de destino (por exemplo, um projeto .NET MAUI multidestino). Se for 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 detalhes 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, retornará para dotnet on PATH.
-h|--help
Mostra informações de ajuda e uso
Exemplos
Gere e abra um projeto Xcode para um projeto .NET MAUI que usa o arquivo de projeto no diretório atual, que é compatível com o net9.0-iosTFM:
xcsync generate -tfm net9.0-ios
Gere e abra um projeto Xcode para um projeto .NET MAUI que dá suporte ao net9.0-iosTFM:
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.