[tools] Add sharpie. Fixes #23962. by rolfbjarne · Pull Request #24622 · dotnet/macios

rolfbjarne · 2026-02-04T11:39:25Z

Open-source the Objective-Sharpie tool.

Port the old closed-source version of Objective-Sharpie to modern .NET, and have it use ClangSharp for its clang integration.
This is a simplified port, any features that were not frequently used have been dropped. In particular, only two features remain:
- Binding an entire OS SDK (which we use for our own bindings).
Binding a .framework (to bind third-party bindings).
The new sharpie will be distributed as a .NET command-line tool.

Open-source the Objective-Sharpie tool. * Port the old closed-source version of Objective-Sharpie to modern .NET, and have it use ClangSharp for its clang integration. * This is a simplified port, any features that were not frequently used have been dropped. In particular, only two features remain: * Binding an entire OS SDK (which we use for our own bindings). * Binding a .framework (to bind third-party bindings). * The new sharpie will be distributed as a .NET command-line tool. Fixes #23962.

Copilot

Pull request overview

This PR open-sources the Objective-Sharpie tool by porting it to modern .NET with ClangSharp integration. The tool generates C# bindings from Objective-C APIs, supporting SDK binding and framework binding workflows. It will be distributed as a .NET command-line tool.

Changes:

Ports Objective-Sharpie from closed-source to open-source using ClangSharp for clang integration
Implements core binding infrastructure including massagers, attributes, and type system
Adds comprehensive test suite with test cases for various binding scenarios

Reviewed changes

Copilot reviewed 299 out of 619 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tools/sharpie/Sharpie.Bind/*.cs	Core binding logic including massagers, type system, and attribute definitions
tools/sharpie/Sharpie.Bind.Tool/*.cs	Command-line tool entry point and configuration
tests/sharpie/Tests/*/.h	Test header files for binding scenarios
tests/sharpie/Tests/*/.cs	Expected C# output for test cases
tests/xtro-sharpie/*/.cs	Updates to xtro-sharpie tool to use new ClangSharp-based binding system
tools/common/ProductConstants.in.cs	Added SharpieVersion constant

Files not reviewed (1)

tools/sharpie/Sharpie.Bind/Resources.designer.cs: Language not supported

dalexsoto

Looking good!

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot · 2026-02-04T17:29:00Z

@rolfbjarne I've opened a new pull request, #24625, to work on those changes. Once the pull request is ready, I'll request review from you.

vs-mobiletools-engineering-service2 · 2026-02-13T15:38:21Z

