Buy Me a Coffee framework for iOS
Donations :moneybag:
Give your audience a friendly way to thank you.
Memberships :spiral_calendar:
Earn recurring revenue by offering a monthly or yearly membership.
Sell Extras :sparkles:
A new, creative way to offer Zoom calls, art commissions, anything.
CocoaPods |
Swift Package Manager |
---|---|
Swift 5.0 | Swift 5.3 |
Xcode 11.x | Xcode 12.x |
These are the two App Store Review Guidelines articles you have to know before using this framework:
- Apps may use in-app purchase currencies to enable customers to “tip” digital content providers in the app.
(vii) Apps may enable individual users to give a monetary gift to another individual without using in-app purchase, provided that (a) the gift is a completely optional choice by the giver, and (b) 100% of the funds go to the receiver of the gift. However, a gift that is connected to or associated at any point in time with receiving digital content or services must use in-app purchase.
UIApplicationDelegate:
swift import BuyMeACoffee
BMCManagershared instance with the username you've chosen on www.buymeacoffee.com, typically in your app's
application:didFinishLaunchingWithOptions:method:
swift BMCManager.shared.configure(username: "appcraftstudio")
viewDidLoadmethod to set the presenting view controller of the
BMCManagerobject.
swift BMCManager.shared.presentingViewController = self // You can also set a custom thank you message BMCManager.shared.thankYouMessage = "Thank you for supporting 🎉 App Craft Studio !"
BMCButtonto your storyboard, XIB file, or instantiate it programmatically. To add the button to your storyboard or XIB file, add a View and set its custom class to
BMCButton.
swift let button = BMCButton(configuration: .default) button.configuraton = .init(color: .orange, font: .cookie)
Depending the legal receiver of the gift configured on Buy Me a Coffee, App Store reviewers can ask for In-App Purchase implementation.
If the following In-App Purchase if configured for your application, it will be displayed as primary flow when user tap on the
BMCButton.
If the framework can't retrieve In-App Purchase informations, the web flow will be used as fallback.
Go to App Store Connect, search for the In-App Purchases section of your app, and then, create a new one with the following informations:
||| | --- | --- | | Type | Consumable | | Reference Name | Buy Me a Coffee | | Product ID |
your.app.bundle.identifier.buymeacoffee | | Cleared for Sale | :whitecheckmark: | | Price | Tier 4 | | Display Name | Buy Me a Coffee | | Description | Hey there! You can now buy me a coffee! | Promotional Image | download here | | Review Screenshot | download here | | Review Notes | Buy Me a Coffee enable customers to “tip” digital content providers in the app. |
You want to add pod
'BuyMeACoffee', '~> 1.0'similar to the following to your Podfile:
rb target 'MyApp' do pod 'BuyMeACoffee', '~> 1.0' endThen run a
pod installinside your terminal, or from CocoaPods.app.
Copyright © 2020 App Craft Studio. All rights reserved.