ios-slim-bindings

Create iOS slim bindings for MAUI. USE FOR: slim iOS binding, Native Library Interop, Swift/Objective-C wrappers, XcodeGen project.yml, Podfile, CocoaPods static linking, BUILD_LIBRARY_FOR_DISTRIBUTION, XcodeProject MSBuild, `@objc`/`[Export]` selector crashes, async completion handlers. DO NOT USE FOR: Android bindings, general MAUI apps, or NuGet packaging.

跳到安装

仓库: dotnet/maui-labs
最近来源活动: 2026年7月8日 11:36
检测到的 SKILL.md 语言: 英语
星标: 212
分支: 33

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/dotnet/maui-labs --skill ios-slim-bindings

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

文件资源管理器

3 个文件

SKILL.md

来源说明 · 只读预览

返回搜索返回安装

When to use this skill

Activate this skill when the user asks:

How do I create iOS bindings for a native library?

How do I wrap an iOS SDK for use in .NET MAUI?

How do I create slim bindings for iOS?

How do I use Native Library Interop for iOS?

How do I bind a Swift library to .NET?

How do I use Objective Sharpie for iOS bindings?

How do I integrate an xcframework into .NET MAUI?

How do I create a Swift wrapper for a native iOS library?

How do I update iOS bindings when the native SDK changes?

How do I fix iOS binding build errors?

How do I expose native iOS APIs to C#?

How do I handle CocoaPods dependencies in iOS bindings?

How do I handle Swift Package Manager dependencies?

Overview

This skill guides the creation of Native Library Interop (Slim Bindings) for iOS. This modern approach creates a thin native Swift/Objective-C wrapper exposing only the APIs you need from a native iOS library, making bindings easier to create and maintain.

When to Use Slim Bindings vs Traditional Bindings

Scenario

Recommended Approach

Need only a subset of library functionality

Slim Bindings

Easier maintenance when SDK updates

Slim Bindings

Prefer working in Swift/Objective-C for wrapper

name	ios-slim-bindings
description	Create iOS slim bindings for MAUI. USE FOR: slim iOS binding, Native Library Interop, Swift/Objective-C wrappers, XcodeGen project.yml, Podfile, CocoaPods static linking, BUILD_LIBRARY_FOR_DISTRIBUTION, XcodeProject MSBuild, `@objc`/`[Export]` selector crashes, async completion handlers. DO NOT USE FOR: Android bindings, general MAUI apps, or NuGet packaging.

When to use this skill

Activate this skill when the user asks:

How do I create iOS bindings for a native library?
How do I wrap an iOS SDK for use in .NET MAUI?
How do I create slim bindings for iOS?
How do I use Native Library Interop for iOS?
How do I bind a Swift library to .NET?
How do I use Objective Sharpie for iOS bindings?
How do I integrate an xcframework into .NET MAUI?
How do I create a Swift wrapper for a native iOS library?
How do I update iOS bindings when the native SDK changes?
How do I fix iOS binding build errors?
How do I expose native iOS APIs to C#?
How do I handle CocoaPods dependencies in iOS bindings?
How do I handle Swift Package Manager dependencies?

Overview

When to Use Slim Bindings vs Traditional Bindings

Scenario	Recommended Approach
Need only a subset of library functionality	Slim Bindings
Easier maintenance when SDK updates	Slim Bindings
Prefer working in Swift/Objective-C for wrapper

Parameter	Required	Example	Notes
libraryName	yes	`FirebaseMessaging`, `Lottie`	Name of the native iOS library to bind
bindingProjectName	yes	`MyBinding.MaciOS`	Name for the C# binding project
dependencySource	no	`cocoapods`, `spm`, `xcframework`	How the native library is distributed
targetFrameworks	no	`net10.0-ios;net10.0-maccatalyst`	Target frameworks (default: latest .NET iOS + Mac Catalyst)
exposedApis	no	List of specific APIs	Which native APIs to expose (helps scope the wrapper)

Method	When to Use
CocoaPods	Library distributed via CocoaPods. Use `use_frameworks! :linkage => :static`. After `pod install`, reference `.xcworkspace` instead of `.xcodeproj`.
Swift Package Manager	Library distributed via SPM. Add via Xcode UI or `Package.swift`.
Manual XCFramework	Pre-built xcframework. Drag into Xcode project, set "Do Not Embed" for static linking.

