Recco iOS SDK
此仓库包含 Recco iOS SDK 的代码库。如何在 使用 部分中添加和使用此 iOS 库的说明。
您可以随时克隆此仓库并自行编译以运行 ShowCase 应用程序。您还可以 联系我们，要求直接访问我们的 ShowCase 应用的 Testflight 构建，以便您的团队成员中可能不太熟悉技术的人员。
但是，请注意，为了将其实际集成到您的应用程序中，您首先需要联系我们的销售团队以启动许可证购置过程。为此，请发送电子邮件至 [email protected]。
概述
基于用户的独特兴趣、动机和健康行为，提供个性化的健康和健身建议。无论是希望提高自己的健身水平，管理压力，还是仅仅过上更充实的生活，Recco 都旨在帮助他们发挥潜能。
我们相信每个人都值得过上最好的生活，我们致力于通过我们前沿的技术和对科学准确的坚定不移承诺来实现这个愿景。
任务
我们希望您亲身体验我们推荐引擎的有效性。通过基于最新科学研究的个性化推荐，让用户实现自我提升。
让产品为用户提供丰富的知识、建议和练习，帮助他们改善行为并达成目标。
 |
 |
 |
关键特性
简单易用
我们坚信公开透明的沟通，并鼓励个人对自己的行为负责。我们抵制归咎文化，而是拥抱合作，认识到我们共同努力的力量。让我们相互伸出援手，共同为实现共同目标而努力。
无缝集成
该产品特别关注与现有产品的无缝协作。Recco 只需几个步骤即可进行配置和完全运行。
科技趋势
Recco 力求与现代解决方案和发展趋势保持一致。我们遵循最佳实践和官方指南，以确保质量达到最高水平。
分析与报告
监控推荐引擎的利用和影响。您可以跟踪关键指标，如用户参与度、满意度水平和健康状况，以评估我们的解决方案的有效性。
个性化内容
我们的引擎会学习为每个主题推荐内容，以激发用户改善健康行为。根据用户选择的道路，推荐的内容将随之改变，并将始终推荐有助于用户前进的内容。
一旦集成，Recco 将成为您产品的一部分，并可为用户提供一个完整的互动之旅。
设置
您可以使用多种方法安装 Recco SDK
Swift Package Manager
使用 Xcode
- 文件 > Swift Packages > 添加软件包依赖
- 添加
https://github.com/sf-recco/ios-sdk.git - 选择“到下一个主要版本”，输入“1.0.0”
要使用 Apple 的 Swift 软件包管理器进行集成（无需 Xcode 集成），请在您的 Package.swift 中添加以下依赖项
dependencies: [
.package(url: "https://github.com/sf-recco/ios-sdk.git", .upToNextMajor(from: "1.0.0"))
]Cocoapods
要使用 Cocoapods 在 Xcode 项目中集成 Alamofire，请在您的 Podfile 中指定它
pod 'ReccoUI'使用方法
本节旨在解释如何在 iOS 项目中实现 Recco 集成。同时请查看 Flutter 和 Android 对应版本！
要将 SDK 集成到您的应用程序中，您需要按照以下步骤操作
初始化
初始化的目的是建立您的 clientSecret 以及加载 SDK 运行所需资源。它还允许您设置适合应用程序的任何样式。为此，请将以下代码添加到您的 AppDelegate.willFinishLaunchingWithOptions 或 App.init 实例
import ReccoUI
ReccoUI.initialize(
clientSecret: "<myClientSecret>",
style: .summer // or your previously created ReccoStyle
)请注意，如果在使用 SDK 之前没有进行初始化，将会导致错误。
登录和退出
该SDK专注于为每位用户提供定制内容。因此，每次您的应用程序登录或退出用户时，您都需要告知Recco这一情况。
在Recco上登录用户仅需要您传递该用户的唯一标识符。我们建议您不要使用任何重要信息来这样做，但在任何情况下，我们的后端都会对该唯一ID进行散列和存储，以作安全措施。在SDK中调用登录时，将像这样
import ReccoUI
// ideally you would call this method after a successful login into your own system
// ReccoUI.login(userId:) is an async function, be sure to run it in an async context.
do {
try await ReccoUI.login(userId: "[email protected]") // you don't need to use an email here, just any unique id related to that user
} catch {
// handle network error
}当您的用户成功退出您的应用程序时，只需调用
import ReccoUI
// ReccoUI.logout is an async function, be sure to run it in an async context.
do {
try await ReccoUI.logout()
} catch {
// handle network error
}Recco的入口点
初始化和登录后，您只需要在应用程序中提供一个入口点来显示Recco。您可以使用任何类型的按钮或视图来实现这一点，但一旦您想要打开Recco，您将需要显示我们的UIViewController或我们的SwiftUI视图。您可以这样做
// using UIKit
// i.e. after the user taps a button:
let reccoViewController = ReccoUI.reccoRootViewController()
yourAppCurrentViewController.present(reccoViewController, animated: true)
// using SwiftUI
// inside your View, a button will toggle the displayRecco variable
YourAwesomeView()
.sheet(isPresented: $displayRecco) {
ReccoUI.ReccoRootView()
}发行版本
我们的