Skip to content

JasonXie-Code/Lux

BranchesTags

Repository files navigation

Lux 照度计 · Lux Light Meter

目录 · Quick navigation

中文： 简介 · 下载 APK · 实机截图 · 功能说明 · 适用场景 · 从 Git 克隆后 · 环境要求 · 构建与运行 · 命令行构建 · 说明 · English ↓

English: Introduction · Download APK · Screenshots · Features · Use cases · Clone & setup · Requirements · Build & run · CLI · Notes · 中文 ↑

中文

简介

通过手机光线传感器读取环境照度（lux），在屏幕中央大字显示当前数值，保留两位小数；显示刷新间隔可在 200ms、500ms、1s、2s 四档中切换（对应约 5Hz / 2Hz / 1Hz / 0.5Hz，默认 500ms），选择会持久保存。

下载 APK

项目 说明
构建 Debug（assembleDebug），versionName 1.0 / versionCode 1
仓库内文件 releases/Lux-v1.0-debug.apk
直链（main 分支） https://github.com/JasonXie-Code/Lux/raw/main/releases/Lux-v1.0-debug.apk
GitHub Releases https://github.com/JasonXie-Code/Lux/releases（若已创建 Release，可优先从页面下载附件）
  • 使用 Android debug 签名，适合体验与自用；侧载安装时若系统提示「未知来源」或「不安全」，请在系统设置中按需允许本次来源。
  • 若需上架应用商店或对外正式分发，请使用 release 构建并配置您自己的 发布签名。

实机截图

照度计（实时测量） 场景检查（推荐范围对比）
照度计主界面：实时照度、亮度指示器与刷新频率 场景检查：选择居家/功能等场景后与推荐照度对比

功能说明

照度计

  • 实时照度：大字显示当前 lux，便于站立或手持时一眼读数。
  • 刷新频率：点按可在四档间隔间循环切换，界面显示等效 Hz（例如 200ms 对应约 5Hz），满足「想更跟手」与「想更省电、少跳动」两种需求。
  • 数据保持：开启后冻结当前用于显示的数值，便于对照纸上标准或向他人展示某一时刻的读数。
  • 亮度指示器：对数刻度的进度条，概括当前光强在常见室内～户外范围内的相对位置。
  • 亮度等级文案：将当前照度归类为「夜晚微光」「居家日常」「办公级亮度」等可读描述。
  • 等效场景提示：根据照度猜测与何种典型场景（如餐桌、办公）接近，辅助理解数值含义。
  • 明暗主题：支持浅色 / 深色界面，与系统或应用内切换习惯一致。

场景检查

  • 场景与分区：按「居家空间、功能区域、学习办公、收纳与设备」等大类，再选具体分区（如卧室、厨房、书房阅读）。
  • 推荐照度区间：每个场景带有 min–max lux 参考范围（内置为常见室内用途的经验区间，非强制标准）。
  • 即时判定：将当前实测照度与所选场景对比，提示 偏暗 / 合适 / 偏亮，并给出「建议提高亮度」或「建议降低亮度」等文字说明。
  • 滚轮选择：大类与分区双滚轮，滚动时有轻微触感反馈，选中项高亮。

通用

  • 使用 Sensor.TYPE_LIGHT，无需额外权限即可在常见机型上读取光线传感器（需 真机；模拟器通常无光线传感器）。
  • 底部导航在「照度计」与「场景检查」之间切换；上次停留的 Tab 等偏好会记忆。

适用场景

  • 家庭与租房：检查客厅、卧室、书桌、餐桌附近照度是否过暗（易疲劳）或过亮（眩光），调整灯具位置与亮度。
  • 阅读与儿童学习：大致对照「书房 / 儿童学习」等场景，判断是否需要台灯补光。
  • 老人起居：在走廊、床头、卫生间门口等位置快速看数值，辅助改善夜间照明安全。
  • 摄影 / 摄像入门：作为手机端简易照度参考（非专业测光表，但便于布光前后对比）。
  • 装修与买灯：换灯前后在同一位置测 lux，用数据对比「有没有变亮」。
  • 传感器与设备体验：开发或爱好者可用可调刷新率观察读数稳定性。

从 Git 克隆后

  1. 用 Android Studio 打开本仓库根目录（与 settings.gradle.kts 同级）。
  2. 若根目录没有 local.properties：复制 local.properties.example 为 local.properties，将 sdk.dir 设为本机 Android SDK 路径；或在 Android Studio 中同步工程，IDE 常会代为创建。
  3. 不要将含本机路径的 local.properties 提交到远程仓库（已在 .gitignore 中忽略）。
  4. 若 Gradle 报 JDK 问题，请在 File → Settings → Build, Execution, Deployment → Build Tools → Gradle 中指定 JDK 17，或在 gradle.properties 中按需设置 org.gradle.java.home（勿提交含隐私路径的注释块）。

环境要求

  • Android Studio Ladybug (2024.2.1) 或更高版本（或兼容的 AGP 8.x）
  • JDK 17
  • Android SDK 34，minSdk 24

构建与运行

  1. 用 Android Studio 打开项目目录 LuxApp。
  2. 若提示缺少 Gradle Wrapper 或 gradle-wrapper.jar，使用菜单 File → Sync Project with Gradle Files；或在本机已安装 Gradle 时在项目根目录执行 gradle wrapper 生成。
  3. 连接真机（光线传感器需真机）或选择模拟器，点击 Run 运行。

