Skip to main content

iOS Digital SDK Installation

This is a framework which extends the BlinkReceipt SDK to enable e-receipt parsing functionality. You must first install the BlinkReceipt framework according to the instructions in that repository.

Installation with CocoaPods​

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like BlinkReceipt in your projects. If you do not have Cocoapods installed, see the Getting Started Guide.

Podfile​

Here is a sample barebones Podfile which imports the BlinkEReceipt pod:

#You must include this additional source as the BlinkEReceipt pod is hosted in a private spec repository
source 'https://github.com/BlinkReceipt/PodSpecRepo.git'
source 'https://cdn.cocoapods.org/'

platform :ios, '15.0'

target 'YourTarget' do
  use_frameworks!

  pod 'BlinkEReceipt', '~> 3.2'
end

After editing your Podfile, run pod install and then make sure to open the .xcworkspace file rather than the .xcodeproj

Installation with Carthage​

Carthage is a lightweight dependency manager for iOS. If you do not have Carthage installed see the Quick Start

Cartfile​

binary "https://raw.githubusercontent.com/BlinkReceipt/blinkereceipt-ios/master/BlinkEReceiptStatic.json" ~> 2.0

After editing your Cartfile, run carthage update and then add the frameworks to your project as described in the Quick Start above.

Standalone Installation​

If you do not use a dependency manager:

  • Download the latest BlinkEReceipt release from https://github.com/BlinkReceipt/blinkereceipt-ios/releases
  • Unzip and drag BlinkEReceiptStatic.framework, AccountLinking.framework and MailCore.framework into your XCode project
  • In your target's settings, in the General tab, scroll down to Frameworks, Libraries, and Embedded Content and change the Embed value for all of these frameworks to Embed & Sign

Duplicate Symbol Warning​

The BlinkEReceipt SDK includes a number of 3rd party dependencies, some of which are provided only as static libraries or depend on static libraries. As such it was not practical to prefix the symbols found in these dependencies, so if your app also includes these dependencies, you will likely encounter duplicate symbol errors during linking. These dependencies are:

If you need to use these dependencies in your app, you may rely on the BlinkEReceipt SDK to provide the symbols and simply include the appropriate headers in your project for compilation. Be sure to check that the versions imported by the SDK match the headers you are including.