File Fabric Mac Tools Packager Legacy (deprecated)
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.
The Packager is wizard-driven to enable customization of logs/icons and specific features that can be turned on/off.
This guide walks you through the various prerequisites and usage of the Packager.
Install "Packages" Application
You will need to begin by downloading the Packages application.
This can be downloaded from here
Install XCode Commandline Tools
The XCode Commandline Tools will be required. To install these, from your Terminal, run the following command:
Generate Developer ID Application & Installer Certificates
You will need an active Apple Mac Developer Program account. To click here 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.
From your Account select (Developer) Account Help.
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 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.
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.
You will need to generate an app-specific password using the following guide
You will need to retain this App-specific password for use whe building the Packaged tools
Default API endpoint
If the following options are checked, then by default these options will be enabled in the Tools:
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.
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
In this field enter the default encryption/decryption passphrase
If checked then user will only be able to access the appliance using secure connection.
Deleted files handling
From the dropdown, select how you want the tools to handle deleted files during sync. There are three options:
- Ask user what to do (default)
- If a file is deleted in the sync pair, then the sync will not proceed without user intervention
- Delete the file
- If a file is deleted in the sync pair, then the sync will delete the file from the corresponding sync pair folder
- 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
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.
For branding replace the SME default icons with you company branded icons. When creating icons, you should be aware of their compatibility with Mac OS X.
Drive menu (offline)
Drive menu (online)
Drive Volume Icon
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.
Please refer to this page.