Skip to main content

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.

warning

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.swift
.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.

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:

ElementSource
"Missing rewards?"AppearanceGlobalColorKey.textPrimary
"Update your receipt"AppearanceGlobalColorKey.textSecondary
Pen icon tintAppearanceGlobalColorKey.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.

Raw value shift

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​

ChangeDetails
AppearanceColorKey.postScanReceiptButtonIconRemoved. Rename to postScanReceiptButtonLabel — now the text color (default .white).
AppearanceIconKey.postScanReceiptButtonIconRemoved. Delete the case from image(forKey:).
AppearanceFontNameKey.postScanReceiptButtonLabelNew (optional). Font for the "Report" text. Default: 12 pt bold.
AppearanceColorKey.postScanReceiptButtonBackgroundUnchanged, but now styles a pill shape rather than a 40 × 40 circle.

Upgrade checklist​

  • In your color(forKey:) implementation, rename .postScanReceiptButtonIcon to .postScanReceiptButtonLabel.
  • In your image(forKey:) implementation, delete the .postScanReceiptButtonIcon branch.
  • Visually verify the Report button against your custom postScanReceiptButtonBackground color — it is now a wider pill shape.
  • Optionally set AppearanceFontNameKey.postScanReceiptButtonLabel if you want a custom typeface on the "Report" text.