diff --git a/tutorials/Signing_and_notarization_on_macOS/README.md b/tutorials/Signing_and_notarization_on_macOS/README.md index 51fe760b3d..1a34c473e0 100644 --- a/tutorials/Signing_and_notarization_on_macOS/README.md +++ b/tutorials/Signing_and_notarization_on_macOS/README.md @@ -15,22 +15,22 @@ for distribution on macOS. * [Xcode](https://developer.apple.com/xcode/). The tutorial was checked with Xcode 12.3. * JDK 15+. The tutorial was checked with OpenJDK 15.0.1. -## Preparing a Developer ID certificate +## Preparing a certificate -You will need a Developer ID certificate for signing your app. +You will need a certificate for signing your app. -#### Checking existing Developer ID certificates +#### Checking existing certificates Open https://developer.apple.com/account/resources/certificates -#### Creating a new Developer ID certificate -1. [Create a certificate signing request](https://help.apple.com/developer-account/#/devbfa00fef7): +#### Creating a new certificate +1. [Create a certificate signing request](https://developer.apple.com/help/account/create-certificates/create-a-certificate-signing-request): * Open `Keychain Access`. * Open the menu dialog ``` Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority ``` - * Enter your Developer ID email and common name. + * Enter your certificate email and common name. * Check `Save to disk` option. 2. Create and install a new certificate using your [Apple Developer account](https://developer.apple.com/account/): * Open https://developer.apple.com/account/resources/certificates/add @@ -104,7 +104,7 @@ Note that you need to create two of these profiles, one for your app and another ## Creating an app-specific password To be able to upload an app for notarization, -you will need an app-specific password associated with your Apple ID. +you will need an app-specific password associated with your Apple ID. Notarization is only required for apps outside the App Store. Follow these steps to generate a new password: 1. Sign in to your [Apple ID](https://appleid.apple.com/account/home) account page. @@ -223,6 +223,8 @@ Those properties could be stored in `$HOME/.gradle/gradle.properties` to use acr ### Configuring notarization settings +Notarization is only required for apps outside the App Store. + ``` kotlin macOS { notarization { @@ -369,9 +371,10 @@ Apple, and they may be able to give you a more detailed error message. ## Using Gradle The following tasks are available: -* Use `createDistributable` or `packageDmg` to get a signed application +* Use `createDistributable`, `packageDmg`, or `packagePkg` to get a signed application (no separate step is required). -* Use `notarize` (e.g. `notarizeDmg`) to upload an application for notarization. +* Use `notarize` (e.g. `notarizeDmg`) to upload an application for notarization. + Notarization is only required for apps outside the App Store. Once the upload finishes, a `RequestUUID` will be printed. The notarization process takes some time. Once the notarization process finishes, an email will be sent to you.