Files

T

Rocky 166019b384 feat: tip IAP, commercial GitHub Pages, and App Store screenshots

Add optional StoreKit support tip (features stay free), redesign the
landing page with zh/en + light/dark and product shots, and ship
iPhone/iPad/Mac App Store screenshot sets.

2026-07-12 11:00:57 +08:00

4.8 KiB

Raw Blame History

StoreKit — Voluntary Support Tip

OSGKeyboard offers a single Consumable in-app purchase:

Field	Value
Type	Consumable
Product ID	`ByRockyACoffee`
Reference name (Connect)	给老刘买杯咖啡
Display name (en)	Buy me a cup of coffee
Display name (zh-Hans)	给老刘买杯冰美式
Price (China)	¥28 (nearest available App Store tier)
Price (US, suggested)	$3.99 equivalent tier

Important: this tip does not unlock translation, dictionary limits, long Flow sessions, or any other capability. The app remains fully free.

Consumable purchases cannot be restored (Apple policy). Settings copy explains this to users.

App Store Connect setup

Open App Store Connect → OSGKeyboard → In-App Purchases.
Create Consumable with Product ID ByRockyACoffee.
Add localizations (en + zh-Hans) using the strings in OSGKeyboardShared/*/Shared.strings (tip.* keys) and docs/APPSTORE_METADATA.md.
Set pricing: China ¥28 (App Store only offers fixed tiers — ¥28 is the nearest to ¥30); pick equivalent tiers for other territories.
Submit the IAP for review with the app version that includes the Settings → Support the Developer entry.

Review screenshot (required — fixes「元数据丢失」)

App Store Connect → IAP ByRockyACoffee → 审核信息 → 截屏:

Run the app (Simulator or device) with Settings open at the top 支持开发者 card showing the green 打赏 ¥28.00 button.
Capture that screen (⌘S in Simulator, or device screenshot).
Upload to 截屏 → 选取文件.
Optional 审核备注:

Optional voluntary tip only (Consumable IAP ByRockyACoffee).
All features free before and after purchase. Settings tab → top of page.
Consumable — cannot restore (stated in UI).

Save — status should become 准备提交.

Local testing (StoreKit Test — no Connect / sandbox account)

Uses OSGKeyboard.storekit. The OSGKeyboard scheme already references it in project.yml (storeKitConfiguration).

xcodegen generate && open OSGKeyboard.xcodeproj
Product → Scheme → Edit Scheme → Run → Options
- Confirm StoreKit Configuration = OSGKeyboard.storekit
Run OSGKeyboard on Simulator (e.g. iPhone 17) or a plugged-in device
Open Settings tab → top card 支持开发者
Tap 打赏 ¥28.00 → StoreKit Test purchase sheet appears
Buy → thank-you alert; Cancel → no error
Repeat buy once (Consumable allows multiple)

Debug menu (optional): Xcode → Debug → StoreKit → Manage Transactions to view / delete test purchases.

Sandbox testing (real App Store sandbox — after Connect IAP is 准备提交)

App Store Connect → 用户和访问 → 沙盒 → create a Sandbox Tester
On device: 设置 → App Store → 沙盒账户 → sign in (not your real Apple ID)
Install via TestFlight or Debug run without .storekit:
- To hit Connect products: Edit Scheme → Run → Options → set StoreKit Configuration to None, then run on device
Settings → 支持开发者 → purchase with sandbox account
Sandbox charges are free; receipt is real sandbox flow

Submit to App Review (after local + sandbox pass)

Yes — wait until testing looks good, then:

IAP ByRockyACoffee status = 准备提交 (pricing + screenshot + localizations)
Bump app version in project.yml / CHANGELOG.md if needed
Archive → upload build to App Store Connect
Open the new App Store version page → App 内购买项目 → + → select ByRockyACoffee
Fill metadata, attach build, submit version + IAP together (first IAP rule)

Sandbox checklist

Product loads and shows localized price
Successful purchase shows thank-you alert
User cancel returns to idle (no error spam)
Repeat purchase works (Consumable allows multiple)
No Restore button for this product (Consumable)
Translation, Flow, dictionary, BYOK unchanged after tipping

macOS note

The menu-bar Mac build (com.osgkeyboard.mac) ships via Developer ID outside the Mac App Store today. StoreKit products load only for App Store builds. The Mac Settings UI is present for parity; tip IAP requires an App Store distribution if Mac tipping is enabled later.

Files

File	Role
`OSGKeyboardShared/Services/Tip/TipProduct.swift`	Product ID constants
`OSGKeyboardShared/Services/Tip/TipPurchaseManager.swift`	StoreKit 2 purchase flow
`OSGKeyboardShared/DesignSystem/SupportDeveloperSection.swift`	iOS Settings UI
`OSGKeyboardMac/MacSupportDeveloperTipRows.swift`	macOS Settings UI
`OSGKeyboard.storekit`	Local StoreKit Test catalog

4.8 KiB Raw Blame History