Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/apotocki/libssh2-iosx
Builds LIBSSH2 static libraries and packs them as XCFramework for iOS (simulator and device), visionOS (simulator and device), and Mac OS X.
https://github.com/apotocki/libssh2-iosx
ios ios-simulator libssh2 macos visionos visionos-simulator xcframework
Last synced: about 1 month ago
JSON representation
Builds LIBSSH2 static libraries and packs them as XCFramework for iOS (simulator and device), visionOS (simulator and device), and Mac OS X.
- Host: GitHub
- URL: https://github.com/apotocki/libssh2-iosx
- Owner: apotocki
- License: bsd-3-clause
- Created: 2021-01-02T21:12:08.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-18T21:21:49.000Z (8 months ago)
- Last Synced: 2024-10-24T04:26:48.534Z (2 months ago)
- Topics: ios, ios-simulator, libssh2, macos, visionos, visionos-simulator, xcframework
- Language: Shell
- Homepage:
- Size: 25.4 KB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
## LIBSSH2 for iOS, visionOS, and Mac OS X (Intel & Apple Silicon M1) - arm64 / x86_64
Supported versions: 1.11.0, 1.10.0, 1.9.0 (use the appropriate tag or branch to choose a version)
This repo provides a universal script for building static LIBSSH2 library for use in iOS, visionOS, and Mac OS X applications.
The actual library version is taken from https://github.com/libssh2/libssh2.git with the appropriate tag, e.g: 'libssh2-1.11.0'
## 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) CMake must be installed because it's used as the build system for LIBSSH2.
4) Cocoapods must be installed because it's used to get the OpenSSL backend.
5) 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
## Building notes
1) The library is built with OpenSSL backend. OpenSSL build scripts are taken from https://github.com/apotocki/openssl-iosx and run using the 'pod' utility.
2) The library is built with ZLIB compression enabled, which is available through the system SDKs.
## How to build?
- Manually
```
# clone the repo
git clone https://github.com/apotocki/libssh2-iosx
# build libraries
cd libssh2-iosx
scripts/build.sh
# have fun, the result artifacts will be located in 'frameworks' folder.
# Then you can add the xcframework in your XCode project. The process is described, e.g., at https://www.simpleswiftguide.com/how-to-add-xcframework-to-xcode-project/
```
- Use cocoapods. Add the following lines into your project's Podfile:
```
use_frameworks!
pod 'libssh2-iosx'
# or optionally more precisely e.g.:
# pod 'libssh2-iosx', :git => 'https://github.com/apotocki/libssh2-iosx'
```
Then 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](https://apps.apple.com/us/app/potohex/id1620963302).
Feedback is welcome!