# 安卓

**Repository Path**: chenbool/android

## Basic Information

- **Project Name**: 安卓
- **Description**: 安卓
- **Primary Language**: Android
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-08-25
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tour 安卓旅游应用

## 📱 项目简介

| 项目 | 说明 |
|------|------|
| 项目名称 | tour |
| 项目类型 | Android 原生应用 |
| 开发语言 | Java |
| 应用包名 | com.bool.tour |
| 应用版本 | 1.0 |

## 🏗 软件架构

| 配置项 | 说明 |
|--------|------|
| 最低 SDK | Android 5.0 (API 21) |
| 目标 SDK | Android 10 (API 29) |
| 编译 SDK | Android 10 (API 29) |
| 构建工具 | Gradle 3.5.0 / Android Gradle Plugin 3.5.0 |
| 构建工具版本 | 29.0.2 |
| 架构模式 | Fragment + Activity |
| 项目编码 | UTF-8 |

## 📦 依赖库

| 库名称 | 版本 | 说明 |
|--------|------|------|
| androidx.appcompat | 1.0.2 | AndroidX 兼容库 |
| androidx.constraintlayout | 1.1.3 | 约束布局 |
| WaitingDots | 0.4.0 | 加载等待动画 |
| junit | 4.12 | 单元测试 |
| androidx.test.runner | 1.2.0 | Android 测试运行器 |
| espresso-core | 3.2.0 | UI 测试框架 |

## 📂 项目结构

```
android/
├── app/                          # 应用模块
│   ├── src/main/
│   │   ├── java/com/bool/tour/  # Java 源码
│   │   └── res/                 # 资源文件
│   ├── build.gradle              # 模块构建配置
│   └── proguard-rules.pro        # 混淆规则
├── build.gradle                  # 根项目构建配置
├── settings.gradle               # 项目设置
├── gradle.properties             # Gradle 属性
└── gradle/wrapper/               # Gradle 包装器
```

## 🧩 核心组件

### Activity 组件

| 类名 | 文件路径 | 功能说明 |
|------|----------|----------|
| SplashActivity | app/src/main/java/com/bool/tour/SplashActivity.java | 启动页，3秒延迟后跳转 |
| GuideActivity | app/src/main/java/com/bool/tour/GuideActivity.java | 引导页，展示新功能 |
| MainActivity | app/src/main/java/com/bool/tour/MainActivity.java | 主界面，包含底部导航 |

### Fragment 组件

| 类名 | 文件路径 | 功能说明 |
|------|----------|----------|
| MainFragment | app/src/main/java/com/bool/tour/fragment/MainFragment.java | 首页，展示旅游内容 |
| FindFragment | app/src/main/java/com/bool/tour/fragment/FindFragment.java | 发现，目的地推荐 |
| MeFragment | app/src/main/java/com/bool/tour/fragment/MeFragment.java | 我的，用户中心 |

### 布局文件

| 文件名 | 路径 | 对应组件 |
|--------|------|----------|
| activity_splash.xml | app/src/main/res/layout/ | SplashActivity 启动页布局 |
| activity_guide.xml | app/src/main/res/layout/ | GuideActivity 引导页布局 |
| activity_main.xml | app/src/main/res/layout/ | MainActivity 主界面布局 |
| fragment_main.xml | app/src/main/res/layout/ | MainFragment 首页布局 |
| fragment_find.xml | app/src/main/res/layout/ | FindFragment 发现页布局 |
| fragment_me.xml | app/src/main/res/layout/ | MeFragment 我的页布局 |

## 🖼 资源文件

### 图片资源 (drawable)

| 文件名 | 说明 |
|--------|------|
| ic_launcher_background.xml | 启动器背景 |
| ic_launcher_foreground.xml | 启动器前景 |
| menu_home_icon_selector.xml | 首页图标选择器 |
| menu_discover_icon_selector.xml | 发现图标选择器 |
| menu_wode_icon_selector.xml | 我的图标选择器 |

### 图标资源 (mipmap)

| 目录 | 用途 |
|------|------|
| mipmap-mdpi/ | 中等密度图标 (48x48) |
| mipmap-hdpi/ | 高密度图标 (72x72) |
| mipmap-xhdpi/ | 超高密度图标 (96x96) |
| mipmap-xxhdpi/ | 超超高密度图标 (144x144) |
| mipmap-xxxhdpi/ | 超超超高密度图标 (192x192) |
| mipmap-anydpi-v26/ | 自适应图标 (API 26+) |

### 配置资源 (values)

| 文件名 | 说明 |
|--------|------|
| colors.xml | 颜色定义 |
| strings.xml | 字符串资源 |
| styles.xml | 样式主题 |

## 🚀 应用流程

```
┌─────────────────┐
│   SplashActivity │ ← 启动页 (3秒延时)
│   (启动页)        │
└────────┬────────┘
         │
    ┌────┴────┐
    │ 判断首次 │
    └────┬────┘
         │
    ┌────┴────┐
    ▼         ▼
┌───────┐ ┌──────────┐
│首次进入│ │非首次进入│
└───┬───┘ └────┬─────┘
    │          │
    ▼          ▼
┌────────┐  ┌──────────┐
│ Guide  │  │ MainActivity │
│Activity│  │ (主界面)   │
└────────┘  └─────┬─────┘
                 │
         ┌───────┼───────┐
         │       │       │
         ▼       ▼       ▼
    ┌────────┐ ┌─────┐ ┌─────┐
    │  首页   │ │发现 │ │ 我的 │
    └────────┘ └─────┘ └─────┘
```

## 📋 安装教程

1. **环境要求**
   - Android Studio 3.0+
   - JDK 1.8+
   - Android SDK

2. **运行步骤**
   | 步骤 | 操作 |
   |------|------|
   | 1 | 使用 Android Studio 打开项目根目录 |
   | 2 | 等待 Gradle 同步完成（首次约5-10分钟） |
   | 3 | 连接真机或启动模拟器 |
   | 4 | 点击 Run 'app' 运行项目 |

## 📖 使用说明

| 页面 | 说明 |
|------|------|
| 启动页 | 显示应用 Logo，3秒后自动跳转 |
| 引导页 | 首次进入展示新功能介绍 |
| 首页 | 底部导航第一个 tab，展示旅游相关内容 |
| 发现 | 底部导航第二个 tab，发现旅游目的地 |
| 我的 | 底部导航第三个 tab，用户个人中心 |

## 📝 配置文件说明

### AndroidManifest.xml 配置

| 配置项 | 值 |
|--------|-----|
| 包名 | com.bool.tour |
| 应用图标 | @mipmap/ic_launcher |
| 应用名称 | @string/app_name |
| 主题 | @style/AppTheme |
| LAUNCHER Activity | SplashActivity |

### build.gradle (app)

| 配置项 | 值 |
|--------|-----|
| applicationId | com.bool.tour |
| minSdkVersion | 21 |
| targetSdkVersion | 29 |
| versionCode | 1 |
| versionName | 1.0 |