android app＞src＞main＞AndroidManifest.xml comment every line

xml 复制代码
<?xml version="1.0" encoding="utf-8"?>
<!-- XML文件声明：版本1.0，字符编码UTF-8，Android清单文件标准头部 -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 根标签manifest，Android命名空间绑定android官方schema地址，所有Android属性都依赖此命名空间 -->

    <!-- 网络权限：允许App访问互联网，发起HTTP/HTTPS网络请求 -->
    <uses-permission android:name="android.permission.INTERNET" />

    <!-- 外部存储写入权限：仅适配Android 12(SDK32)及更低版本 -->
    <!-- Android13及以上使用MediaStore媒体库API，不再需要该存储写入权限 -->
    <uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE"
        android:maxSdkVersion="32" />

    <!-- 网络状态访问权限：获取当前网络连接状态（Wi-Fi/移动数据/无网络），用于网络判断逻辑 -->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

    <!-- Wi-Fi状态权限：读取Wi-Fi开关、连接信息、信号强度等Wi-Fi相关数据 -->
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

    <!-- 唤醒锁权限：防止设备休眠锁屏，后台持续运行（下载、播放、推流等场景使用） -->
    <uses-permission android:name="android.permission.WAKE_LOCK" />

    <!-- 相机硬件权限：申请调用设备摄像头，拍照、扫码、视频采集功能必备 -->
    <uses-permission android:name="android.permission.CAMERA" />

    <!-- 声明设备摄像头硬件特性，required=false代表无摄像头设备也可安装本App -->
    <uses-feature
        android:name="android.hardware.camera"
        android:required="false" />

    <!-- 声明前置摄像头硬件特性，required=false代表无前置摄像头设备仍可正常安装运行 -->
    <uses-feature
        android:name="android.hardware.camera.front"
        android:required="false" />

    <!-- Android11(SDK30)及以上应用包可见性规则：<queries>声明需要查询的外部应用/服务 -->
    <!-- 系统仅允许查询清单中声明的Intent组件，未声明则无法发现对应第三方服务 -->
    <!-- 此处用于检索系统TTS文字转语音引擎服务，实现朗读语音功能 -->
    <queries>
        <!-- 定义要检索的Intent行为：TTS_SERVICE 文字转语音服务 -->
        
    </queries>

    <!-- application根节点：全局配置当前应用所有组件、基础属性、全局设置 -->
    <application
        <!-- 允许系统自动备份应用数据（设置-备份中可开启，包含本地偏好、数据库等） -->
        android:allowBackup="true"
        <!-- 应用桌面图标，引用mipmap目录下ic_launcher资源 -->
        android:icon="@mipmap/ic_launcher"
        <!-- 应用显示名称，引用strings.xml内app_name字符串 -->
        android:label="@string/app_name"
        <!-- 网络安全配置文件，路径res/xml/network_security_config.xml，管控HTTPS证书、明文域名等 -->
        android:networkSecurityConfig="@xml/network_security_config"
        <!-- 圆形桌面图标，适配原生圆形图标桌面样式 -->
        android:roundIcon="@mipmap/ic_launcher_round"
        <!-- 支持RTL从右到左布局（阿拉伯、希伯来等文字语言适配） -->
        android:supportsRtl="true"
        <!-- 全局应用主题，引用自定义Theme.FlaypSignage样式 -->
        android:theme="@style/Theme.FlaypSignage"
        <!-- 允许明文HTTP流量（不加密网络请求），生产环境建议关闭，仅内网调试使用 -->
        android:usesCleartextTraffic="true">

        <!-- 主页面Activity：程序入口页面MainActivity -->
        <activity
            <!-- 当前Activity完整类名，当前包下MainActivity -->
            android:name=".MainActivity"
            <!-- exported=true：允许系统、外部应用启动该页面，桌面启动页必须开启 -->
            android:exported="true"
            <!-- 屏幕方向：sensor跟随设备物理传感器，横竖屏自动切换 -->
            android:screenOrientation="sensor">
            <!-- Intent过滤器：定义页面可接收的启动意图，作为桌面启动入口 -->
            <intent-filter>
                <!-- Main标识：应用主入口动作 -->
                <action android:name="android.intent.action.MAIN" />
                <!-- LAUNCHER分类：系统桌面会识别该Activity并创建桌面图标 -->
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>