Chronosight/README_zh.md

Chronosight

English | 简体中文

时间都去哪儿了？通过 Chronosight 了解您的数字习惯，跨平台跟踪和分析您的屏幕时间。

深入了解您在设备上花费时间的方式。Chronosight 帮助您跟踪屏幕使用时间、分析您的应用使用情况，并最终促进您在手机、平板电脑和电脑上实现更好的数字健康。

主要功能

• 跨平台跟踪: 在 Android、iOS 和桌面 (macOS, Windows, Linux) 上无缝跟踪您的屏幕使用时间。
• 详细使用情况分析: 获取您的应用使用情况明细，包括每个应用花费的时间和使用模式。
• 数字健康洞察: 了解您的数字习惯并找出需要改进的方面。
• 共享状态: 可选择与朋友或您自己的其他设备共享您的使用统计信息，以获得全面的了解。
• 可自定义报告: 生成可自定义的报告，以分析您在特定时间段内的屏幕使用时间数据。

技术栈

• Kotlin Multiplatform Mobile (KMM): 为所有平台提供核心业务逻辑、数据分析和共享功能。
• Android: 使用 Kotlin 和 Jetpack Compose 进行原生 UI 开发。
• iOS: 使用 Swift 和 SwiftUI 进行原生 UI 开发。
• 桌面: 使用 [例如，Compose for Desktop] 进行基于 Kotlin 的 UI 开发。
• 后端: Ktor 3.0 用于用户身份验证，云端同步和共享状态功能。

平台支持

• 📱 移动端: Android, iOS
• 💻 桌面端: macOS, Windows, Linux

入门指南 (面向开发者)

如果您有兴趣贡献代码或自行构建项目，请参考以下简要指南：

1. 前提条件: 确保您已设置好 Android、iOS 和桌面 Kotlin 开发所需的 SDK 和开发环境。
2. 克隆代码仓库: git clone https://github.com/grtsinry43/Chronosight.git
3. 打开: 在 IntelliJ IDEA 或 Android Studio 中打开项目。
4. 构建并运行:
   • Android: 运行 androidApp 模块。
   • iOS: 在 Xcode 中打开 iosApp/iosApp.xcodeproj 并运行。
   • 桌面: 运行 desktopApp 模块。

屏幕截图

贡献指南

许可证

更多

这是一个面向 Android、iOS 和桌面平台的 Kotlin Multiplatform 项目。

• /composeApp 目录用于存放将在您的 Compose Multiplatform 应用程序之间共享的代码。 它包含以下几个子文件夹：

  • commonMain 目录用于存放所有目标平台通用的代码。
  • 其他文件夹用于存放仅针对文件夹名称所指示的平台编译的 Kotlin 代码。 例如，如果您想在您的 Kotlin 应用程序的 iOS 部分使用 Apple 的 CoreCrypto， iosMain 将是进行此类调用的正确文件夹。

• /iosApp 目录包含 iOS 应用程序。即使您正在使用 Compose Multiplatform 共享您的 UI， 您仍然需要这个作为您的 iOS 应用程序的入口点。这也是您应该为您的项目添加 SwiftUI 代码的地方。

• /shared 目录用于存放将在项目中的所有目标平台之间共享的代码。 最重要的子文件夹是 commonMain。如果需要，您也可以在此处的平台特定文件夹中添加代码。

了解更多关于 Kotlin Multiplatform…