Error	Cause	Solution
"Framework not found"	XCFramework path incorrect or missing architectures	Verify path in `<XcodeProject>`, check `lipo -info`
"Undefined symbols for architecture"	Missing linked frameworks or symbol visibility	Add system frameworks, verify `public` + `@objc` annotations
"No type or protocol named"	Missing import or protocol mismatch	Add `using` directives, use interface types
"Duplicate symbol"	Multiple framework references	Remove duplicates, resolve version conflicts
"Native class hasn't been loaded" (runtime)	Framework not embedded or missing `@objc`	Set `<ForceLoad>true</ForceLoad>`, check annotations
"unrecognized selector" (runtime)	Selector mismatch between C# and Swift	Verify `[Export("...")]` matches `@objc(...)` exactly
"Library not loaded: @rpath" (runtime)	Swift runtime or embedding issue	Add linker flags, set "Embed & Sign" for dynamic frameworks
Callbacks not working	Wrong thread, GC'd reference, or missing `@escaping`	Use `DispatchQueue.main.async`, hold strong reference

Swift Type	Objective-C Type	C# Type
`String`	`NSString *`	`string`
`Bool`	`BOOL`	`bool`
`Int`, `Int32`	`int`	`int`
`Int64`	`long long`	`long`
`Double`	`double`	`double`
`Float`	`float`	`float`
`Data`	`NSData *`	`NSData`
`[String: Any]`	`NSDictionary *`	`NSDictionary`
`[Any]`	`NSArray *`	`NSArray`
`UIView`	`UIView *`	`UIView`
`UIImage`	`UIImage *`	`UIImage`
`URL`	`NSURL *`	`NSUrl`
Custom Class	Must inherit `NSObject`	Interface with `[BaseType]`
`(Result, Error?) -> Void`	Block	`Action<Result?, NSError?>`

Attribute	Purpose
`[BaseType(typeof(NSObject))]`	Specifies base class
`[Static]`	Static method/property
`[Export("selector:")]`	Objective-C selector
`[Async]`	Generate async wrapper for completion handler methods
`[NullAllowed]`	Nullable parameter/return
`[Protocol]`	Objective-C protocol
`[Model]`	Protocol implementation
`[Abstract]`	Required protocol method
`[Internal]`	Don't expose publicly
`[Sealed]`	Prevent subclassing

ios-slim-bindings

安装方式

检查来源文件

When to use this skill

Overview

When to Use Slim Bindings vs Traditional Bindings

When to use this skill

Overview

When to Use Slim Bindings vs Traditional Bindings

Inputs

Project Structure

Step-by-step Process

Step 1: Create Project Structure

Step 2: Create the Xcode Project

Step 3: Create the C# Binding Project

Step 4: Build and Verify

Step 5: Add Native Library Dependencies

Step 6: Implement the Swift Wrapper

Step 7: Generate ApiDefinition.cs

Step 8: Build the Final Binding

Step 9: Use in Your MAUI App

Updating Bindings When Native SDK Changes

Troubleshooting

Quick Reference

Swift Wrapper Annotation Requirements

Type Mapping

ApiDefinition Attributes

XcodeProject MSBuild Properties

Resources

Official Documentation

Tools

Templates and Examples

Reference Files

Output Format

Property	Description	Default
`SchemeName`	Xcode scheme to build	Required
`Configuration`	Build configuration	`Release`
`Kind`	`Framework` or `Static`	Auto-detected
`SmartLink`	Enable smart linking	`true`
`ForceLoad`	Force load all symbols	`false`

ios-slim-bindings

来源信息

安装方式

检查来源文件

同仓库更多 Skills

同仓库更多 Skills

When to use this skill

Overview

When to Use Slim Bindings vs Traditional Bindings

When to use this skill

Overview

When to Use Slim Bindings vs Traditional Bindings

Inputs

Project Structure

Step-by-step Process

Step 1: Create Project Structure

Step 2: Create the Xcode Project

Step 3: Create the C# Binding Project

Step 4: Build and Verify

Step 5: Add Native Library Dependencies

Step 6: Implement the Swift Wrapper

Step 7: Generate ApiDefinition.cs

Step 8: Build the Final Binding

Step 9: Use in Your MAUI App

Updating Bindings When Native SDK Changes

Troubleshooting

Quick Reference

Swift Wrapper Annotation Requirements

Type Mapping

ApiDefinition Attributes

XcodeProject MSBuild Properties

Resources

Official Documentation

Tools

Templates and Examples

Reference Files

Output Format