# Time_TV

**Repository Path**: NetADs/time_tv

## Basic Information

- **Project Name**: Time_TV
- **Description**: Android系统TV版的屏幕显示时间和日期的项目
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-09
- **Last Updated**: 2026-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 时钟天气

同时支持 Android 手机和 Android TV 的全屏时钟。

## 界面

- 屏幕中央：等宽粗体 `HH：MM：SS`（启动瞬间为 `--：--：--`）
- 右上角：公历日期、星期、农历（农历来自香港天文台开放数据，免 Key；失败则用本地换算）
- 农历下方：当前天气，例如 `晴 24℃`
- 天气默认按天津取数
- 底部走马灯：上行滚动资讯标题，开市时下行滚动自选股行情。相邻两条内容之间留出一屏空白；刷新资讯或行情时保留当前滚动位置，不会跳变

手机点左上角齿轮打开设置。电视按确认 / 菜单。遥控器和鼠标都能操作。
手机连续两次返回退出。按 Home 或切到后台时退出进程并清理缓存。

设置项：天气城市、开机自启动、界面主题、网络自动校时、日期自动校准、手动调时/调日、底部走马灯、关于。主题可在默认（黑底青字）与墨水屏（高对比黑白）间循环切换。调时关校时，调日关校日。两者默认都开。部分电视还要在系统里允许自启动。

底部走马灯可开关资讯、选择资讯板块、设置开市是否显示行情、维护自选股（最多 8 只）。

启动后会静默检查更新。发现新版本时底部弹出提示，可立即更新或稍后。关于页也可手动检查。更新来源是上游仓库 `https://gitee.com/NetADs/time_tv` 的最新发行版 APK。

## 开发环境

一键安装 JDK 17、Android SDK（compileSdk 34 + Android 5.1.1/API 22）、platform-tools、build-tools 34.0.0，并写入 `local.properties`、`get_android` 与 Gradle wrapper 缓存：

```bash
bash tools/install-android-dev.sh
```

默认路径：`ANDROID_HOME=/opt/android-sdk`，`JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64`（另有 `temurin-17-jdk-amd64` 兼容链接）。`minSdk 21` 覆盖 Android 5.1.1 电视、手机、PAD；资源限定符 `values-television`、`values-sw600dp`。

新终端先执行 `get_android`。国内网络可加 `--china`。卸载：`bash tools/install-android-dev.sh --uninstall --yes`。

## 编译

```bash
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export ANDROID_HOME=/opt/android-sdk
export GRADLE_USER_HOME=/w/.gradle-home
./gradlew :app:assembleDebug
```

产物：`app/build/outputs/apk/debug/app-debug.apk`

版本写在 `app/version.properties`。执行 `assemble` 时自动加一：`versionCode` +1，`versionName` 补丁号 +1。`clean`、查任务不会加。验证环境请用 `:app:compileDebugJavaWithJavac`，该任务不改版本号。