Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
packagers/macos [2019_11_19 11:09] – [Pre-Requisites] zimpackagers/macos [2019_11_26 11:19] – smeadmin
Line 1: Line 1:
 ====== SME Mac Tools Packager ====== ====== SME Mac Tools Packager ======
  
-Download the latest version of SME Mac Packager. Before installing the Packager software, please install Mac Developer Sign in keys on your machine. Once the Packager software is installed, to generate tools there are following configurations that need setting up. These are available in the following tabs:+The SME Mac Tools Packager is an application that allows you to provide branded versions of the SME Mac Tools to your users. 
  
-  * Pre-Requisites +The Packager provides a graphical interface where you can control a number of the available default settings and controls as well as configuring logos and icons used.  
-  * Configuration + 
-  * Images +This guide walks you through the various prerequisites and usage of the Packager. 
-  * Installer +
-  * Installer readme +
-  * Licence+
  
 ==== Pre-Requisites ==== ==== Pre-Requisites ====
  
-- SME Mac Packager Application  
  
-- Install Apple Command Line Developer Tools+=== Install "Packages" Application === 
 + 
 +You will need to begin by downloading the Packages application.  
 + 
 +This can be downloaded from [here](http://s.sudre.free.fr/Software/Packages/about.html) 
 + 
 + 
 + 
 + 
 +=== Install XCode Commandline Tools === 
 + 
 +The XCode Commandline Tools will be required. To install these, from your **Terminal**, run the following command: 
 + 
 +``` 
 +xcode-select --install  
 +``` 
 + 
 +=== Generate Developer ID Application & Installer Certificates === 
 + 
 +You will need an active Apple Mac Developer Program account. To [click here](https://developer.apple.com) and then follow the steps to enroll. 
 + 
 +When the account has been created, use your Apple ID to Sign In to [Apple's Developer platform](https://developer.apple.com).  
 + 
 +From your **Account** select **Certificates, IDs & Profiles**.  
 + 
 +Select the + button to create a new certificate.  
 + 
 +From the list of options under **Software** select **Developer ID Application**. 
 + 
 +Follow Apple's instructions to generate the Developer ID Application Certificate. This process will involve creating a Certificate Signing Request. The Apple Documentation on the interface will guide you through this process.  
 + 
 +Once you have uploaded your Certificate Signging Request to Apple, Apple will provide you with a valid Certificate. You should click **Download** and save this locally.  
 + 
 +Once the Certificate has downloaded. Right-click the file, and select to open with the **Keychain Access** application. When Keychain Access opens, under the **Certificates** category, you should see the "Developer ID Application" certificate in the list. Double clicking the certificate will show more details.  
 + 
 +Following the same steps as before, navigate to the **Certificates, Identifiers & Profiles** screen on the Apple Developer site, and click the + button again. This time select **Developer ID Installer** from under **Software** 
 + 
 +When prompted to select the Certificate Signing Request, upload the Certificate Signing Request that you created for the previous certificate.  
 + 
 +Download the generated certificate, Right Click an oepn with Keychain Access. 
 + 
 +Reviewing your Keychain Access **Certificates** you should now also see a "Developer ID Installer" certificate.  
 + 
 +In both the Developer ID Installer and Developer ID Application certificates, they should both have expandable arrows to the left, and when expanded, you should see the Private Key. It is imperative to ensure that this is the case.  
 + 
 +To further confirm that the Developer ID Application & Installer certificates are installed, you can run the following command: 
 + 
 +``` 
 +security -v find-identity |grep Developer\ ID |cut -c 47- 
 +``` 
 + 
 +=== Generate iCloud "App-specific Password" === 
 + 
 +Since the release of macOS Catalina, Notarization of the generated application is required at the end of the process.  
 + 
 +In order to notorize your application, the Packager requires the Sign-In Credentials for your Developer Account in order to Notorize the application with Apple. 
  
-- Mac Developer Account to obtain signing certificates +You will need to generate an app-specific password using the [following guide](https://support.apple.com/en-us/HT204397)
  
-{image 1} +You will need to retain this App-specific password for use whe building the Packaged tools
-=== Mac Developer Account ===+
  
- 1. You will need an Apple Mac Developer Program account — you can register from: 
-https://developer.apple.com/programs/mac/ (click Enroll Now) and follow Apple’s instructions. 
- 2. When the account has been created, use your Apple ID to sign in from https:// developer.apple.com 
- 3. Click on “Mac” 
-{image3} 
- 4. Click on “Get Started in the right-hand side”, under “Certificates, identifiers and profiles” 
- 5. Under Mac Apps, click on ‘Certificates” 
-{image5} 
- 6. Under “Mac Apps” click on “All” then “+” 
-{image6} 
- 7. In the list, select “Developer ID” 
-{image7} 
- 8. Select “developer ID Application” 
-{image8} 
- 9. Follow Apple’s instructions to the end and download the generated file. 
-{image9a} 
-{image9b} 
- 10. Open the generated file. You have now generated the Developer ID Application.  
- 11. Repeat steps 6 to 10 but select “Developer ID installer” at step 8 this time. 
-You should now have valid signing keys for the Mac Tools. 
 ===== Configuration ===== ===== Configuration =====
  
Line 226: Line 256:
  
 Once these configurations have been setup, you can click on Generate installer button and to generate the tools. Once these configurations have been setup, you can click on Generate installer button and to generate the tools.
 +
 +===== Code Signing & Notorization =====
 +
 +At the bottom of the Packager configuration are 4 fields:
 +  * Code Signing Identity
 +  * Package signing identity
 +  * Username for notarization
 +  * Password for notarization 
 +
 +For the "Code Signing Identity" and "Package Signing Identity" you should select the Developer ID Application and Developer ID Installer Certificates retrospectively. As these certificates work in pairs, it's important to ensure that the identifier of the certificate (in brackets at the end) match in both dropdowns. 
 +
 +For the username and passwords, you will need to enter your Apple ID email and the App-specific password you generated in the earlier steps.  
  
 === CloudEdit Branding === === CloudEdit Branding ===
 Please refer to [[packagers/cloudedit_branding|this page]]. Please refer to [[packagers/cloudedit_branding|this page]].
  
© Copyright 2024 Nasuni.