Compare commits
2
Commits
9ce815c5fc
...
2525df58d8
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
2525df58d8 | ||
|
|
e551944d69 |
@@ -0,0 +1,10 @@
|
||||
# 构建上下文瘦身:CI 里是全新 clone,这里主要防止把本地产物/仓库元数据塞进镜像
|
||||
.git/
|
||||
.gradle/
|
||||
build/
|
||||
app/build/
|
||||
.idea/
|
||||
*.iml
|
||||
*.apk
|
||||
*.aab
|
||||
local.properties
|
||||
@@ -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
|
||||
@@ -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: 新增悬浮窗碎片录入`。
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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"]
|
||||
Reference in New Issue
Block a user