Differences

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

--- packagers/macos [2019_11_01 11:11] – zim
+++ packagers:macos [2023_06_22 05:41] – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== SME Mac Tools Packager ======
+====== File Fabric Mac Tools Packager Legacy (deprecated) ======
-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 File Fabric Mac Tools Packager is an application that enables companies to customize the features and branding of the File Fabric Mac App suite to create a specific version for their end users.
-  * Pre-Requisites
+The Packager is wizard-driven to enable customization of logs/icons and specific features that can be turned on/off.
-  * Configuration
-  * Images
+This guide walks you through the various prerequisites and usage of the Packager.
-  * Installer
-  * Installer readme
-  * Licence
 ==== Pre-Requisites ====
-- SME Mac Packager Application
-- Install Apple Command Line Developer Tools
-- Mac Developer Account to obtain signing certificates
+=== 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 **[(Developer) Account Help](https://help.apple.com/developer-account/)**.
+From **(Developer) Account Help** then select **Certificates, IDs & Profiles**. If you don't see this option you may not have the required role. See [Create Developer ID certificates](https://help.apple.com/developer-account/#/dev04fd06d56) for more information.
+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.
-{image 1}
+Download the generated certificate, Right Click an oepn with Keychain Access.
-=== Mac Developer Account ===
+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.
+You will need to generate an app-specific password using the [following guide](https://support.apple.com/en-us/HT204397)
+You will need to retain this App-specific password for use whe building the Packaged tools
+\\ \\
 ===== Configuration =====
@@ Line 27: / Line 78: @@
 {{:/packagers:macos:images:sme_mpss1.png}}
+\\ \\
 === Default API endpoint ===
@@ Line 33: / Line 84: @@
 {{:/packagers:macos:images:sme_mpss2.png}}
+\\ \\
 === Main URL ===
@@ Line 39: / Line 90: @@
 {{:/packagers:macos:images:sme_mpss3.png}}
+\\ \\
 === Terms of use URL ===
@@ Line 47: / Line 98: @@
 {{:/packagers:macos:images:sme_mpss5.png}}
+\\ \\
 === Enable virtual drive ===
 When checked, this option will enable the cloud drive for use. An icon will appear in the menu bar, from where the drive can be star
+\\ \\
 === Enable Finder services ===
 If checked this will show Cloud action options in Finder>>Services>>System Preferences.
+\\ \\
 === Start drive automatically ===
 This option if checked will ensure that on login to the machine the drive will start automatically
+\\ \\
 === Enable automatic sync ===
 With automatic sync enabled users can sync local folder with cloud folder without any intervention.
+\\ \\
 === Quick upload ===
 Here you can provide the path for the quick upload option
+\\ \\
 === Enable search plugin ===
 If checked a search icon will appear in the menu bar to provide search for your user appliance account search.
+\\ \\
 === Decrypt file on download ===
 When selected, on download the files will be automatically decrypted using the provided passphrase
+\\ \\
 === Encrypt file on upload ===
 When selected, on upload the files will be automatically encrypted using the provided passphrase
+\\ \\
 === Encryption passphrase ===
 In this field enter the default encryption/decryption passphrase
+\\ \\
 === Force HTTPS ===
 If checked then user will only be able to access the appliance using secure connection.
+\\ \\
 === Deleted files handling ===
@@ Line 97: / Line 148: @@
   * Reinstate the file
     * If a file is deleted in the sync pair, then the sync will reinstate the file to the folder it was deleted from.
+\\ \\
 === Sync ignores hidden files ===
 If checked then any hidden files present in the sync pair will not be synced.
+\\ \\
 === Sync ignore extensions ===
 In this field enter the file extensions you want to ignore on sync
+\\ \\
 === Default State ===
 If checked then the tools default state will be OFF.
+\\ \\
 === Enable menu bar share plug-in ===
 If enabled, user will see the share icon in the ribbon when the tools are started.
+\\ \\
 ===== Images =====
@@ Line 119: / Line 170: @@
 {{:/packagers:macos:images:sme_mpss6.png}}
+\\ \\
 === Large icon ===
@@ Line 125: / Line 176: @@
 {{:/packagers:macos:images:sme_mpss7.png}}
+\\ \\
 === Drive menu (offline) ===
@@ Line 131: / Line 182: @@
 {{:/packagers:macos:images:sme_mpss8.png}}
+\\ \\
 === Drive menu (online) ===
@@ Line 137: / Line 188: @@
 {{:/packagers:macos:images:sme_mpss9.png}}
+\\ \\
 === Padlock ===
@@ Line 143: / Line 194: @@
 {{:/packagers:macos:images:sme_mpss10.png}}
+\\ \\
 === Drive Volume Icon ===
@@ Line 149: / Line 200: @@
 {{:/packagers:macos:images:sme_mpss11.png}}
+\\ \\
 === Search tool ===
@@ Line 155: / Line 206: @@
 {{:/packagers:macos:images:sme_mpss12.png}}
+\\ \\
 === Sync icon ===
@@ Line 161: / Line 212: @@
 {{:/packagers:macos:images:sme_mpss13.png}}
+\\ \\
 === Paused sync ===
@@ Line 167: / Line 218: @@
 {{:/packagers:macos:images:sme_mpss14.png}}
+\\ \\
 === Sync failure ===
@@ Line 173: / Line 224: @@
 {{:/packagers:macos:images:sme_mpss15.png}}
+\\ \\
 === Mail Plugin ===
@@ Line 179: / Line 230: @@
 {{:/packagers:macos:images:sme_mpss16.png}}
+\\ \\
 === Share tool ===
@@ Line 185: / Line 236: @@
 {{:/packagers:macos:images:sme_mpss17.png}}
+\\ \\
 ===== Installer =====
@@ Line 191: / Line 242: @@
 {{:/packagers:macos:images:sme_mpss18.png}}
+\\ \\
 ===== Installer readme =====
@@ Line 197: / Line 248: @@
 {{:/packagers:macos:images:sme_mpss19.png}}
+\\ \\
 ===== Licence =====
@@ Line 205: / Line 256: @@
 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 ===
 Please refer to [[packagers/cloudedit_branding|this page]].