74 lines
3.4 KiB
Markdown
74 lines
3.4 KiB
Markdown
# Chronosight
|
||
|
||
|
||
[](https://kotlinlang.org)
|
||
|
||
**[English](README.md) | 简体中文**
|
||
|
||
**时间都去哪儿了？通过 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](https://www.jetbrains.com/help/kotlin-multiplatform-dev/get-started.html)… |