Rozmowa Kwalifikacyjna StoreKit 2: Zarządzanie Subskrypcjami i Walidacja Paragonów

Opanuj pytania na rozmowy iOS dotyczące StoreKit 2, zarządzania subskrypcjami, walidacji paragonów i implementacji zakupów w aplikacji z praktycznymi przykładami kodu Swift.

Architektura subskrypcji iOS StoreKit 2 i walidacja paragonów

StoreKit 2 stanowi fundamentalną zmianę w sposobie obsługi zakupów w aplikacji w iOS. Wprowadzony wraz z iOS 15, ten nowoczesny framework drastycznie upraszcza kod wymagany do zarządzania subskrypcjami i walidacji transakcji. Techniczne rozmowy kwalifikacyjne iOS regularnie poruszają ten temat, aby ocenić wiedzę programistów w zakresie monetyzacji aplikacji.

Kluczowy Wgląd na Rozmowę

StoreKit 2 wykorzystuje natywne API Swift z async/await, eliminując potrzebę skomplikowanych callbacków i walidacji paragonów po stronie klienta. Rozmówcy cenią kandydatów, którzy potrafią wyartykułować podstawowe różnice w stosunku do StoreKit 1.

Przegląd Architektury StoreKit 2

StoreKit 2 jest zbudowany na nowoczesnej architekturze, która w pełni wykorzystuje Swift Concurrency. W przeciwieństwie do StoreKit 1, wszystkie operacje są asynchroniczne i używają natywnych typów Swift.

Pobieranie Dostępnych Produktów

Pierwszy krok obejmuje załadowanie produktów skonfigurowanych w App Store Connect. StoreKit 2 upraszcza tę operację za pomocą deklaratywnego API.

ProductService.swiftswift
import StoreKit

actor ProductService {

    // Identyfikatory produktów skonfigurowane w App Store Connect
    private let productIdentifiers: Set<String> = [
        "com.app.subscription.monthly",
        "com.app.subscription.yearly",
        "com.app.premium.lifetime"
    ]

    // Cache produktów, aby uniknąć powtórnych wywołań sieciowych
    private var cachedProducts: [Product] = []

    func loadProducts() async throws -> [Product] {
        // Zwraca cache, jeśli jest dostępny
        guard cachedProducts.isEmpty else {
            return cachedProducts
        }

        // Asynchroniczne żądanie do App Store
        let products = try await Product.products(for: productIdentifiers)
        cachedProducts = products
        return products
    }

    func product(for identifier: String) async throws -> Product? {
        let products = try await loadProducts()
        return products.first { $0.id == identifier }
    }
}

Użycie actor zapewnia bezpieczeństwo wątków podczas zarządzania cache produktów.

Typy Produktów w StoreKit 2

StoreKit 2 wyraźnie rozróżnia różne typy produktów. Zrozumienie tego rozróżnienia jest kluczowe dla rozmów kwalifikacyjnych.

ProductType+Extensions.swiftswift
import StoreKit

extension Product.ProductType {

    var displayName: String {
        switch self {
        case .consumable:
            // Produkty konsumpcyjne (kredyty, życia itp.)
            return "Consumable"
        case .nonConsumable:
            // Stałe zakupy (odblokowanie funkcji)
            return "Non-Consumable"
        case .autoRenewable:
            // Subskrypcje z automatycznym odnawianiem
            return "Auto-Renewable Subscription"
        case .nonRenewable:
            // Subskrypcje bez odnawiania (tymczasowy bilet)
            return "Non-Renewable Subscription"
        @unknown default:
            return "Unknown"
        }
    }
}

Subskrypcje z automatycznym odnawianiem stanowią dominujący model biznesowy nowoczesnych aplikacji iOS.

Obsługa Transakcji Zakupowych

Proces zakupu w StoreKit 2 staje się liniowy dzięki async/await. Koniec z delegatami i zagnieżdżonymi callbackami z StoreKit 1.

Inicjowanie Zakupu

PurchaseManager.swiftswift
import StoreKit

