Skip to content

Commit 115eefc

Browse files
Copilotagocke
andcommitted
Fix macOS branding and add debugging entitlements
Co-authored-by: agocke <[email protected]>
1 parent 18f8a41 commit 115eefc

File tree

1 file changed

+12
-5
lines changed

1 file changed

+12
-5
lines changed

docs/core/deploying/macos.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
---
2-
title: Publish .NET apps for Mac OS
3-
description: Learn how to publish .NET applications for Mac OS, including signing, notarization, and app entitlements.
2+
title: Publish .NET apps for macOS
3+
description: Learn how to publish .NET applications for macOS, including signing, notarization, and app entitlements.
44
author: agocke
55
ms.author: angocke
66
ms.date: 10/22/2025
77
ms.topic: how-to
88
ai-usage: ai-assisted
99
---
1010

11-
# Publish .NET apps for Mac OS
11+
# Publish .NET apps for macOS
1212

13-
Publishing .NET applications for Mac OS requires several additional steps compared to other platforms, due to Apple's security requirements.
13+
Publishing .NET applications for macOS requires several additional steps compared to other platforms, due to Apple's security requirements.
1414

1515
## Prerequisites
1616

17-
Before you publish your .NET application for Mac OS, ensure you have the following:
17+
Before you publish your .NET application for macOS, ensure you have the following:
1818

1919
- **Apple Developer Account**: Needed for code signing and notarization.
2020
- **Xcode Command Line Tools**: Provides `codesign`, `altool`, and other utilities.
@@ -36,6 +36,13 @@ For CoreCLR apps, the `com.apple.security.cs.allow-jit` entitlement is required.
3636

3737
For Native AOT apps, no entitlements are required.
3838

39+
### Optional entitlements for debugging and diagnostics
40+
41+
The following entitlements enable additional debugging and diagnostic capabilities:
42+
43+
- **`com.apple.security.get-task-allow`**: Needed for dump collection with `createdump` and `dotnet dump`.
44+
- **`com.apple.security.cs.debugger`**: Needed to attach a debugger to the process.
45+
3946
## Sign and notarize
4047

4148
Use Apple's developer documentation to sign and notarize the binary.

0 commit comments

Comments
 (0)