apotocki / openssl-iosx

Builds OpenSSL static libraries and packages them as XCFrameworks (ssl & crypto) for iOS (simulator and device), visionOS (simulator and device), macOS and Mac Catalyst (Intel & Apple Silicon M1).

OpenSSL for iOS, visionOS, macOS (Intel & Apple Silicon M1) & Catalyst - arm64 / x86_64

Supported 3.3.X versions: 3.3.0

Supported 3.2.X versions: 3.2.1, 3.2.0

Supported 3.1.X versions: 3.1.5, 3.1.4, 3.1.3, 3.1.2, 3.1.1, 3.1.0

Supported 3.0.X versions: 3.0.13, 3.0.12, 3.0.11, 3.0.10, 3.0.9, 3.0.8, 3.0.8, 3.0.7

Supported 1.1.1X versions: 1.1.1w, 1.1.1v, 1.1.1u, 1.1.1t, 1.1.1s, 1.1.1q, 1.1.1p, 1.1.1o, 1.1.1n, 1.1.1m, 1.1.1l, 1.1.1k, 1.1.1j, 1.1.1i

Use the appropriate tag or branch to choose a version.

This repository provides a universal script for building static OpenSSL libraries for use in iOS, visionOS, and macOS & Catalyst applications. The actual library version is taken from https://github.com/openssl/openssl with an appropriate tag like 'OpenSSL_1_1_1w' or 'openssl-3.2.1'

Prerequisites

1. Xcode must be installed because xcodebuild is used to create xcframeworks
2. xcode-select -p must point to Xcode app developer directory (by default e.g. /Applications/Xcode.app/Contents/Developer). If it points to CommandLineTools directory you should execute: sudo xcode-select --reset or sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
3. For the creation of visionOS related artifacts and their integration into the resulting xcframeworks, XROS.platform and XRSimulator.platform should be available in the folder: /Applications/Xcode.app/Contents/Developer/Platforms

How to build?

• Manually

    # clone the repo
    git clone https://github.com/apotocki/openssl-iosx
    
    # build libraries
    cd openssl-iosx
    scripts/build.sh

    # have fun, the result artifacts will be located in 'frameworks' folder.

• Use cocoapods. Add the following lines into your project's Podfile:

    use_frameworks!
    pod 'openssl-iosx', '~> 3.3.0'
    # or optionally more precisely
    # pod 'openssl-iosx', :git => 'https://github.com/apotocki/openssl-iosx', :tag => '3.3.0.0'

install new dependency:

   pod install --verbose

As an advertisement…

Please check out my iOS application on the App Store:

	PotoHEX HEX File Viewer & Editor

This application is designed to view and edit files at the byte or character level; calculate different hashes, encode/decode, and compress/decompress desired byte regions.

You can support my open-source development by trying the App.

Feedback is welcome!