[rolfbjarne]

---

Internal previews

File	Preview link
docs/ios/building-apps/build-items.md	Learn preview
docs/ios/building-apps/build-properties.md	Learn preview
docs/ios/building-apps/build-targets.md	Learn preview

Build report

[Copilot]

🟡 Changes recommended

The artifact-writing example loses entries when multiple artifacts exist, and the overview link needs a valid destination.

2 open issues

• Prevent artifact metadata overwrite across batches · New
• Fix broken link to missing documentation page · New

What changed in this PR

Updates the Apple-platform MSBuild reference for the macios release targeting Xcode 27.0.

Changes:

• Documents application artifact collection, metadata, and extension targets.
• Adds build properties and updates runtime, packaging, and launch guidance.
• Clarifies image asset support for Icon Composer directories.

File	Description
docs/​ios/​building-apps/​build-targets.md	Documents artifact retrieval and extension hooks.
docs/​ios/​building-apps/​build-properties.md	Expands property documentation and updates defaults.
docs/​ios/​building-apps/​build-items.md	Documents artifact metadata and image asset formats.

_{Review effort: Balanced}

[Copilot]

🔵 Needs a closer look

Several documented settings and artifact guarantees need correction to match SDK behavior.

No open issues 🎉

5 previously missed issues

In code that hasn't changed since last review

Clarify application metadata availability after Build

docs/​ios/​building-apps/​build-items.md:261

A plain Build does not populate the listed Application* metadata. _AddAppleApplicationArtifactMetadata adds those fields through GetApplicationArtifacts, which Publish also invokes. State this requirement so consumers do not expect application names and versions to be available in an AfterTargets="Build" target. The example below uses only PackageFormat, so it can remain unchanged.

Document disabled linker mode for .NET 11+

docs/​ios/​building-apps/​build-properties.md:726

An empty value is not a reliable opt-out on .NET 11+: Xamarin.Shared.Sdk.props uses an empty value to select the default compatibility or strict mode. Document the explicit disabled value accepted by the linker so readers can disable inlining without depending on property evaluation order.

Clarify WaitForExit behavior with direct app launches

docs/​ios/​building-apps/​build-properties.md:1545

On macOS and Mac Catalyst, this setting controls waiting only when launching through open. As the existing RunWithOpen section explains, RunWithOpen=false executes the app directly and dotnet run waits until it exits, even with WaitForExit=false. Document that limitation so readers do not expect the direct launch to return immediately.

Clarify .NET 11+ SDK location lookup behavior

docs/​ios/​building-apps/​build-properties.md:1820

DetectSdkLocations.ExecuteImpl disables the environment-variable and settings-file lookups for projects targeting .NET 11 or later. These settings are already ignored for those projects, not merely deprecated for future removal. Qualify the lookup steps and warning by framework version so readers do not configure an ignored Xcode path.

Document missing app bundles for Windows-to-Mac builds

docs/​ios/​building-apps/​build-targets.md:58

_CollectAppleAppBundleOutput explicitly excludes IsRemoteBuild=true, so Windows Pair to Mac builds do not return an .app artifact even for ordinary application projects. Qualify this guarantee so Windows consumers do not expect a bundle that the target deliberately omits.

2 resolved since last review

• Fix broken link to missing documentation page
• Prevent artifact metadata overwrite across batches

_{Review effort: Balanced}