Synkronisera med Xcode

xcsync är ett .NET-verktyg som gör det möjligt för utvecklare att använda Xcode för att hantera Apple-specifika filer med .NET-projekt. Verktyget genererar ett tillfälligt Xcode-projekt från ett .NET-projekt och synkroniserar ändringar i Xcode-filerna tillbaka till .NET-projektet.

Viktig

xcsync är för närvarande i förhandsversion.

Filtyper som stöds är:

• Tillgångskatalog
• Plist
• Bildmanus
• Xib

Verktyget har två kommandon: generate och sync. Använd generate för att skapa ett Xcode-projekt från ett .NET-projekt och sync för att få tillbaka ändringar i Xcode-projektet till .NET-projektet.

Not

Det här verktyget är endast tillgängligt för macOS på grund av interaktionerna med Xcode.

Visual Studio Code

Installation

Installera förhandsversionen av .NET xcsync globalt med följande kommando:

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

Användning

1. .NET MAUI-tillägget ger stöd för xcsync. Kontrollera att du har den senaste versionen. De xcsync kommandona i .NET MAUI-tillägget är endast tillgängliga när du använder Visual Studio Code på macOS.
2. Öppna kommandopaletten (Cmd + Skift + P) och sök efter kommandona .NET MAUI: xcsync - Generate an Xcode project och .NET MAUI: xcsync - Sync from an Xcode project.

Felsökning

Om du vill se information om fel som rör xcsyncgår du till fönstret Output (CMD + Skift + u ) och väljer .NET MAUI – xcsync i listrutan. Om du har problem, vänligen rapportera ett problem.

Lämna feedback

Kontrollera befintliga kända problem innan du skickar in ett nytt problem eller förslag.

CLI

Installation

Installera förhandsversionen av .NET xcsync globalt med följande kommando:

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

Sammanfattning

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

Alternativ

• -p|--project <PROJECT>

  Projektfilen som ska skapas. Projekttyper som stöds är .NET MAUI-projekt eller .NET-projekt som riktar sig till en plattform som stöds (iOS, tvOS, macOS, MacCatalyst).

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

  Anropa verktyget för ett specifikt ramverk. Ramverket måste definieras i projektfilen. Exempel: net9.0-ios, net9.0-maccatalyst. Obligatoriskt om .NET-projektet stöder flera målramverk (till exempel ett .NET MAUI-projekt med flera mål). Om ett enskilt plattformsprojekt är standardvärdet det enda målramverk som anges i projektfilen.

• -t|--target <TARGET_XCODE_DIRECTORY>

  Katalogen där det genererade Xcode-projektet ska placeras. Standardvärdet är (*_$(IntermediateOutputPath)_/xcsync*).

• -f|--force

  Tvingar att ett befintligt Xcode-projekt skrivs över. Standardvärdet är False.

• -o|--open

  Öppnar det genererade projektet i Xcode. Standardvärdet är False.

• -v|--verbosity <LEVEL>

  Anger kommandots verbositetsnivå. Tillåtna värden är Detailed, Diagnostic, Minimal, Normal, Quiet. Standardvärdet är Normal.

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

  Sökväg till .NET SDK. Standardvärdet är sökvägen från den överordnade processen om det är dotnet, annars faller det tillbaka på dotnet i PATH.

• -h|--help

  Visar hjälp- och användningsinformation

Exempel

• Generera och öppna ett Xcode-projekt för ett .NET MAUI-projekt som använder projektfilen i den aktuella katalogen, som stöder net9.0-iosTFM-:

  xcsync generate -tfm net9.0-ios
  

• Generera och öppna ett Xcode-projekt för ett .NET MAUI-projekt som stöder net9.0-iosTFM-:

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

• Synkronisera ändringar från ett genererat Xcode-projekt på standardplatsen ($(IntermediateOutputPath)/xcsync) tillbaka till ett .NET MAUI-projekt som stöder net9.0-iosTFM-:

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

Mer information

xcsync är öppen källkod. För mer information eller för att rapportera ett problem, vänligen besök https://github.com/dotnet/xcsync.