App 生成 允许您直接从 Spline 生成预构建的 Xcode 项目，以便使用我们基于 Metal 的渲染器在 App Store 发布。
我们基于 Metal 渲染器可让您将在 Spline 中制作的 3D 设计的所有交互性带到苹果设备上。它还能充分利用 iPhone、iPad 或 Mac 等苹果设备的所有原生性能。
📺 视频详情介绍
使用要求
请按照以下步骤设置使用 App 生成。
1. 注册 Apple ID 或加入 Apple Developer Program
- 要开始在设备上测试应用程序，你需要一个免费的 Apple ID。
- 要在 App Store 发布应用程序，您需要注册 Apple Developer Program。
有关 Apple ID 和 Apple Developer Program 会员资格之间区别的更多信息，请参阅 Apple 有关选择会员资格的文档。
团队 ID
要在 Xcode 中构建应用程序，您可能需要一个团队 ID。
了解如何在 Apple 文档中找到您的团队 ID： 查找您的团队 ID。
2. 下载并安装 Xcode
要使用从 Spline 生成的 Xcode 项目构建应用程序，您需要使用 Xcode。Xcode 仅适用于 macOS。
- 从 Mac App Store 下载最新版本的 Xcode。
- 从 Apple Developer 网站下载 Xcode 的最新版本或测试版。
开始使用
请按照以下步骤使用 Spline iOS Runtime 在您的 Swift 项目中使用原生 3D 嵌入。
平台支持
Spline 采用最新技术在 Apple 平台上渲染 3D 内容。
设备 | OS最低要求 | 芯片最低要求 |
iPhone | iOS 16.0 及以上 | A13 及以上 |
iPad | iPadOS 16.0 及以上 | A13 及以上 |
Mac | macOS 13.0 及以上（（通过 Mac Catalyst 或专为 iPad 设计） | Apple Silicon |
Vision Pro | 实验支持（开发中） | M2 |
Apple TV | 未支持 | - |
Apple Watch | 未支持 | - |
语言和库支持
Spline iOS Runtime 使用 SwiftUI 和 Swift。
1. 从 Spline 生成 Xcode 项目
- 从顶部工具栏点击
导出按钮，打开导出面板； - 在 Apple 平台 下，选择
App选项； - 填写所有所需设置，以创建 Xcode 项目。更多信息请参阅下文；
- 点击生成按钮。
1.1 设置概览
有关应用程序生成的所有不同设置的详细信息，请参阅下文。
设置 | 目的 |
App Name | 您的应用程序或项目的名称。 |
Organization ID | 您的组织或团队的 ID。最佳做法是使用您的反向域名。 com.mycompany |
Version | 应用程序的版本。 |
Team ID | 您的 Xcode 团队或组织的 ID。请参阅团队 ID 部分了解更多信息。 |
Mode | 嵌入 Spline 场景的方式。
- 通过云端 URL 加载场景。
- 本地将下载并使用 .splineswift 文件 |
Xcode version | 打开生成的项目所需的 Xcode 版本。 |
Logo | 启用或禁用 Spline logo。您需要激活超级或超级团队订阅。 |
App Icon | 上传一张 1024x1024 的图片，作为您的应用程序图标。 |
Orientation | 定义应用程序将使用的方向。在自动旋转模式下，您可以选择应用程序可以使用的方向。 |
Status Bar | 定义应用程序的状态栏是可见还是隐藏。 |
2.使用 Xcode 构建并运行应用程序
只需几个简单的步骤，就可以通过 Xcode 构建并运行应用程序。
- 在 Xcode 中，转到 "文件">"打开"，然后选择包含项目的解压缩文件夹；
- 选择您的构建设备--确保使用您的物理设备（Mac、iPhone、iPad 或 Vision Pro），因为模拟器目前无法预览 Spline 场景。
- 按 ▶️ 来构建项目。
有关如何使用 Xcode 构建应用程序的更多信息，请参阅 Apple 有关构建和运行应用程序的文档。
如果你没有从 Spline 添加团队 ID，在 Xcode 上，你可能需要进入 Signing & Capabilities，在 Signing 下，你可以手动添加你的团队。
3.发布和分发应用程序
有关向 App Store 发布应用程序的更多信息，请参阅 Apple 有关为 beta 测试和发布发布应用程序的文档。
可能的警告
构建应用程序时，即使应用程序正确构建，嵌入中也可能会显示一些错误。请参阅下文以查看警告及其解释。
"Spline scene file is in an unknown format”
导出的文件太旧、运行时太旧或者文件可能已损坏。
"Spline scene file URL could not be reached”
当运行时无法从网络下载 .splineswift 文件时会显示它。这可能是因为 URL 无效，或者只是网络连接无法正常工作。
功能支持路线图
Metal 渲染 的所有 Spline 功能的全面覆盖预计将于 2024 年初准备就绪，以下是每个功能的当前状态列表。该列表将每周更新一次，直到一切都得到完全支持。
功能 | 状态 | 笔记 |
参数化二维形状 | ✅ | |
参数化三维形状 | ✅ | |
非参数化三维形状 | 🚧 | 3D 路径、车床、细分网格已烘焙（暂时）- 即将推出全面支持 |
材质图层 | ✅ | 视频层支持即将推出。
轮廓图层中的某些设置尚不支持。 |
状态 | ✅ | |
基础过渡 | ✅ | |
物理 | 🚧 | |
交互 | 🚧 | 游戏控制、变量变化、距离、状态变化、触发区域和碰撞事件即将推出 |
动作 | 🚧 | 截至今天，仅支持转换和打开链接操作 |
后处理 | 🚧 | |
点光源 | 🚧 | |
动画模型 | 🚧 | |
多场景 | 🚧 | 仅导出主要场景 |
Xcode 模拟器预览 | 🚧 | 目前，只能在真实设备中测试您的应用程序。 Xcode 中的模拟器支持即将推出。 |
为 iOS 导出本地嵌入式内容
为 iOS 等苹果平台导出 3D 内容的另一种方法是使用 Swift 代码片段的本地嵌入。
前往查看更多详情：本地嵌入3D到iOS