feat: QFace CDN faces and gated market GIF playback

Drop bundled bigface assets for on-demand QFace png/apng, prefer dynamic market stickers in chat with a 2-slot play gate, and add app-new Android CI.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: heDuke

.github/workflows/android.yml

@@ -0,0 +1,96 @@
+name: Android CI
+
+on:
+  push:
+    branches: [main, master, 'upgrade/**']
+    paths-ignore:
+      - '**.md'
+      - 'LICENSE'
+  pull_request:
+    branches: [main, master]
+    paths-ignore:
+      - '**.md'
+      - 'LICENSE'
+  workflow_dispatch:
+    inputs:
+      buildRelease:
+        description: 'Also build the release APK'
+        type: boolean
+        default: false
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Assemble APK
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      # README baseline: JDK 17+, AGP 9.3, Gradle 9.5.
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '17'
+
+      # The ubuntu runner ships an Android SDK with ANDROID_HOME preset;
+      # install the exact components this project pins (compileSdk 37,
+      # build-tools 37.0.0) with the bundled sdkmanager directly instead of
+      # a third-party action.
+      - name: Install Android SDK components
+        run: |
+          SDKMANAGER="$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager"
+          yes | "$SDKMANAGER" --licenses > /dev/null 2>&1 || true
+          # Since SDK 36 the platform packages carry a minor version:
+          # "platforms;android-37.0" (a bare "android-37" does not exist).
+          "$SDKMANAGER" --install "platforms;android-37.0" "build-tools;37.0.0" "platform-tools"
+
+      # Gradle build/configuration caches. The wrapper downloads its
+      # distribution from the Tencent mirror pinned in
+      # gradle-wrapper.properties, which is reachable from GitHub runners.
+      - name: Set up Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Grant execute permission to gradlew
+        run: chmod +x gradlew
+
+      - name: Build debug APK
+        run: ./gradlew :app-new:assembleDebug --stacktrace
+
+      - name: Build release APK
+        if: ${{ github.event_name == 'workflow_dispatch' && inputs.buildRelease }}
+        run: ./gradlew :app-new:assembleRelease --stacktrace
+
+      # NOTE: the APK embeds Tencent's proprietary watch-QQ runtime (see
+      # README disclaimer) — keep artifact retention short.
+      - name: Upload debug APK
+        uses: actions/upload-artifact@v4
+        with:
+          name: qmce-debug
+          path: app-new/build/outputs/apk/debug/*.apk
+          retention-days: 7
+
+      - name: Upload release APK
+        if: ${{ github.event_name == 'workflow_dispatch' && inputs.buildRelease }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: qmce-release
+          path: app-new/build/outputs/apk/release/*.apk
+          retention-days: 7
+
+      - name: Upload build reports on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-reports
+          path: |
+            app-new/build/reports/
+            build/reports/
+          retention-days: 7
+          if-no-files-found: ignore

app-new/src/main/assets/bigface.zip

@@ -17,6 +17,7 @@ import androidx.multidex.MultiDex
 import coil3.ImageLoader
 import coil3.SingletonImageLoader
 import coil3.gif.GifDecoder
+import coil3.memory.MemoryCache
 import coil3.network.okhttp.OkHttpNetworkFetcherFactory
 import com.microsoft.appcenter.AppCenter
 import com.microsoft.appcenter.analytics.Analytics
@@ -34,6 +35,7 @@ import mqq.app.IAccountCallback
 import mqq.app.MobileQQ
 import rj.qmce.lite.data.LoginPrefs
 import rj.qmce.lite.data.emotion.EmotionAssetBridge
+import rj.qmce.lite.data.emotion.EmotionRepository
 import rj.qmce.lite.data.reporting.OfficialReportBridge
 import rj.qmce.lite.data.update.OtaUpdateSession
 import rj.qmce.lite.kernel.KernelBridge
@@ -75,7 +77,8 @@ class QmceApplication : WatchApplicationDelegate(), SingletonImageLoader.Factory
                 Constants.LogoutReason.expired,
                 Constants.LogoutReason.suspend,
                 -> {
-                    if (isLoginTransitionSuppressing()) {
+                    // Only suppress during active login transition — not post-login grace.
+                    if (loginTransitionActive.get()) {
                         QmceLog.w(
                             "QMCE",
                             "account: suppress transitional logout reason=$reason " +
@@ -93,6 +96,11 @@ class QmceApplication : WatchApplicationDelegate(), SingletonImageLoader.Factory
 
     override fun newImageLoader(context: coil3.PlatformContext): ImageLoader {
         return ImageLoader.Builder(context)
+            .memoryCache {
+                MemoryCache.Builder()
+                    .maxSizePercent(context, 0.12)
+                    .build()
+            }
             .components {
                 add(GifDecoder.Factory())
                 add(OkHttpNetworkFetcherFactory())
@@ -307,6 +315,8 @@ class QmceApplication : WatchApplicationDelegate(), SingletonImageLoader.Factory
         }.onFailure {
             QmceLog.w("QMCE", "URLDrawable runtime unavailable; emotion fallback remains enabled", it)
         }
+        runCatching { EmotionRepository.warmupEmotionAssets() }
+            .onFailure { QmceLog.w("QMCE", "emotion assets warmup schedule failed", it) }
     }
 
     private fun isMainProcess(): Boolean {

app-new/src/main/assets/bigface_index.json

@@ -11,18 +11,15 @@ import java.util.zip.ZipInputStream
 /**
  * Installs the small system-emotion resource set that NT expects under filesDir.
  *
- * The official resource manager does not read these files from APK assets.  It only looks at
- * filesDir/qq_emoticon_res, so the bridge materializes the bundled config and lottie/static files
- * before the manager is initialized.  Existing downloaded resources are preserved.
+ * Bundles [face_config.json] and [emoji_res.zip] only. Animated system faces are served
+ * on-demand from [QFaceRemoteStore] instead of a packaged bigface/qlottie zip.
  */
 object EmotionAssetBridge {
     private const val TAG = "QMCE-EmotionAssets"
-    private const val VERSION = 7
+    private const val VERSION = 9
     private const val RESOURCE_DIR = "qq_emoticon_res"
     private const val CONFIG_ASSET = "face_config.json"
-    private const val ZIP_ASSET = "bigface.zip"
     private const val EMOJI_ZIP_ASSET = "emoji_res.zip"
-    private const val INDEX_ASSET = "bigface_index.json"
     private const val MARKER = ".qmce_emotion_assets_v$VERSION"
 
     @Volatile
@@ -35,7 +32,7 @@ object EmotionAssetBridge {
         synchronized(this) {
             applicationContext = context.applicationContext
             runCatching {
-                ensureLocked(context)
+                ensureLocked(context.applicationContext)
             }.onFailure {
                 Log.e(TAG, "emotion resource initialization failed", it)
             }
@@ -59,31 +56,26 @@ object EmotionAssetBridge {
 
     private fun ensureFiles(context: Context, resourceDir: File) {
         val bundledConfig = context.assets.open(CONFIG_ASSET).bufferedReader().use { it.readText() }
-        val bundledIndex = context.assets.open(INDEX_ASSET).bufferedReader().use { it.readText() }
-        val indexFile = File(resourceDir, INDEX_ASSET)
-        if (!indexFile.isFile || indexFile.readText() != bundledIndex) {
-            writeAtomically(indexFile, bundledIndex)
-        }
+        val animatedIds = QFaceRemoteStore.animatedIds().map(Int::toString)
         val mergedConfig = mergeConfig(
             existing = File(resourceDir, CONFIG_ASSET).takeIf { it.isFile }?.readText(),
             bundled = bundledConfig,
-            animatedIds = readAnimatedIds(bundledIndex),
+            animatedIds = animatedIds,
         )
         val configFile = File(resourceDir, CONFIG_ASSET)
         if (!configFile.isFile || configFile.readText() != mergedConfig) {
             writeAtomically(configFile, mergedConfig)
         }
 
         val marker = File(resourceDir, MARKER)
-        if (!marker.isFile || !hasBundledResource(resourceDir, bundledIndex, bundledConfig)) {
-            extractZipAsset(context, resourceDir, ZIP_ASSET)
-            extractZipAsset(context, resourceDir, EMOJI_ZIP_ASSET)
+        if (!marker.isFile || !hasStaticBundledResource(resourceDir, bundledConfig)) {
+            extractZipAssetDirect(context, resourceDir, EMOJI_ZIP_ASSET)
             writeAtomically(marker, "version=$VERSION\n")
         }
         Log.i(
             TAG,
             "emotion resources ready config=${configFile.length()} bytes " +
-                "animated=${readAnimatedIds(bundledIndex).size} dir=${resourceDir.absolutePath}",
+                "animated=${animatedIds.size} dir=${resourceDir.absolutePath}",
         )
     }
 
@@ -98,10 +90,7 @@ object EmotionAssetBridge {
         }.getOrNull()
     }
 
-    fun bundledAnimatedIds(): List<Int> = runCatching {
-        val index = resourceFile(INDEX_ASSET)?.takeIf(File::isFile)?.readText() ?: return@runCatching emptyList()
-        readAnimatedIds(index).mapNotNull(String::toIntOrNull).distinct()
-    }.getOrDefault(emptyList())
+    fun bundledAnimatedIds(): List<Int> = QFaceRemoteStore.animatedIds()
 
     private fun mergeConfig(
         existing: String?,
@@ -141,6 +130,7 @@ object EmotionAssetBridge {
         }
 
         animatedIds.forEach { id ->
+            val entry = QFaceRemoteStore.lookup(id)
             if (!itemIndexById.containsKey(id)) {
                 itemIndexById[id] = baseSysface.length()
                 baseSysface.put(
@@ -149,10 +139,19 @@ object EmotionAssetBridge {
                         put("IQLid", id)
                         put("AQLid", id)
                         put("EMCode", "10$id")
-                        put("QDes", "/大表情$id")
+                        put(
+                            "QDes",
+                            entry?.describe?.takeIf { it.isNotBlank() } ?: "/大表情$id",
+                        )
                         put("AniStickerType", 1)
-                        put("AniStickerPackId", "1")
-                        put("AniStickerId", id)
+                        put(
+                            "AniStickerPackId",
+                            entry?.aniStickerPackId?.takeIf { it > 0 }?.toString() ?: "1",
+                        )
+                        put(
+                            "AniStickerId",
+                            entry?.aniStickerId?.takeIf { it > 0 }?.toString() ?: id,
+                        )
                     },
                 )
             }
@@ -177,86 +176,40 @@ object EmotionAssetBridge {
         }
     }
 
-    private fun readAnimatedIds(indexJson: String): List<String> = runCatching {
-        val ids = JSONObject(indexJson).optJSONArray("ids") ?: return@runCatching emptyList()
-        buildList(ids.length()) {
-            for (index in 0 until ids.length()) {
-                ids.optString(index).takeIf(String::isNotBlank)?.let(::add)
-            }
-        }.distinct()
-    }.getOrDefault(emptyList())
-
-    private fun hasBundledResource(
+    private fun hasStaticBundledResource(
         resourceDir: File,
-        indexJson: String,
         bundledConfigJson: String,
     ): Boolean {
-        val indexIds = readAnimatedIds(indexJson)
-        val configIds = runCatching {
-            val sysface = JSONObject(bundledConfigJson).optJSONArray("sysface") ?: return@runCatching emptyList()
-            buildList {
-                for (index in 0 until sysface.length()) {
-                    val item = sysface.optJSONObject(index) ?: continue
-                    if (item.optInt("AniStickerType", 0) <= 0) continue
-                    item.optString("AniStickerId")
-                        .takeIf(String::isNotBlank)
-                        ?.let(::add)
-                }
-            }
-        }.getOrDefault(emptyList())
-        val animatedIds = (indexIds + configIds).distinct()
-        val animatedReady = animatedIds.isEmpty() || animatedIds.all { id ->
-            File(resourceDir, "qlottie/1/$id/$id.json").isFile
-        }
         val configReady = runCatching {
             JSONObject(bundledConfigJson).optJSONArray("sysface")?.length()?.let { it > 0 } == true &&
                 File(resourceDir, CONFIG_ASSET).isFile
         }.getOrDefault(false)
         val emojiReady = (0..164).all { index ->
             File(resourceDir, "emoji_res/emoji_${index.toString().padStart(3, '0')}.png").isFile
         }
-        return animatedReady && configReady && emojiReady
+        return configReady && emojiReady
     }
 
-    private fun extractZipAsset(context: Context, resourceDir: File, assetName: String) {
-        val stage = File(
-            resourceDir.parentFile,
-            ".${resourceDir.name}.qmce-stage-${System.nanoTime()}",
-        )
-        deleteRecursively(stage)
-        if (!stage.mkdirs()) error("cannot create ${stage.absolutePath}")
-
+    private fun extractZipAssetDirect(context: Context, resourceDir: File, assetName: String): Int {
         var extracted = 0
-        try {
-            context.assets.open(assetName).buffered().use { input ->
-                ZipInputStream(input).use { zip ->
-                    while (true) {
-                        val entry = zip.nextEntry ?: break
-                        val output = safeEntry(stage, entry.name)
-                        if (entry.isDirectory) {
-                            output.mkdirs()
-                        } else {
-                            output.parentFile?.mkdirs()
-                            output.outputStream().buffered().use { zip.copyTo(it) }
-                            extracted++
-                        }
-                        zip.closeEntry()
+        context.assets.open(assetName).buffered().use { input ->
+            ZipInputStream(input).use { zip ->
+                while (true) {
+                    val entry = zip.nextEntry ?: break
+                    if (entry.isDirectory) {
+                        safeEntry(resourceDir, entry.name).mkdirs()
+                    } else {
+                        val output = safeEntry(resourceDir, entry.name)
+                        output.parentFile?.mkdirs()
+                        output.outputStream().buffered().use { zip.copyTo(it) }
+                        extracted++
                     }
+                    zip.closeEntry()
                 }
             }
-
-            stage.walkTopDown()
-                .filter(File::isFile)
-                .forEach { source ->
-                    val relative = source.relativeTo(stage)
-                    val target = File(resourceDir, relative.path)
-                    target.parentFile?.mkdirs()
-                    source.copyTo(target, overwrite = true)
-                }
-            Log.i(TAG, "extracted $extracted bundled resources from $assetName")
-        } finally {
-            deleteRecursively(stage)
         }
+        Log.i(TAG, "extracted $extracted entries from $assetName -> ${resourceDir.absolutePath}")
+        return extracted
     }
 
     private fun safeEntry(root: File, entryName: String): File {
@@ -275,9 +228,4 @@ object EmotionAssetBridge {
             temporary.delete()
         }
     }
-
-    private fun deleteRecursively(file: File) {
-        if (!file.exists()) return
-        file.walkBottomUp().forEach { it.delete() }
-    }
 }