actor PurchaseManager {

    enum PurchaseError: Error {
        case productNotFound
        case purchaseCancelled
        case purchasePending
        case verificationFailed
        case unknown
    }

    func purchase(_ product: Product) async throws -> Transaction {
        // Inicjuje zakup z modalem systemowym
        let result = try await product.purchase()

        switch result {
        case .success(let verification):
            // Weryfikuje podpis transakcji
            let transaction = try checkVerification(verification)

            // Oznacza transakcję jako zakończoną
            await transaction.finish()

            return transaction

        case .userCancelled:
            // Użytkownik anulował modal zakupu
            throw PurchaseError.purchaseCancelled

        case .pending:
            // Zakup oczekujący (zatwierdzenie rodzicielskie itp.)
            throw PurchaseError.purchasePending

        @unknown default:
            throw PurchaseError.unknown
        }
    }

    private func checkVerification<T>(_ result: VerificationResult<T>) throws -> T {
        switch result {
        case .verified(let safe):
            // Transakcja podpisana i zweryfikowana przez App Store
            return safe
        case .unverified(_, let error):
            // Nieprawidłowy lub uszkodzony podpis
            throw PurchaseError.verificationFailed
        }
    }
}

Metoda finish() jest kluczowa: sygnalizuje App Store, że treść została dostarczona użytkownikowi.

Ostrzeżenie na Rozmowę

Nigdy nie zapominaj wywołać transaction.finish() po dostarczeniu treści. Niezakończona transakcja zostanie przywrócona przy następnym uruchomieniu aplikacji, powodując nieoczekiwane zachowanie.

Nasłuchiwanie Transakcji w Tle

StoreKit 2 wprowadza Transaction.updates, asynchroniczny strumień, który emituje transakcje zachodzące poza aplikacją (odnowienia, zakupy w ramach family sharing itp.).

TransactionObserver.swiftswift
import StoreKit

actor TransactionObserver {

    private var updateTask: Task<Void, Never>?

    func startObserving() {
        // Anuluj wszelkie wcześniejsze obserwacje
        updateTask?.cancel()

        updateTask = Task(priority: .background) {
            // Nieskończony strumień aktualizacji transakcji
            for await result in Transaction.updates {
                do {
                    let transaction = try self.checkVerification(result)

                    // Przetwarza transakcję w zależności od typu
                    await self.handleTransaction(transaction)

                    // Zawsze finalizuj transakcję
                    await transaction.finish()
                } catch {
                    // Loguj błąd do debugowania
                    print("Transaction verification failed: \(error)")
                }
            }
        }
    }

    func stopObserving() {
        updateTask?.cancel()
        updateTask = nil
    }

    private func handleTransaction(_ transaction: Transaction) async {
        switch transaction.productType {
        case .autoRenewable:
            // Aktualizuj status subskrypcji
            await updateSubscriptionStatus(transaction)
        case .nonConsumable:
            // Odblokuj funkcję premium
            await unlockFeature(transaction.productID)
        default:
            break
        }
    }

    private func checkVerification<T>(_ result: VerificationResult<T>) throws -> T {
        switch result {
        case .verified(let safe):
            return safe
        case .unverified:
            throw PurchaseError.verificationFailed
        }
    }

    private func updateSubscriptionStatus(_ transaction: Transaction) async {
        // Implementacja aktualizacji statusu
    }

    private func unlockFeature(_ productID: String) async {
        // Implementacja odblokowywania funkcji
    }

    enum PurchaseError: Error {
        case verificationFailed
    }
}

Obserwacja transakcji powinna rozpocząć się natychmiast po uruchomieniu aplikacji, aby nie przegapić żadnych aktualizacji.

Często Zadawane Pytania na Rozmowach o Subskrypcje StoreKit 2

Rozmowy iOS często zawierają konkretne pytania dotyczące zarządzania subskrypcjami. Oto najczęstsze z nich wraz ze szczegółowymi odpowiedziami.

Pytanie 1: Jak Sprawdzić Aktualny Status Subskrypcji?

StoreKit 2 zapewnia bezpośredni dostęp do aktywnych entitlementów poprzez Transaction.currentEntitlements.

SubscriptionStatusChecker.swiftswift
import StoreKit

struct SubscriptionStatusChecker {

    struct SubscriptionStatus {
        let isActive: Bool
        let expirationDate: Date?
        let willRenew: Bool
        let productID: String?
    }

    static func checkCurrentStatus() async -> SubscriptionStatus {
        // Pobiera wszystkie aktywne transakcje
        var latestTransaction: Transaction?

        for await result in Transaction.currentEntitlements {
            if case .verified(let transaction) = result {
                // Filtruje tylko subskrypcje
                if transaction.productType == .autoRenewable {
                    // Zachowuje najnowszą transakcję
                    if latestTransaction == nil ||
                       transaction.purchaseDate > latestTransaction!.purchaseDate {
                        latestTransaction = transaction
                    }
                }
            }
        }

        guard let transaction = latestTransaction else {
            return SubscriptionStatus(
                isActive: false,
                expirationDate: nil,
                willRenew: false,
                productID: nil
            )
        }

        // Sprawdź, czy subskrypcja jest nadal aktywna
        let isActive = transaction.expirationDate ?? Date.distantPast > Date()

        // Pobierz informacje o odnowieniu
        let renewalInfo = await getRenewalInfo(for: transaction.productID)

        return SubscriptionStatus(
            isActive: isActive,
            expirationDate: transaction.expirationDate,
            willRenew: renewalInfo?.willAutoRenew ?? false,
            productID: transaction.productID
        )
    }

    private static func getRenewalInfo(for productID: String) async -> Product.SubscriptionInfo.RenewalInfo? {
        guard let product = try? await Product.products(for: [productID]).first,
              let subscription = product.subscription else {
            return nil
        }

        // Pobierz status odnowienia
        let status = try? await subscription.status.first
        return status?.renewalInfo
    }
}

To podejście zapewnia precyzyjny stan subskrypcji bez wywołań serwerowych.

Gotowy na rozmowy o iOS?

Ćwicz z naszymi interaktywnymi symulatorami, flashcards i testami technicznymi.

Pytanie 2: Jak Obsługiwać Bezpłatne Wersje Próbne i Oferty Promocyjne?

StoreKit 2 upraszcza dostęp do informacji o ofertach. Rozmówcy często testują rozumienie różnych typów ofert.

OfferManager.swiftswift
import StoreKit

struct OfferManager {

    enum OfferType {
        case freeTrial(duration: String)
        case payAsYouGo(periods: Int, price: Decimal)
        case payUpFront(duration: String, price: Decimal)
        case none
    }

    static func getIntroductoryOffer(for product: Product) -> OfferType {
        guard let subscription = product.subscription,
              let offer = subscription.introductoryOffer else {
            return .none
        }

        switch offer.paymentMode {
        case .freeTrial:
            // Bezpłatny okres próbny
            return .freeTrial(duration: formatPeriod(offer.period))

        case .payAsYouGo:
            // Obniżona cena przez wiele okresów
            return .payAsYouGo(
                periods: offer.periodCount,
                price: offer.price
            )

        case .payUpFront:
            // Jednorazowa płatność za okres
            return .payUpFront(
                duration: formatPeriod(offer.period),
                price: offer.price
            )

        @unknown default:
            return .none
        }
    }

    static func checkEligibility(for product: Product) async -> Bool {
        // Sprawdź, czy użytkownik może skorzystać z oferty
        guard let subscription = product.subscription else {
            return false
        }

        // isEligibleForIntroOffer wskazuje, czy jest to nowy subskrybent
        return await subscription.isEligibleForIntroOffer
    }

    private static func formatPeriod(_ period: Product.SubscriptionPeriod) -> String {
        let value = period.value
        switch period.unit {
        case .day:
            return "\(value) day\(value > 1 ? "s" : "")"
        case .week:
            return "\(value) week\(value > 1 ? "s" : "")"
        case .month:
            return "\(value) month\(value > 1 ? "s" : "")"
        case .year:
            return "\(value) year\(value > 1 ? "s" : "")"
        @unknown default:
            return ""
        }
    }
}

