# FlashAlarm

**Repository Path**: itcode-itcode/FlashAlarm

## Basic Information

- **Project Name**: FlashAlarm
- **Description**: 一个开源的带有闪光灯，可自定义文本图片,可数学解锁的Android闹钟软件
- **Primary Language**: Android
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 28
- **Created**: 2019-12-12
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#Android Flash Alarm Project

##项目简介

###一个亮瞎你狗眼绝对能起床的简易闹钟
###灵感源于我早上起不了床,但是可以被光照照醒的特性

###功能:闪光灯闪瞎狗眼定起床,数学题目让你大脑迅速清醒,自定义闹钟界面让你喜欢上闹钟

> 欢迎大家参考学习,也望大家能够对本软件中的不足或错误进行指正批评.

开发者: **刘越(HangxingLiu)**

![我的微博:](http://www.sinaimg.cn/blog/developer/wiki/LOGO_16x16.png)[@航行刘](http://weibo.com/chinavl)

当前版本:`1.3`
[最新版本APK安装文件](http://git.oschina.net/voyageliu/FlashAlarm/raw/master/update/FlashAlarm_1_3_0330.apk)

[历史版本信息](http://git.oschina.net/voyageliu/FlashAlarm/blob/master/update/version.md)

首发时间:2015-03-22

开源许可证: [MIT License](http://git.oschina.net/voyageliu/FlashAlarm/raw/master/LICENSE)

##特别鸣谢
软件图标来源:[EasyIcon-draseart](http://www.easyicon.net/1145412-torch_icon.html)

[TOC]

##软件截图
闹钟设置界面

![闹钟设置界面](http://git.oschina.net/voyageliu/FlashAlarm/raw/master/screenshot/screenshot1.png)

闹钟运行界面

![闹钟运行界面](http://git.oschina.net/voyageliu/FlashAlarm/raw/master/screenshot/screenshot2.png)

解数学题界面

![闹钟运行界面](http://git.oschina.net/voyageliu/FlashAlarm/raw/master/screenshot/screenshot3.png)
##项目目录结构

- `.settings` 项目配置目录
- `bin` 项目编译生成的文件(包含未签名的APK文件)
- `gen` 项目的Gen文件夹
- `res` **项目的资源文件夹**
- `src` **项目的Java源代码**

- `screenshot` 软件的相关截图
- `update` 软件的更新信息以及已签名的APK文件



##项目源码说明

###Java主要源码:

>所在包: **com.hangxingliu.flashalarm**

- `AlarmAct` 闹钟界面
- `CheckUpdateAct` 检查更新界面
- `FlashCtrl` **闪光灯控制类**
- `MainAct` 闹钟设置界面
- `MainRec` 接收系统闹钟发送的广播
- `MediaTools` 媒体工具类(响音乐用的)
- `NowTimeView` 显示现在时间并自动刷新时间的控件
- `VLog` 我的SDCard日志输出类
- `MathGen` 数学计算题生成类
- `MathUnlock` 数学解锁界面类
- `ViewCreator` 控件生成类
- `SimpleAdapter` Android列表类控件的简单适配器

###主要资源

> 图片 **res/drawable**

- `bg_pic.jpg` 默认闹钟背景图
- `ic_launcher.png` 软件图标

>自述文件 **res/raw**

- `readme.txt` 自述文件

`%VERSION_NAME%`:当前版本名称

>字符串 **res/values**

- `strings.xml` 字符串文件

##更新文件说明

> 更新文件 **/update/update.txt**

格式:(一共四行)


1. 最新的版本号(int)
2. 最新的版本名称(String)
3. 最新版本的介绍(String)
4. 最新版本的APK文件下载地址(String)


##数据存储说明

本闹钟的相关配置均使用Android内置的**`SharedPreferences`**进行读写

> SharedPreferences读写文件 `settings.xml`

Key:Value

- `h`:闹钟响时的小时
- `m`:闹钟响时的分钟
- `useVibrate` 是否使用震动
- `useMusic`:是否使用铃音
- `music`:铃音文件的路径
- `text`:显示在闹钟上的话
- `useMath`:使用算术解锁
- `mathHard`:算数题的难度
- `mathCount`:算术题的道数 **存储的值是实际道数-1,没有数学题即为-1**

##日志输出

> 软件日志输出位置:
> 
>`ExternalStorageDirectory`/FlashAlarm/log

##彩蛋

1. 在SDCard的根目录下新建(找到)`FlashAlarm`的目录,在里面放一张图片,并改名为`bg.jpg`或`bg.png`等以`bg`开头的图像文件.当闹钟响起的时候,闹钟的背景图就是你的那张图片了.

2. 长按闹钟设置页面的`铃音名显示文本`,会弹出这个`铃音文件的完整路径`哦