Android应用中实现“游戏循环”的正确姿势：避免UI线程阻塞

public class MainActivity extends AppCompatActivity {

    Boolean running = true;
    public int years = 0;
    TextView textView; // 声明但未初始化
    ImageButton button; // 声明但未初始化

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 错误的初始化方式：findViewById在布局未完全加载前可能返回null
        // textView = (TextView) findViewById(R.id.year_counter);
        // button = (ImageButton) findViewById(R.id.advance);

        // 游戏循环？
        while (running) {
            // advance(); // 即使这里能执行，也是重复设置监听器，且阻塞UI
        }
    }

    // 错误的advance方法：在循环中重复设置监听器是无效的
    public void advance() {
        // ImageButton button = (ImageButton) findViewById(R.id.advance); // 每次调用都查找一次，效率低下
        // button.setOnClickListener(new View.OnClickListener() {
        //     @Override
        //     public void onClick(View view) {
        //         years += 1;
        //         textView.setText("" + years + "");
        //     }
        // });
    }
}

import android.os.Bundle;
import android.view.View;
import android.widget.ImageButton;
import android.widget.TextView;

import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {

    // 声明视图组件变量和游戏状态变量
    private TextView yearCounterTextView;
    private ImageButton advanceButton;
    private int years = 0; // 初始化年份为0

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main); // 设置Activity的布局

        // 1. 在布局设置完成后，初始化所有视图组件
        setupViews();

        // 2. 设置所有事件监听器，只设置一次
        setupClickEvents();

        // 首次加载时，更新TextView显示初始年份
        yearCounterTextView.setText(String.valueOf(years));
    }

    /**
     * 负责查找并初始化所有UI视图组件。
     * 确保在调用findViewById之前，布局已经通过setContentView加载。
     */
    private void setupViews() {
        yearCounterTextView = findViewById(R.id.year_counter); // 通过ID找到TextView
        advanceButton = findViewById(R.id.advance);       // 通过ID找到ImageButton
    }

    /**
     * 负责为所有可交互的UI组件设置事件监听器。
     * 监听器只需设置一次，当事件发生时，其内部的回调方法会被执行。
     */
    private void setupClickEvents() {
        advanceButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                // 当“前进”按钮被点击时，执行以下逻辑
                years += 1; // 增加年份计数
                // 更新TextView以显示新的年份值
                // 注意：setText方法接收CharSequence，String.valueOf(int) 是推荐方式
                yearCounterTextView.setText(String.valueOf(years));
                // 如果有其他需要触发的“游戏逻辑”或UI更新，也应在这里调用
            }
        });
    }

    // 如果R.id.year_counter 和 R.id.advance 是在XML布局文件（例如 activity_main.xml）中定义的，
    // 示例XML布局片段可能如下：
    /*
    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        android:gravity="center">

        <TextView
            android:id="@+id/year_counter"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="0"
            android:textSize="48sp"
            android:padding="16dp"/>

        <ImageButton
            android:id="@+id/advance"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:src="@android:drawable/ic_media_next"
            android:contentDescription="Advance Year"
            android:padding="16dp"/>

    </LinearLayout>
    */
}

import android.os.Bundle;
import android.os.Handler;
import android.os.Looper;
import android.util.Log;
import android.view.View;
import android.widget.ImageButton;
import android.widget.TextView;

import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {

    private TextView yearCounterTextView;
    private ImageButton advanceButton;
    private int years = 0;

    // 用于调度周期性任务的Handler
    private Handler gameLoopHandler = new Handler(Looper.getMainLooper());
    // 周期性任务的Runnable
    private Runnable gameLoopRunnable = new Runnable() {
        @Override
        public void run() {
            // 在这里执行周期性更新逻辑，例如更新动画帧、游戏状态等
            // 注意：这里仍然在主线程，不要执行耗时操作
            Log.d("GameLoop", "Performing periodic update...");
            // 示例：每隔5秒自动增加年份
            // years += 1;
            // yearCounterTextView.setText(String.valueOf(years));

            // 再次调度自身，实现循环
            gameLoopHandler.postDelayed(this, 5000); // 每5秒执行一次
        }
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        setupViews();
        setupClickEvents();
        yearCounterTextView.setText(String.valueOf(years));
    }

    @Override
    protected void onResume() {
        super.onResume();
        // 在Activity可见时启动周期性任务
        // 首次立即执行，然后每隔5秒执行一次
        // gameLoopHandler.post(gameLoopRunnable);
        // 或者首次延迟5秒执行
        // gameLoopHandler.postDelayed(gameLoopRunnable, 5000);
    }

    @Override
    protected void onPause() {
        super.onPause();
        // 在Activity不可见时停止周期性任务，避免资源浪费和内存泄漏
        gameLoopHandler.removeCallbacks(gameLoopRunnable);
    }

    private void setupViews() {
        yearCounterTextView = findViewById(R.id.year_counter);
        advanceButton = findViewById(R.id.advance);
    }

    private void setupClickEvents() {
        advanceButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                years += 1;
                yearCounterTextView.setText(String.valueOf(years));
            }
        });
    }
}