How to install¶

A wrapper is a private pod, so private podspec must be set. Put at the top of the Podfile:

source 'https://github.com/hyperledger/indy-sdk.git'

Cocoapod will search for spec files in the root Specs folder.

Binaries¶

There are 2 types of automatically built archives containing libindy core library which can be used for your iOS application.
- library built for aarch64-apple-ios and armv7-apple-ios targets.
- universal libindy built for all architectures.
Add pod to target:
```
  pod 'libindy'
```
These archives are located at https://repo.sovrin.org/ios/libindy/{release-channel}/libindy-core/.
There is manually built and published archive containing libindy objective C wrapper. This archive is located at https://repo.sovrin.org/ios/libindy/{release-channel}/indy-objc/.

Add pod to target:
```
  pod 'libindy-objc'    
```

{release channel} must be replaced with master, rc or stable to define corresponded release channel.

How to manually build¶

Core library¶

Install Rust and rustup (https://www.rust-lang.org/install.html).

Install toolchains using command:

rustup target add aarch64-apple-ios armv7-apple-ios armv7s-apple-ios i386-apple-ios x86_64-apple-ios

Install cargo-lipo:
```
cargo install cargo-lipo
```

Install required native libraries and utilities:

brew install libsodium
brew install zeromq
brew install openssl (1.0.2q can be any fresh version)

Setup environment variables:

export PKG_CONFIG_ALLOW_CROSS=1
export CARGO_INCREMENTAL=1

Edit script ci/ios-build.sh: set the following variables to fit your environment:
```
export OPENSSL_DIR=/usr/local/Cellar/openssl/1.0.2q
export LIBINDY_POD_VERSION=0.0.1
```
OPENSSL_DIR - path to installed openssl library

LIBINDY_POD_VERSION - version of libindy-core pod to be built
Run the script Validate the output that all goes well.

Parameters:
- package - target package to build.
  - libindy
  - libnullpay
- targets - target architectures.
  - one of aarch64-apple-ios armv7-apple-ios armv7s-apple-ios i386-apple-ios x86_64-apple-ios
  - leave empty to build for all architectures.
Go to Specs/libindy dir.
Create directory with name defined in LIBINDY_POD_VERSION:
```
mkdir LIBINDY_POD_VERSION
```
Copy libindy.podspec.json to that new directory from some previous version.
Edit this json -> change version field to LIBINDY_POD_VERSION.
Add new directory and file inside to git repository.
Commit to master branch.
for all projects which using libindy do not forget to make:
```
pod repo update
pod install
```

Wrapper Cocoapod¶

Run Archive process for Indy target. Custom post-action shell script universal_framework.sh will be triggered and you get universal framework. Then put it to folder: libindy-objc/Indy.framework and upload to repo.

Wrapper usage¶

Import header starting from 0.1.3:

#import <Indy/Indy.h>

For 0.1.1 and 0.1.2 versions:

#import <libindy/libindy.h>

All wrapper types and classes have prefix Indy.

Troubleshooting¶

Enable Logging - Use setLogger to pass a callback that will be used by Libindy to log a record.
IS-1058
- OpenSSL cp: file.tgz: No such file or directory -
```
sudo gem uninstall cocoapods-downloader
sudo gem install cocoapods-downloader -v 1.2.0
```
- Multiple commands produce */Debug-iphonesimulator/Indy-demo.app/PlugIns/Indy-demoTests.xctest/Info.plist - remove Info.plist from there: Solution -> Target -> Build phases -> Copy Bundle Resources