[Fix] (ci): split APK retrace AVD lifecycle

- expose AVD create, launch, retrace, diagnostics, and stop as separate workflow steps

- add bounded waits for emulator adb connection, boot, and trace replay execution

- collect emulator diagnostics for APK retrace artifacts
This commit is contained in:
2026-06-20 14:27:11 +08:00
parent 317b3602c3
commit a49a463acf
2 changed files with 208 additions and 96 deletions
+39 -5
View File
@@ -96,6 +96,9 @@ jobs:
name: retrace (${{ matrix.backend.name }}, ${{ matrix.case.name }})
runs-on: ubuntu-latest
needs: build
timeout-minutes: 75
env:
AVD_NAME: mobilegl-${{ matrix.backend.id }}
strategy:
fail-fast: false
max-parallel: 4
@@ -376,6 +379,8 @@ jobs:
run: |
echo "date_today=$(date +'%Y-%m-%d')" >> "$GITHUB_ENV"
echo "short_sha=${GITHUB_SHA::7}" >> "$GITHUB_ENV"
echo "EMULATOR_LOG=${RUNNER_TEMP}/mobilegl-emulator.log" >> "$GITHUB_ENV"
echo "EMULATOR_PID_FILE=${RUNNER_TEMP}/mobilegl-emulator.pid" >> "$GITHUB_ENV"
- name: Setup Android SDK
uses: android-actions/setup-android@v3
@@ -393,17 +398,28 @@ jobs:
sudo udevadm control --reload-rules
sudo udevadm trigger --name-match=kvm
- name: Retrace and validate
- name: Create AVD
run: |
apk_file="$(find android-retrace-apks -name '${{ matrix.backend.apk }}' -print -quit)"
sh android-plugin/run-avd-ci.sh \
sh android-plugin/run-avd-ci.sh create \
--api-level 35 \
--target google_apis \
--arch x86_64 \
--profile pixel_6 \
--avd-name "${AVD_NAME}"
- name: Launch Emulator
run: |
sh android-plugin/run-avd-ci.sh start \
--avd-name "${AVD_NAME}" \
--gpu "${{ matrix.backend.gpu }}" \
--avd-name "mobilegl-${{ matrix.backend.id }}" \
-- sh android-plugin/trace-replay-ci.sh \
--emulator-log "${EMULATOR_LOG}" \
--pid-file "${EMULATOR_PID_FILE}" \
--boot-timeout 300
- name: Retrace and validate
run: |
apk_file="$(find android-retrace-apks -name '${{ matrix.backend.apk }}' -print -quit)"
timeout "$(( ${{ matrix.case.timeout_seconds }} + 300 ))" sh android-plugin/trace-replay-ci.sh \
--apk-file "${apk_file}" \
--package "${{ matrix.backend.package }}" \
--backend "${{ matrix.backend.name }}" \
@@ -424,6 +440,24 @@ jobs:
--fuzz-percent "${{ matrix.case.fuzz_percent }}" \
--timeout-seconds "${{ matrix.case.timeout_seconds }}"
- name: Collect emulator diagnostics
if: always()
run: |
mkdir -p android-retrace-result/diagnostics
adb devices -l > android-retrace-result/diagnostics/adb-devices.txt || true
timeout 30 adb logcat -d -t 1000 > android-retrace-result/diagnostics/logcat.txt || true
if [ -f "${EMULATOR_LOG}" ]; then
cp "${EMULATOR_LOG}" android-retrace-result/diagnostics/emulator.log
fi
- name: Stop Emulator
if: always()
run: |
sh android-plugin/run-avd-ci.sh stop \
--avd-name "${AVD_NAME}" \
--emulator-log "${EMULATOR_LOG}" \
--pid-file "${EMULATOR_PID_FILE}"
- name: Upload Android retrace result
if: always()
uses: actions/upload-artifact@v4
+102 -24
View File
@@ -4,14 +4,24 @@ set -eu
usage() {
cat <<'EOF'
Usage:
sh android-plugin/run-avd-ci.sh \
sh android-plugin/run-avd-ci.sh create \
--api-level N \
--target TARGET \
--arch ARCH \
--profile PROFILE \
--gpu GPU \
--avd-name NAME
sh android-plugin/run-avd-ci.sh start \
--avd-name NAME \
-- COMMAND [ARGS ...]
--gpu GPU \
--emulator-log FILE \
--pid-file FILE \
--boot-timeout SECONDS
sh android-plugin/run-avd-ci.sh stop \
--avd-name NAME \
--emulator-log FILE \
--pid-file FILE
EOF
}
@@ -36,11 +46,21 @@ require_value() {
fi
}
print_diagnostics() {
emulator_log="$1"
adb devices -l >&2 || true
if [ -f "${emulator_log}" ]; then
echo "----- emulator log -----" >&2
cat "${emulator_log}" >&2 || true
echo "----- end emulator log -----" >&2
fi
}
create_avd() {
api_level=""
target=""
arch=""
profile=""
gpu=""
avd_name=""
while [ "$#" -gt 0 ]; do
@@ -49,11 +69,9 @@ while [ "$#" -gt 0 ]; do
--target) target="$(next_arg "$@")"; shift 2 ;;
--arch) arch="$(next_arg "$@")"; shift 2 ;;
--profile) profile="$(next_arg "$@")"; shift 2 ;;
--gpu) gpu="$(next_arg "$@")"; shift 2 ;;
--avd-name) avd_name="$(next_arg "$@")"; shift 2 ;;
--) shift; break ;;
-h|--help) usage; exit 0 ;;
*) die "unknown argument: $1" ;;
*) die "unknown create argument: $1" ;;
esac
done
@@ -61,18 +79,39 @@ require_value "${api_level}" "--api-level"
require_value "${target}" "--target"
require_value "${arch}" "--arch"
require_value "${profile}" "--profile"
require_value "${gpu}" "--gpu"
require_value "${avd_name}" "--avd-name"
if [ "$#" -eq 0 ]; then
die "missing command"
fi
system_image="system-images;android-${api_level};${target};${arch}"
sdkmanager "platform-tools" "emulator" "platforms;android-${api_level}" "${system_image}"
echo no | avdmanager create avd --force --name "${avd_name}" --package "${system_image}" --device "${profile}"
}
emulator_log="${RUNNER_TEMP:-.}/${avd_name}-emulator.log"
start_avd() {
avd_name=""
gpu=""
emulator_log=""
pid_file=""
boot_timeout=""
while [ "$#" -gt 0 ]; do
case "$1" in
--avd-name) avd_name="$(next_arg "$@")"; shift 2 ;;
--gpu) gpu="$(next_arg "$@")"; shift 2 ;;
--emulator-log) emulator_log="$(next_arg "$@")"; shift 2 ;;
--pid-file) pid_file="$(next_arg "$@")"; shift 2 ;;
--boot-timeout) boot_timeout="$(next_arg "$@")"; shift 2 ;;
-h|--help) usage; exit 0 ;;
*) die "unknown start argument: $1" ;;
esac
done
require_value "${avd_name}" "--avd-name"
require_value "${gpu}" "--gpu"
require_value "${emulator_log}" "--emulator-log"
require_value "${pid_file}" "--pid-file"
require_value "${boot_timeout}" "--boot-timeout"
mkdir -p "$(dirname "${emulator_log}")" "$(dirname "${pid_file}")"
emulator -avd "${avd_name}" \
-no-window \
-gpu "${gpu}" \
@@ -83,18 +122,15 @@ emulator -avd "${avd_name}" \
-camera-front none \
> "${emulator_log}" 2>&1 &
emulator_pid="$!"
echo "${emulator_pid}" > "${pid_file}"
cleanup() {
if kill -0 "${emulator_pid}" 2>/dev/null; then
adb -s emulator-5554 emu kill >/dev/null 2>&1 || kill "${emulator_pid}" >/dev/null 2>&1 || true
if ! timeout "${boot_timeout}" adb wait-for-device; then
print_diagnostics "${emulator_log}"
die "emulator did not connect to adb within ${boot_timeout}s"
fi
}
trap cleanup EXIT INT TERM
adb wait-for-device
booted=""
for _ in $(seq 1 300); do
for _ in $(seq 1 "${boot_timeout}"); do
booted="$(adb shell getprop sys.boot_completed 2>/dev/null | tr -d '\r' || true)"
if [ "${booted}" = "1" ]; then
break
@@ -103,13 +139,55 @@ for _ in $(seq 1 300); do
done
if [ "${booted}" != "1" ]; then
cat "${emulator_log}" >&2 || true
die "emulator did not boot"
print_diagnostics "${emulator_log}"
die "emulator did not boot within ${boot_timeout}s"
fi
adb shell settings put global window_animation_scale 0
adb shell settings put global transition_animation_scale 0
adb shell settings put global animator_duration_scale 0
adb shell input keyevent 82 || true
}
"$@"
stop_avd() {
avd_name=""
emulator_log=""
pid_file=""
while [ "$#" -gt 0 ]; do
case "$1" in
--avd-name) avd_name="$(next_arg "$@")"; shift 2 ;;
--emulator-log) emulator_log="$(next_arg "$@")"; shift 2 ;;
--pid-file) pid_file="$(next_arg "$@")"; shift 2 ;;
-h|--help) usage; exit 0 ;;
*) die "unknown stop argument: $1" ;;
esac
done
require_value "${avd_name}" "--avd-name"
require_value "${emulator_log}" "--emulator-log"
require_value "${pid_file}" "--pid-file"
adb emu kill >/dev/null 2>&1 || true
if [ -f "${pid_file}" ]; then
emulator_pid="$(cat "${pid_file}")"
if [ -n "${emulator_pid}" ] && kill -0 "${emulator_pid}" 2>/dev/null; then
kill "${emulator_pid}" >/dev/null 2>&1 || true
fi
fi
}
if [ "$#" -eq 0 ]; then
die "missing command"
fi
command="$1"
shift
case "${command}" in
create) create_avd "$@" ;;
start) start_avd "$@" ;;
stop) stop_avd "$@" ;;
-h|--help) usage; exit 0 ;;
*) die "unknown command: ${command}" ;;
esac