3 Commits
6 changed files with 189 additions and 1 deletions
+10
View File
@@ -0,0 +1,10 @@
# 构建上下文瘦身:CI 里是全新 clone,这里主要防止把本地产物/仓库元数据塞进镜像
.git/
.gradle/
build/
app/build/
.idea/
*.iml
*.apk
*.aab
local.properties
+110
View File
@@ -0,0 +1,110 @@
name: lpt-android Build
on:
workflow_dispatch:
inputs:
environment:
description: '构建环境(dev 仅允许 dev 分支;prod 仅允许 master 分支)'
required: true
type: choice
options:
- dev
- prod
env:
APP: lpt-android
REPO_URL: https://git.cat-shark.xyz/cat-shark/lpt-android.git
# 各环境的默认 API 地址。必须与 app/src/main/java/com/catshark/lpt/data/ApiClient.kt
# 里的 DEFAULT_BASE_URL 保持一致——第二步会逐字比对。
DEV_API: https://lpt-dev.cat-shark.xyz/api
PROD_API: https://lpt.cat-shark.xyz/api
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: 校验分支 ↔ 环境
run: |
set -euo pipefail
REF="${{ gitea.ref }}"
BRANCH="${REF#refs/heads/}"
if [[ "$REF" == refs/tags/* ]]; then
echo "ERROR: 请从分支触发构建,不要用 tag。当前 ref=$REF"
exit 1
fi
ENV="${{ inputs.environment }}"
echo "branch=$BRANCH environment=$ENV sha=${{ gitea.sha }}"
case "$ENV" in
prod)
case "$BRANCH" in
master) echo "OK: prod 允许从 $BRANCH 构建" ;;
*)
echo "ERROR: prod 只能从 master 构建,当前分支是 '$BRANCH'"
echo "请切换到 master 后再 Run workflow,并选择 environment=prod"
exit 1
;;
esac
;;
dev)
case "$BRANCH" in
dev) echo "OK: dev 允许从 $BRANCH 构建" ;;
*)
echo "ERROR: dev 只能从 dev 分支构建,当前分支是 '$BRANCH'"
echo "请切换到 dev 后再 Run workflow,并选择 environment=dev"
exit 1
;;
esac
;;
*)
echo "ERROR: 未知 environment=$ENV"
exit 1
;;
esac
- name: Checkout code
run: |
set -euo pipefail
git clone "$REPO_URL" .
git checkout "${{ gitea.sha }}"
- name: 校验代码里的默认环境地址
run: |
set -euo pipefail
ENV="${{ inputs.environment }}"
ACTUAL="$(grep -oE 'DEFAULT_BASE_URL = "[^"]+"' app/src/main/java/com/catshark/lpt/data/ApiClient.kt \
| head -1 | sed 's/.*= "//; s/"$//')"
if [ "$ENV" = "prod" ]; then EXPECT="$PROD_API"; else EXPECT="$DEV_API"; fi
echo "代码里的分支默认地址 = $ACTUAL"
echo "本环境期望的地址 = $EXPECT"
if [ "$ACTUAL" != "$EXPECT" ]; then
echo "ERROR: $ENV 的默认 API 地址与分支不匹配。"
echo "这两个分支只允许差这一行:dev 指向 dev 环境、master 指向生产环境。"
exit 1
fi
echo "OK: 默认地址与环境匹配"
- name: 构建 APK(容器内完成,JDK/SDK 版本固化)
run: |
set -euo pipefail
docker build -f ci/Dockerfile -t lpt-android-apk:ci .
- name: 取出 APK 并打印校验值
run: |
set -euo pipefail
ENV="${{ inputs.environment }}"
SHORT="$(echo "${{ gitea.sha }}" | cut -c1-8)"
NAME="lpt-android-${ENV}-${SHORT}.apk"
docker create --name lpt-apk-out lpt-android-apk:ci > /dev/null
docker cp lpt-apk-out:/out/app-debug.apk "$NAME"
docker rm -f lpt-apk-out > /dev/null
ls -l "$NAME"
sha256sum "$NAME" | tee apk-sha256.txt
- name: 归档 APK
uses: actions/upload-artifact@v4
with:
name: lpt-android-${{ inputs.environment }}-apk
path: |
*.apk
apk-sha256.txt
if-no-files-found: error
+17
View File
@@ -39,6 +39,23 @@
- 认证:Sa-Token,token 放请求头 `satoken`(不用 Cookie)
- 只使用学习会话相关端点,**不碰 `review/*`**
## 分支与发布
与 `lpt-be` / `lpt-fe` / `lpt-ai` 同规则:**一个分支对一个环境**(本仓库没有服务端部署,环境差异落在“默认 API 地址”上)。
| 分支 | 环境 | 默认 API 地址 |
|------|------|----------------|
| `dev` | 开发 | `https://lpt-dev.cat-shark.xyz/api` |
| `master` | 生产 | `https://lpt.cat-shark.xyz/api` |
- 两个分支的代码**只允许差 `ApiClient.DEFAULT_BASE_URL` 这一行**(其余全部一致)。改这一行时必须确认自己在哪个分支上,改完只提本分支。
- 不要跨分支合并:`dev` 的功能要上生产时,只把常规代码改动同步过去,并保持 master 的默认地址不变。
- 构建在 Gitea 手动触发 `.gitea/workflows/build.yml`(dev/prod 二选一),不需要签本地环境:
1. 校验「分支 ↔ 环境」(从 dev 发 prod 直接被拒);
2. 校验代码里的 `DEFAULT_BASE_URL` 是否与本环境一致,不一致直接失败;
3. 容器内构建 APK(`ci/Dockerfile` 固定 JDK 17 / cmdline-tools / android-36),产物归档为 Actions artifact 并打印 sha256。
- APK 不入 Git(`.gitignore` 已忽略 `*.apk`),分发走 Actions artifact。
## 提交规范
同 meta 仓库:简短中文,格式 `类型: 简述`,例如 `feat: 新增悬浮窗碎片录入`。
+11
View File
@@ -46,6 +46,17 @@ LPT 的学习计时原本只能在电脑浏览器里进行;而真实的学习
> ⚠️ Compose BOM ≥ 2026.04(compose 1.11+)要求 **AGP 9.1+ 与 compileSdk 37**,配 AGP 8.13.2 会报 `requires Android Gradle plugin 9.1.0 or higher`。要么整体升 AGP 9,要么锁在 2026.03.01。
### 分支与环境
| 分支 | 环境 | 默认 API 地址 | 用途 |
|------|------|----------------|------|
| `dev` | 开发 | `https://lpt-dev.cat-shark.xyz/api` | 日常开发与验证 |
| `master` | 生产 | `https://lpt.cat-shark.xyz/api` | 给真实使用打的生产包 |
两个分支**只差 `ApiClient.DEFAULT_BASE_URL` 一行**;安装后仍可在「设置」页临时改地址(调试用)。
打包走 Gitea Actions 的 `lpt-android Build`(手动触发,选 `dev` 或 `prod`),它会先校验「分支 ↔ 默认地址」是否匹配,再把 APK 归档成 artifact——本地不需要配签名环境。
## 构建与安装
```bash
@@ -56,6 +56,6 @@ class ApiClient {
get() = (retrofit ?: throw IllegalStateException("ApiClient 尚未设置 baseUrl")).create(LptApi::class.java)
companion object {
const val DEFAULT_BASE_URL = "https://lpt-dev.cat-shark.xyz/api"
const val DEFAULT_BASE_URL = "https://lpt.cat-shark.xyz/api"
}
}
+40
View File
@@ -0,0 +1,40 @@
# CI 专用:在容器里完成 Android 构建。
#
# 采用容器构建的原因与 lpt-be / lpt-fe / lpt-ai 一致:版本(JDK 17 / Android SDK 36)
# 固化在镜像里,不依赖 runner 上碰巧装了什么;Docker 层缓存让重复构建不必重下 SDK。
#
# 产物固定在 /out,由流水线用 `docker cp` 取出后归档为 Actions artifact。
FROM eclipse-temurin:17-jdk
ENV ANDROID_HOME=/opt/android-sdk \
ANDROID_SDK_ROOT=/opt/android-sdk \
GRADLE_USER_HOME=/root/.gradle \
PATH=/opt/android-sdk/cmdline-tools/latest/bin:/opt/android-sdk/platform-tools:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# 固定版本,避免 Google 换文件名导致构建随机失败
ARG CMDLINE_TOOLS=commandlinetools-linux-13114758_latest.zip
RUN apt-get update \
&& apt-get install -y --no-install-recommends unzip curl ca-certificates \
&& rm -rf /var/lib/apt/lists/*
RUN mkdir -p "${ANDROID_HOME}/cmdline-tools" \
&& curl -fsSL -o /tmp/cmdline-tools.zip "https://dl.google.com/android/repository/${CMDLINE_TOOLS}" \
&& unzip -q /tmp/cmdline-tools.zip -d /tmp/cmdline-tools \
&& mv /tmp/cmdline-tools/cmdline-tools "${ANDROID_HOME}/cmdline-tools/latest" \
&& rm -rf /tmp/cmdline-tools /tmp/cmdline-tools.zip
# 与 app/build.gradle.kts 对齐:compileSdk / targetSdk = 36
# build-tools 装 35 与 36 两版,避免 AGP 默认版本落在哪个上不确定
RUN yes | sdkmanager --licenses > /dev/null \
&& sdkmanager --install "platform-tools" "platforms;android-36" "build-tools;36.0.0" "build-tools;35.0.0" > /dev/null
WORKDIR /workspace
COPY . .
# 容器内没有 daemon 需要常驻,显式关掉
RUN ./gradlew --no-daemon :app:assembleDebug
RUN mkdir -p /out && cp app/build/outputs/apk/debug/*.apk /out/
CMD ["true"]