app_security_lock

迁移到 Flutter Built-in Kotlin

• Android：迁移到 Flutter Built-in Kotlin，消除 “plugins that apply Kotlin Gradle Plugin (KGP)” 警告。 AGP < 9 或 android.builtInKotlin=false 时仍应用 KGP（org.jetbrains.kotlin.android）以兼容旧工程；AGP 9+ 开启内置 Kotlin 时不再 apply KGP。 kotlinOptions 改为通过 KotlinAndroidProjectExtension.compilerOptions 设置 JVM target，避免无 Kotlin 扩展时出现 Could not find method kotlin()；Kotlin 升级到 2.1.0。 参考：https://docs.flutter.dev/release/breaking-changes/migrate-to-built-in-kotlin/for-plugin-authors

• iOS：修复 Package.swift 里 target 的 path 指向包根目录之外，导致 flutter run/构建报错 target 'app_security_lock' in package 'app_security_lock-0.3.5' is outside the package root （启用了 Swift Package Manager 的 Flutter 工程会直接构建失败）
• iOS：Swift 源码统一移到 ios/app_security_lock/Sources/app_security_lock/，CocoaPods 的 podspec 和 SPM 的 Package.swift 现在共用同一份源码，不再各自维护一份
• iOS：修复 Package.swift 里 library product 命名错误（沿用 Dart 包名 app_security_lock 下划线），导致构建报错 product 'app-security-lock' required by package 'fluttergeneratedpluginswiftpackage' ... not found in package 'app_security_lock'。 Flutter 生成的 FlutterGeneratedPluginSwiftPackage 按「下划线转短横线」的约定引用各插件的 product， 现在改成 app-security-lock（短横线）

• iOS：修复从多任务清理应用时崩溃（deinit 中调用带 [weak self] 的截屏保护清理会触发 objc_fatal）
• iOS：进程退出时改为同步释放截屏保护引用，不再恢复 layer

• iOS：开启截屏/录屏防护不再立刻弹遮罩；平时界面保持正常
• iOS 截屏：secure UITextField 静默保护，相册截图显示与录屏一致的暗色模糊 + warningMessage 占位（应用内不弹层）
• iOS 录屏：录屏/镜像进行中显示全屏 warningMessage 遮罩
• Android：FLAG_SECURE 同时拦截截屏与录屏
• 文档与示例文案更新为「禁止截屏/录屏」

修复了一些问题

. 修复 deinit 中的崩溃问题 问题原因： 在 deinit 中调用 setScreenRecordingProtectionEnabled(false) 会触发异步操作 showSecurityOverlay() 和 hideSecurityOverlay() 使用了 DispatchQueue.main.async { [weak self] } 对象正在释放时，weak 引用可能失效，导致崩溃 修复方案： 在 deinit 中直接同步清理资源，不再调用可能触发异步操作的方法 直接同步移除安全覆盖视图，不使用异步操作 直接移除观察者，避免调用其他方法 2. 优化异步操作 将 showSecurityOverlay() 和 hideSecurityOverlay() 拆分为同步和异步版本 添加 performShowSecurityOverlay() 和 performHideSecurityOverlay() 方法，确保在主线程执行 在正常使用时使用异步，在 deinit 中使用同步清理 3. 修复观察者重复注册问题 移除了 setupScreenRecordingProtection() 中重复的 willEnterForegroundNotification 观察者 在 onEnterForeground() 中检查录屏状态，避免重复注册 确保观察者的添加和移除成对出现

关键修复

应用后台清理崩溃问题修复

本版本修复了一个严重的稳定性问题：当用户手动从最近任务列表中清理应用时，系统会错误地提示应用已崩溃。

修复内容

Android 平台修复

• Flutter 引擎销毁异常处理: 在 invokeMethod() 中添加双层异常捕获，防止 Flutter 引擎销毁后尝试通信导致的崩溃
• 完善资源清理: 在 onActivityDestroyed() 中添加完整的定时器和监听器清理逻辑
• 增强插件分离清理: 改进 onDetachedFromEngine() 的资源清理流程，安全处理生命周期回调注销
• 强化计时器清理: 对所有计时器清理方法添加异常捕获，包括后台超时和触摸超时
• 屏幕状态监听器: 改进广播接收器的清理，正确处理 IllegalArgumentException

iOS 平台修复

• 安全方法调用: 添加 safeInvokeMethod() 包装器，防止在插件销毁时调用已释放的方法通道
• 通知观察者清理: 强化 deinit 方法，分别注销各个通知观察者避免竞态条件
• UI 元素引用清理: 清空所有 UI 元素引用，包括手势识别器和覆盖视图
• 方法调用安全: 将所有 lifecycleChannel?.invokeMethod() 调用替换为安全调用

