RuoYi-Android-App

基于Android开发的轻量级移动端框架

简介

RuoYi Android App 移动解决方案，采用kotlin框架，一份代码多终端适配，实现了与RuoYi-Go 、RuoYi-Vue、RuoYi-Cloud完美对接的移动解决方案！目前已经实现登录、我的、工作台、编辑资料、头像修改、密码修改、常见问题、关于我们等基础功能。

• 配套后端代码仓库地址RuoYi-Go 或 RuoYi-Vue 或 RuoYi-Cloud 版本。
• 应用框架基于kotlin，支持Android。

技术文档

• GitEE：https://gitee.com/OptimisticDevelopers/Ruoyi-Android-App
• 文档地址：https://ruoyi-go.qiqjia.com

以下是详细的Android开发环境搭建教程，涵盖从下载安装到首次运行应用的完整流程：

一、准备工作

1. 系统要求
   • 操作系统：Windows 10/11（64位）、macOS 10.14+、Linux（64位，如Ubuntu 18.04+）
   • 硬件：至少8GB内存（推荐16GB）、20GB以上空闲磁盘空间、支持虚拟化技术的CPU（加速模拟器运行）

二、下载Android Studio

1. 访问官方下载页：Android Studio 官网
2. 点击「Download Android Studio」，勾选同意条款，选择对应系统的安装包（如Windows版为.exe，macOS为.dmg）
3. 等待下载完成（约1-2GB，取决于网络速度）

三、安装Android Studio

Windows系统

1. 双击下载的android-studio-xxxx.exe文件，弹出安装向导
2. 点击「Next」，默认勾选所有组件（包括Android Studio、Android SDK、模拟器等），如需自定义路径可修改安装位置（建议避免中文路径）
3. 点击「Install」，等待安装完成，最后点击「Finish」

macOS系统

1. 打开android-studio-xxxx.dmg，将Android Studio拖拽到「Applications」文件夹
2. 从启动台打开Android Studio，首次运行可能需要验证开发者，点击「打开」

四、初始化配置与SDK安装

1. 首次启动

   • 首次打开会提示「Import Android Studio Settings」，选择「Do not import settings」，点击「OK」
   • 如遇「Android Studio Setup Wizard」，点击「Next」进入配置流程

2. 选择安装类型

   • 推荐新手选择「Standard」（标准安装），自动配置SDK、模拟器等；进阶用户可选择「Custom」自定义组件
   • 点击「Next」，选择界面主题（Light/Dark），继续点击「Next」

3. 安装Android SDK

   • 系统会自动选择最新的Android SDK版本（如Android 14），确认安装路径（默认路径即可，避免中文）
   • 点击「Next」，接受SDK许可协议，点击「Finish」开始下载安装（约2-3GB，耗时取决于网络）
   • 安装完成后点击「Finish」，进入Android Studio主界面

五、配置模拟器（可选，用于运行测试）

1. 在主界面点击「More Actions」→「AVD Manager」（或顶部菜单栏「Tools」→「Device Manager」）
2. 点击「Create Virtual Device」，选择设备类型（如「Pixel 6」），点击「Next」
3. 选择系统镜像（推荐选择带有「Google Play」的版本，如「Android 14.0 (API 34)」），点击「Download」下载镜像
4. 下载完成后点击「Next」，确认模拟器名称和配置，点击「Finish」完成创建
5. 点击模拟器卡片上的「启动」按钮（▶️），等待模拟器启动（首次启动可能需要几分钟）

六、连接真实设备（可选，推荐用于实际测试）

1. 在安卓设备上：

   • 打开「设置」→「关于手机」，连续点击「版本号」7次，开启「开发者模式」
   • 返回设置，进入「系统」→「开发者选项」，开启「USB调试」和「USB安装」

2. 用USB线连接设备与电脑，首次连接会提示「允许USB调试」，在设备上点击「允许」

3. 在Android Studio中，顶部工具栏的设备选择下拉框会显示已连接的设备

七、创建并运行第一个项目

1. 在主界面点击「New Project」，选择项目模板（推荐新手选择「Empty Activity」），点击「Next」
2. 配置项目信息：
   • 「Name」：项目名称（如「MyFirstApp」）
   • 「Package name」：应用包名（默认即可，格式为com.example.xxx）
   • 「Save location」：项目保存路径（避免中文）
   • 「Language」：选择开发语言（Java或Kotlin，推荐Kotlin）
   • 「Minimum SDK」：最低支持的安卓版本（默认即可）
3. 点击「Finish」，Android Studio会自动构建项目（首次构建可能需要几分钟，耐心等待）
4. 运行项目：
   • 确保顶部工具栏已选择设备（模拟器或真实设备）
   • 点击运行按钮（▶️，或快捷键Shift+F10）
   • 等待编译完成，应用会自动安装到设备上，显示默认的「Hello World!」界面

八、常见问题解决

1. SDK下载缓慢：可在「File」→「Settings」→「Appearance & Behavior」→「System Settings」→「HTTP Proxy」中配置国内镜像（如阿里云镜像）
2. 模拟器启动失败：检查是否开启CPU虚拟化（进入BIOS开启VT-x/AMD-V），或降低模拟器配置（如减少内存）
3. 项目构建报错：点击「Build」→「Clean Project」清理缓存，再重新构建

通过以上步骤，即可完成Android开发环境的搭建。如需深入学习，可参考官方文档：Android 开发者指南。