SharkCardScan is a Credit/Debit Card scanner built using Apple's Vision Framework.
SharkCardScan allows you to quickly implement a card scanner inside of your own app.
SharkCardScan is built and maintained with love by the Gymshark Engineering Team
Usage
It's possible to get started quickly with the following snippet.
let scannerVC = SharkCardScanViewController(viewModel: CardScanViewModel(noPermissionAction: { [weak self] in
self?.showNoPermissionAlert()
}, successHandler: { (response) in
print("Expiry 💣: \(response.expiry ?? "")")
print("Card Number 💳: \(response.number)")
print("Holder name 🕺: \(response.holder ?? "")")
}))
Here we handle the No Camera Permission error, from the ViewModeland our successHandler is called upon receipt of finding a card number, and the expiry and card holders name, albeit, we can call success if only a valid card number is found.
Styling
SharkCardScanViewController initialiser takes a default parameter for styling, which you can specify your own, if you wish to amend fonts/colours.
SharkCardScanViewController(viewModel: CardScanViewModel{...}, styling: MyOwnCardScannerStyling())
CardScanStyling is a protocol, your styling struct must conform too with the following properties you have to set;
public protocol CardScanStyling {
var instructionLabelStyling: LabelStyling { get set }
var cardNumberLabelStyling: LabelStyling { get set }
var expiryLabelStyling: LabelStyling { get set }
var holderLabelStyling: LabelStyling { get set }
var backgroundColor: UIColor { get set }
}
NB: By using the default parameter, and using our DefaultStyling struct instance, the font will only have fixed sizes, for now, rather than being dynamic - one for us to fix later (or send us a PR?!)
Other Customisations
ACardScanViewModel has a insturctionText property, if you wish to override the default instruction text that is shown on the viewer.
Installation
Swift Package Manager (SPM) To install SharkCardScan using Swift Package Manager you can follow the tutorial published by Apple using the URL for the SharkCardScan repo with the current version:
- In Xcode, select “File” → “Swift Packages” → “Add Package Dependency”
- Enter https://github.com/gymshark/ios-card-scan.git
793 Dec 14, 2022
44 Nov 20, 2022
0 Jan 19, 2022
61 Nov 23, 2022
0 Dec 22, 2021
40 Nov 24, 2022
1 Dec 20, 2021
299 Dec 17, 2022
21 Sep 13, 2022
488 Dec 17, 2022
11 Aug 20, 2022
359 Dec 17, 2022
4 Jul 9, 2022
1.5k Jan 4, 2023
46 Dec 14, 2020
5 Aug 29, 2022
5 Nov 27, 2022
2.4k Jan 3, 2023
372 Sep 1, 2022