SAP BTP SDK for iOS 提供的 Swift Package

此 Swift Package 分发 SAP BTP SDK for iOS 二进制框架，并告知您相关的开源 Swift Package。

BTP SDK for iOS 使您能够使用 Swift 快速开发原生应用。该 SDK 使用 SAP Fiori for iOS 设计语言中可重用的 UI 组件扩展了标准的 Swift Apple iOS 框架。它提供了将应用与 SAP BTP 服务无缝集成的 API。

SAP BTP SDK for iOS 框架和组件是特定功能的独立模块，允许开发者选择并仅实施其移动应用所需的功能。

以下二进制框架可以通过 Apple 的 Swift Package Manager (SPM) 使用此 Swift Package 进行消费

SAPCommon 包括常用的服务和日志记录组件。
SAPFoundation 包括通用组件，这些组件与设备和 SAP Mobile Services 的特性和功能集成，例如身份验证、连接、缓存、安全等。
SAPFiori 启用 SAP Fiori for iOS 作为一种设计语言，以统一 iOS 和 SAP Fiori 特性，从而优化企业应用中的用户体验。
SAPFioriFlows 用于开发复杂但典型的应用程序 onboarding 场景。
SAPOData 提供对暴露的后端 OData 服务的在线访问，没有任何缓存或本地数据存储。当应用程序需要最新的后端数据并具有可靠的连接时，这是最佳选择。
SAPOfflineOData 在应用在线时检索后端 OData 服务，然后创建一个离线 OData 存储，该存储使用定义查询列表进行初始化和填充。该存储持久保存在设备上（离线）。设备用户操作本地数据（查询、更新、创建、删除等），然后稍后将离线更改上传到后端。SAPOfflineOData 提供了离线 OData 所需的附加功能：创建离线存储、将待处理的修改请求发送到 SAP Mobile Services/后端、根据需要刷新离线存储、从离线存储中删除数据和删除离线存储并在最后一次使用离线存储后释放资源等等。当连接可能变得不可靠或需要不频繁地更新后端数据时，离线应用程序非常适用。
SAPML 用于在应用程序中开发机器学习功能，包括用于文本识别的拖放式 UI 组件、用于轻松搜索和过滤文本观察结果的拓扑 API，以及用于将托管在 SAP Mobile Services 上的自定义 Core ML 模型分发到应用程序的 Core ML 模型管理 API。

注意： 我们目前还在直接以 Swift Package 的形式开发一套新的开源库

FioriSwiftUI 作为 SAP Fiori for iOS 设计语言的 SwiftUI 实现，旨在增强并在某些情况下取代 SAPFiori 框架中包含的基于 UIKit 的实现。仓库链接
FioriAR 作为增强现实模式的实现，例如 SAP Fiori for iOS 设计语言中的 AR 注释。仓库链接
SAPCAI 用于本地启动和渲染来自 SAP Conversational AI 的对话。仓库链接

配置

获取技术用户和密码

SDK 二进制文件托管在 SAP 面向互联网的仓库中，这需要身份验证访问。您必须访问技术用户 UI 主页以获取技术用户名/密码。

SAP 客户和合作伙伴：使用您的 S-User 凭据

SAP 员工：使用您的 SAP 电子邮件用户名和 GLOBAL 凭据

安装凭据

打开或在 ~/.netrc 创建一个新文件。

添加一个包含用户名密码凭据对的条目，如下所示

machine rbsc.repositories.cloud.sap 
    login sap-xxxxxx 
    password xxxxxxxxxxxxxxxxxx

netrc 凭据技术是标准的 cURL API。有关完整文档，请参阅 gnu.org。

用法

在 Xcode 中，您可以通过导航到 File > Add Packages... > 将 Swift Package 添加到您的项目。使用 Search or Enter Package URL 字段，使用仓库 URL https://github.com/SAP/cloud-sdk-ios 查找软件包。

您可以选择以下多个软件包产品添加到您的应用程序/框架目标。

故障排除

缓存

SwiftPM 的缓存可能在您的机器上不正确，并可能在软件包解析期间导致错误消息，在 Xcode 中也是如此。然后您可能会看到错误消息，例如 invalid archive returned from 'https//rbsc.respositories.cloud.sap/nexus3/...

要解决此问题，请关闭 Xcode 并运行以下命令以清除您的本地缓存

rm -rf $HOME/Library/Caches/org.swift.swiftpm/
rm -rf $HOME/Library/org.swift.swiftpm

许可

SAP BTP SDK for iOS 二进制框架的下载由 SAP 的基于仓库的发货渠道提供支持。RBSC 基于许可证检查授予对这些仓库的访问权限。许可证信息基于购买的软件，并附加到您的 S-user 帐户。

如果您收到 HTTP 403 Forbidden 错误，请查看您的当前许可证，如此处所述，以确保您的用户拥有正确产品版本的许可证。

限制

此服务不适用于 SDK 的试用版本。

引用 SAP 支持网站的话，“您可以下载与您的 S-user ID 关联的 SAP 产品。虽然每位访问者都可以在没有任何特殊权限的情况下浏览软件产品列表，但下载文件需要软件下载授权；要请求授权，请联系您公司中的用户管理员。” 此限制也适用于云发货渠道。

框架的数字签名

SAP SE 使用 Team ID "7R5ZEU67FQ" 签署来自 SAP BTP SDK for iOS 的 XCFrameworks。

注意：Xcode 15 及更高版本将自动验证您应用的依赖项，并通过在检测到问题时向您发出警报来保护您的供应链完整性。Xcode 在检查器中显示一个部分，显示您应用中包含的 XCFrameworks 的签名状态。

已知问题

如何获得支持

对于与此仓库内容相关的问题，请提交 Issue。

对于与任何引用的资源和二进制文件相关的问题，请通过常规渠道向 SAP 提交支持票证。

贡献

如果您希望为仓库做出贡献，请遵守 SAP 的贡献指南。

维护者：更新软件包

确保您的 .netrc 文件已设置好（请参阅上面的配置部分）。
克隆/ fork & 克隆仓库
打开 update_version.sh
在第 3 行，将 VERSION="x.x.x" 更改为您要更新到的版本。请确保该版本在SDK 云发货中可用
- 注意：下载 URL 和最低部署目标可能会随主要版本而更改，并且必须在脚本 update_version.sh 中进行调整。
运行脚本
确保新计算的校验和都不同。如果某些校验和相同，则表示下载失败（例如，此版本的文件不存在）
提交您的更改并提交拉取请求

在 Xcode 13 中使用 Package Collection

在 Xcode 中，选择 File，然后选择 Add Packages... 。单击 + > 按钮，选择 Add Swift Package Collection，粘贴此 URL 并单击 Load。

现在，您可以通过选择一个软件包并单击 Add Package，从我们的集合中将软件包添加到您的项目。