Purpl Documentation
빠르게 시작하기
사용할 방식 하나를 선택해 최소 설치와 첫 호출까지 진행합니다.
Swift SDK만 사용
Purpl 계정이나 서버 없이 앱 코드에서 전체 상품과 권한을 구성합니다.
- Xcode Package Dependencies에 Purpl-Swift를 추가합니다.
- 앱에서 사용할 전체 상품과 권한을 PurchaseConfiguration으로 정의합니다.
- 앱 시작 시 Purchases.configure를 호출하고 CustomerInfo에서 권한을 확인합니다.
Package URL
https://github.com/ineedtoint/Purpl-Swift.gitSwift
import Purpl
let plusEntitlement = PurchaseEntitlement(identifier: "plus")
let monthlyProduct = PurchaseProduct(
productIdentifier: "time.plus.monthly",
entitlementIdentifier: plusEntitlement.identifier
)
let yearlyProduct = PurchaseProduct(
productIdentifier: "time.plus.yearly",
entitlementIdentifier: plusEntitlement.identifier
)
let purchaseConfiguration = PurchaseConfiguration(
entitlements: [plusEntitlement],
products: [monthlyProduct, yearlyProduct]
)
Purchases.configure(purchaseConfiguration)Swift
let customerInfo = try await Purchases.shared.customerInfo()
if customerInfo.isEntitlementActive("plus") {
enablePremiumFeatures()
}Swift SDK와 Purpl 서비스 사용
웹에서 판매 구성과 고객 권한을 관리하고 Swift 앱은 페이월 식별자로 활성 구성을 불러옵니다.
- Purpl에서 애플리케이션과 스토어를 연결합니다.
- 상품과 권한을 연결하고 카탈로그와 페이월을 생성합니다.
- Swift 앱을 서버 모드로 구성하고 웹에서 만든 페이월 식별자를 전달합니다.
Swift
import Purpl
import PurplUI
Purchases.configure(entitlementMode: .server)
PaywallView(paywallIdentifier: "standard") {
PremiumMarketingContent()
}서버 API 사용
앱 계정 연결과 권한 조회가 개발자 서버에 필요할 때 애플리케이션 API 자격 증명을 사용합니다.
- Purpl에서 애플리케이션 API 자격 증명을 생성합니다.
- 자격 증명을 앱에 포함하지 않고 개발자 서버의 비밀값으로 보관합니다.
- Bearer 인증으로 필요한 고객 또는 권한 API를 호출합니다.
cURL
curl 'https://api.purpl.sh/v1/customers/user-123/entitlements' \
--header 'Authorization: Bearer <application-api-credential>'