⚡ 稳定性改进

• 异常容错: 所有可能产生异常的操作都添加了 try-catch 保护
• 内存泄漏防护: 确保所有定时器、监听器和引用在适当时机被正确清理
• 竞态条件处理: 处理多线程环境下的资源清理竞态条件

测试建议

为验证修复效果，请按以下步骤测试：

1. Android 测试: 启用后台锁定功能 → 将应用发送到后台 → 从最近任务列表滑动清除应用 → 验证不出现崩溃提示
2. iOS 测试: 启用后台锁定和触摸超时 → 将应用发送到后台 → 从任务列表向上滑动移除应用 → 验证不出现崩溃
3. Debug 验证: 在 init() 时传入 debug: true，通过原生日志查看清理过程

屏幕录制防护功能

本版本新增了强大的屏幕录制防护功能，确保应用内容不被非法录屏。

新特性

• 屏幕录制防护: 禁止对应用进行屏幕录制
• 自定义警告文本: 支持自定义录屏时显示的警告提示文本 仅限IOS
• iOS 模糊覆盖视图: 检测到录屏时显示带有模糊效果的安全覆盖层
• Android FLAG_SECURE: 使用系统级别的FLAG_SECURE标志禁止屏幕录制

平台实现

iOS

• 监听屏幕录制状态变化通知 (UIScreen.capturedDidChangeNotification)
• 检测到录屏时显示模糊效果的安全覆盖视图
• 覆盖视图上显示自定义的警告文本
• 拦截所有触摸事件防止操作被录制

Android

• 使用 WindowManager.LayoutParams.FLAG_SECURE 标志禁止屏幕录制
• 防止应用内容在屏幕录制中出现

新增 API

// 启用/禁用录屏防护，支持自定义警告文本
Future<AppSecurityLock> screenRecordingProtectionEnabled(
  bool enabled, {
  String? warningMessage,
})

使用示例

// 启用录屏防护并显示自定义文本
await lock.screenRecordingProtectionEnabled(
  true,
  warningMessage: '检测到屏幕录制，该操作已被阻止',
);

// 禁用录屏防护
await lock.screenRecordingProtectionEnabled(false);

// 也可以使用链式调用
await lock.screenRecordingProtectionEnabled(
  true,
  warningMessage: '屏幕正在被录制',
);

API 重构 & 链式调用支持

本版本对 API 进行了全面重构，提供更简洁、更直观的使用方式。

新特性

• 链式调用支持: 所有方法现在支持链式调用，代码更简洁
• 锁定原因回调: onLock 回调现在包含 LockReason 参数，可以知道是什么导致了锁定
• 新增 LockReason 枚举:
  • LockReason.screenLock - 设备屏幕锁定
  • LockReason.backgroundTimeout - 后台超时
  • LockReason.touchTimeout - 触摸超时（无操作超时）
  • LockReason.unknown - 未知原因

API 变更

使用示例

// 新的链式调用方式
final lock = AppSecurityLock()
  ..onLock((reason) {
    print('应用已锁定，原因: ${reason.name}');
    // reason: screenLock / backgroundTimeout / touchTimeout / unknown
  })
  ..onUnlock(() => print('请解锁应用'))
  ..onForeground(() => print('进入前台'))
  ..onBackground(() => print('进入后台'));

await lock.init(
  isScreenLockEnabled: true,
  isBackgroundLockEnabled: true,
  backgroundTimeout: 30.0,
);

向后兼容

• 旧 API 仍然可用，但已标记为 @Deprecated
• 建议尽快迁移到新 API

新增debug倒计时

降级示例代码的SDK版本，删除测试文件

降级flutter 版本和dart版本要求，以适配老项目

Debug Logging Enhancement

• New Debug Field: Added debug parameter to control log output for better development experience
• Configurable Logging: Developers can now enable/disable plugin logs based on debug mode
• Development Support: Enhanced debugging capabilities for easier troubleshooting during development

New Features

• Debug Control: New debug field parameter to toggle log output
• Conditional Logging: Logs are now shown only when debug mode is enabled
• Developer Experience: Improved debugging workflow with controllable log verbosity
• Production Ready: Clean log output in production builds when debug is disabled

Technical Improvements

• Added debug parameter support across all platform implementations
• Enhanced logging system with conditional output
• Improved development workflow with debug controls
• Optimized log management for production builds

修复ios 构建错误

添加安卓缺失的括号

