APK（Android Package）是用于分发和安装 Android 应用程序的传统文件格式。它包含所有必要的组件，打包成一个文件。用户可以直接下载并安装 APK 到他们的 Android 设备上，使其成为在 Google Play 商店之外分发应用程序的标准。
通过使用 Spline，你可以通过我们的基于 Vulkan渲染器生成 3D 场景的 APK 文件。
我们的基于 Vulkan渲染器使你能够将 Spline 中制作的所有 3D 设计的互动性带到 Android 设备上，并充分利用它们的原生性能。
开始使用
按照以下步骤开始生成和使用 3D 场景的 APK 文件。
平台支持
Spline 使用最新技术在 Android 设备上渲染 3D 内容。
它可以在 Android 7.0 及以上版本的手机、平板电脑、Wear OS、桌面、电视和汽车设备上运行，但我们建议使用 Android 10.0 以上版本，且支持Vulkan。
语言和库支持
Spline Android Runtime 可与 Kotlin 和 Java 一起使用。
Android Studio 模拟器
Android Studio 模拟器上的性能并不代表最终在物理设备上运行的 3D 场景的性能。根据你的开发硬件，Android 模拟器有时只使用 CPU（较慢）或 GPU（较快）来渲染图形。然而，设备上的 3D 场景将始终使用 GPU。
1. 从 Spline 生成 Android Package (APK)
- 在顶部工具栏中，点击“
导出”按钮打开导出面板； - 在 Android 平台下，选择“
APK”选项； - 填写生成 APK 文件所需的所有设置。有关更多信息，请参阅下文；
- 点击“
生成”按钮生成 APK 文件。
1.1 设置概览
参阅以下内容，了解与 APK 生成相关的所有不同设置的更多信息。
设置 | 目的 |
App Icon | 上传 1024x1024 图像作为应用程序图标。 |
App 名称 | 应用或项目的名称。 |
应用包标识符 | Android 应用的唯一标识符，用于将其与 Google Play 商店和设备上的所有其他应用区分开来。 |
版本 | 应用的版本。 |
模式 | Spline 场景的嵌入方式：
- 云端：通过 URL 加载场景。
- 本地：下载并使用 .splinecontent 文件。 |
Android 版本 | 应用将编译的 Android 版本。 |
Logo | 启用或禁用 Spline 标志。 |
Orientation | 定义应用将使用的方向。选择自动旋转时，可以选择应用可以使用的方向。 |
Status Bar | 定义应用是否显示状态栏。 |
2. 在 Android 设备上安装并启动应用
你可以将 APK 文件传输到你的物理 Android 设备，按照以下步骤进行安装和运行：
- 在安装 APK 文件之前，你需要启用从未知来源安装应用的选项（这允许安装来自 Google Play 商店之外的应用）；
- 将 APK 文件传输到你的 Android 设备；
- 打开 APK 文件进行安装；
- 安装完成后，你可以启动该应用。
3. 发布和分发你的应用
有关发布到 Google Play 商店的更多信息，请参阅 Android 关于发布应用的文档。
功能支持路线图
预计 Vulkan 渲染器的所有 Spline 功能将在 2024 年第四季度全面覆盖。以下是每项功能当前状态的列表。该列表将每周更新，直到所有功能完全支持。
功能 | 状态 | 备注 |
参数化形状 | ✅ | |
非参数化形状 | ✅ | 细分、3D 路径、文本 和 布尔已处理。 |
材质 | ✅ ⏰ | 轮廓和视频图层支持即将推出。 |
事件与状态 | ✅ | |
物理 | ✅ | |
游戏控制 | ✅ | |
后期处理 | 🚧 | |
粒子 | 🚧 | |
变量 | ✅ ⏰ | 时间变量和本地存储支持即将推出。 |
动画模型 | 🚧 | |
环境阴影 | 🚧 | |
多场景 | 🚧 | |
UI 场景 | 🚧 |
为 Android 提供原生 3D 嵌入
使用我们的基于 Vulkan 的渲染器，你现在可以在 Android 项目中嵌入原生 3D 内容。
了解更多关于 Android 原生 3D 嵌入 的信息。
生成 AAB
通过直接从 Spline 生成预构建的 Android 应用程序包文件（AAB），为 Android 设备导出 3D 内容。
了解更多关于 Android App Bundles (AAB) 的信息。