Repository navigation
Document native library and XCFramework bindings for Apple platforms - #150
Draft
rolfbjarne wants to merge 2 commits into
Draft
rolfbjarne wants to merge 2 commits into
rolfbjarne wants to merge 2 commits into
Conversation
- Add docs/ios/binding-libs/index.md covering NativeReference, XcodeProject, and NuGet packaging (runtimes/<rid>/native/ vs binding resource packages) - Add docs/ios/binding-libs/xcframeworks.md covering single and multiple XCFrameworks, Objective Sharpie slice usage, NoBindingEmbedding (.NET 12 removal of false), dotnet pack, and troubleshooting - Expand NativeReference in docs/ios/building-apps/build-items.md and NoBindingEmbedding / CompressBindingResourcePackage in docs/ios/building-apps/build-properties.md - Add Bind native libraries section to docs/ios/TOC.yml Refs: dotnet/macios#13053 Refs: dotnet/macios#14647 Refs: dotnet/macios#14413 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9330d047-38d9-439a-95d1-3ebf60aaebaf
… Kind docs - Sync docs/ios/building-apps/build-properties.md and docs/ios/building-apps/build-items.md with latest additions from dotnet/macios (including AppManifestEntry, ComputeInstructionSetForReadyToRun, TrimExportAttributes, EnableCrashReport, StripMergeableLibraries, ValidateSceneManifest) - Clarify that Kind is required on NativeReference items in binding projects (and inferred for frameworks/xcframeworks in app projects) - Fix #xcodeproject anchor link in docs/ios/binding-libs/index.md and use relative links to binding-libs articles Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add conceptual and reference documentation for using, binding, and distributing native libraries and XCFrameworks in .NET for iOS, Mac Catalyst, macOS, and tvOS:
docs/ios/binding-libs/index.mdcovering how to choose an integration approach (<NativeReference>with P/Invoke, Objective-C binding projects, or<XcodeProject>),<NativeReference>metadata, and shipping native libraries in NuGet packages (runtimes/<rid>/native/caveats vs. binding resource packages).docs/ios/binding-libs/xcframeworks.mdcovering SDK-style binding projects for single and multiple.xcframeworkbundles, running Objective Sharpie against a slice's.frameworkheaders,.resources/.resources.zipbinding resource packages, the.NET 12removal ofNoBindingEmbedding=false, packaging viadotnet pack, and troubleshooting.docs/ios/building-apps/build-properties.mdanddocs/ios/building-apps/build-items.mdwithdotnet/macios, including expandedNativeReference,NoBindingEmbedding, andCompressBindingResourcePackagedocumentation.Bind native librariessection todocs/ios/TOC.yml.Refs:
runtimes/{rid}/nativewithoutNativeReference? macios#14622Internal previews
Build report