SME Mac Tools Packager

The SME Mac Tools Packager is an application that allows you to provide branded versions of the SME Mac Tools to your users.

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.

This guide walks you through the various prerequisites and usage of the Packager.

Pre-Requisites

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:

xcode-select --install 

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 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.

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

Branding

You can enter name for the new tools to be generated in this field

Default API endpoint

Here you enter the appliance URL/endpoint proceeding with “/api”

Main URL

Appliance URL should be entered here.

Terms of use URL

Enter the link for your company’s terms of use here

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.

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

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

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.

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.

Large icon

This replaces the Tools icon in System Preferences.

Drive menu (offline)

This icon is displayed in menu bar when the drive is offline

Drive menu (online)

This icon is displayed in menu bar when the drive is started and is online.

Padlock

This icon is displayed in front of the locked files in the drive.

Drive Volume Icon

This icon is displayed in the finder window. When users access their account using the drive.

Search tool

This icon is displayed in the menu bar for the search add-on

Sync icon

This icon is displayed in menu bar when sync is running

Paused sync

This icon is displayed in menu bar when sync is paused

Sync failure

This icon is displayed in menu bar if the sync fails

Mail Plugin

This is the SME mail add-in icon that appears on the top left when user composes a new email.

Share tool

This icon is displayed in the menu bar for the share tool add-on

This image will be displayed as the background for the tools installer.

Here you can provide instruction and links for the users to see when installing the tools.

Here you can provide links for your company Terms of use, privacy policy or any other company policy that the users will/can see during the installation of the tools.

Once these configurations have been setup, you can click on Generate installer button and to generate the tools.

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 this page.

This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies