在 iOS SDK 中使用 Flow Builder 启用内购

要启用应用内购买，你需要了解三个核心概念：

产品 – 用户可以购买的任何内容（订阅、消耗型商品、永久授权）
流程 – 向用户呈现产品的屏幕序列，在无代码的 Flow Builder 中构建。SDK 通过 getFlow 获取流程。如果你更倾向于用自己的代码构建 UI，请改用付费墙 — 参见手动实现付费墙。
版位 – 在应用中展示流程的位置和时机（例如 main、onboarding、settings）。你在看板中将流程绑定到版位，然后在代码中通过版位 ID 请求它们。这样可以轻松进行 A/B 测试，并向不同用户展示不同的流程。 Adapty 为您提供三种在应用中启用购买的方式，请根据应用需求选择其中一种： | 实现方式 | 复杂度 | 适用场景 | |---|---|---| | Adapty Flow Builder | ✅ 简单 | 你在无代码编辑工具中创建完整的、可立即购买的流程。Adapty 自动完成渲染，并在后台处理所有复杂的购买流程、收据验证和订阅管理。 | | 手动创建付费墙 | 🟡 中等 | 你在应用代码中自行实现付费墙 UI，但仍通过 Adapty 获取 flow 对象，从而保持产品组合的灵活性。参阅指南。 | | 观察者模式 | 🔴 复杂 | 你已有自己的购买处理基础设施并希望继续使用。请注意，观察者模式在 Adapty 中存在一定限制。参阅文章。 |

以下步骤展示如何在应用中实现通过 Adapty Flow Builder 创建的流程。

如果你想自行构建付费墙 UI，请参阅手动实现付费墙。

要在应用代码中展示通过 Adapty Flow Builder 创建的流程，你只需完成以下步骤：

获取流程：从 Adapty 获取。
展示流程，Adapty 会自动处理购买逻辑：在应用中显示该视图。
处理按钮操作：将用户交互与应用的响应逻辑绑定，例如在用户点击按钮时打开链接或关闭流程。

开始之前

开始之前，请先完成以下步骤：

在 Adapty 看板中将你的应用连接到 App Store。
在 Adapty 中创建产品。
创建流程并添加产品。
创建版位并将流程添加到其中。
在应用代码中安装并激活 Adapty SDK。本指南使用 Adapty iOS SDK v4（测试版）API。

1. 获取流程

你的流程与在看板中配置的版位相关联。版位允许你针对不同的目标受众运行不同的流程，或者运行 A/B 测试。

要获取在 Adapty Flow Builder 中创建的流程，你需要：

通过 getFlow 方法，使用版位 ID 获取 flow 对象，并检查它是否包含视图配置。
使用 getFlowConfiguration 方法获取视图配置。该配置包含显示流程所需的 UI 元素和样式信息。


func loadFlow() async {
    let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")

    guard flow.hasViewConfiguration else {
        print("Flow doesn't have a view configuration")
        return
    }

    flowConfiguration = try await AdaptyUI.getFlowConfiguration(forFlow: flow)
}

2. 展示流程

现在，当你获取到流程配置后，只需添加几行代码即可展示你的流程。

在 SwiftUI 中，展示流程时还需要处理事件。didFailPurchase、didFinishRestore、didFailRestore 和 didReceiveError 是必须处理的。在测试阶段，你可以直接复制下方代码片段来记录这些事件。

处理 didFinishPurchase 不是必须的，但在购买成功后需要执行某些操作时会很有用。如果不实现该回调，流程将自动关闭。

.flow(
    isPresented: $flowPresented,
    flowConfiguration: flowConfiguration,
    didFailPurchase: { product, error in
        print("Purchase failed: \(error)")
    },
    didFinishRestore: { profile in
        print("Restore finished successfully")
    },
    didFailRestore: { error in
        print("Restore failed: \(error)")
    },
    didReceiveError: { error in
        flowPresented = false
        print("Flow error: \(error)")
    }
)


func presentFlow(with config: AdaptyUI.FlowConfiguration) {
    let flowController = try AdaptyUI.flowController(
        with: config,
        delegate: self
    )
    present(flowController, animated: true)
}

实现 AdaptyFlowControllerDelegate 以处理事件。至少需要实现必要的错误处理方法（以下三个没有默认实现的方法）：

extension YourViewController: AdaptyFlowControllerDelegate {
    func flowController(_ controller: AdaptyFlowController,
                        didFailPurchase product: AdaptyPaywallProduct,
                        error: AdaptyError) {
        print("Purchase failed: \(error)")
    }

    func flowController(_ controller: AdaptyFlowController,
                        didFinishRestoreWith profile: AdaptyProfile) {
        print("Restore finished successfully")
    }

    func flowController(_ controller: AdaptyFlowController,
                        didFailRestoreWith error: AdaptyError) {
        print("Restore failed: \(error)")
    }
}

有关如何展示流程的更多详情，请参阅我们的指南。

3. 处理按钮操作

当用户点击按钮时，iOS SDK 会自动处理购买、恢复、关闭流程以及打开链接等操作。

不过，其他按钮具有自定义或预定义的 ID，需要在代码中处理相应操作。你也可以根据需要覆盖这些按钮的默认行为。

例如，以下是处理关闭按钮的方式。在 UIKit 中，当 .close 触发时，SDK 会自动关闭控制器——只有在需要自定义行为时才需要覆盖。在 SwiftUI 中，你必须自行将 isPresented 绑定设置为 false。

阅读我们的指南，了解如何处理按钮操作和事件。

.flow(
    isPresented: $flowPresented,
    flowConfiguration: flowConfiguration,
    didPerformAction: { action in
        switch action {
            case .close:
                flowPresented = false // 当用户点击关闭时，关闭流程
            default:
                break
        }
    },
    didFailPurchase: { product, error in /* 处理错误 */ },
    didFinishRestore: { profile in /* 检查访问等级并关闭 */ },
    didFailRestore: { error in /* 处理错误 */ },
    didReceiveError: { error in flowPresented = false }
)

extension YourViewController: AdaptyFlowControllerDelegate {
    func flowController(_ controller: AdaptyFlowController,
                        didPerform action: AdaptyUI.Action) {
        switch action {
            case .close:
                controller.dismiss(animated: true) // default behavior — override only if needed
            default:
                break
        }
    }
}

后续步骤

有疑问或遇到问题？请访问我们的支持论坛，您可以在那里找到常见问题的解答，或者提出您自己的问题。我们的团队和社区随时为您提供帮助！

您的流程已准备好在应用中展示。请在沙盒模式下测试购买，确保能够完成测试购买。

接下来，您需要检查用户的访问等级，以确保向正确的用户展示流程或开放付费功能的访问权限。

完整示例

以下是本指南中所有步骤在应用中整合的完整示例。


struct ContentView: View {
    @State private var flowPresented = false
    @State private var flowConfiguration: AdaptyUI.FlowConfiguration?
    @State private var isLoading = false
    @State private var hasInitialized = false

    var body: some View {
        VStack {
            if isLoading {
                ProgressView("Loading...")
            } else {
                Text("Your App Content")
            }
        }
        .task {
            guard !hasInitialized else { return }
            await initializeFlow()
            hasInitialized = true
        }
        .flow(
            isPresented: $flowPresented,
            flowConfiguration: flowConfiguration,
            didPerformAction: { action in
                switch action {
                case .close:
                    flowPresented = false
                default:
                    break
                }
            },
            didFailPurchase: { product, error in
                print("Purchase failed: \(error)")
            },
            didFinishRestore: { profile in
                print("Restore finished successfully")
            },
            didFailRestore: { error in
                print("Restore failed: \(error)")
            },
            didReceiveError: { error in
                print("Flow error: \(error)")
                flowPresented = false
            }
        )
    }

    private func initializeFlow() async {
        isLoading = true
        defer { isLoading = false }

        await loadFlow()
        flowPresented = true
    }

    private func loadFlow() async {
        do {
            let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")
            guard flow.hasViewConfiguration else {
                print("Flow doesn't have a view configuration")
                return
            }
            flowConfiguration = try await AdaptyUI.getFlowConfiguration(forFlow: flow)
        } catch {
            print("Failed to load: \(error)")
        }
    }
}


class ViewController: UIViewController {
    private var flowConfiguration: AdaptyUI.FlowConfiguration?

    override func viewDidLoad() {
        super.viewDidLoad()

        Task {
            await initializeFlow()
        }
    }

    private func initializeFlow() async {
        do {
            flowConfiguration = try await loadFlow()

            if let flowConfiguration {
                await MainActor.run {
                    presentFlow(with: flowConfiguration)
                }
            }
        } catch {
            print("Error initializing: \(error)")
        }
    }

    private func loadFlow() async throws -> AdaptyUI.FlowConfiguration? {
        let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")

        guard flow.hasViewConfiguration else {
            print("Flow doesn't have a view configuration")
            return nil
        }

        return try await AdaptyUI.getFlowConfiguration(forFlow: flow)
    }

    private func presentFlow(with config: AdaptyUI.FlowConfiguration) {
        guard let flowController = try? AdaptyUI.flowController(
            with: config,
            delegate: self
        ) else { return }

        present(flowController, animated: true)
    }
}

extension ViewController: AdaptyFlowControllerDelegate {
    func flowController(_ controller: AdaptyFlowController,
                        didFailPurchase product: AdaptyPaywallProduct,
                        error: AdaptyError) {
        print("Purchase failed for \(product.vendorProductId): \(error)")

        guard error.adaptyErrorCode != .paymentCancelled else { return }

        let message = switch error.adaptyErrorCode {
        case .paymentNotAllowed:
            "Purchases are not allowed on this device."
        default:
            "Purchase failed. Please try again."
        }

        let alert = UIAlertController(title: "Purchase Error", message: message, preferredStyle: .alert)
        alert.addAction(UIAlertAction(title: "OK", style: .default))
        present(alert, animated: true)
    }

    func flowController(_ controller: AdaptyFlowController,
                        didFinishRestoreWith profile: AdaptyProfile) {
        print("Restore finished successfully")
        controller.dismiss(animated: true)
    }

    func flowController(_ controller: AdaptyFlowController,
                        didFailRestoreWith error: AdaptyError) {
        print("Restore failed: \(error)")
    }

    func flowController(_ controller: AdaptyFlowController,
                        didReceiveError error: AdaptyUIError) {
        print("Flow error: \(error)")
        controller.dismiss(animated: true)
    }
}