From 54d1647a5cc11be5f9ab7c6ab8381d31ae169079 Mon Sep 17 00:00:00 2001 From: Kevin Sawicki Date: Tue, 14 Jun 2016 15:20:29 -0700 Subject: [PATCH 1/3] Mention dialog entitlements --- .../mac-app-store-submission-guide.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/tutorial/mac-app-store-submission-guide.md b/docs/tutorial/mac-app-store-submission-guide.md index b2c08e8849f9..bc03ddd9110f 100644 --- a/docs/tutorial/mac-app-store-submission-guide.md +++ b/docs/tutorial/mac-app-store-submission-guide.md @@ -166,6 +166,30 @@ Also, due to the usage of app sandboxing, the resources which can be accessed by the app are strictly limited; you can read [App Sandboxing][app-sandboxing] for more information. +### Additional Entitlements + +Depending on which Electron APIs your app uses, you may need to add additional +entitlements to your `parent.plist` file to be able to use these certain APIs +from your app's Mac App Store build. + +#### dialog.showOpenDialog + +```xml +com.apple.security.files.user-selected.read-only + +``` + +See [Apple documentation](https://developer.apple.com/library/mac/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html#//apple_ref/doc/uid/TP40011195-CH4-SW6). + +#### dialog.showSaveDialog + +```xml +com.apple.security.files.user-selected.read-write + +``` + +See [Apple documentation](https://developer.apple.com/library/mac/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html#//apple_ref/doc/uid/TP40011195-CH4-SW6). + ## Cryptographic Algorithms Used by Electron Depending on the country and region you are located, Mac App Store may require From bfde8b02bb0f003ba714675b320a592de662d0c5 Mon Sep 17 00:00:00 2001 From: Kevin Sawicki Date: Tue, 14 Jun 2016 15:22:12 -0700 Subject: [PATCH 2/3] Drop the certain --- docs/tutorial/mac-app-store-submission-guide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/tutorial/mac-app-store-submission-guide.md b/docs/tutorial/mac-app-store-submission-guide.md index bc03ddd9110f..32f36a93b556 100644 --- a/docs/tutorial/mac-app-store-submission-guide.md +++ b/docs/tutorial/mac-app-store-submission-guide.md @@ -169,8 +169,8 @@ more information. ### Additional Entitlements Depending on which Electron APIs your app uses, you may need to add additional -entitlements to your `parent.plist` file to be able to use these certain APIs -from your app's Mac App Store build. +entitlements to your `parent.plist` file to be able to use these APIs from your +app's Mac App Store build. #### dialog.showOpenDialog From 5c5fb0e39e3939305e5030b9c41f7ec6a5cbd5af Mon Sep 17 00:00:00 2001 From: Kevin Sawicki Date: Tue, 14 Jun 2016 15:24:05 -0700 Subject: [PATCH 3/3] Tweak documentation link --- docs/tutorial/mac-app-store-submission-guide.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/tutorial/mac-app-store-submission-guide.md b/docs/tutorial/mac-app-store-submission-guide.md index 32f36a93b556..80a2f8acc9f1 100644 --- a/docs/tutorial/mac-app-store-submission-guide.md +++ b/docs/tutorial/mac-app-store-submission-guide.md @@ -179,7 +179,8 @@ app's Mac App Store build. ``` -See [Apple documentation](https://developer.apple.com/library/mac/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html#//apple_ref/doc/uid/TP40011195-CH4-SW6). +See the [Enabling User-Selected File Access documentation][user-selected] for +more details. #### dialog.showSaveDialog @@ -188,7 +189,8 @@ See [Apple documentation](https://developer.apple.com/library/mac/documentation/ ``` -See [Apple documentation](https://developer.apple.com/library/mac/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html#//apple_ref/doc/uid/TP40011195-CH4-SW6). +See the [Enabling User-Selected File Access documentation][user-selected] for +more details. ## Cryptographic Algorithms Used by Electron @@ -237,3 +239,4 @@ ERN)][ern-tutorial]. [app-sandboxing]: https://developer.apple.com/app-sandboxing/ [ern-tutorial]: https://carouselapps.com/2015/12/15/legally-submit-app-apples-app-store-uses-encryption-obtain-ern/ [temporary-exception]: https://developer.apple.com/library/mac/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/AppSandboxTemporaryExceptionEntitlements.html +[user-selected]: https://developer.apple.com/library/mac/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html#//apple_ref/doc/uid/TP40011195-CH4-SW6