Cocos引擎中AGDK/GameActivity导致的ANR问题分析与解决方案

背景介绍

在Cocos Creator 3.6.x及以上版本中，引擎开始采用Google的AGDK/GameActivity框架来优化Android平台的应用性能。该框架理论上能够显著降低应用无响应(ANR)的发生概率。然而，在实际产品开发和使用过程中，许多开发者发现即使基于3.7.x引擎版本发布的产品，在Google Play上仍然存在较高的ANR率。

问题现象

通过分析ANR日志，发现大量ANR问题发生在GameActivity.onPauseNative方法中，特别是在游戏前后台切换时表现尤为明显。进一步追踪发现，问题根源在于android_native_app_glue.c文件中使用的pthread_cond_timedwait函数。

技术分析

在Android应用的Activity生命周期管理中，当应用从前台切换到后台时，系统会调用onPause()方法。在AGDK/GameActivity的实现中，这个操作会触发一个同步等待机制：

static void android_app_set_activity_state(struct android_app* android_app,
                                           int8_t cmd) {
    pthread_mutex_lock(&android_app->mutex);
    android_app_write_cmd(android_app, cmd);
    while (android_app->activityState != cmd) {
        pthread_cond_wait(&android_app->cond, &android_app->mutex);
    }
    pthread_mutex_unlock(&android_app->mutex);
}

这段代码的问题在于：

1. 使用了阻塞式的同步等待机制
2. 在主线程中执行可能导致线程挂起
3. 当系统资源紧张时，容易触发ANR

解决方案

针对这一问题，我们设计了一个基于栈的状态管理机制来替代原有的同步等待方式。核心思路是将状态变更请求存入栈中，由主线程在合适时机异步处理，避免直接阻塞。

关键实现

1. 定义状态栈结构：

#define HH_STACK_SIZE 32
typedef struct HH_Stack {
    int top;
    int data[HH_STACK_SIZE];
    pthread_mutex_t lock;
} HH_Stack;

2. 栈操作函数： 实现了完整的栈操作函数，包括初始化、压栈、弹栈等，所有操作都通过互斥锁保证线程安全。

3. 修改状态处理流程：

static void process_cmd(struct android_app* app,
                        struct android_poll_source* source) {
    int val = HH_pop(app->stateStack);
    if (val >= 0){
        if (app->onAppCmd != NULL) {
            app->onAppCmd(app, val);
        }
        return;
    }
    // 原有处理逻辑...
}

4. 修改onPause实现：

static void onPause(GameActivity* activity) {
    struct HH_Stack *stateStack = ToApp(activity)->stateStack;
    HH_push(stateStack, APP_CMD_PAUSE);
    LOGV("Pause: %p", activity);
}

优化效果

在实际产品中应用该解决方案后，ANR率显著降低至原来的三分之一左右。这一改进特别针对以下场景效果明显：

• 频繁的前后台切换
• 系统资源紧张时的状态变更
• 多线程环境下的状态同步

技术总结

该解决方案的核心优势在于：

1. 将同步阻塞改为异步处理，避免主线程挂起
2. 通过栈结构保证状态变更的顺序性
3. 线程安全的实现方式确保多线程环境下的稳定性
4. 对原有代码改动小，风险可控

这种设计模式不仅适用于解决当前的ANR问题，也为类似的状态同步问题提供了参考方案。开发者可以根据实际需求调整栈大小和处理策略，以获得最佳的性能表现。