Added docs for "Support for Mac App Store"

Cong Liu · rogerwang · commit ffd22a8675e6 · 2017-01-16T13:56:19.000+08:00
diff --git a/docs/For Users/Advanced/Support for Mac App Store.md b/docs/For Users/Advanced/Support for Mac App Store.md
@@ -0,0 +1,77 @@
+# Support for Mac App Store {: .doctitle}
+---
+
+[TOC]
+
+## Overview
+
+You can distribute your macOS apps through official Mac App Store or outside the store. But the apps should always be signed before distribution. Unsigned apps are refused to be launched by the [Gatekeeper](https://support.apple.com/en-us/HT202491).
+
+This guide will show you how to sign NW.js based apps for macOS.
+
+## Prerequisits
+
+* Create a macOS app through [iTunesConnect](https://itunesconnect.apple.com)
+* Obtain Application & Installer certificates from [Apple Developer](https://developer.apple.com).
+    - If you distribute your app through **Mac App Store**:
+        + 3rd Party Mac Developer Application: Foo (XXXXXXXXXX)
+        + 3rd Party Mac Developer Installer: Foo (XXXXXXXXXX)
+    - If you distribute your app **outside the store**:
+        + Developer ID Application: Foo (XXXXXXXXXX)
+        + Developer ID Installer: Foo (XXXXXXXXXX)
+
+## Build the App
+
+Download NW.js MAS build from [nwjs.io](http://dl.nwjs.io/v0.19.5-mas-beta/) and build your app as described in [Package and Distribute](../Package and Distribute.md).
+
+## Sign the App
+
+`build_mas.py` is used to sign your app for macOS. And the script can generate an uploadable `.pkg` file for Mac App Store after signing by giving `--pkg` argument.
+
+**Basic Usage**
+
+```bash
+python build_mas.py -C build.cfg -I myapp-dev.app -O MyApp.app
+```
+
+## Configuration File Format
+
+Configuration file (`build.cfg`) is a human readable text file. It contains important settings for signing and packaging the app.
+
+`ApplicationIdentity` and `InstallerIdentity` are the names of the certificates used for signing and packaging your app. See [Prerequisits](#prerequisits) for which certificates you need.
+
+`NWTeamID` is used to establish IPC channels for launch NW.js based app. It can be obtained from Apple Developer -> Membership -> Team ID.
+
+`ParentEntitlements` and `ChildEntitlements` should be valid [entitlements files](https://developer.apple.com/library/content/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/AboutEntitlements.html). By default, your app is signed with minimal privileges as below.
+
+**entitlements-parent.plist**
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>com.apple.security.app-sandbox</key>
+  <true/>
+  <key>com.apple.security.application-groups</key>
+  <string>NWTeamID.your.app.bundle.id</string>
+</dict>
+</plist>
+```
+
+**entitlements-child.plist**
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>com.apple.security.app-sandbox</key>
+  <true/>
+  <key>com.apple.security.inherit</key>
+  <true/>
+</dict>
+</plist>
+```
+
+Read the sample `build.cfg` for detailed meanings all fields.
diff --git a/docs/For Users/Package and Distribute.md b/docs/For Users/Package and Distribute.md
@@ -93,7 +93,7 @@ On Mac OS X, you need to modify following files to have your own icon and bundle
 * `Contents/Resources/nw.icns`: icon of your app. `nw.icns` is in [Apple Icon Image Format](https://en.wikipedia.org/wiki/Apple_Icon_Image_format). You can convert your icon in PNG/JPEG format into ICNS by using tools like [Image2Icon](http://www.img2icnsapp.com/).
 * `Contents/Info.plist`: the apple package description file. You can view [Implementing Cocoa's Standard About Panel](http://cocoadevcentral.com/articles/000071.php) on how this file will influence your app and what fields you should modify.
 
-And you should sign you Mac app. Or the user won't launch the app if Gatekeeper is turned on. See [Signed Apps or Installer Packages](https://developer.apple.com/library/mac/documentation/IDEs/Conceptual/AppDistributionGuide/DistributingApplicationsOutside/DistributingApplicationsOutside.html) for details.
+You should sign your Mac app, or the user won't launch the app if Gatekeeper is turned on. See [Support for Mac App Store](Advanced/Support for Mac App Store.md) for details.
 
 ## References
 
diff --git a/docs/index.md b/docs/index.md
@@ -25,6 +25,7 @@ The source of the document is in [our git repo](https://github.com/nwjs/nw.js/tr
         + [JavaScript Contexts in NW.js](For Users/Advanced/JavaScript Contexts in NW.js.md)
         + [Protect JavaScript Source Code](For Users/Advanced/Protect JavaScript Source Code.md)
         + [Security in NW.js](For Users/Advanced/Security in NW.js.md)
+        + [Support for Mac App Store](For Users/Advanced/Support for Mac App Store.md)
         + [Test with ChromeDriver](For Users/Advanced/Test with ChromeDriver.md)
         + [Use Flash Plugin](For Users/Advanced/Use Flash Plugin.md)
         + [Use NaCl in NW.js](For Users/Advanced/Use NaCl in NW.js.md)
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -37,6 +37,7 @@ pages:
             - 'JavaScript Contexts in NW.js': 'For Users/Advanced/JavaScript Contexts in NW.js.md'
             - 'Protect JavaScript Source Code': 'For Users/Advanced/Protect JavaScript Source Code.md'
             - 'Security in NW.js': 'For Users/Advanced/Security in NW.js.md'
+            - 'Support for Mac App Store': 'For Users/Advanced/Support for Mac App Store.md'
             - 'Test with ChromeDriver': 'For Users/Advanced/Test with ChromeDriver.md'
             - 'Transparent Window': 'For Users/Advanced/Transparent Window.md'
             - 'Use Flash Plugin': 'For Users/Advanced/Use Flash Plugin.md'
