# lockscreen
**Repository Path**: opensourcemarket/lockscreen
## Basic Information
- **Project Name**: lockscreen
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-04
- **Last Updated**: 2025-09-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 椰子锁屏（LockScreen）
椰子锁屏是一款安卓端的一键锁屏小工具，提供两种锁屏方式：
- “锁屏”按钮：基于设备管理员（Device Admin）权限进行锁屏。
- “使用无障碍锁屏（指纹可解锁）”按钮：基于无障碍服务（AccessibilityService）调用系统全局锁屏动作，解锁可直接使用指纹/面容等生物特征。
## 解决的痛点
- **快速锁屏不便**：部分机型物理按键不便或易损，希望通过桌面或应用“一键锁屏”。
- **管理员锁屏不便于生物解锁**：传统“设备管理员”方式锁屏后，多数机型解锁默认先走手势/密码输入，影响效率。
- **更贴近原生体验**：无障碍全局锁屏动作更贴近系统自身熄屏效果，唤醒后可直接使用生物特征（指纹/面容）解锁（具体表现依厂商实现而异）。
## 功能概览
- 主界面显示权限状态与两个锁屏按钮。
- 支持设备管理员授权的锁屏（按钮“锁屏”）。
- 支持无障碍服务授权的锁屏（按钮“使用无障碍锁屏（指纹可解锁）”）。
- 提供桌面小组件便捷锁屏。
- 界面底部提供实时调试日志区域，便于观察点击与授权流程。
## 两种锁屏方式说明
- **“锁屏”（设备管理员）**
- 首次使用需要授予“设备管理员”权限。
- 优点：可靠、对系统版本适配稳定。
- 可能的体验：部分机型解锁时优先展示图案/密码输入页，指纹/面容需要额外唤起或步骤。
- **“使用无障碍锁屏（指纹可解锁）”（无障碍服务）**
- 首次使用需要在“设置 → 无障碍”启用本应用的无障碍服务。
- 优点：更接近系统熄屏效果，唤醒后通常可直接使用生物特征解锁。
- 说明：不同厂商/系统版本的行为存在差异，少数环境可能与描述不完全一致。
## 隐私与安全
- 应用仅用于实现“锁屏”本地动作，不采集、不上传任何个人数据。
- 设备管理员权限仅用于调用 `lockNow()` 等相关能力；无障碍服务仅用于调用“全局锁屏”动作。
## 构建与安装（JDK17）
1. 安装 Android SDK（确保 `sdk.dir` 已在 `local.properties` 配置）。
2. 使用 JDK 17。
3. 命令行构建：
- Debug：`./gradlew assembleDebug`
- Release：`./gradlew assembleRelease`
4. 安装到设备：
- `adb install -r -t app/build/outputs/apk/debug/app-debug.apk`
## 使用指南
1. 打开应用后查看顶部权限状态：
- 若要使用“锁屏”按钮，请点击“授予权限”进入设备管理员授权；
- 若要使用“使用无障碍锁屏（指纹可解锁）”，请在系统“设置 → 无障碍”中启用“锁屏无障碍服务”。
2. 授权完成后，点击相应按钮即可一键锁屏：
- 管理员锁屏：更强的系统级控制；
- 无障碍锁屏：更便捷的生物特征解锁体验。
3. 可将桌面小组件添加到主屏幕，快速锁屏。
## 注意事项
- 无障碍锁屏的生物特征解锁体验依赖厂商系统实现，不同机型可能略有差异。
- 若使用管理员锁屏，希望更流畅的指纹解锁，可尝试切换为无障碍锁屏方式。
- 如遇授权页未弹出或闪退，请在设置中手动前往对应页面完成授权。
## 免责声明
- 本软件完全由 AI 生成，包括需求分析和方案设计、整个代码、构建脚本、说明等。
- 本软件完全由 AI 生成，仅供学习与技术交流使用，不对任何商业或生产环境场景负责。
- 使用本软件即表示您已理解并同意自行承担相关风险。
---
如需参与开发或二次定制，欢迎提交 Issue 或 PR（请勿提交包含密钥或本地配置的文件，如 `local.properties`、证书等）。