Activation iOS SDK 1.13.0
1.13.0 replaces the icon-only missed earnings button with a text pill labeled "Report", and adds a new in-context entry point to missed earnings from the Your Earnings section.
This release contains breaking changes. Two theming keys were removed or renamed. See Breaking changes and the Upgrade checklist.
Installation
Update your Swift Package Manager or CocoaPods dependency to 1.13.0.
.package(url: "https://github.com/BlinkReceipt/blink-engage-ios", from: "1.13.0")
What's new
Report button
The icon-only receipt glyph that opened missed earnings is replaced with a text pill reading "Report". It appears in the receipt summary header and in the receipt details navigation bar. The button copy is always "Report" and is not customizable.
Missed earnings footer
When missed earnings is available, the Your Earnings section now ends with a two-line "Missing rewards? / Update your receipt" action. Tapping it opens the same correction flow as the Report button. This entry point is additive — no code changes are required to enable it.
The footer is styled from the global color palette:
| Element | Source |
|---|---|
| "Missing rewards?" | AppearanceGlobalColorKey.textPrimary |
| "Update your receipt" | AppearanceGlobalColorKey.textSecondary |
| Pen icon tint | AppearanceGlobalColorKey.primary |
Breaking changes
Renamed color key
AppearanceColorKey.postScanReceiptButtonIcon is renamed to AppearanceColorKey.postScanReceiptButtonLabel. The key now colors the button's text rather than an icon tint. Any Theme that references postScanReceiptButtonIcon will not compile.
Removed icon key
AppearanceIconKey.postScanReceiptButtonIcon is removed with no replacement — the button is now text-only. Remove the case from your image(forKey:) implementation.
Removing this case shifted the raw integer values of subsequent AppearanceIconKey cases. Always match cases by name, not by raw value.
For full before/after code examples, see the Migration guide.
Theming
| Change | Details |
|---|---|
AppearanceColorKey.postScanReceiptButtonIcon | Removed. Rename to postScanReceiptButtonLabel — now the text color (default .white). |
AppearanceIconKey.postScanReceiptButtonIcon | Removed. Delete the case from image(forKey:). |
AppearanceFontNameKey.postScanReceiptButtonLabel | New (optional). Font for the "Report" text. Default: 12 pt bold. |
AppearanceColorKey.postScanReceiptButtonBackground | Unchanged, but now styles a pill shape rather than a 40 × 40 circle. |
Upgrade checklist
- In your
color(forKey:)implementation, rename.postScanReceiptButtonIconto.postScanReceiptButtonLabel. - In your
image(forKey:)implementation, delete the.postScanReceiptButtonIconbranch. - Visually verify the Report button against your custom
postScanReceiptButtonBackgroundcolor — it is now a wider pill shape. - Optionally set
AppearanceFontNameKey.postScanReceiptButtonLabelif you want a custom typeface on the "Report" text.