企业官网建设流程全解析

一、代码推送

1.推送报错：Login failed. Check API token or GitLab version.

Log in via Git if the version is older than 14.0
现象：多次更换token一直失败，使用 账户密码登录时 报错：
Access denied. The provided password or token is incorrect or your account has 2FA enabled and you must use a personal access token instead of a password
最终解决方案：关闭代理，重新推送

二、新项目配置

1. 报错信息：No version of NDK

What went wrong: Execution failed for task ':app:stripDebugDebugSymbols'. > No version of NDK matched the requested version 21.0.6113669. Versions available locally: 26.3.11579264

核心原因:NDK（Native Development Kit）版本不匹配：项目要求使用 NDK 版本21.0.6113669，但你本地仅安装了26.3.11579264，导致编译任务:app:stripDebugDebugSymbols执行失败

解决方案：
方案一（永久性设置）： 在Tools->SDKManager 中 切换到 SDK Tools 先勾选sdk 确保与 build.gradle 中一致如30.03 Show Package Details 中勾选 21.0.6113669 下载后重新编译

方案二（临时使用）：在build.gradle 中直接指定 ndkVersion

android { compileSdk 33 // 此处版本可能与你的项目不同，无需修改 buildToolsVersion "33.0.1" // 同上，无需修改 defaultConfig { applicationId "com.example.yourapp" minSdk 21 targetSdk 33 versionCode 1 versionName "1.0" // 关键：修改或添加 ndkVersion，使用本地已有的 26.3.11579264 ndkVersion "26.3.11579264" } // 其他配置... }

2. 报错信息： Failed to read key AndroidDebugKey from store

Execution failed for task ':app:packageDebug'. > A failure occurred while executing com.android.build.gradle.internal.tasks.Workers$ActionFacade > com.android.ide.common.signing.KeytoolException: Failed to read key AndroidDebugKey from store "C:\Users\xcadviser011\.android\debug.keystore": Invalid keystore format

主要原因：

这个错误的核心原因是Android 调试密钥库（debug.keystore）格式无效，导致 Gradle 在执行:app:packageDebug任务（打包 Debug 版本 APK）时无法读取密钥AndroidDebugKey，进而打包失败。

解决方案：

删除旧密钥库，让 Android Studio 自动重建（最常用、最有效）

调试密钥库是自动生成的，删除后重新运行项目时，Android Studio 会自动创建新的有效密钥库，步骤如下：

1. 关闭 Android Studio（避免文件被占用）。

2. 打开路径C:\Users\xcadviser011\.android\（直接复制路径到文件管理器地址栏回车）。

3. 在该目录下找到debug.keystore文件，直接删除（如果有debug.keystore.lock文件也一并删除）。

4. 重新打开 Android Studio，点击「运行」（绿色三角按钮）或执行gradlew assembleDebug命令。

5. Android Studio 会自动检测密钥库缺失，并生成新的debug.keystore，此时打包任务会正常执行。

3. 报错信息：Unresolved reference 'databinding'.

在android 中使用了视图绑定 setContentView，需要在app/build.gradle 中 声明：（添加完之后先 Sync Now / clean Project 再 Rebuild Project）

buildFeatures {
dataBinding = true // 启用 DataBinding
// 如果同时用了 ViewBinding，也可以加上
viewBinding = true
}

三、环境配置

1.新版JDK配置

全局默认配置jdk位置 setting-》build,Exception,Deployment -》build Tools -》gradle

当前应用jdk配置位置：Project Structure -> Moudles -> 对应app -> Properties

有两个属性Source Compatibility（源码兼容性）、Target Compatibility（目标兼容性）一般不需要单独去配置

Source Compatibility（源码兼容性）作用：指定编译后的字节码与哪个版本的 Java 虚拟机（JVM）兼容（影响.class文件的格式）。

Target Compatibility（目标兼容性）作用：指定生成的字节码针对的目标 JVM 版本（与Source Compatibility配合使用，确保跨版本兼容性）

四、android 设备配置

1.fastboot 指令

adb reboot bootloader

fastboot flashing unlock

fastboot reboot

2.fastboot 问题：执行adb reboot bootloader之后，执行fastboot flashing unlock 显示没有设备

排查思路：

如果设备界面显示 fastboot mode，说明设备已经进入fastboot 而电脑没有识别到

解决方案：

（1）先去下载一个驱动并解压，记住保存位置：https://dl.google.com/android/repository/usb_driver_r13-windows.zip

（2）设备管理器-其他设备-Android-右键更新驱动程序

（2）选择浏览我的电脑以查找驱动程序

（3）点下边这个

直接下一步，点从磁盘安装

选择刚刚下载的usb_driver/android_winusb.inf

这样点下一步就好了