xinli/xinli-App/打包说明.md

108 lines
2.6 KiB
Markdown
Raw Normal View History

2025-11-23 10:19:32 +08:00
# APK打包说明
## 配置JDK 1.8
### 方法一在Android Studio中配置推荐
1. 打开 `File``Project Structure``SDK Location`
2.`JDK location` 中选择JDK 1.8的安装路径
- 例如:`C:\Program Files\Java\jdk1.8.0_xxx`
3. 点击 `Apply``OK`
### 方法二在gradle.properties中配置
1. 打开 `gradle.properties` 文件
2. 找到 `org.gradle.java.home` 这一行(如果被注释了)
3. 取消注释并设置JDK 1.8的路径:
```properties
org.gradle.java.home=C:\\Program Files\\Java\\jdk1.8.0_xxx
```
**注意**:路径中的反斜杠需要转义(使用双反斜杠 `\\`
### 验证JDK版本
在项目根目录执行:
```bash
gradlew.bat -v
```
查看显示的Java版本是否为1.8
---
## 方法一使用Android Studio打包最简单
1. **配置JDK 1.8**(见上方说明)
2. 用Android Studio打开项目
3. 等待Gradle同步完成
4. 菜单栏:`Build` → `Build Bundle(s) / APK(s)``Build APK(s)`
5. 等待构建完成,点击通知中的 `locate` 查看APK位置
---
## 方法二:使用命令行打包
### 前提条件
确保已安装:
- **Java JDK 1.8**(必须)
- Android SDK
- Gradle或使用项目自带的Gradle Wrapper
### 步骤1配置JDK 1.8
**方式A设置环境变量**
- 设置 `JAVA_HOME` 环境变量指向JDK 1.8
- 将JDK 1.8的 `bin` 目录添加到 `PATH`
**方式B在gradle.properties中指定**
- 编辑 `gradle.properties`,设置 `org.gradle.java.home`
### 步骤2打包APK
**方式A使用打包脚本推荐**
```bash
build-apk.bat
```
然后根据提示选择Debug或Release版本
**方式B直接使用命令**
打包Debug版本用于测试
```bash
gradlew.bat assembleDebug
```
打包Release版本用于发布
```bash
gradlew.bat assembleRelease
```
### 生成的APK位置
- Debug版本`app\build\outputs\apk\debug\app-debug.apk`
- Release版本`app\build\outputs\apk\release\app-release.apk`
---
## 安装APK到设备
### 方法1通过USB连接
```bash
adb install app\build\outputs\apk\debug\app-debug.apk
```
### 方法2直接传输
将APK文件复制到手机在手机上点击安装
---
## 注意事项
- **JDK版本**项目已配置为使用Java 1.8确保使用JDK 1.8进行编译
- **Debug版本**:用于测试,体积较大,未优化,可以直接安装
- **Release版本**用于发布体积较小已优化已配置为使用debug签名可以直接安装
如果遇到JDK版本问题请确保
1. 系统已安装JDK 1.8
2. Android Studio或命令行使用的JDK版本为1.8
3. `gradle.properties` 中正确配置了JDK路径如果需要