GitLab CI配置：Android项目使用本地SDK的.gitlab-ci.yml编写方法

我来帮你搞定这个配置！要在GitLab CI里用本地SDK而不是官方下载，还要配合你已经装好的本地Runner，咱们一步步来：

首先，你的本地Runner得能访问到本地SDK文件夹。如果是用shell executor（本地工作站最常用的Runner类型），它直接就能读写本地文件系统，这一步会很顺畅。

你可以打开Runner的配置文件（一般在~/.gitlab-runner/config.toml，Windows是C:\Users\你的用户名\.gitlab-runner\config.toml），检查核心配置是否类似这样：

[[runners]]
  name = "我的本地Android Runner"
  url = "你的GitLab实例地址"
  token = "你的Runner令牌"
  executor = "shell"
  tags = ["local-android"] # 给Runner加个专属标签，后面CI配置要用到
  [runners.custom_build_dir]
  [runners.cache]
    [runners.cache.s3]
    [runners.cache.gcs]
    [runners.cache.azure]

重点确认executor是shell，并且设置了专属标签，方便后续CI任务指定使用这个Runner。

核心思路是通过环境变量指定本地SDK路径，让构建工具直接用本地资源，跳过下载流程。下面是一个可以直接复用的模板，你根据自己的情况修改：

# 定义构建阶段
stages:
  - build

# 全局环境变量：指定本地SDK路径
variables:
  ANDROID_HOME: "/path/to/your/local/android-sdk" # 替换成你实际的SDK路径
  ANDROID_SDK_ROOT: "$ANDROID_HOME" # 兼容部分依赖这个变量的工具
  GRADLE_OPTS: "-Dorg.gradle.daemon=false" # 可选：关闭Gradle守护，避免CI环境的冲突

# Android构建任务
build_debug_apk:
  stage: build
  tags:
    - local-android # 这里要和你本地Runner的标签完全一致
  before_script:
    - echo "正在使用本地SDK：$ANDROID_HOME"
    - # 可选：检查本地SDK是否包含项目需要的组件（比如build-tools、对应版本的platform）
    - $ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager --list | grep "build-tools"
  script:
    - # 执行你的Gradle构建命令，比如打包Debug包
    - ./gradlew assembleDebug
  artifacts:
    paths:
      - app/build/outputs/apk/debug/*.apk # 保存构建产物，可选
    expire_in: 1 week # 产物自动过期时间，可选

关键细节提醒 #

• SDK路径替换：一定要把ANDROID_HOME换成你本地的实际路径：
  • Mac：~/Library/Android/sdk
  • Linux：/home/你的用户名/Android/Sdk
  • Windows：C:\Users\你的用户名\AppData\Local\Android\Sdk（如果用PowerShell执行，路径格式要对应）
• 标签必须匹配：tags字段要和你本地Runner的标签完全一致，不然GitLab会把任务派给其他Runner。
• 提前检查SDK组件：确保本地SDK已经安装了项目需要的所有组件（比如对应版本的build-tools、platforms），如果缺失，用sdkmanager命令安装即可，比如：$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager "build-tools;34.0.0"
• Windows适配：如果是Windows的shell executor，脚本里的命令要改成PowerShell格式，比如.\gradlew assembleDebug。

1. 把修改好的.gitlab-ci.yml提交到GitLab仓库
2. 去项目的「CI/CD -> Pipelines」页面触发一个新流水线
3. 查看流水线日志，确认输出里有正在使用本地SDK：xxx的提示，且没有出现“下载SDK”相关的步骤，同时Gradle能正常完成构建。

如果遇到权限问题，检查本地Runner的运行用户是否有权限访问你的SDK文件夹；如果组件缺失，补充安装对应的SDK组件即可。

内容的提问来源于stack exchange，提问作者user1854307