OpenSSL-Universal
OpenSSL CocoaPods, Carthage and Swift Package Manager package for iOS and macOS. A complete solution to OpenSSL on iOS and macOS. The package comes with precompiled libraries and includes a script to build newer versions if necessary.
The current version contains binaries built with the latest iOS SDK (target 9.0), and the latest macOS SDK (target 3) for all supported architectures (including macOS Catalyst).
Support & Sponsors
The financial sustainability of the project is possible thanks to the ongoing contributions from our GitHub Sponsors
Premium Sponsors
Emerge Tools is a suite of revolutionary products designed to supercharge mobile apps and the teams that build them.
Architectures
- iOS with architectures: arm64 + simulator (x86_64, arm64)
- macOS with architectures: x86_64, arm64 (including Catalyst target)
Output Formats
- Static library libcrypto.a, libssl.a
- OpenSSL.framework
- OpenSSL.xcframework
Why?
Apple says: "Although OpenSSL is commonly used in the open source community, OpenSSL does not provide a stable API from version to version. For this reason, although OS X provides OpenSSL libraries, the OpenSSL libraries in OS X are deprecated, and OpenSSL has never been provided as part of iOS."
Installation
Build
You don't have to use the pre-built binaries I provide. You can build it locally on your trusted machine.
$ git clone https://github.com/krzyzanowskim/OpenSSL.git
$ cd OpenSSL
$ make
The result of a build process is put inside Frameworks directory.
Hardened Runtime (macOS) and Xcode
Binary OpenSSL.xcframework (Used by the Swift Package Manager package integration) won't load properly in your app if the app uses Sign to Run Locally Signing Certificate with Hardened Runtime enabled. It is possible to setup Xcode like this. To solve the problem you have two options:
- Use proper Signing Certificate, eg. Development <- this is the proper action
- Use
Disable Library Validationakacom.apple.security.cs.disable-library-validationentitlement
Swift Package Manager
dependencies: [
.package(url: "https://github.com/krzyzanowskim/OpenSSL.git", .upToNextMinor(from: "1.1.1700"))
]
CocoaPods
pod 'OpenSSL-Universal'
Carthage
- If building from source is preferred:
github "krzyzanowskim/OpenSSL"
- If using a prebuilt framework is preferred:
binary "https://raw.githubusercontent.com/krzyzanowskim/OpenSSL/master/OpenSSL.json"
Authors
FAQ etc.
Where can I use OpenSSL-Universal?
These libraries work for both iOS and macOS. It is your prerogative to check. Ask yourself, are you trying to write an app for old devices? new devices only? all iOS devices? only macOS?, etc ::
What is XCFramework?
OpenSSL.xcframework is distributed as a multiplatform XCFramework bundle, for more information checkout the documentation Distributing Binary Frameworks as Swift Packages