SpendSmart 项目启动与配置教程

1. 项目目录结构及介绍

SpendSmart 是一个开源的 iOS 应用，旨在通过 AI 技术简化收据管理。以下是项目的目录结构及文件介绍：

SpendSmart/
├── SpendSmart.xcodeproj           # Xcode 项目文件
├── SpendSmart.xcworkspace         # Xcode 工作区文件
├── .gitignore                     # 指定 Git 忽略的文件和目录
├── LICENSE                        # 项目许可证文件
├── README.md                      # 项目说明文件
└── APIKeys.swift                  # API 密钥存储文件（需自行创建）

• SpendSmart.xcodeproj：Xcode 项目文件，用于打开和编辑 SpendSmart iOS 应用。
• SpendSmart.xcworkspace：Xcode 工作区文件，包含项目设置和配置信息。
• .gitignore：Git 忽略文件，列出不应被 Git 跟踪的文件和目录。
• LICENSE：项目使用的 MIT 许可证文件。
• README.md：项目说明文件，提供项目信息和使用说明。
• APIKeys.swift：API 密钥文件，存储各种服务的 API 密钥（此文件需要自行创建，并不应提交到版本控制中）。

2. 项目的启动文件介绍

项目的启动主要是通过 Xcode 打开 SpendSmart.xcodeproj 文件，然后编译和运行项目。

• 打开终端。
• 切换到项目目录：cd /path/to/SpendSmart。
• 使用 Xcode 打开项目：open SpendSmart.xcodeproj。

在 Xcode 中，你可以直接点击运行按钮来编译和运行应用，应用将在 iOS 模拟器中启动。

3. 项目的配置文件介绍

APIKeys.swift 文件是项目的配置文件，用于存储项目运行所需的各种 API 密钥。在第一次配置项目时，需要创建此文件并填入相应密钥。

以下是 APIKeys.swift 文件的基本结构：

let supabaseURL = "YOUR_SUPABASE_URL"
let supabaseAnonKey = "YOUR_SUPABASE_ANON_KEY"
let supabaseServiceRoleKey = "YOUR_SUPABASE_SERVICE_ROLE_KEY"
let geminiAPIKey = "YOUR_GEMINI_API_KEY"
let secretKey = "YOUR_SECRET_BACKEND_KEY"
let imgBBAPIKey = "YOUR_IMGBB_API_KEY"

你需要从相应的服务提供商那里获取这些密钥，并将它们替换掉上面的占位符。请确保不要将这些密钥提交到版本控制系统中，以免造成安全风险。

完成以上步骤后，你就可以开始使用 SpendSmart 应用了。如果有任何问题，可以在项目的 GitHub 页面上提出 issue 或讨论。