Swiftpack.co - Package -

Screenshot iOS

Bitrise CocoaPods CocoaPods downloads Twitter: @JohnSanzo

๐Ÿ“ฒ How to Install

Using CocoaPods

Edit your Podfile and specify the dependency:

pod 'MLCardDrawer'

Using Swift Package Manager

Add MLCardDrawer as a dependency. Adding the following line in dependenciesvalue of your Package.swift.

  dependencies: [
    .package(url: "https://github.com/mercadolibre/meli-card-drawer-ios.git", from: "1.0")
  ]

๐ŸŒŸ Features

  • โ˜‘ Easy to integrate
  • โ˜‘ Card number, name, expiration date and CVV support (CardData protocol)
  • โ˜‘ Card left and right image customization (CardUI protocol)
  • โ˜‘ CVV support at front & back view
  • โ˜‘ Card flip animation integrated
  • โ˜‘ Shine card effect with MotionEffect ๐Ÿ”ฅ๐Ÿ”ฅ
  • โ˜‘ Live card view updated while CardData protocol is edited
  • โ˜‘ PCI compliance (We do not save anything)
  • โ˜‘ Support for custom overlay background image
  • โ˜‘ Support for custom gradient
  • โ˜‘ Support remote images (optional)

๐Ÿ’ How to use

1 - Import into project

import MLCardDrawer

2 - Define CardHeaderController reference & your own container view.

// You can create your containerView by code or by storyboard/xib (as you like)
private var containerView: UIView = UIView()
private var cardDrawer: MLCardDrawerController?

3 - Init cardDrawer sending CardUI and CardData protocol as parameters.

cardDrawer = MLCardDrawerController(cardUIHandler, cardDataHandler)

4 - Call to setup and show method.

cardDrawer?.setUp(inView: containerView).show()

๐Ÿ’ก Advanced features

Show security code

Gif

// You can highlight the security code location. 
// If the security code is behind, the card will transition with flip animation.
cardDrawer?.showSecurityCode()

Show front card view

cardDrawer?.show()

๐Ÿ”ฅ Shine card support based on MotionEffect ๐Ÿ”ฅ

cardDrawer?.setShineCard(enabled: true)

๐Ÿ’ณ Card data structure and style customization

You can customize the data structure and style of your card.

๐Ÿ”  CardData protocol

Using CardData protocol to update the card display values.

@objc public protocol CardData {
    var name: String { get set }
    var number: String { get set }
    var expiration: String { get set }
    var securityCode: String { get set }
    @objc optional var lastDigits: String { get set}
}

๐ŸŽจ CardUI protocol

Using CardUI protocol to customize: position of security code, card background, font color, place holders, etc.

@objc public protocol CardUI {
    var cardPattern: [Int] { get }
    var placeholderName: String { get }
    var placeholderExpiration: String { get }
    var cardFontColor: UIColor { get }
    var cardBackgroundColor: UIColor { get }
    var securityCodeLocation: MLCardSecurityCodeLocation { get }
    var defaultUI: Bool { get }
    var securityCodePattern: Int { get }

    @objc optional func set(bank: UIImageView)
    @objc optional func set(logo: UIImageView)
    @objc optional var fontType: String { get }
    @objc optional var bankImage: UIImage? { get }
    @objc optional var cardLogoImage: UIImage? { get }
    @objc optional var ownOverlayImage: UIImage? { get }
}

๐Ÿ˜‰ Next steps

  • [x] Bitrise for releases
  • [x] Codebeat integration
  • [x] Shine card effect with MotionEffect ๐Ÿ”ฅ๐Ÿ”ฅ
  • [ ] SwiftLint
  • [ ] Migration to Swift 5
  • [ ] Native support to display card in disabled mode (card disabled)
  • [ ] Version 2.0 SwiftUI compatible ๐Ÿ˜ˆ

๐Ÿ”ฎ Project Example

This project include an example project using MLCardDrawer and another target with xCTests test cases. Enter to path: meli-card-drawer-ios/Example_MeliCardDrawer and run pod install command. After that, you can open Example_MeliCardDrawer.xcworkspace

๐Ÿ•ต๏ธโ€โ™‚๏ธ Test cases

TestCases

๐Ÿ“‹ Supported OS & SDK Versions

  • iOS 9.0+
  • Swift 4.2
  • xCode 9.2+
  • @Objc full compatibility

โค๏ธ Feedback

This is an open source project, so feel free to contribute. How? -> Fork this project and propose your own fixes, suggestions and open a pull request with the changes.

๐Ÿ‘จ๐Ÿปโ€๐Ÿ’ป Author

Juan Sanzone / @juansanzone

๐Ÿ‘ฎ๐Ÿป License

Copyright 2019 Mercadolibre Developers

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Github

link
Stars:
Help us keep the lights on

Dependencies

Used By

Total: 0

Releases

๐Ÿš€ 1.2.1 ๐Ÿš€ - 2019-12-05 13:57:09

  • New disabled grey

๐Ÿš€ 1.2 ๐Ÿš€ - 2019-12-04 19:40:19

  • Medium cards allow hide chevron

๐Ÿš€ 1.1 ๐Ÿš€ - 2019-11-28 15:26:43

  • Support for small and medium cards

๐Ÿš€v1.0.5 ๐Ÿš€- Support remote images - 2019-10-22 19:13:28

๐Ÿš€v1.0.5 ๐Ÿš€- Custom gradient

  • Optional support for remote images

๐Ÿš€v1.0.4 ๐Ÿš€- Custom gradient - 2019-07-15 13:40:50

Support for custom gradient

๐Ÿš€v1.0.3 ๐Ÿš€- Custom background image - 2019-07-06 00:35:43

  • Support for custom background image (card watermark)

๐Ÿš€v1.0.2 ๐Ÿš€- ShineCards - 2019-06-04 02:03:28

๐Ÿš€v1.0.1 ๐Ÿš€- Bitrise - 2019-05-26 17:14:15

  • Add bitrise hook

๐Ÿš€First Release 1.0 ๐Ÿš€ - 2019-05-25 12:12:36

  • First release 1.0