Metoda isEligibleForIntroOffer jest kluczowa, aby unikać wyświetlania niedostępnych ofert.

Pytanie 3: Jak Przywrócić Wcześniejsze Zakupy?

Przywracanie zakupów jest obowiązkową funkcją zgodnie z wytycznymi App Store.

RestoreManager.swiftswift
import StoreKit

actor RestoreManager {

    struct RestoreResult {
        let restoredProducts: [String]
        let activeSubscriptions: [String]
    }

    func restorePurchases() async throws -> RestoreResult {
        var restoredProducts: [String] = []
        var activeSubscriptions: [String] = []

        // Synchronizuje z App Store
        try await AppStore.sync()

        // Iteruje przez wszystkie transakcje użytkownika
        for await result in Transaction.currentEntitlements {
            guard case .verified(let transaction) = result else {
                continue
            }

            switch transaction.productType {
            case .nonConsumable:
                // Przywróć stałe zakupy
                restoredProducts.append(transaction.productID)

            case .autoRenewable:
                // Sprawdź, czy subskrypcja jest aktywna
                if let expiration = transaction.expirationDate,
                   expiration > Date() {
                    activeSubscriptions.append(transaction.productID)
                }

            default:
                // Konsumpcyjne nie są przywracalne
                break
            }
        }

        return RestoreResult(
            restoredProducts: restoredProducts,
            activeSubscriptions: activeSubscriptions
        )
    }
}

AppStore.sync() wymusza synchronizację z serwerami Apple, przydatne po reinstalacji.

Walidacja Paragonów po Stronie Serwera

Walidacja po stronie serwera pozostaje zalecana dla aplikacji z krytycznymi subskrypcjami. StoreKit 2 wprowadza JWS (JSON Web Signatures) dla nowoczesnej walidacji.

Wyodrębnianie Danych Transakcji dla Serwera

ServerValidation.swiftswift
import StoreKit

struct TransactionPayload: Codable {
    let transactionID: String
    let originalTransactionID: String
    let productID: String
    let purchaseDate: Date
    let expirationDate: Date?
    let jwsRepresentation: String
}

actor ServerValidationService {

    private let apiEndpoint = "https://api.example.com/verify"

    func validateWithServer(_ transaction: Transaction) async throws -> Bool {
        // Tworzy payload dla serwera
        let payload = TransactionPayload(
            transactionID: String(transaction.id),
            originalTransactionID: String(transaction.originalID),
            productID: transaction.productID,
            purchaseDate: transaction.purchaseDate,
            expirationDate: transaction.expirationDate,
            jwsRepresentation: transaction.jwsRepresentation ?? ""
        )

        // Koduje do JSON
        let encoder = JSONEncoder()
        encoder.dateEncodingStrategy = .iso8601
        let jsonData = try encoder.encode(payload)

        // Wysyła na serwer
        var request = URLRequest(url: URL(string: apiEndpoint)!)
        request.httpMethod = "POST"
        request.httpBody = jsonData
        request.setValue("application/json", forHTTPHeaderField: "Content-Type")

        let (data, response) = try await URLSession.shared.data(for: request)

        guard let httpResponse = response as? HTTPURLResponse,
              httpResponse.statusCode == 200 else {
            return false
        }

        // Dekoduje odpowiedź serwera
        let validationResponse = try JSONDecoder().decode(
            ValidationResponse.self,
            from: data
        )

        return validationResponse.isValid
    }
}

struct ValidationResponse: Codable {
    let isValid: Bool
    let subscriptionStatus: String?
}

Pole jwsRepresentation zawiera podpis kryptograficzny weryfikowalny przez serwer.

App Store Server API

Apple udostępnia obecnie App Store Server API do walidacji po stronie serwera. To nowoczesne API zastępuje przestarzały endpoint verifyReceipt i oferuje zaawansowane funkcje, takie jak powiadomienia serwer-do-serwera.

Konfiguracja Powiadomień Serwerowych