Enhanced iOS Screen Lock Detection

• Improved Production Reliability: Fixed iOS screen lock detection not working in production builds
• Native iOS Notification System: Replaced unreliable brightness detection with system-level protectedData notifications
• Superior Lock Detection: Uses UIApplication.protectedDataWillBecomeUnavailableNotification and protectedDataDidBecomeAvailableNotification for accurate screen lock events
• Production-Ready: Eliminates brightness threshold issues that caused failures in release builds

iOS Implementation Changes

• New Lock Detection Method: Implemented protectedData notification observers for reliable screen lock detection
• Removed Brightness Detection: Completely removed unreliable brightness-based screen lock detection
• System-Level Integration: Uses iOS native notification center for optimal performance
• Production Build Compatible: Resolves screen lock detection failures in production/release builds

Technical Improvements

• Added screenLocked() and screenUnlocked() callback methods
• Enhanced startListen() method with protectedData notification observers
• Cleaned up brightness timer and related detection methods
• Improved iOS app lifecycle integration
• Optimized notification center observer management

Bug Fixes

• Fixed screen lock detection not working in iOS production builds
• Resolved brightness threshold reliability issues
• Improved app state monitoring accuracy
• Enhanced notification system performance

Touch Timeout Lock Feature

• New Touch Timeout Functionality: Added touch event monitoring with configurable timeout lock
• Cross-Platform Touch Detection: Implemented touch event listeners for both iOS and Android
• Gesture Recognition System: iOS uses UITapGestureRecognizer and UIPanGestureRecognizer for comprehensive touch detection
• Configurable Touch Timeout: Support for custom touch timeout duration and enable/disable state
• Touch Timer Management: Smart touch timer restart mechanism with infinite loop prevention
• Enhanced Security: App automatically locks after period of user inactivity

New APIs

• setTouchTimeoutEnabled(bool enabled) - Enable/disable touch timeout functionality
• setTouchTimeout(double timeoutSeconds) - Configure touch timeout duration
• restartTouchTimer() - Manual restart of touch timeout timer
• Support for touch timeout parameters in init() method

Platform Updates

• iOS: Comprehensive gesture recognizer implementation with UIWindow-based touch detection
• Android: Touch timeout timer management with Handler and Runnable
• iOS: Upgraded minimum version to iOS 13.0 for enhanced functionality
• Fixed infinite loop issues in touch event listener setup
• Improved touch timer lifecycle management

Bug Fixes

• Fixed touch event listener infinite loop during screen interactions
• Resolved touch timer not restarting properly after unlock
• Fixed touch event listeners not being set up correctly on init
• Improved touch timer state management during app lifecycle changes

Swift Package Manager Support

• Added Swift Package Manager Support: Package now supports iOS Swift Package Manager
• Full pub.dev Score Compliance: Added ios/app_security_lock/Package.swift for complete pub.dev compatibility
• Future-proof iOS Integration: Ensures maximum compatibility with modern iOS development workflows

Changes

• Added Package.swift file for Swift Package Manager support
• Configured iOS platform minimum version (iOS 11.0+)
• Enhanced pub.dev scoring compliance
• Improved iOS integration options for developers

Improvements & Bug Fixes

• Enhanced Documentation: Improved README with better usage examples and API documentation
• Better pub.dev Score: Optimized package metadata for higher pub.dev analysis score
• Improved Example App: Enhanced example app with better UI and event logging
• Test Coverage: Fixed and improved unit tests for better reliability
• Code Quality: Resolved all dart analyze warnings and issues
• Repository Links: Added proper repository, issue tracker, and documentation URLs

Changes

• Updated pubspec.yaml with complete repository information
• Enhanced CHANGELOG with detailed release notes
• Improved example app UI with event logs display
• Fixed all dart analyze issues (0 warnings)
• Updated test files to match current API
• Better error handling and code documentation

Initial Release

• Screen Lock Detection: Monitor when device screen is locked/unlocked
• Background Timeout: Automatically lock app when backgrounded for specified duration
• Lifecycle Monitoring: Track app lifecycle events (foreground/background)
• Biometric Authentication: Support for fingerprint and face recognition
• Cross-platform Support: Works on both iOS and Android
• Configurable Settings: Customizable timeout periods and feature toggles

Features

• Screen lock/unlock detection
• Background timeout with configurable duration
• Application lifecycle monitoring
• Biometric authentication integration
• iOS and Android platform support
• Easy integration with existing Flutter apps

Platform Support

• iOS: iOS 11.0 or later
• Android: API level 21 (Android 5.0) or later