<?xml version="1.0" encoding="utf-8"?>
<!-- AndroidManifest.xml 是每个 Android 应用的核心配置文件，
     用于声明应用的组件、权限、配置信息以及与系统的交互方式 -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp">

    <!-- 声明应用兼容的 SDK 版本范围 -->
    <uses-sdk
        android:minSdkVersion="21"
        android:targetSdkVersion="33"
        android:maxSdkVersion="33" />

    <!-- 声明应用期望的设备配置 -->
    <uses-configuration
        android:reqFiveWayNav="false"
        android:reqHardKeyboard="false"
        android:reqKeyboardType="nokeys"
        android:reqNavigation="nonav"
        android:reqTouchScreen="finger" />

    <!-- 声明应用需要的硬件或软件特性 -->
    <uses-feature
        android:name="android.hardware.camera"
        android:required="true" />

    <!-- 请求应用运行所需的权限 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.CAMERA" />

    <!-- 自定义权限定义，用于保护应用组件 -->
    <permission
        android:name="com.example.myapp.MY_PERMISSION"
        android:label="string:permission_label"
        android:description="string:permission_desc"
        android:protectionLevel="normal" />

    <!-- 权限树定义，用于组织相关权限组 -->
    <permission-tree
        android:name="com.example.myapp.permission_tree"
        android:label="string:permission_tree_label" />

    <!-- 权限组定义，用于对权限进行逻辑分组 -->
    <permission-group
        android:name="com.example.myapp.permission_group"
        android:label="string:permission_group_label"
        android:description="string:permission_group_desc" />

    <!-- 声明测试工具类，用于自动化测试 -->
    <instrumentation
        android:name="androidx.test.runner.AndroidJUnitRunner"
        android:targetPackage="com.example.myapp" />

    <!-- 声明应用支持的屏幕尺寸和密度 -->
    <supports-screens
        android:resizeable="true"
        android:smallScreens="true"
        android:normalScreens="true"
        android:largeScreens="true"
        android:xlargeScreens="true"
        android:anyDensity="true" />

    <!-- 应用定义标签，包含应用的全局属性和组件 -->
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">

        <!-- Activity 组件声明，用于提供用户界面 -->
        <activity
            android:name=".MainActivity"
            android:label="@string/app_name"
            android:exported="true">
            <!-- Intent Filter 定义 Activity 可以响应的 Intent 类型 -->
            <intent-filter>
                <!-- 声明此 Activity 可以作为应用入口点 -->
                <action android:name="android.intent.action.MAIN" />
                <!-- 声明此 Activity 应显示在应用启动器中 -->
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <!-- Activity 别名声明，用于为现有 Activity 提供替代入口 -->
        <activity-alias
            android:name=".MainActivityAlias"
            android:targetActivity=".MainActivity"
            android:enabled="true"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <!-- 元数据定义，用于存储额外配置信息 -->
            <meta-data
                android:name="additional_info"
                android:value="alias_info" />
        </activity-alias>

        <!-- Service 组件声明，用于在后台执行操作 -->
        <service
            android:name=".MyService"
            android:enabled="true"
            android:exported="false">
            <intent-filter>
                <action android:name="com.example.myapp.MY_SERVICE" />
            </intent-filter>
            <meta-data
                android:name="service_config"
                android:value="config_value" />
        </service>

        <!-- BroadcastReceiver 组件声明，用于监听系统或应用事件 -->
        <receiver
            android:name=".MyReceiver"
            android:enabled="true"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.BOOT_COMPLETED" />
            </intent-filter>
            <meta-data
                android:name="receiver_data"
                android:value="data_value" />
        </receiver>

        <!-- ContentProvider 组件声明，用于跨应用共享数据 -->
        <provider
            android:name=".MyContentProvider"
            android:authorities="com.example.myapp.provider"
            android:enabled="true"
            android:exported="false">
            <!-- 声明允许访问的 URI 权限 -->
            <grant-uri-permission
                android:path="/data"
                android:pathPattern="/.*"
                android:pathPrefix="/images" />
            <meta-data
                android:name="provider_info"
                android:value="provider_value" />
        </provider>

        <!-- 声明应用需要链接的共享库 -->
        <uses-library
            android:name="android.test.runner"
            android:required="true" />
    </application>
</manifest>