# app-apk

**Repository Path**: jre/app-apk

## Basic Information

- **Project Name**: app-apk
- **Description**: No description available
- **Primary Language**: Android
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Elderly Guardian - 独居人士安保APP

## 项目简介
Elderly Guardian是一款面向空巢老人和单独租住等独居人士的安保APP，提供全面的监控和预警功能。

## 主要功能

### 1. 用户状态检测
- **位置轨迹监测**：使用GPS和网络定位，检测用户是否在正常活动范围内
- **传感器数据采集**：使用加速度传感器、陀螺仪等检测用户活动
- **网络流量活动监测**：检测网络连接状态

### 2. 意外情况检测
- **跌落检测**：通过加速度传感器数据识别可能的跌落情况
- **长时间无活动检测**：监测用户是否长时间没有活动
- **睡眠状态监测**：检测睡眠中的翻身等活动
- **位置异常检测**：检测用户是否离开正常活动范围

### 3. 预警提醒机制
- **本地通知**：发送紧急情况通知
- **紧急联系人**：向预设的亲友、社区、110等发送预警信息
- **短信和电话**：支持向紧急联系人发送短信和拨打电话

### 4. 后台运行功能
- **前台服务**：确保APP在后台持续运行
- **开机自启**：设备重启后自动启动监控服务

### 5. 用户自定义设置
- **紧急联系人管理**：添加、删除紧急联系人
- **通知方式设置**：选择是否发送短信或拨打电话

### 6. 数据存储
- **本地存储**：使用SharedPreferences和JSON格式存储数据
- **数据备份**：支持云服务扩展

## 技术架构

### 项目结构
```
ElderlyGuardian/
├── app/
│   ├── src/
│   │   └── main/
│   │       ├── java/com/elderlyguardian/
│   │       │   ├── MainActivity.java          # 主界面
│   │       │   ├── SettingsActivity.java      # 设置界面
│   │       │   ├── services/
│   │       │   │   └── MonitoringService.java # 监控服务
│   │       │   ├── receivers/
│   │       │   │   └── BootReceiver.java     # 开机自启接收器
│   │       │   └── utils/
│   │       │       ├── SensorManager.java     # 传感器管理
│   │       │       ├── LocationManager.java   # 位置管理
│   │       │       ├── EmergencyDetector.java # 意外检测
│   │       │       ├── NotificationManager.java # 通知管理
│   │       │       ├── ContactManager.java   # 联系人管理
│   │       │       └── FirebaseManager.java  # 数据存储
│   │       ├── res/
│   │       │   ├── layout/               # 布局文件
│   │       │   ├── values/               # 资源值
│   │       │   ├── mipmap-*/             # 图标资源
│   │       │   └── xml/                  # 配置文件
│   │       └── AndroidManifest.xml       # 应用清单
│   ├── build.gradle                     # 模块级构建配置
│   └── google-services.json            # Firebase配置（可选）
├── build.gradle                         # 项目级构建配置
├── settings.gradle                       # Gradle设置
└── gradlew.bat                         # Gradle包装器脚本
```

### 技术栈
- **开发语言**：Java
- **最低SDK版本**：21 (Android 5.0)
- **目标SDK版本**：34 (Android 14)
- **构建工具**：Gradle 8.0
- **主要依赖**：
  - AndroidX AppCompat
  - Material Components
  - Google Play Services Location
  - WorkManager

## 如何运行

### 前置要求
1. 安装Android Studio (推荐最新版本)
2. 安装JDK 8或更高版本
3. Android设备或模拟器（Android 5.0+）

### 构建步骤

#### 方法1：使用Android Studio（推荐）
1. 打开Android Studio
2. 选择"Open an Existing Project"
3. 导航到 `D:\Android\app-apk\ElderlyGuardian` 文件夹
4. 点击"OK"
5. 等待Gradle同步完成
6. 连接Android设备或启动模拟器
7. 点击工具栏的绿色运行按钮（▶）

#### 方法2：使用命令行
```bash
# 进入项目目录
cd D:\Android\app-apk\ElderlyGuardian

# 构建Debug版本
gradlew assembleDebug

# 构建Release版本
gradlew assembleRelease

# 安装到连接的设备
gradlew installDebug
```

## 使用说明

### 首次使用
1. 打开APP，点击"启动监控"按钮开始监测
2. 点击"设置"按钮进入设置页面
3. 添加紧急联系人信息
4. 设置通知方式（短信/电话）
5. 返回主界面，监控已自动开始

### 日常使用
- **启动监控**：点击主界面的"启动监控"按钮
- **停止监控**：点击主界面的"停止监控"按钮
- **紧急求助**：点击"紧急求助"按钮（功能开发中）
- **修改设置**：点击"设置"按钮修改紧急联系人和监测参数

### 权限说明
APP需要以下权限：
- **位置权限**：用于位置轨迹监测
- **短信权限**：用于发送紧急短信
- **电话权限**：用于拨打紧急电话
- **录音权限**：用于声音检测（可选）
- **开机启动权限**：用于开机自启

## 性能优化

### 电池优化
- 传感器采样率设置为正常模式
- 位置更新频率：30秒/次
- 最小移动距离：50米
- 后台服务使用前台服务模式

### 内存优化
- 使用轻量级数据结构
- 及时释放资源
- 使用弱引用避免内存泄漏

## 扩展功能

### 可选功能
1. **语音识别**：支持语音紧急求助
2. **社区服务整合**：与社区服务中心对接
3. **健康数据监测**：集成健康传感器数据
4. **云服务集成**：使用Firebase或其他云服务
5. **多语言支持**：支持多种语言界面
6. **数据分析**：提供用户活动数据分析报告

## 注意事项

1. **隐私保护**：所有数据仅存储在本地设备，不上传到云端
2. **误报处理**：用户可以手动取消误报
3. **网络依赖**：部分功能需要网络连接
4. **电池消耗**：持续监控会消耗一定电量，建议充电时使用

## 技术支持

如有问题，请检查：
1. Android Studio版本是否为最新
2. JDK版本是否正确
3. 设备是否支持所需传感器
4. 权限是否已正确授予

## 许可证

本项目仅用于学习和研究目的。

## 版本信息

- **版本号**：1.0
- **构建日期**：2026-03-12
- **开发者**：综合设计大实验项目