命令行构建

在项目根目录 LuxApp 下（需先有 gradle-wrapper.jar，用 Android Studio 同步或执行 gradle wrapper 生成）：

# 调试版 APK
./gradlew assembleDebug

# 输出：app/build/outputs/apk/debug/app-debug.apk

说明

  • 使用 Sensor.TYPE_LIGHT 获取照度，单位 lux。
  • 场景推荐区间为应用内预设，仅供参考；专业验收请以相关国家标准或仪器检定为准。

↑ 回到目录 · English →

English

Introduction

Lux Light Meter reads ambient illuminance (lux) from the phone’s ambient light sensor, shows the value large in the center with two decimal places, and lets you choose a UI refresh interval of 200ms, 500ms, 1s, or 2s (roughly 5 / 2 / 1 / 0.5 Hz; default 500ms). The choice is persisted.

Download APK

Item Details
Build Debug (assembleDebug), versionName 1.0 / versionCode 1
File in repo releases/Lux-v1.0-debug.apk
Direct link (main) https://github.com/JasonXie-Code/Lux/raw/main/releases/Lux-v1.0-debug.apk
GitHub Releases https://github.com/JasonXie-Code/Lux/releases (prefer the release asset when available)
  • Signed with the Android debug keystore (fine for personal testing). Allow Install unknown apps / sideloading if the system prompts you.
  • For Play Store or formal distribution, ship a release build with your own signing key.

Screenshots

Lux meter (live) Scene check (vs. recommended range)
Main screen: live lux, brightness bar, refresh rate Scene check: pick home/functional scenes and compare to suggested lux

Features

Lux meter

  • Live lux: Large numeric readout for at-a-glance use while standing or holding the phone.
  • Refresh rate: Cycles through four intervals; the UI shows an equivalent Hz (e.g. ~5 Hz at 200ms) for quick vs. calm updates.
  • Hold: Freezes the displayed value to compare with a written guideline or show a snapshot to someone else.
  • Brightness indicator: Log-style progress bar for rough position from typical indoor to outdoor levels.
  • Level labels: Human-readable bands such as “dim home” or “office-like” brightness.
  • Equivalent scene hint: Suggests which typical scene (e.g. dining, desk) the current lux is closest to.
  • Theme: Light / dark UI.

Scene check

  • Categories & zones: Pick a category (home, functional areas, study/office, storage, etc.) and a specific zone (bedroom, kitchen, study reading, …).
  • Suggested lux range: Each scene has a min–max lux band (heuristic indoor guidance, not a binding standard).
  • Verdict: Compares live lux to the selected scene—too dark / OK / too bright—with short advice (e.g. increase or decrease brightness).
  • Wheel pickers: Two wheels with light haptic feedback and highlighted selection.

General

  • Uses Sensor.TYPE_LIGHT; no extra permission on typical devices (physical device required; emulators usually lack a light sensor).
  • Bottom navigation switches between Lux meter and Scene check; last tab and other prefs are remembered.

Use cases

  • Home & rental: Check living room, bedroom, desk, or dining areas for fatigue-level dimness or glare; adjust lamps and brightness.
  • Reading & study: Use study/children’s-study presets to see if a desk lamp is needed.
  • Seniors: Quick checks in hallways, bedside, or bathroom entrances to improve night safety.
  • Photo / video hobby: Rough on-phone lux reference (not a pro meter, but good before/after comparisons).
  • Renovation & buying lamps: Measure at the same spot before/after a change to see if it actually got brighter.
  • Sensor tinkering: Use adjustable refresh to observe stability of readings.

After cloning

  1. Open the repository root (next to settings.gradle.kts) in Android Studio.
  2. If local.properties is missing: copy local.properties.example to local.properties and set sdk.dir to your Android SDK path, or let Android Studio create it when syncing.
  3. Do not commit machine-specific local.properties (already in .gitignore).
  4. If Gradle reports a JDK issue: set JDK 17 under File → Settings → Build, Execution, Deployment → Build Tools → Gradle, or set org.gradle.java.home in gradle.properties locally (avoid committing private paths).

Requirements

  • Android Studio Ladybug (2024.2.1) or newer (or compatible AGP 8.x)
  • JDK 17
  • Android SDK 34, minSdk 24

Build & run

  1. Open the LuxApp project in Android Studio.
  2. If Gradle Wrapper or gradle-wrapper.jar is missing, use File → Sync Project with Gradle Files, or run gradle wrapper where Gradle is installed.
  3. Connect a physical device (recommended for the light sensor) or an emulator, then Run.

Command-line build

From the project root (with gradle-wrapper.jar present):

# Debug APK
./gradlew assembleDebug

# Output: app/build/outputs/apk/debug/app-debug.apk

Notes

  • Illuminance comes from Sensor.TYPE_LIGHT, unit lux.
  • Scene ranges are in-app heuristics only; for formal compliance, follow applicable national standards and calibrated instruments.

↑ Back to contents · ← 中文

About

A practical mobile app for measuring environmental brightness

Resources

Readme

License

MIT license
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases 1

Lux v1.0.0（Debug APK） Latest
Mar 27, 2026

Packages

 
 
 

Contributors

Languages