1.4.0

NOTES

• Full support of version 1.4 features requires version 138 or higher of the Pay Display app.
• This is the Swift 4 compatible version of this library.
• A Swift 2.3 compatible version of this library is available under the 1.4.0-swift2.3 release.

NEW

• Added a new Print API
  • Please migrate all print requests to the new API using the PrintRequest object:
    • print(request: PrintRequest)
  • Printing via type-specific functions is deprecated and will be removed in a future release:
    • printText(lines: [String])
    • printImage(image: UIImage)
    • printImageFromURL(image: String)
  • Added a new API to open cash drawers
    • Please migrate all cash drawer requests to the new API using the OpenCashDrawerRequest object:
      • openCashDrawer(request: OpenCashDrawerRequest)
    • opening of cash drawers with a reason string is deprecated and will be removed in a future release:
      • openCashDrawer(reason: String)
  • Query available printers
    • retrievePrinters(request: RetrievePrintersRequest)
    • onRetrievePrintersResponse(retrievePrintersResponse: RetrievePrintersResponse)
  • Query the status of a print job
    • retrievePrintJobStatus(request: PrintJobStatusRequest)
    • onPrintJobStatusResponse(printJobStatusResponse: PrintJobStatusResponse)
• Added support for printing large images through message fragmenting

• Creation of an instance of the CloverConnector should now go through the CloverConnectorFactory (see example below)
• Added support for Mac OS-based apps

1.4.0 Swift 2.3

NOTES

• Full support of version 1.4 features requires version 138 or higher of the Pay Display app.
• This is the Swift 2.3 compatible version of this library.
• A Swift 4 compatible version of this library is available under release 1.4.0.
• Swift 2.3 compatible support will be discontinued with an upcoming release. Emergency bug fixes may still be performed on a case by case basis, but new features and functionality will not be back ported to Swift 2.3.

NEW

• Added a new Print API
  • Please migrate all print requests to the new API using the PrintRequest object:
    • print(request: PrintRequest)
  • Printing via type-specific functions is deprecated and will be removed in a future release:
    • printText(lines: [String])
    • printImage(image: UIImage)
    • printImageFromURL(image: String)
  • Added a new API to open cash drawers
    • Please migrate all cash drawer requests to the new API using the OpenCashDrawerRequest object:
      • openCashDrawer(request: OpenCashDrawerRequest)
    • opening of cash drawers with a reason string is deprecated and will be removed in a future release:
      • openCashDrawer(reason: String)
  • Query available printers
    • retrievePrinters(request: RetrievePrintersRequest)
    • onRetrievePrintersResponse(retrievePrintersResponse: RetrievePrintersResponse)
  • Query the status of a print job
    • retrievePrintJobStatus(request: PrintJobStatusRequest)
    • onPrintJobStatusResponse(printJobStatusResponse: PrintJobStatusResponse)
• Added support for printing large images through message fragmenting

• Creation of an instance of the CloverConnector should now go through the CloverConnectorFactory (see example below)
• Added support for Mac OS-based apps

1.3.1

NEW

• Added support for Custom Activities on the Clover Mini
  • Added a startCustomActivity request that starts a custom activity on the Clover device and an onCustomActivityResponse that receives a callback when it is done
  • AddedsendMessageToActivity to send messages to a Custom Activity running on the Clover device and onMessageFromActivity to receive messages from the Custom Activity
• Added an onDeviceError callback for connection errors

• Added a RetrievePayment() request and onRetrievePaymentResponse response that enable you to query for a payment by entering its external ID on the device

• Added a retrieveDeviceStatus request and onRetrieveDeviceStatusResponse response to retrieve the status of the device

IMPROVED

• resetDevice now calls back to onResetDeviceResponse with the current status

FIXED

• Fixed a few memory leaks with respect to WebSocket connections and Swift String interpolation