目录

• 一、速查模板
• 二、文件结构概览
• 三、高频主要属性详解
• 四、根元素
• 五、 应用元素
• 六、四大组件
• 七、意图过滤器与程序常量
• 八、权限相关
• 九、功能与 SDK 声明
• 十、辅助元素
• 十一、屏幕兼容
• 十二、版本里程碑速查
• 十三、避坑教程与常用方法
• 附录 A：属性字母序索引

一、速查模板

标准应用骨架

启动器 Activity









深链接 / App Links Activity 
















前台 Service 



 // 是否随所属任务一起结束，默认 true。若设置 false，则即使所属任务结束也会继续运行。

/>


FileProvider 

 //如果你不需要共享文件。请删除此 Provider 元素，以减少潜在攻击面。/* 此处可以自定义你的 FileProvider 子类 */
// 如果你有自己的 FileProvider 实现。例如 MyCustomFileProvider，// 请把 .MyCustomFileProvider 替换进去，并确保对应类已实现所需功能。/* 如果你的项目中已经集成了第三方库提供的 Provider。且该 Provider 已经满足需求，则可以直接引用而无需
声明。*/
/* 在 meta-data 中指定 file_paths.xml，用于描述哪些方法可以被共享 */
/* 确保 file_paths.xml 文件已放置在 res/xml/ 目录下 */
/* 若你的方法配置不同，请自行修改 resource 引用 */


静态广播接收器 




应用可见性查询（targetSdk≥30 必加。否则 PackageManager 查不到目标应用) 

二、文件结构概览 









<attribution />


<application>

<activity>
<intent-filter>
<action />
<category />
<data />
&三、高频主要属性详解


: 所有含 Intent Filter 的 Component 必须显式声明
: foregroundServiceType 与对应 permission 必须匹配
: debug,backup,exported,permission 等属性务必审慎配置


1️⃣  : 控制是否能被外部调用 | S+ 强制要求明确值 | 不设置导致编译错误或运行时安装失败。

①  **作用**   : 定义该 Component 是否能够被 **其他应用** 启动 / 绑定 / 广播触发。

②  **为何关键**  : 从 **Android 12 ** 开始，所有拥有 `` 的 `Activity`/`Service`/`Receiver` **必须显式提供 `android:exported`**。缺失会导致这方面，


`Apps targeting Android 12 require attribute ...` 编译错误。*解决办法*: 在 Manifest 中补全 `exported=true|false`。
*若不设置*,打包后 Android 程序会抛出 `INSTALL_PARSE_FAILED_MANIFEST_MALFORMED` 错误阻止安装。
按理说，*安全隐患*: 未正确限制 `exported=true` 将导致恶意 App 任意启动或绑定你的组件。引发信息泄漏或执行未授权操作。


③  **取值规则** ：
`FileProvider ` t d> `false`
 .

⚠ 常见踩坑：

• 忘记为含 Intent‑filter 的 Activity 设置 exported→编译报错.
• 为所有 Component 随意设 true→暴露过多入口。增大攻击面.
• 未同步 `foregroundServiceType + 权限`,导致 Foreground Service 启动失败.
<\/ ul>
<\/ t h>



场景 
推荐值

`Launcher Activity ` 
`true` 

`内部页面跳转` 
`false` 

`Deep Link / App Link Activity ` 
`true` 

`System Broadcast Receiver ` 
`true ` 

`内部 Service ` `false` t d>


*安全建议*: 默认倾向 **false**,若确实需要公开请配合 `` 或 runtime 检查进行细粒度控制。
{% raw %}{{% endraw %}}
;;;<# attr export />
{# attr export}

">


属性名称;，;，;，;，;，;
#attr-launchmode #attr-launchmode #attr-launchmode #attr-launchmode #attr-launchmode #attr-launchmode #attr-launchmode #attr-launchmode #attr-launchmode #attr-launchmode #attr-launch mode;