MyNote Mobile
MyNote Client 的 Flutter 移动端项目，支持 Android 和 iOS。启动后直接进入主界面，可新建本地仓库；登录托管同步服务后也可克隆远端笔记库并手动双向同步。支持切换仓库、查看仓库信息，以及选择 Markdown 文件编辑和预览。
功能
当前功能、行为限制和同步注意事项见 功能说明。
首页“更多操作”中的 MP3 播放器连接现有线上音频服务，支持正文阅读、后台播放及蓝牙耳机控制。新增音频原生插件后需完全重启应用。
录音附件支持手动转文字：先在“更多操作 → 语音识别设置”填写豆包 AppID 与 Access Token，再点击语音条的转文字图标。凭据仅安全保存在本机，详细交互见 录音转文字。
开发
需要 Flutter 3.47.5（Dart 3.13.4）及对应平台的开发工具。Windows 可以开发 Android；构建和运行 iOS 需要 macOS 与 Xcode。
首次配置 Windows 安卓开发环境，请按 Android 开发环境搭建 操作。
首次拉取代码或出现插件缺失错误时，运行以下命令统一 Flutter 版本检查并重建本机依赖缓存：
.\tool\bootstrap.ps1
Android 暂固定使用 path_provider_android 2.2.23，并在启动时显式注册，以保持 Flutter 原生插件注册兼容；升级该依赖后需在设备上验证登录后的本地库初始化。
flutter pub get
dart run tool/flutter_with_metadata.dart run
Android 和 iOS 构建步骤会自动采集版本、Git 提交和 UTC 构建时间，供“更多操作 → 关于”查看和复制。
普通 flutter run/build 同样包含这些信息；专用脚本额外处理 Windows Java 临时目录配置。参数覆盖与运行说明见
Android 开发环境搭建。
在 VS Code 中安装 Python 和 Python Debugger 扩展，选择 Python 3.8 或更新版本的解释器。
在“运行和调试”中选择 Python: Android UI regression，按 F5 调试 test/ui/run.py。
默认选择唯一在线的 Android 模拟器；指定设备或执行轮数时，在 .vscode/launch.json 的 args 中填写
["--device", "emulator-5554", "--repeat", "3"]。
运行前准备及脚本对模拟器的操作见 编辑与预览回归说明。
验证
flutter analyze
flutter test
dart run tool/flutter_with_metadata.dart build apk --debug
dart run tool/flutter_with_metadata.dart build apk --release
测试输出与指定用例的命令见 测试运行说明。
Android 构建需要 Android SDK API 36、Build-Tools 36.0.0、NDK 28.2.13676358、CMake 3.22.1 和 JDK 17 或更新版本。APK 输出位于 build/app/outputs/flutter-apk/。当前 release APK 使用调试签名，仅供安装验证；正式发布前需配置发布签名。
