Skip to content

Commit

Permalink
3.2: Style updated to match our iOS app v2.0
Browse files Browse the repository at this point in the history
* [UPDATE] Style updated to match our iOS app v2.0
* [UPDATE] Base SDK updated to iOS 12, built with Xcode 10.1
* [IMPROVEMENT] Location permissions are handled when presenting the
  login view controller. The merchant is asked to grant location
  permissions if needed and restricted from logging in when denied.
* [IMPROVEMENT] Added a section to the README on how to
  [integrate with Carthage](https://github.com/sumup/sumup-ios-sdk/blob/master/README.md#integration-via-carthage).
  Heavily inspired by [Zyphrax's](https://github.com/Zyphrax) help in
  [PR #42](#43) addressing
  [issue #37](#37).
* [BUGFIX] Fix a crash in checkout when trying to use an audio
  connection to a PIN+ or C&S readers when microphone permissions have
  been denied.
* [ADDED] Added support for the SumUp 3G reader
  • Loading branch information
mollidor committed Apr 9, 2019
2 parents d0c280b + 9edf040 commit 9957182
Show file tree
Hide file tree
Showing 312 changed files with 81 additions and 12 deletions.
17 changes: 17 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,22 @@
# SumUp iOS SDK Changelog

## Version 3.2

* [UPDATE] Style updated to match our iOS app v2.0
* [UPDATE] Base SDK updated to iOS 12, built with Xcode 10.1
* [IMPROVEMENT] Location permissions are handled when presenting the
login view controller. The merchant is asked to grant location
permissions if needed and restricted from logging in when denied.
* [IMPROVEMENT] Added a section to the README on how to
[integrate with Carthage](https://github.com/sumup/sumup-ios-sdk/blob/master/README.md#integration-via-carthage).
Heavily inspired by [Zyphrax's](https://github.com/Zyphrax) help in
[PR #42](https://github.com/sumup/sumup-ios-sdk/pull/43) addressing
[issue #37](https://github.com/sumup/sumup-ios-sdk/issues/37).
* [BUGFIX] Fix a crash in checkout when trying to use an audio
connection to a PIN+ or C&S readers when microphone permissions have
been denied.
* [ADDED] Added support for the SumUp 3G reader

## Version 3.1

* [CHANGED] If you integrate the SDK manually, please link to the `ExternalAccessory`
Expand Down
42 changes: 36 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,10 @@
[![Platform](https://img.shields.io/badge/Platform-iOS-lightgrey.svg?style=flat-square)](#prerequisites)
[![Created](https://img.shields.io/badge/Made%20by-SumUp-blue.svg?style=flat-square)](https://sumup.com)
[![Supports](https://img.shields.io/badge/Requires-iOS%209+-red.svg?style=flat-square)]()
[![Version](https://img.shields.io/badge/Version-3.1-yellowgreen.svg?style=flat-square)](CHANGELOG.md)
[![Version](https://img.shields.io/badge/Version-3.2-yellowgreen.svg?style=flat-square)](CHANGELOG.md)
[![License](https://img.shields.io/badge/License-SumUp-brightgreen.svg?style=flat-square)](LICENSE)
[![CocoaPods](https://img.shields.io/cocoapods/v/SumUpSDK.svg?style=flat-square)]()
[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

This repository provides a native iOS SDK that enables you to integrate SumUp's proprietary
card terminal(s) and its payment platform to accept credit and debit card payments
Expand All @@ -28,13 +29,14 @@ For more information, please refer to SumUp's
2. Received SumUp card terminal: Air, Air Lite, PIN+ terminal, Chip & Signature reader, or SumUp Air Register.
3. Requested an Affiliate (Access) Key via [SumUp Dashboard](https://me.sumup.com/developers) for Developers.
4. Deployment Target iOS 9.0 or later.
5. Xcode 9 and iOS SDK 11 or later.
5. Xcode 10.1 and iOS SDK 12 or later.
6. iPhone, iPad or iPod touch.

### Table of Contents
* [Installation](#installation)
* [Manual Integration](#manual-integration)
* [Integration via CocoaPods](#integration-via-cocoapods)
* [Integration via Carthage](#integration-via-carthage)
* [Supported device orientation](#supported-device-orientation)
* [Privacy Info plist keys](#privacy-info-plist-keys)
* [Getting started](#getting-started)
Expand Down Expand Up @@ -75,19 +77,19 @@ images and localizations. Please follow the steps below to prepare your project:

SumUpSDK.embeddedframework/Resources/SMPSharedResources.bundle

6. Make sure the [required Info.plist keys](#privacy-info-plist-keys) are present.

> Note:
> You can use the [sample app](SampleApp/SumUpSDKSampleApp)
> that is provided with the SumUp SDK as a reference project.
> The Xcode project contains sample apps written in Objective-C and Swift.
> In your debug setup you can also call `+[SMPSumUpSDK testSDKIntegration]`.
> It will run various checks and print its findings to the console.
> Please do not call it in your Release build.
> See [Test your integration](#test-your-integration) for more information.
### Integration via CocoaPods

The SumUp SDK can be integrated via CocoaPods. Regardless if you use dynamic
frameworks (`use_frameworks!`), SumUp will always be added to your app as a
staticly linked library.
statically linked library.

```ruby
target '<Your Target Name>' do
Expand All @@ -97,6 +99,34 @@ end

To learn more about setting up your project for CocoaPods, please refer to the [official documentation](https://cocoapods.org/#install).

### Integration via Carthage

The SumUp SDK can be integrated with Carthage by following the steps below:

1. Add the following line to your `Cartfile`:

github "sumup/sumup-ios-sdk"

2. Run `carthage update sumup-ios-sdk`
3. Link your app against `Carthage/Build/iOS/SumUpSDK.framework` by dragging it into "Linked Frameworks and Libraries".
Because SumUp is a statically linked library, it must **not** be contained in "Embedded Frameworks" and you must **not** add `SumUpSDK.framework` to Carthage's build phase.
4. Add `-ObjC` to "Other Linker Flags" if not yet included.
5. Add the provided `SMPSharedResource` bundle to your app target:

Carthage/Build/iOS/SumUpSDK.framework/Versions/A/Resources/SMPSharedResources.bundle

6. Make sure the [required Info.plist keys](#privacy-info-plist-keys) are present.

To learn more about setting up your project for Carthage, please refer to the [official documentation](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos).

> Note:
> See [Test your integration](#test-your-integration) for more information.
### Test your integration
In your debug setup you can call `+[SMPSumUpSDK testSDKIntegration]`.
It will run various checks and print its findings to the console.
Please do not call it in your Release build.

### Supported device orientation
The SDK supports all device orientations on iPad and portrait on iPhone.
Feel free to support other orientations on iPhone but please keep in mind that
Expand Down
2 changes: 1 addition & 1 deletion SampleApp/SumUpSDKSampleApp.xcodeproj/project.pbxproj
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@
);
name = SumUpSDK.embeddedframework;
path = ../SumUpSDK.embeddedframework;
sourceTree = "<group>";
sourceTree = SOURCE_ROOT;
};
E95D10B71FA346F900035A3C /* Resources */ = {
isa = PBXGroup;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -175,8 +175,15 @@
"size" : "44x44",
"idiom" : "watch",
"scale" : "2x",
"role" : "longLook",
"subtype" : "42mm"
"role" : "appLauncher",
"subtype" : "40mm"
},
{
"size" : "50x50",
"idiom" : "watch",
"scale" : "2x",
"role" : "appLauncher",
"subtype" : "44mm"
},
{
"size" : "86x86",
Expand All @@ -192,6 +199,13 @@
"role" : "quickLook",
"subtype" : "42mm"
},
{
"size" : "108x108",
"idiom" : "watch",
"scale" : "2x",
"role" : "quickLook",
"subtype" : "44mm"
},
{
"idiom" : "watch-marketing",
"size" : "1024x1024",
Expand Down
4 changes: 2 additions & 2 deletions SampleApp/SumUpSDKSampleApp/SumUpSDKSampleApp-Info.plist
Original file line number Diff line number Diff line change
Expand Up @@ -28,11 +28,11 @@
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
<string>3.1</string>
<string>3.2</string>
<key>CFBundleSignature</key>
<string>????</string>
<key>CFBundleVersion</key>
<string>853</string>
<string>946</string>
<key>LSRequiresIPhoneOS</key>
<true/>
<key>NSBluetoothPeripheralUsageDescription</key>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -132,6 +132,14 @@ NS_SWIFT_NAME(CheckoutRequest)
*/
@property (nonatomic, copy, nullable) NSDecimalNumber *tipAmount;

/**
* An optional count for the display of the number of sale items throughout the checkout process.
* Default is zero which will hide the display of the item count.
* This value is currently not reflected in the merchant's history
* or the customer receipts.
*/
@property (nonatomic) NSUInteger saleItemsCount;


/**
* An optional flag to skip the confirmation screen in checkout.
Expand Down
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified ...s/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ons/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ons/A/Resources/SMPSharedResources.bundle/[email protected]
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file modified ...ns/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ns/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...s/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...s/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file not shown.
Binary file modified ...sources/SMPSharedResources.bundle/[email protected]
Binary file modified ...sources/SMPSharedResources.bundle/[email protected]
Binary file modified ...s/SMPSharedResources.bundle/[email protected]
Binary file modified ...s/SMPSharedResources.bundle/[email protected]
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file removed ...ces/SMPSharedResources.bundle/[email protected]
Diff not rendered.
Binary file removed ...ces/SMPSharedResources.bundle/[email protected]
Diff not rendered.
Binary file modified .../A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified .../A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ersions/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...s/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...s/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ns/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...s/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...s/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...sources/SMPSharedResources.bundle/[email protected]
Binary file modified ...sources/SMPSharedResources.bundle/[email protected]
Binary file modified .../A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified .../A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ources/SMPSharedResources.bundle/[email protected]
Binary file modified ...A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified .../A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified .../A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ons/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...ons/A/Resources/SMPSharedResources.bundle/[email protected]
Binary file modified ...Resources/SMPSharedResources.bundle/[email protected]
Loading

0 comments on commit 9957182

Please sign in to comment.