Installing OpenSSL on macOS

Gruff users: if you were directed to this page, that means you must install OpenSSL to use a certain features of Gruff.

OpenSSL is no longer included with Allegro CL 10.1 or product downloads based on 10.1, including some versions of Gruff (the ones built on 10.1).

This change is due to Apple's handling of OpenSSL. We have two issues with the changes:

Since they are not supporting OpenSSL, it will not get timely security fixes, and that is a serious concern for anyone using OpenSSL, and
They stopped making the OpenSSL header files available to developers, which prevents us from building any products that use it.

How to install OpenSSL on macOS

Apple does not supply OpenSSL libraries for applications, so you must install one for use with Allegro CL or Allegro CL-based applications:

Download the appropriate MacPorts installer for your version of macOS.
Execute the downloaded file (with a .pkg extension) and follow the prompts. Once the installer exits, continue to the next step.
Open Terminal.app and type:
```
$ sudo /opt/local/bin/port -N install openssl +universal
```
Unless you already have Xcode installed, there will a popup that gives you three choices:
1. Get Xcode: you will be directed to the App store to download Xcode, which is quite large (~4.5GB).
2. Not Now: nothing will be download and the installation of OpenSSL will fail.
3. Install: only the command line Xcode compilers will be installed, and the download is relatively small (it is hard to determine the exact size but it happens fairly quickly).
Select Install.

If successful, the last two lines of the installation will be:
```
---> No broken files found.
---> No broken ports found.
```
Otherwise, see the next section for tips on possible fixes.

If you cannot find the solution to your problem in this section, please email our support team.

You may ignore the following warnings:

Warning: xcodebuild exists but failed to execute
Warning: Xcode does not appear to be installed; most ports will likely fail to build.

If you get this error:
```
Error: Unable to determine location of a macOS SDK.
Error: Unable to open port: can't read "configure.sdkroot": Unable to determine location of a macOS SDK.
```
The likely cause of this is an Xcode version too old for the version of macOS you are running. This can happen as you upgrade to newer macOS versions. Update the software on your Mac and retry the procedure in the section above.