Set up with Cocoapods (Recommended)

The setup process for the Wirecard ePOS SDK has been simplified on both platforms. On iOS, installation using Cocoapods is now available, but you still have the ability to set up the SDK manually because all setup files are available on the Github repository for iOS.

Before starting, ensure that Cocoapods is installed on your Mac. For more information about installing and using Cocoapods, see the CocoaPods site.

To add the Wirecard ePOS SDK to your application, create a Podfile and then:

1. Open the Podfile in a text editor.
2. Add the below lines to the Podfile

   platform :ios, '9.0'
   use_frameworks!
   target 'YourTarget' do
       pod 'WDePOS/All'
   end
   

   That's it. Only couple of lines are required to install the SDK into your app. Note: If you want to use more than one target then you must explicitly state this in your Podfile.

   • Tip

     If you encounter issues with pod install please run 'pod repo update' to upgrade your cocoapods

     pod repo update
     

3. In the folder where your podfile is stored, run pod install to install a new pod. Or run pod update to update your current one. This downloads and installs the SDK from Cocoapods and it creates the workspace for your application. The Example folder is below the main project folder and it contains Integration Tests that you can use to check the usage of each public API. The iOS Integration Tests chapter has more information.
4. Should you wish to use BlueTooth devices (Terminals, Printers, Cash Registers) you need to include UISupportedExternalAccessoryProtocols settings in your application plist file:

Device Vendor	Accessory protocol
Spire	com.thyron
StarMicronics / StarIO	jp.star-m.starpro
Datecs	com.datecs.printer.escpos
SocketMobile	com.socketmobile.chs

Note

The workspace for the Example app can be installed using cocoapods, however, the podfile is pointing to the local pod which is WDePOS in the path in the directory one level above the current Example app project.