Files
maidong-ktv/app/build.gradle
T
zijunchiang fad2599e63 V1.5.1: 修复"点歌最后一首按切歌→播完卡死",并按要求改为转入公放
现象: 点歌清单只剩最后一首且正在播放时按一下「切歌」,那首歌播完后 App 直接卡死
(之后按切歌/播放都没反应)。

根因(advancePlayback 的出口语义 + 僵尸态):
- orderQueue 是"已点清单",正在播的那首**仍在队列里**;按切歌时才移除。
- 旧逻辑: 显式切歌移除最后一首后队列已空 → 落到"清空到空闲态"分支,
  该分支把 currentSong 置空、playWhenPrepared=false,**却没有停播放器**。
- 于是那首歌继续播到结束;而 onCompletion 第一行是
  `if (generation != playbackGeneration || currentSong?.equals(song) != true) return`
  → currentSong 已为 null,回调被**直接吞掉**,再也不推进。
- 结果就是"音频结束 / currentSong 为空 / 播放中标志为 false"的僵尸态:
  再按切歌或播放都没有任何反应(用户看到的卡死)。

修复(完全按用户要求的状态机):
- 显式切歌且点歌清单已空(= 在最后一首上按切歌)→ **转入公放**(playRandomLocalSong(skipped)),
  不再清空到空闲态。公放清单与点歌清单互不影响:随机歌曲不入 orderQueue;
  用户一点歌,挂起的随机请求会被 orderQueue.isNotEmpty() 守卫取消。
- 其它出口保持原逻辑不变(队列还有歌→下一首;自然播完+autoNext+队列空→公放;
  手动模式自然播完→空闲)。
- 僵尸态兜底: 所有"清空播放状态"的出口都补上 `player.stopPlayback()` + currentMediaPlayer = null
  (空闲态分支、公放库为空的兜底分支)。唯一例外是马上 play() 下一首的路径——
  故意不停,避免切歌瞬间因曲库扫描而静音。

AGENTS.md 增补「切歌/续播状态机」四条出口 + 僵尸态的成因与强制约定。

版本 1.5.0(31) → 1.5.1(32);签名证书不变。测试 8 例全通过。
2026-09-26 21:47:12 +08:00

105 lines
3.6 KiB
Groovy

plugins {
id "com.android.application"
id "org.jetbrains.kotlin.android"
}
android {
namespace "com.local.ktv"
compileSdk 35
defaultConfig {
applicationId "com.local.ktv"
minSdk 21
targetSdk 25
versionCode 32
versionName "1.5.1"
ndk {
// 双 ABI 打包:兼容 64 位(Exynos 1580 等 arm64-v8a)与 32 位设备(极米 Play 超越版
// 的 Amlogic 950X2/S905X2 采用 32 位 Android 用户态,必须包含 armeabi-v7a,否则
// 会出现 INSTALL_FAILED_NO_MATCHING_ABIS 安装失败)。
// Package each ABI's complete IJK set; never mix individual SOs across the two sets.
abiFilters "armeabi-v7a", "arm64-v8a"
}
// 曲库已改为官方 Muse 同步(database_publish 不再发布到 Gitee),
// 不再需要 GITEE_DATABASE_* 构建参数。
}
// 签名配置:使用已有的 ktv_keystore.jks
signingConfigs {
release {
storeFile file("../../ktv_keystore.jks")
storePassword "123456"
keyAlias "ktv"
keyPassword "123456"
}
}
buildTypes {
release {
minifyEnabled true
shrinkResources true
signingConfig signingConfigs.release
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
debug {
debuggable true
applicationIdSuffix ".qa"
}
}
// 支持 .ts 视频文件(aapt 不压缩这些文件以避免 SoundPool/MediaPlayer 问题)
androidResources {
noCompress 'ts', 'mp3', 'mp4', 'aac', 'm4a', 'flac', 'wav'
}
// lint 策略:
// - 「调用了高于 minSdk 且未做版本守卫的 API」(NewApi) 必须**阻断发布构建**:
// 这类问题在 Android 5.x / 6.x 上直接 NoSuchMethodError / NoClassDefFoundError 闪退,
// 而本地打包测试用的都是较新设备, 极容易漏出去(v1.4.0 在极米 H1S / Android 5.1.1
// 一打开就闪退, 根因就是 AudioDeviceCallback(API 23) 被写进了 Activity 的字段初始化器)。
// - ExpiredTargetSdkVersion 默认也是 fatal 级, 但本地分发的 APK 不上架 Google Play,
// 显式关掉, 否则会挤占下面这道闸门。
// - abortOnError 必须为 true: 设为 false 会把 lintVital 的失败一并吞掉, 闸门会失效。
lint {
fatal += ['NewApi']
disable += ['ExpiredTargetSdkVersion']
checkReleaseBuilds true
abortOnError true
}
// 启用 BuildConfig 生成,供 AboutFragment 读取版本号/版本Code等信息
buildFeatures {
buildConfig = true
}
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
kotlinOptions {
jvmTarget = "17"
}
}
// 强制统一 Kotlin 标准库版本,避免 appcompat 与其他依赖的版本冲突
configurations.all {
resolutionStrategy {
force "org.jetbrains.kotlin:kotlin-stdlib:1.8.22"
force "org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.8.22"
force "org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.8.22"
force "org.jetbrains.kotlin:kotlin-stdlib-common:1.8.22"
}
}
dependencies {
implementation files('libs/original-ijk-runtime.jar')
implementation "androidx.core:core:1.12.0"
implementation "androidx.appcompat:appcompat:1.6.1"
implementation "com.google.zxing:core:3.5.3"
implementation "com.liulishuo.okdownload:okdownload:1.0.7"
testImplementation "junit:junit:4.13.2"
}