Swift projection tooling

[kotlarmilos]

Description

This issue tracks the progress of implementing and shipping the projection tooling in .NET 9. The primary objective is to create a tooling capable of generating bindings for a set of features confirmed by the design document. We will divide the development process into stages to facilitate faster iterations:

• Alpha version: The tool is available in a public repository and can be manually downloaded from a NuGet feed. Then, it can be run manually by a user to generate bindings for provided Swift library.
• Beta version: The tool is available for internal use. The idea is to integrate it into the dotnet/runtime repository and utilize it for surfacing CryptoKit APIs. Additionally, it should have publishing infrastructure and be shipped using Darc.
• Release version: The tool is available for external use as a part of the Apple workload or as a standalone package.

Update: The experimental package is available in dotnet-experimental feed.

Below is a list of tasks that needs to be implemented. Please note that the breakdown of the issues does not impose hard deadlines. If some of the functionality does not get upstreamed for a particular preview version, this issue will be updated accordingly.

Tasks

• Design
  • Add .NET Swift interop tooling components and layout designs#312
  • Review projections from Swift into C#
    • Review UX and bindings for .NET Swift interop tooling in simple P/Invoke void cases runtimelab#2518
    • Review UnsafeRawPointer projections in C# for CryptoKit dev templates runtimelab#2529
    • Review struct and enum projections in C# for CryptoKit dev templates runtimelab#2533
    • Review projections of Swift generics in C# for CryptoKit dev template runtimelab#2580
  • Review Swift projections tooling UX and functionality runtimelab#2582
• Implementation
  • Add initial documentation for the projection tooling runtimelab#2512
  • Swift bindings generator with simple parser and emitter runtimelab#2525
  • Update parser and emitter to support nested Swift types runtimelab#2548
  • Add basic support for frozen structs projections runtimelab#2560
  • Add support for Swift frozen enums
  • Add support for Swift non-frozen structs and enums
  • Add support for Swift generics at P/Invokes boundary
• Distribution
  • Create a new branch in runtimelab repository
  • Setup testing CI on macOS platforms
  • Create a NuGet package within dotnet-experimental feed

[ghost]

Tagging subscribers to this area: @dotnet/area-meta
See info in area-owners.md if you want to be subscribed.

Issue Details

---

Description

This issue tracks the work for adapting the existing Binding Tools for Swift and shipping it as a product in .NET 9. The projection tooling consists of three main areas: Importing Swift into .NET, Exporting .NET to Swift, and distribution.

Below is a list of tasks that needs to be implemented. Please note that the breakdown of the issues does not impose hard deadlines. If some of the functionality does not get upstreamed for a particular preview version, this issue will be updated accordingly.

Tasks

.NET9 Preview 1

• Update documentation to specify tool's layout
• Update documentation to specify type representations
• Create a NuGet package for the BTfS
• Ensure that the NuGet package is shipped for supported platforms such as OSX and Apple mobile

.NET9 Preview 2

• Adapt the tool to work with the new runtime support
• Add Roslyn source generators to generate Swift metadata for selected assemblies

.NET9 Preview 3

TBD

Author:	kotlarmilos
Assignees:	kotlarmilos, stephen-hawley
Labels:	area-Meta, User Story
Milestone:	9.0.0

[stephen-hawley]

Might want to include "Update BTfS to run on .NET 7 and later" - I'm in the middle of that right now.