Server Notifications V2 umożliwia odbieranie zdarzeń w czasie rzeczywistym.

ServerNotificationTypes.swiftswift
enum NotificationType: String, Codable {
    case subscribed = "SUBSCRIBED"
    case didRenew = "DID_RENEW"
    case didFailToRenew = "DID_FAIL_TO_RENEW"
    case didChangeRenewalStatus = "DID_CHANGE_RENEWAL_STATUS"
    case expired = "EXPIRED"
    case gracePeriodExpired = "GRACE_PERIOD_EXPIRED"
    case offerRedeemed = "OFFER_REDEEMED"
    case priceIncrease = "PRICE_INCREASE"
    case refund = "REFUND"
    case renewalExtended = "RENEWAL_EXTENDED"
    case revoke = "REVOKE"
}

struct ServerNotification: Codable {
    let notificationType: NotificationType
    let subtype: String?
    let data: NotificationData

    struct NotificationData: Codable {
        let bundleId: String
        let environment: String
        let signedTransactionInfo: String
        let signedRenewalInfo: String?
    }
}

Te powiadomienia umożliwiają synchronizację stanu subskrypcji z backendem.

Obsługa Błędów i Przypadki Brzegowe

Rozmowy często testują zrozumienie scenariuszy błędów i ich właściwej obsługi.

Częste Błędy w StoreKit 2

PurchaseErrorHandler.swiftswift
import StoreKit

struct PurchaseErrorHandler {

    enum UserFacingError {
        case networkError
        case paymentFailed
        case notAuthorized
        case productNotAvailable
        case unknown

        var message: String {
            switch self {
            case .networkError:
                return "Connection failed. Please check your internet connection."
            case .paymentFailed:
                return "Payment failed. Please verify your payment information."
            case .notAuthorized:
                return "In-app purchases are disabled on this device."
            case .productNotAvailable:
                return "This product is not currently available."
            case .unknown:
                return "An unexpected error occurred."
            }
        }
    }

    static func handle(_ error: Error) -> UserFacingError {
        // Sprawdza, czy to błąd StoreKit
        if let storeKitError = error as? StoreKitError {
            switch storeKitError {
            case .networkError:
                return .networkError
            case .userCancelled:
                // Nie pokazuj błędu, użytkownik anulował
                return .unknown
            case .notAvailableInStorefront:
                return .productNotAvailable
            case .notEntitled:
                return .notAuthorized
            default:
                return .unknown
            }
        }

        // Błędy zakupu
        if let purchaseError = error as? Product.PurchaseError {
            switch purchaseError {
            case .invalidQuantity:
                return .unknown
            case .productUnavailable:
                return .productNotAvailable
            case .purchaseNotAllowed:
                return .notAuthorized
            default:
                return .unknown
            }
        }

        return .unknown
    }
}

Przejrzysta obsługa błędów poprawia doświadczenie użytkownika i upraszcza debugowanie.

Wsparcie dla Trybu Offline

OfflineCapabilityManager.swiftswift
import StoreKit

actor OfflineCapabilityManager {

    private let userDefaults = UserDefaults.standard
    private let entitlementsKey = "cached_entitlements"

    func cacheCurrentEntitlements() async {
        var entitlements: [String: Date] = [:]

        for await result in Transaction.currentEntitlements {
            if case .verified(let transaction) = result {
                entitlements[transaction.productID] = transaction.expirationDate
            }
        }

        // Zapisz lokalnie
        if let data = try? JSONEncoder().encode(entitlements) {
            userDefaults.set(data, forKey: entitlementsKey)
        }
    }

    func getCachedEntitlements() -> [String: Date] {
        guard let data = userDefaults.data(forKey: entitlementsKey),
              let entitlements = try? JSONDecoder().decode(
                  [String: Date].self,
                  from: data
              ) else {
            return [:]
        }

        // Filtruj wygasłe entitlementy
        let now = Date()
        return entitlements.filter { _, expiration in
            expiration > now
        }
    }

    func hasValidEntitlement(for productID: String) -> Bool {
        let cached = getCachedEntitlements()
        return cached[productID] != nil
    }
}

