Kotlin 多平台应用模板项目结构及配置指南

1. 项目目录结构及介绍

KMP-App-Template-Native 是一个使用 Kotlin 多平台技术构建的模板项目，它允许开发者使用单一的 Kotlin 代码库创建跨平台应用程序。以下是项目的目录结构及各部分的作用介绍：

KMP-App-Template-Native/
├── app/
│   ├── common/
│   │   ├── main/
│   │   │   ├── kmp/
│   │   │   │   ├──presentation/
│   │   │   │   └── domain/
│   │   │   └── shared/
│   │   └── resources/
│   ├── ios/
│   │   ├── main/
│   │   └── SwiftUI/
│   ├── android/
│   │   ├── main/
│   │   ├── java/
│   │   └── res/
│   └── macos/
│       ├── main/
│       └── SwiftUI/
├── scripts/
│   └── build.gradle.kts
├── build.gradle.kts
└── settings.gradle.kts

• app/: 应用程序的主要目录，包含了不同平台共享的代码和平台特定的代码。
• app/common/: 包含所有平台共享的 Kotlin 代码。
• app/common/main/kmp/: 包含跨平台模块的代码，通常分为 presentation 和 domain 层。
• app/common/main/resources/: 存储共享资源，如字符串、图片等。
• app/ios/: 包含 iOS 平台特有的代码和资源。
• app/ios/main/: iOS 应用程序的入口点。
• app/ios/SwiftUI/: 如果使用 SwiftUI 构建界面，相关的代码将放在这里。
• app/android/: 包含 Android 平台特有的代码和资源。
• app/android/main/: Android 应用程序的主要代码目录。
• app/android/java/: 如果需要使用 Java 语言编写的代码，将放在这里。
• app/android/res/: 包含 Android 的资源文件，如布局、图片、字符串资源等。
• app/macos/: 包含 macOS 平台特有的代码和资源。
• app/macos/main/: macOS 应用程序的入口点。
• app/macos/SwiftUI/: 如果使用 SwiftUI 构建界面，相关的代码将放在这里。
• scripts/: 包含构建脚本。
• build.gradle.kts: Kotlin 格式的 Gradle 构建脚本，用于配置项目的构建过程。
• settings.gradle.kts: Gradle 设置文件，用于定义项目的结构和配置。

2. 项目的启动文件介绍

项目的启动文件根据平台的不同而有所差异。

• 对于 iOS 和 macOS 平台，启动文件通常位于 app/ios/main/AppDelegate.swift 或 app/macos/main/AppDelegate.swift。这些文件包含应用的初始化代码和生命周期管理。
• 对于 Android 平台，启动文件是 app/android/main/java/your/package/name/MainActivity.kt。这个 Kotlin 文件定义了 Android 应用的主活动，是用户与应用交互的入口点。

3. 项目的配置文件介绍

项目的配置主要通过 Gradle 文件进行。

• build.gradle.kts: 这是主要的 Kotlin 格式的 Gradle 构建脚本，用于定义项目的构建逻辑，包括依赖管理、构建任务和构建类型等。
• settings.gradle.kts: 这个文件用于配置 Gradle 的设置，如项目根目录下的模块。
• 每个平台目录下可能还有自己的 build.gradle.kts 文件，用于指定该平台的特定构建配置。

这些配置文件允许开发者为不同的平台定制构建过程，同时保持代码库的统一性。