gitProject/src

Android 大学助手 应用

项目简介

本项目是一个基于 Android 的示例应用，包名为 com.example.myapplication，采用 Java 编写，使用 Gradle 进行构建。

项目中集成了以下常用功能依赖：

• AndroidX 基础组件：appcompat、material、coordinatorlayout、recyclerview 等
• Gson：用于 JSON 数据解析
• OkHttp / Retrofit + Gson Converter：用于网络请求与接口数据封装
• Jsoup：用于 HTML 解析（例如成绩数据解析等场景）
• 高德地图 SDK（本地 JAR）：用于地图展示、位置相关功能

说明：具体业务逻辑和界面功能请参考 app/src/main/java/com/example/myapplication/ 下的源码。

---

技术栈 & 环境要求

• 语言：Java
• 构建工具：Gradle / Android Gradle Plugin 7.4.2
• 最低支持系统版本：minSdk = 24
• 目标 / 编译版本：targetSdk = 33，compileSdk = 33
• 开发工具：Android Studio（推荐使用与 Gradle 插件版本兼容的版本）
• JDK 版本：Java 8（sourceCompatibility / targetCompatibility 为 1.8）

---

快速开始

1. 克隆项目（若在 Git 仓库中）：

   git clone <your-repo-url>
   cd demo
   

2. 使用 Android Studio 打开：

   • 打开 Android Studio
   • 选择 Open an Existing Project
   • 选择本项目根目录（包含 build.gradle、settings.gradle 的目录）

3. 配置 Android SDK 路径：

   • 首次打开时，如果 local.properties 不存在或路径不正确，可在 Android Studio 中设置 SDK 路径，或手动编辑 local.properties：

     sdk.dir=你的_Android_SDK_路径
     

4. 同步 & 构建项目：

   • 在 Android Studio 中点击 Sync Project with Gradle Files
   • 等待依赖下载、构建完成

5. 运行应用：

   • 连接真机或启动模拟器（API 24 及以上）
   • 选择 app 模块，点击 Run 按钮即可安装运行

---

高德地图 SDK 说明

• 项目中通过本地 JAR 的方式集成了高德地图相关 SDK：
  • JAR 路径配置于 app/build.gradle 中的：

    implementation files('libs/AMap3DMap_10.1.500_AMapSearch_9.7.4_AMapLocation_6.5.0_20250814.jar')
    

• 若要正常使用高德地图功能，请：
  • 前往 高德开放平台 申请 Android Key；
  • 按照高德官方文档在 AndroidManifest.xml 中配置 API Key 相关信息；
  • 确保本地 JAR 文件已放置在 app/libs/ 目录下（与 build.gradle 中路径一致）。

如需升级或调整 SDK 版本，请同步更新 libs 目录中的 JAR 文件以及对应的 Gradle 配置。

---

主要依赖

app/build.gradle 中关键依赖包括：

• UI & 基础组件

  • androidx.appcompat:appcompat:1.4.1
  • com.google.android.material:material:1.5.0
  • androidx.coordinatorlayout:coordinatorlayout:1.2.0
  • androidx.recyclerview:recyclerview:1.2.1

• 数据解析

  • com.google.code.gson:gson:2.8.9
  • org.jsoup:jsoup:1.15.3

• 网络请求

  • com.squareup.okhttp3:okhttp:4.9.3
  • com.squareup.retrofit2:retrofit:2.9.0
  • com.squareup.retrofit2:converter-gson:2.9.0

• 测试

  • junit:junit:4.13.2
  • androidx.test.ext:junit:1.1.3
  • androidx.test.espresso:espresso-core:3.4.0

---

目录结构（简要）

• app/
  • src/main/java/com/example/myapplication/：主要业务代码（Activity、数据管理、网络请求等）
  • src/main/res/：布局、资源文件
  • build.gradle：应用模块构建配置
• AMap_Android_SDK_All/：高德 SDK 相关文件（如有）
• temp_sdk/：临时存放的 SDK / 相关文件（如有）
• build.gradle：项目根构建配置（包含 Android Gradle 插件、SonarQube 等）
• settings.gradle：模块配置
• gradle/、gradlew、gradlew.bat：Gradle Wrapper 相关文件

---

代码质量（可选）

项目根 build.gradle 中集成了 SonarQube 插件，用于代码质量分析。若需要在本地或 CI 中使用：

1. 搭建或连接到可用的 SonarQube 服务器；
2. 在本地或 CI 环境中配置好 SonarQube 的地址和认证信息；
3. 使用 Gradle 任务执行代码扫描（如 sonarqube 任务）。

注意：在对外开源或提交到公共仓库时，请勿提交真实的访问 Token 或其他敏感信息。

---

TODO / 后续规划

• 根据实际业务补充更详细的功能说明和截图
• 编写接口文档、数据结构说明
• 完善单元测试与 UI 测试
• 若需要，对高德地图和网络模块进行封装与抽象，提升可维护性