CCC 的安装和配置教程

项目的基础介绍和主要的编程语言

CCC（Currency Converter Calculator）是一个货币转换器和计算器的开源项目，它支持Android、iOS和后端，利用Kotlin多平台的优势开发而成。该项目允许用户快速进行货币转换和数学运算。主要编程语言包括Kotlin和Swift。

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

项目采用以下关键技术和框架：

• Kotlin Multiplatform (KMP): 允许开发者用单一的代码库编写可以在多个平台（如Android、iOS和后端）上运行的应用程序。
• Ktor: 用于后端服务器和网络通信的框架。
• MVVM 架构: 模型-视图-视图模型（Model-View-ViewModel）架构模式，用于帮助分离业务逻辑和用户界面。
• StateFlow: 用于在Kotlin中管理状态和事件的库。
• SQLDelight: 用于数据库访问的轻量级框架。
• Combine: 用于在Swift中处理异步事件的框架。

项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您的开发环境满足以下要求：

• 安装了最新版本的Android Studio。
• 安装了Xcode 13.0或更高版本（对于iOS开发）。
• 确保您的系统中已安装了Git。

安装步骤

1. 克隆项目

   打开终端或命令提示符，运行以下命令以克隆CCC项目：

   git clone https://github.com/Oztechan/CCC.git
   cd CCC
   git submodule update --init --recursive
   

   这将下载项目及其所有子模块。

2. 配置Android项目

   使用Android Studio打开CCC/android/app目录。在打开项目时，选择android:app作为启动模块。

3. 配置iOS项目

   打开Xcode，然后打开CCC/ios/CCC.xcworkspace。在包解析完成后，您就可以运行iOS项目了。

4. 运行后端

   在终端中，导航到项目根目录，并运行以下命令以启动后端服务器：

   ./gradlew :backend:run
   

5. 进行测试

   当您运行应用程序时，所有API调用可能会失败，因为私有URL不会公开共享。如果想要使用真实的API调用进行测试，需要将com.oztechan.ccc.common.core.network.api.backend.BackendApiImpl和com.oztechan.ccc.common.core.network.api.premium.PremiumApiImpl中的getConversion方法替换为实际的API调用。

按照以上步骤操作，您应该能够成功安装并运行CCC项目。