# app-floating-tools

**Repository Path**: limi-open-soft/app-floating-tools

## Basic Information

- **Project Name**: app-floating-tools
- **Description**: 悬浮窗工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-01
- **Last Updated**: 2026-02-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# appFloatingTools 启动指南

## 项目概述

这是一个Android应用项目，包含以下功能：
- 主界面（MainActivity）
- 录音机功能（RecorderActivity）
- AI咨询功能（ScreenshotAIActivity）

## 启动步骤

### 1. 环境准备

确保您的开发环境已正确搭建：

#### 1.1 安装必要软件
- **Android Studio**：最新版本
- **JDK**：推荐JDK 17或更高版本

#### 1.2 配置Android Studio
- 确保已安装最新的Android SDK
- 确保已配置好SDK路径

### 2. 导入项目

1. 打开Android Studio
2. 选择 "Open an existing project"
3. 导航到 `d:\project\android\appFloatingTools` 目录并选择它
4. 等待Android Studio完成项目同步和依赖下载

### 3. 设备准备

#### 3.1 使用物理设备
1. 启用设备的开发者选项
2. 启用USB调试模式
3. 使用USB cable连接设备到电脑
4. 等待设备驱动安装完成

#### 3.2 使用模拟器
1. 在Android Studio中打开AVD Manager（Tools → Device Manager）
2. 创建一个新的虚拟设备或使用现有设备
3. 启动模拟器

### 4. 运行应用

#### 4.1 通过Android Studio运行
1. 在Android Studio中，确保已选择正确的设备（物理设备或模拟器）
2. 点击顶部工具栏中的 "Run" 按钮（绿色三角形）
3. 或使用快捷键 `Shift + F10`
4. 等待应用构建并安装到设备上

#### 4.2 构建APK并手动安装
1. 在Android Studio中，选择 "Build → Build Bundle(s) / APK(s) → Build APK(s)"
2. 构建完成后，在 `app\build\outputs\apk\debug\` 目录找到 `app-debug.apk`
3. 将APK文件复制到设备上并安装

### 5. 首次启动注意事项

应用首次启动时，会请求以下权限：
- 录音权限（RECORD_AUDIO）
- 存储权限（READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE）
- 前台服务权限（FOREGROUND_SERVICE）
- 系统弹窗权限（SYSTEM_ALERT_WINDOW）
- 通知权限（POST_NOTIFICATIONS）

请确保授予所有必要权限以保证应用正常运行。

## 功能说明

### 主界面
- 应用的入口点，包含主要功能的导航

### 录音机功能
- 提供录音功能
- 包含浮动服务，可在后台运行

### AI咨询功能
- 提供截屏和AI咨询功能
- 使用媒体投影服务进行截屏

## 技术栈

- **开发语言**：Kotlin
- **构建工具**：Gradle
- **UI框架**：Android原生UI

## 常见问题排查

### 1. 构建失败
- 检查Gradle依赖是否正确
- 确保网络连接正常，可下载依赖
- 清理项目：`Build → Clean Project`

### 2. 运行时崩溃
- 检查是否已授予所有必要权限
- 查看Logcat中的错误信息
- 确保设备Android版本与应用兼容

### 3. 功能不可用
- 录音机：确保已授予录音权限
- 截屏AI：确保已授予存储和前台服务权限

## 联系方式

如有任何问题，请联系开发团队。