Currency Converter Calculator —— 跨平台货币转换应用的最佳实践

1. 项目介绍

Currency Converter Calculator（以下简称CCC）是一个基于Kotlin Multiplatform的开源项目，旨在为Android、iOS和后端提供一个货币转换和计算器功能的应用。通过使用Kotlin Multiplatform，CCC实现了代码的最大复用，同时保证了各个平台上的性能和用户体验。

2. 项目快速启动

克隆项目

首先，您需要克隆整个项目到本地：

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

环境配置

确保您安装了最新的Android Studio和XCode 13.0或更高版本。

Android

1. 使用Android Studio打开CCC文件夹。
2. 选择android:app作为配置。
3. 运行项目。

iOS

1. 使用XCode打开CCC/ios/CCC.xcworkspace。
2. 等待依赖包解析完成。
3. 运行项目。

Backend

运行后端服务：

./gradlew :backend:run

注意事项

由于项目中使用的API密钥没有公开，运行应用时API调用可能会失败。您可以替换com.oztechan.ccc.common.core.network.api.backend.BackendApiImpl和com.oztechan.ccc.common.core.network.api.premium.PremiumApiImpl中的getConversion方法，使用预定义的JSON响应进行测试。

3. 应用案例和最佳实践

Modularization

项目采用了模块化的架构设计，将不同平台的代码和应用逻辑分离开来，具体如下：

• android, ios, backend：包含特定平台的代码。
• client：一个KMM模块，用于在iOS和Android之间共享代码。
• common：一个KMP模块，包含所有平台共享的代码。
• submodule：包含不同的git子模块，可以在任何主模块中使用。
• test：包含架构和编码约定的测试用例。

Architecture

项目的架构分为后端和移动端两部分：

Backend

• database：数据存储。
• datasource：数据源。
• api：API接口。
• service：服务层。
• Controller：控制器。

Mobile

• Persistence：持久化存储。
• Database：数据库。
• API：API接口。
• Service：服务层。
• RemoteConfig：远程配置。
• ConfigService：配置服务。
• Storage、DataSource、Repository、ViewModel、Views：按照MVVM模式组织。

4. 典型生态项目

CCC项目使用了以下技术和库：

• Kotlin Multiplatform：跨平台开发。
• Kotlin DSL：构建脚本。
• SQLDelight：数据库访问。
• Ktor：网络通信。
• Coroutines：异步编程。
• MVVM、StateFlow：应用架构和状态管理。

以上是Currency Converter Calculator项目的最佳实践介绍。希望这些信息能够帮助您更好地理解和使用该项目。