xinli/xinli-App/打包说明.md
2025-11-23 10:19:32 +08:00

108 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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路径如果需要