Notifee项目中Android前台服务类型被覆盖的问题解析

问题背景

在使用Notifee库实现Android前台通知时，开发者可能会遇到一个奇怪的现象：在开发环境中正常工作的foregroundServiceType参数（如设置为specialUse类型），在构建生产APK时会被意外重置为默认值shortService，导致应用因权限缺失而崩溃。

问题重现与诊断

通过创建一个最小化的Expo测试项目，开发者可以重现该问题。关键现象表现为：

1. 开发环境（使用npx expo run:android）下前台通知工作正常
2. 生产构建（使用eas build -p android --profile preview --local）后服务类型被重置
3. 移除.gitignore中的android目录后问题消失

根本原因分析

经过深入调查，发现问题源于EAS构建工具的特殊处理机制：

1. 当使用eas build --local命令时，构建系统会复制项目文件，但会忽略.gitignore中列出的目录
2. android目录通常被包含在.gitignore中
3. 由于android目录未被复制，构建过程中生成的AndroidManifest.xml文件会使用默认配置
4. 手动修改的前台服务类型(foregroundServiceType)因此丢失

解决方案

针对这一问题，开发者可以采用以下两种解决方案：

方案一：使用.easignore文件

1. 在项目根目录创建.easignore文件
2. 确保该文件中不包含android目录
3. 这样构建时android目录及其修改会被保留

方案二：通过Android Studio构建

直接使用Android Studio进行APK构建可以避免EAS构建工具的文件过滤问题，确保所有修改都能正确应用到最终产物中。

最佳实践建议

1. 对于Expo项目，建议同时维护.gitignore和.easignore文件
2. 重要的Android原生配置修改应在两个ignore文件中保持一致
3. 构建前检查临时构建目录，确认所有必要文件都被正确包含
4. 对于关键的原生配置，考虑通过config-plugin实现，而非直接修改原生文件

总结

这个问题展示了混合开发框架中一个典型的"开发与构建环境差异"案例。理解构建工具的文件处理逻辑对于解决这类问题至关重要。通过正确配置ignore文件或选择合适的构建方式，开发者可以确保Notifee的前台服务配置在生产环境中按预期工作。