✅ [CI Build #09205e8] Build passed (Build packages) ✅

Pipeline on Agent
Hash: 09205e81ce8b96dc3eeef3f57c5d74e9dee24352 [PR build]

vs-mobiletools-engineering-service2 · 2026-02-13T16:52:11Z

✅ [CI Build #09205e8] Build passed (Build macOS tests) ✅

Pipeline on Agent
Hash: 09205e81ce8b96dc3eeef3f57c5d74e9dee24352 [PR build]

vs-mobiletools-engineering-service2 · 2026-02-13T17:03:20Z

💻 [CI Build #09205e8] Tests on macOS X64 - Mac Sonoma (14) passed 💻

✅ All tests on macOS X64 - Mac Sonoma (14) passed.

Pipeline on Agent
Hash: 09205e81ce8b96dc3eeef3f57c5d74e9dee24352 [PR build]

vs-mobiletools-engineering-service2 · 2026-02-13T17:06:40Z

💻 [CI Build #09205e8] Tests on macOS M1 - Mac Monterey (12) passed 💻

✅ All tests on macOS M1 - Mac Monterey (12) passed.

Pipeline on Agent
Hash: 09205e81ce8b96dc3eeef3f57c5d74e9dee24352 [PR build]

vs-mobiletools-engineering-service2 · 2026-02-13T17:07:39Z

💻 [CI Build #09205e8] Tests on macOS M1 - Mac Ventura (13) passed 💻

✅ All tests on macOS M1 - Mac Ventura (13) passed.

Pipeline on Agent
Hash: 09205e81ce8b96dc3eeef3f57c5d74e9dee24352 [PR build]

vs-mobiletools-engineering-service2 · 2026-02-13T17:08:16Z

💻 [CI Build #09205e8] Tests on macOS arm64 - Mac Tahoe (26) passed 💻

✅ All tests on macOS arm64 - Mac Tahoe (26) passed.

Pipeline on Agent
Hash: 09205e81ce8b96dc3eeef3f57c5d74e9dee24352 [PR build]

vs-mobiletools-engineering-service2 · 2026-02-13T17:08:17Z

💻 [CI Build #09205e8] Tests on macOS arm64 - Mac Sequoia (15) passed 💻

✅ All tests on macOS arm64 - Mac Sequoia (15) passed.

Pipeline on Agent
Hash: 09205e81ce8b96dc3eeef3f57c5d74e9dee24352 [PR build]

vs-mobiletools-engineering-service2 · 2026-02-16T08:57:21Z

✅ [PR Build #09205e8] Build passed (Detect API changes) ✅

Pipeline on Agent
Hash: 09205e81ce8b96dc3eeef3f57c5d74e9dee24352 [PR build]

vs-mobiletools-engineering-service2 · 2026-02-16T09:41:56Z

✅ API diff for current PR / commit

NET (empty diffs)

iOS: vsdrops gist ( No breaking changes )
tvOS: vsdrops gist ( No breaking changes )
MacCatalyst: vsdrops gist ( No breaking changes )
macOS: vsdrops gist ( No breaking changes )

✅ API diff vs stable

NET (empty diffs)

iOS: vsdrops gist ( No breaking changes )
tvOS: vsdrops gist ( No breaking changes )
MacCatalyst: vsdrops gist ( No breaking changes )
macOS: vsdrops gist ( No breaking changes )

ℹ️ Generator diff

Generator Diff: vsdrops (html) vsdrops (raw diff) gist (raw diff) - Please review changes)

Pipeline on Agent
Hash: 09205e81ce8b96dc3eeef3f57c5d74e9dee24352 [PR build]

vs-mobiletools-engineering-service2 · 2026-02-16T22:10:16Z

🚀 [CI Build #09205e8] Test results 🚀

Test results

✅ All tests passed on VSTS: test results.

🎉 All 131 tests passed 🎉

Tests counts

✅ cecil: All 1 tests passed. [attempt 4] Html Report (VSDrops) Download
✅ dotnettests (iOS): All 1 tests passed. [attempt 2] Html Report (VSDrops) Download
✅ dotnettests (MacCatalyst): All 1 tests passed. [attempt 4] Html Report (VSDrops) Download
✅ dotnettests (macOS): All 1 tests passed. [attempt 4] Html Report (VSDrops) Download
✅ dotnettests (Multiple platforms): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (tvOS): All 1 tests passed. Html Report (VSDrops) Download
✅ framework: All 2 tests passed. Html Report (VSDrops) Download
✅ fsharp: All 4 tests passed. Html Report (VSDrops) Download
✅ generator: All 5 tests passed. Html Report (VSDrops) Download
✅ interdependent-binding-projects: All 4 tests passed. Html Report (VSDrops) Download
✅ introspection: All 6 tests passed. Html Report (VSDrops) Download
✅ linker: All 44 tests passed. Html Report (VSDrops) Download
✅ monotouch (iOS): All 11 tests passed. Html Report (VSDrops) Download
✅ monotouch (MacCatalyst): All 15 tests passed. Html Report (VSDrops) Download
✅ monotouch (macOS): All 12 tests passed. Html Report (VSDrops) Download
✅ monotouch (tvOS): All 11 tests passed. [attempt 4] Html Report (VSDrops) Download
✅ msbuild: All 2 tests passed. Html Report (VSDrops) Download
✅ sharpie: All 1 tests passed. Html Report (VSDrops) Download
✅ windows: All 3 tests passed. Html Report (VSDrops) Download
✅ xcframework: All 4 tests passed. Html Report (VSDrops) Download
✅ xtro: All 1 tests passed. Html Report (VSDrops) Download

Pipeline on Agent
Hash: 09205e81ce8b96dc3eeef3f57c5d74e9dee24352 [PR build]

beeradmoore · 2026-02-16T23:32:18Z

@rolfbjarne , is there any ETA/plans for when sharpie should be released as a dotnet tool. Where is the best place to follow/monitor to hear when it is out?

cho-trackman · 2026-02-17T08:31:08Z

Nice to see this :)

Is there no way to run this on x86 (build agents in Azure DevOps)? We currently run Sharpie as a part of our CI build, but we don't have access to ARM agents yet.

rolfbjarne · 2026-02-17T08:39:34Z

@rolfbjarne , is there any ETA/plans for when sharpie should be released as a dotnet tool. Where is the best place to follow/monitor to hear when it is out?

We'll try to publish something shortly.

I'll post something here with instructions: #23964

rolfbjarne · 2026-02-17T08:41:15Z

Is there no way to run this on x86 (build agents in Azure DevOps)? We currently run Sharpie as a part of our CI build, but we don't have access to ARM agents yet.

No, we depend on https://github.com/dotnet/clangsharp/, which is arm64 only on macOS.

One potential idea could be to create a NuGet from your native framework, and build that locally and reference to the NuGet in your main project. That way you won't have to run sharpie as part of a CI build.

cho-trackman · 2026-02-17T09:16:51Z

Is there no way to run this on x86 (build agents in Azure DevOps)? We currently run Sharpie as a part of our CI build, but we don't have access to ARM agents yet.

No, we depend on https://github.com/dotnet/clangsharp/, which is arm64 only on macOS.

One potential idea could be to create a NuGet from your native framework, and build that locally and reference to the NuGet in your main project. That way you won't have to run sharpie as part of a CI build.

Yeah, you are right, that is the solution. Right now we are doing it in CI as a kind of validation, but it's not really needed. Thanks!

rolfbjarne added 2 commits February 4, 2026 12:38

Add clang headers.

e4ae9e7

rolfbjarne requested a review from Copilot February 4, 2026 11:39

Copilot AI reviewed Feb 4, 2026

View reviewed changes

Comment thread tools/sharpie/Sharpie.Bind/Massagers/NamespaceMassager.cs Outdated

Comment thread tools/sharpie/Sharpie.Bind/NRefactoryExtensions.cs

Comment thread tools/sharpie/Sharpie.Bind/StringExtensions.cs

Auto-format source code

c2d5fcb

This comment has been minimized.

Sign in to view

dalexsoto reviewed Feb 4, 2026

View reviewed changes

This comment has been minimized.

Sign in to view

Update tools/sharpie/Sharpie.Bind/Massagers/NamespaceMassager.cs

3e86c9b

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI mentioned this pull request Feb 4, 2026

Respond to review question about SharedPrefix implementation #24625

Closed

No sharpie on linux.

a1d4caa

This comment has been minimized.

Sign in to view

Merge branch 'main' into dev/rolf/sharpie

09205e8

rolfbjarne enabled auto-merge (squash) February 13, 2026 14:46

This comment has been minimized.

Sign in to view

rolfbjarne merged commit 73ebf5a into main Feb 16, 2026
48 checks passed

Grzegorz1223 mentioned this pull request Feb 17, 2026

New Sharpie QotoQot/Bindings.Lottie.iOS#2

Open

Conversation

rolfbjarne commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

dalexsoto left a comment

Choose a reason for hiding this comment

Uh oh!

This comment has been minimized.

Copilot AI commented Feb 4, 2026

Uh oh!

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

This comment has been minimized.

vs-mobiletools-engineering-service2 commented Feb 13, 2026

✅ [CI Build #09205e8] Build passed (Build packages) ✅

Uh oh!

vs-mobiletools-engineering-service2 commented Feb 13, 2026

✅ [CI Build #09205e8] Build passed (Build macOS tests) ✅

Uh oh!

vs-mobiletools-engineering-service2 commented Feb 13, 2026

💻 [CI Build #09205e8] Tests on macOS X64 - Mac Sonoma (14) passed 💻

Uh oh!

vs-mobiletools-engineering-service2 commented Feb 13, 2026

💻 [CI Build #09205e8] Tests on macOS M1 - Mac Monterey (12) passed 💻

Uh oh!

vs-mobiletools-engineering-service2 commented Feb 13, 2026

💻 [CI Build #09205e8] Tests on macOS M1 - Mac Ventura (13) passed 💻

Uh oh!

vs-mobiletools-engineering-service2 commented Feb 13, 2026

💻 [CI Build #09205e8] Tests on macOS arm64 - Mac Tahoe (26) passed 💻

Uh oh!

vs-mobiletools-engineering-service2 commented Feb 13, 2026

💻 [CI Build #09205e8] Tests on macOS arm64 - Mac Sequoia (15) passed 💻

Uh oh!

This comment has been minimized.

vs-mobiletools-engineering-service2 commented Feb 16, 2026

✅ [PR Build #09205e8] Build passed (Detect API changes) ✅

Uh oh!

This comment has been minimized.

vs-mobiletools-engineering-service2 commented Feb 16, 2026

✅ API diff for current PR / commit

✅ API diff vs stable

ℹ️ Generator diff

Uh oh!

This comment has been minimized.

vs-mobiletools-engineering-service2 commented Feb 16, 2026

🚀 [CI Build #09205e8] Test results 🚀

Test results

rolfbjarne commented Feb 4, 2026 •

edited

Loading