# androidRadio

**Repository Path**: bgProducts/android-radio

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-02-18
- **Last Updated**: 2026-02-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Android Radio 项目运行指南

## 项目简介
这是一个 Android 音频录制和播放应用项目。

## 在 Android Studio 中运行项目

### 前置要求
1. **Android Studio** (建议使用最新版本，至少需要 Android Studio Hedgehog 或更高版本)
2. **JDK 17** 或更高版本（Android Studio 通常自带）
3. **Android SDK** (API 34，项目配置中已指定)

### 运行步骤

#### 1. 打开项目
- 打开 Android Studio
- 选择 `File` -> `Open`
- 选择项目根目录：`androidRadio/androidRadio`（注意：需要打开内层的 androidRadio 文件夹）

#### 2. 同步 Gradle
- 打开项目后，Android Studio 会自动提示同步 Gradle
- 如果没有自动提示，点击 `File` -> `Sync Project with Gradle Files`
- 等待同步完成（首次同步可能需要下载依赖，需要一些时间）

#### 3. 配置运行设备
- **使用模拟器**：
  - 点击工具栏中的设备选择下拉菜单
  - 选择 `Device Manager` 或 `AVD Manager`
  - 创建一个新的虚拟设备（建议使用 API 34 的模拟器）
  - 启动模拟器

- **使用真机**：
  - 在手机上启用开发者选项和 USB 调试
  - 通过 USB 连接手机到电脑
  - 在 Android Studio 的设备选择中应该能看到你的设备

#### 4. 运行应用
- 确保设备选择下拉菜单中已选择设备（模拟器或真机）
- 点击工具栏中的绿色运行按钮（▶️）或按 `Shift + F10`
- 如果运行按钮是灰色的，请检查：
  - 是否已选择设备
  - Gradle 同步是否完成
  - 是否有编译错误

### 常见问题解决

#### 问题 1: 运行按钮是灰色的
**可能原因和解决方案：**
1. **没有选择设备**
   - 在设备选择下拉菜单中选择一个设备（模拟器或真机）

2. **Gradle 同步未完成**
   - 等待 Gradle 同步完成
   - 查看底部状态栏的同步进度
   - 如果有错误，查看 `Build` 窗口的错误信息

3. **缺少 Gradle Wrapper**
   - 项目已包含 Gradle Wrapper 文件
   - 如果仍有问题，可以在终端运行：`gradlew wrapper`

4. **项目结构问题**
   - 确保打开的是 `androidRadio/androidRadio` 目录（内层目录）
   - 不是外层的 `androidRadio` 目录

#### 问题 2: Gradle 同步失败
**解决方案：**
1. 检查网络连接（需要下载依赖）
2. 检查 `build.gradle` 文件中的仓库配置是否正确
3. 尝试清理项目：`Build` -> `Clean Project`
4. 重新同步：`File` -> `Sync Project with Gradle Files`

#### 问题 3: 找不到 MainActivity
- 检查 `app/src/main/java/com/yantu/radio/MainActivity.kt` 文件是否存在
- 检查 `AndroidManifest.xml` 中的 Activity 配置是否正确

#### 问题 4: 编译错误
- 查看 `Build` 窗口的错误信息
- 确保所有依赖都已正确下载
- 检查 Kotlin 版本是否兼容

### 项目配置信息
- **最低 SDK 版本**: 24 (Android 7.0)
- **目标 SDK 版本**: 34 (Android 14)
- **编译 SDK 版本**: 34
- **Kotlin 版本**: 1.9.0
- **Gradle 版本**: 8.0

### 项目结构
```
androidRadio/
├── app/
│   ├── build.gradle
│   └── src/
│       └── main/
│           ├── AndroidManifest.xml
│           └── java/com/yantu/radio/
│               ├── MainActivity.kt
│               ├── AudioRecordTestActivity.kt
│               ├── AudioFileListActivity.kt
│               └── util/
│                   ├── MediaRecorderTool.kt
│                   └── AudioFileManager.kt
├── build.gradle
├── settings.gradle
├── gradle.properties
└── gradlew (Gradle Wrapper)
```

### 注意事项
1. 首次运行需要下载依赖，请确保网络连接正常
2. 如果使用真机调试，需要在手机上允许 USB 调试
3. 应用需要录音权限，首次运行时需要在手机上授予权限