Skip to content

[Foundation] Improve nullability in NSArray.FromArray.#24873

Merged
rolfbjarne merged 1 commit intomainfrom
dev/rolf/foundation-nullability-44-nsarray-fromarray
Mar 11, 2026
Merged

[Foundation] Improve nullability in NSArray.FromArray.#24873
rolfbjarne merged 1 commit intomainfrom
dev/rolf/foundation-nullability-44-nsarray-fromarray

Conversation

@rolfbjarne
Copy link
Copy Markdown
Member

  • Improve nullability annotations for FromArray (accept NSArray?, return T[]?).
  • Add a ToNonNullArrayDropNullElements variant that guarantees a non-null return value.
  • Add an ArrayFromHandleDropNullElements overload with NSNullBehavior parameter.
  • Rewrite FromArray to use ArrayFromHandleDropNullElements.
  • Update UIFontDescriptor.CascadeList to use ToNonNullArrayDropNullElements.
  • Update bgen to append '!' for non-nullable wrapped array properties.
  • Fix MTKMesh.FromAsset to annotate sourceMeshes as MDLMesh[]?.
  • Add a test for MTKMesh.FromAsset.

Contributes towards #17285.

* Improve nullability annotations for FromArray<T> (accept NSArray?, return T[]?).
* Add a ToNonNullArrayDropNullElements<T> variant that guarantees a non-null return value.
* Add an ArrayFromHandleDropNullElements overload with NSNullBehavior parameter.
* Rewrite FromArray<T> to use ArrayFromHandleDropNullElements.
* Update UIFontDescriptor.CascadeList to use ToNonNullArrayDropNullElements.
* Update bgen to append '!' for non-nullable wrapped array properties.
* Fix MTKMesh.FromAsset to annotate sourceMeshes as MDLMesh[]?.
* Add a test for MTKMesh.FromAsset.

Contributes towards #17285.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves nullability correctness and array conversion behavior for Apple bindings/tests, and adds coverage for MetalKit’s MTKMesh.FromAsset wrapper.

Changes:

  • Update NSArray.FromArray<T> to use the newer handle-based conversion path and add helpers for “drop null elements” conversions.
  • Adjust MetalKit MTKMesh.FromAsset nullability and add a new NUnit test for the API.
  • Resolve a MetalKit type name ambiguity in registrar tests and simplify UIFontDescriptor.CascadeList using the new NSArray helper.

Reviewed changes

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

Show a summary per file
File Description
tests/monotouch-test/ObjCRuntime/RegistrarTest.cs Qualifies MetalKit types with global:: to avoid namespace/type ambiguity.
tests/monotouch-test/Metal/MTKMeshTest.cs Adds a new test validating MTKMesh.FromAsset behavior.
src/UIKit/UIFontDescriptor.cs Uses a new NSArray helper to return a non-null cascade list (empty when absent).
src/MetalKit/MTKMesh.cs Updates FromAsset wrapper signature to reflect nullable sourceMeshes.
src/Foundation/NSArray.cs Adds handle-based “drop null elements” helper + updates FromArray<T> docs/signature/implementation.
src/bgen/Generator.cs Updates generated code for wrapped array properties to account for FromArray<T> now being annotated nullable.
Comments suppressed due to low confidence (1)

src/MetalKit/MTKMesh.cs:25

  • FromAsset can succeed with error == null (and fail with error != null), so the out NSError error parameter should be annotated as nullable (NSError?) to reflect actual behavior under nullable reference types. Otherwise the signature implies callers can always dereference error safely, which isn't true.
		public static MTKMesh []? FromAsset (MDLAsset asset, IMTLDevice device, out MDLMesh []? sourceMeshes, out NSError error)
		{
			NSArray aret;

			var ret = FromAsset (asset, device, out aret, out error);
			sourceMeshes = NSArray.FromArray<MDLMesh> (aret);
			return ret;

You can also share your feedback on Copilot code review. Take the survey.

@vs-mobiletools-engineering-service2
Copy link
Copy Markdown
Collaborator

✅ [CI Build #407ae51] Build passed (Build packages) ✅

Pipeline on Agent
Hash: 407ae5197b72b2068366033839c76cc39c9e6361 [PR build]

@vs-mobiletools-engineering-service2
Copy link
Copy Markdown
Collaborator

✅ [CI Build #407ae51] Build passed (Detect API changes) ✅

Pipeline on Agent
Hash: 407ae5197b72b2068366033839c76cc39c9e6361 [PR build]

@vs-mobiletools-engineering-service2
Copy link
Copy Markdown
Collaborator

✅ [CI Build #407ae51] Build passed (Build macOS tests) ✅

Pipeline on Agent
Hash: 407ae5197b72b2068366033839c76cc39c9e6361 [PR build]

@vs-mobiletools-engineering-service2
Copy link
Copy Markdown
Collaborator

✅ API diff for current PR / commit

NET (empty diffs)

✅ API diff vs stable

NET (empty diffs)

ℹ️ Generator diff

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

Pipeline on Agent
Hash: 407ae5197b72b2068366033839c76cc39c9e6361 [PR build]

@vs-mobiletools-engineering-service2
Copy link
Copy Markdown
Collaborator

🚀 [CI Build #407ae51] Test results 🚀

Test results

✅ All tests passed on VSTS: test results.

🎉 All 156 tests passed 🎉

Tests counts

✅ cecil: All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (iOS): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (MacCatalyst): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (macOS): All 1 tests passed. 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. 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

macOS tests

✅ Tests on macOS Monterey (12): All 5 tests passed. Html Report (VSDrops) Download
✅ Tests on macOS Ventura (13): All 5 tests passed. Html Report (VSDrops) Download
✅ Tests on macOS Sonoma (14): All 5 tests passed. Html Report (VSDrops) Download
✅ Tests on macOS Sequoia (15): All 5 tests passed. Html Report (VSDrops) Download
✅ Tests on macOS Tahoe (26): All 5 tests passed. Html Report (VSDrops) Download

Pipeline on Agent
Hash: 407ae5197b72b2068366033839c76cc39c9e6361 [PR build]

@rolfbjarne rolfbjarne enabled auto-merge (squash) March 11, 2026 16:33
@rolfbjarne rolfbjarne merged commit bb1797a into main Mar 11, 2026
52 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants