SpendSmart 的安装和配置教程

项目基础介绍

SpendSmart 是一个开源的 iOS 应用，它通过 AI 技术使得收据管理变得轻松简单。用户只需要使用 iPhone 相机拍摄收据照片，SpendSmart 就可以自动提取出所有关键信息，包括商店名称、位置、商品、总额、支付方式等。

该项目的开发语言主要是 Swift，并且使用了 SwiftUI 进行界面设计。

项目使用的关键技术和框架

在技术实现上，SpendSmart 使用了以下关键技术和框架：

• AI/OCR: 使用 Gemini 2.0 Flash 进行光学字符识别（OCR），以识别和提取收据上的文本信息。
• 存储与认证: 使用本地存储和 Supabase 进行数据同步。
• 图像上传: 使用 imgBB API 进行图像上传。

项目安装和配置的准备工作

在开始安装和配置 SpendSmart 项目之前，请确保您的开发环境已经准备就绪：

1. 安装最新版本的 Xcode。
2. 确保您的计算机上已经安装了 Git。

安装步骤

以下是详细的安装步骤：

1. 克隆项目仓库

   打开您的终端（Terminal），然后运行以下命令来克隆 SpendSmart 项目：

   git clone https://github.com/yourusername/SpendSmart.git
   

   注意：请将 yourusername 替换为您的 GitHub 用户名。

2. 设置 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"
   

   注意：您需要从 Supabase、Google Cloud Console 和 imgBB 获取相应的密钥并填入上述位置。不要将这个文件提交到版本控制中。

3. 打开项目

   使用 Xcode 打开克隆下来的项目文件夹中的 .xcodeproj 文件。

4. 构建和运行

   在 Xcode 中，选择您的设备，然后点击“构建和运行”按钮来编译和运行 SpendSmart 应用。

按照上述步骤操作，您应该能够成功安装和配置 SpendSmart 项目，并在您的 iOS 设备上运行它。