Vue+Capacitor应用如何正确配置Android原生设置避免被构建覆盖？

使用Vue+Capacitor技术栈开发跨Web/Android端应用时，直接修改BridgeActivity源码添加屏幕常亮等原生逻辑，会在构建时被覆盖，需要找到正确的原生代码修改方式。
已知直接在自动生成的BridgeActivity的onCreate方法中添加如下代码可以实现屏幕常亮，但修改会丢失：

getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);

当前项目默认的MainActivity仅继承BridgeActivity，无自定义逻辑：

import com.getcapacitor.BridgeActivity;
public class MainActivity extends BridgeActivity {}

认知纠正 #

你遇到代码被覆盖的核心原因是修改了错误的文件：
BridgeActivity是Capacitor依赖包中提供的父类，属于第三方依赖代码，和node_modules中的前端依赖一样，构建、同步依赖时会被重新覆盖，本身就不应该直接修改。
Capacitor永远不会覆盖你在android/app/src/main/路径下编写的自有业务代码，包括你项目自己的MainActivity文件。

屏幕常亮功能正确实现方式 #

直接在你项目自带的MainActivity中重写onCreate生命周期方法，添加自定义逻辑即可，修改永久生效：

• 打开路径android/app/src/main/java/[你的应用包名]/MainActivity.java
• 补充导入语句、重写onCreate方法，完整代码如下：

import android.os.Bundle;
import android.view.WindowManager;
import com.getcapacitor.BridgeActivity;

public class MainActivity extends BridgeActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // 必须首先调用父类onCreate，保证Capacitor桥接逻辑正常初始化
        super.onCreate(savedInstanceState);
        // 添加屏幕常亮标记
        getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
    }
}

• 执行npx cap sync android同步变更，之后重新构建应用即可生效。

重写onCreate方法时必须第一行调用super.onCreate(savedInstanceState)，否则会破坏Capacitor桥接初始化逻辑，导致应用闪退、功能异常。

Capacitor原生开发通用规则 #

• 所有自定义原生逻辑都写在android/app模块的自有代码路径下，禁止修改Capacitor依赖包内的源码、构建生成的临时文件
• 通用系统能力优先使用官方或社区维护的Capacitor插件实现，减少自定义原生代码维护成本
• 如果需要实现Web层（Vue代码）和原生层的双向通信，不要直接在Activity中写耦合逻辑，按照Capacitor规范封装自定义插件，通过官方桥接接口完成通信
• 日常开发中执行npx cap sync只会同步依赖、更新Web资源包，不会删除你编写的原生业务代码，不要随意重新执行npx cap add android重建平台目录，否则确实可能丢失原生修改。

内容的提问来源于stack exchange，提问作者Ezechiel2k