Lokalne cachowanie zachowuje dostęp do funkcji premium nawet bez łączności.

Najlepsze Praktyki Produkcyjne

Zalecana Architektura

SubscriptionService.swiftswift
import StoreKit
import Combine

@MainActor
final class SubscriptionService: ObservableObject {

    static let shared = SubscriptionService()

    @Published private(set) var products: [Product] = []
    @Published private(set) var purchasedProductIDs: Set<String> = []
    @Published private(set) var subscriptionStatus: SubscriptionStatus = .none

    private var transactionObserver: Task<Void, Never>?

    enum SubscriptionStatus {
        case none
        case active(expirationDate: Date)
        case expired
        case inGracePeriod
    }

    private init() {
        // Rozpocznij obserwację transakcji
        startTransactionObserver()

        // Załaduj stan początkowy
        Task {
            await loadProducts()
            await updateSubscriptionStatus()
        }
    }

    private func startTransactionObserver() {
        transactionObserver = Task.detached(priority: .background) {
            for await result in Transaction.updates {
                if case .verified(let transaction) = result {
                    await transaction.finish()
                    await self.updateSubscriptionStatus()
                }
            }
        }
    }

    func loadProducts() async {
        do {
            let productIDs = [
                "com.app.subscription.monthly",
                "com.app.subscription.yearly"
            ]
            products = try await Product.products(for: productIDs)
        } catch {
            print("Failed to load products: \(error)")
        }
    }

    func purchase(_ product: Product) async throws {
        let result = try await product.purchase()

        switch result {
        case .success(let verification):
            if case .verified(let transaction) = verification {
                await transaction.finish()
                await updateSubscriptionStatus()
            }
        case .userCancelled:
            break
        case .pending:
            break
        @unknown default:
            break
        }
    }

    func updateSubscriptionStatus() async {
        var purchasedIDs: Set<String> = []
        var latestSubscription: Transaction?

        for await result in Transaction.currentEntitlements {
            if case .verified(let transaction) = result {
                purchasedIDs.insert(transaction.productID)

                if transaction.productType == .autoRenewable {
                    if latestSubscription == nil ||
                       transaction.purchaseDate > latestSubscription!.purchaseDate {
                        latestSubscription = transaction
                    }
                }
            }
        }

        purchasedProductIDs = purchasedIDs

        if let subscription = latestSubscription,
           let expiration = subscription.expirationDate {
            if expiration > Date() {
                subscriptionStatus = .active(expirationDate: expiration)
            } else {
                subscriptionStatus = .expired
            }
        } else {
            subscriptionStatus = .none
        }
    }

    deinit {
        transactionObserver?.cancel()
    }
}

Ta scentralizowana architektura upraszcza zarządzanie stanem zakupów w całej aplikacji.

Podsumowanie

StoreKit 2 przekształca zarządzanie zakupami w aplikacji w nowoczesne i bezpieczne doświadczenie programistyczne. Kluczowe punkty do zapamiętania na rozmowę:

✅ Natywne API async/await: koniec ze skomplikowanymi delegatami i callbackami z StoreKit 1

✅ Automatyczna weryfikacja: VerificationResult zarządza walidacją kryptograficzną transakcji

Transaction.updates: asynchroniczny strumień dla transakcji w tle

Transaction.currentEntitlements: bezpośredni dostęp do aktywnych entitlementów użytkownika

✅ Oferty promocyjne: isEligibleForIntroOffer do sprawdzenia kwalifikowalności

✅ Walidacja serwera: JWS i App Store Server API dla zwiększonego bezpieczeństwa

transaction.finish(): obowiązkowy po dostarczeniu treści

✅ Obsługa offline: lokalne cachowanie entitlementów dla płynnego doświadczenia

Zacznij ćwiczyć!

Sprawdź swoją wiedzę z naszymi symulatorami rozmów i testami technicznymi.

Tagi

#ios
#storekit
#in-app-purchase
#swift
#interview

Udostępnij

Powiązane artykuły