App(SSEMarket-X)是集市主站的移动入口,也是小程序的宿主客户端。它用一套 Flutter 代码同时出 Android、iOS、HarmonyOS、Windows、macOS、Linux 和 Web,共九种产物。lib/ 约 4 万行、124 个 dart 文件,仓库见 SysuMirror/SSEMarket-X。
七套宿主,九种产物
六个原生平台加 Web;Android 按 CPU 架构分三个包,共九种产物:
| 平台 | 产物 | 说明 |
|---|---|---|
| Android | arm64-v8a / armeabi-v7a / x86_64 | 2015 年前的老设备走 v7a |
| iOS | nosign | 未签名包,需自行签名或开发者账号安装 |
| HarmonyOS | nosign | 未签名包,需自行签名安装 |
| Windows | x64 / arm64 | ARM 笔记本单独出包 |
| macOS | universal | Intel 与 Apple 芯片共用 |
| Linux | x64 | 主流发行版 |
| Web | — | 无本地通知,小程序走外部窗口 |
1 | android/ ios/ ohos/ linux/ macos/ windows/ web/ ← 七套宿主工程 |
七套宿主共用 lib/,业务代码只写一遍;平台差异收敛在 core/services 与 core/miniprogram,用 Platform.is* 和 MethodChannel 分流。关键依赖:webview_flutter 4.6、web_socket_channel、flutter_local_notifications 19、just_audio 0.9、shared_preferences。
能力差异与 HarmonyOS 依赖覆盖
| 能力 | 实现 | 差异 |
|---|---|---|
| 本地通知 | flutter_local_notifications |
HarmonyOS 走原生 MethodChannel('ssemarket/notifications');Web 降级为空操作 |
| 小程序容器 | 移动端内嵌 WebView | 桌面端开外部窗口,Web 与桌面无内嵌 WebView |
| 后台保活 | Android 生命周期通道 start / stop |
其他平台不做保活 |
通知服务在 lib/core/services/notification_service.dart;HarmonyOS 的原生实现在 ohos/entry/src/main/ets/entryability/EntryAbility.ets。
平台不支持写成抛异常,会让 Web 每个页面都报错;应降级为空操作,业务侧只判断有没有触发。
HarmonyOS 用的是 OpenHarmony TPC 的 Flutter 分支,依赖覆盖单独写在 pubspec_overrides.ohos.yaml,构建其他平台时不带这个文件。覆盖文件常驻会让 Android/iOS 去拉 OHOS 分支的包,编译直接失败——构建脚本必须按平台增删。
桌面开窗,移动内嵌
移动端用内嵌 WebView;桌面端不内嵌,直接开浏览器窗口。Windows 上按候选路径找 Edge / Chrome / Brave,用 --new-window --app=<url> 以无地址栏的应用窗口启动,找不到才退回系统默认;macOS、Linux、Web 直接 launchUrl。
1 | Future<void> _openDesktopWindow(Uri uri) async { |
好处是看起来像独立客户端,代价是依赖用户装了 Chromium 系浏览器。开窗由外部进程完成,不能在主窗口叠加载入遮罩,否则等不到回调,界面一直转圈。
Android 额外用生命周期通道做保活,让小程序音频在切后台后继续播放:
1 | Future<void> _setKeepAlive(bool on) async { |
保活必须与「离开容器」成对调用。只 start 不 stop,退出小程序后前台服务还在,通知栏会一直挂着。
网络与身份
ApiService(lib/core/api/api_service.dart)用常量 base https://ssemarket.cn/api,一个业务动作一个方法,统一解析响应里的 code / msg / data,错误以异常上抛。base 写死会让测试与灰度无法切换,要么构建时注入,要么收进配置类。
登录响应同时返回 access 与 refresh。StorageService 用 shared_preferences 存 user_token、refresh_token、refresh_token_expiry 三个键,启动时读回恢复登录态。
shared_preferences 在 Android 是明文 XML、iOS 是明文 plist,root/越狱设备可直接读;需要更强保护时接 flutter_secure_storage(Keychain / Keystore)。刷新失败要一次性清掉三个键并回登录页,只清 access 不清 refresh,下次启动拿过期 refresh 反复请求,形成死循环。
主站功能
首页与搜索走 views/home 下的 home_page.dart 和 search_page.dart,接口是 /auth/browse。帖子详情由 post_detail_page.dart(1400+ 行)承载评论、点赞、收藏,配 latex_markdown.dart(1200+ 行)自绘 Markdown 与 LaTeX,表情选择器 emoji_picker.dart 是独立组件。
LaTeX 与 Markdown 必须在同一次解析里处理。先渲染 Markdown 再替换公式,公式里的 _、* 会被当成斜体/加粗吃掉。
发帖页 create_post_page.dart 支持标题、正文、图片、匿名、分区,图片先传拿地址再拼进正文。私信由 websocket_service.dart 维持长连接,断线重连后按最后消息 ID 补拉历史;移动端切后台会断连,回前台要先补历史再重连,否则消息在界面上是空洞。
通知侧 notification_service.dart 负责权限、点击跳转和新帖提醒,入口有 init()、requestPermission()、showNewPosts()、openSystemSettings()。通知跳转要在冷启动就绪;只在热启动注册回调,冷启动点通知会落在首页。
在线心跳是模块级单例,登录后每 60 秒上报一次:
1 | // lib/core/services/presence_service.dart |
beat 里用 _inFlight 防重入:弱网下请求悬挂,定时器每 60 秒再发一次,会堆出一串并发请求。切后台时暂停心跳。投币弹窗与流水在 views/coin,打分专区入口是 views/todo/score_page.dart(目录名是历史命名,内容是打分)。
小程序容器
客户端拉目录并缓存,prefetchTickets 提前申请票据,点开时直接取。票据只有 60 秒 TTL,缓存必须带过期判断,不能直接复用。
票据申请调 POST /v1/launch-tickets,带上 appKey、deviceID 和可选的 origin:
1 | Future<MPLaunchTicket> launchTicket({required String appKey, String? origin}) async { |
打开前用 _isAllowed(app, uri) 比对应用配置的 origin 白名单,不匹配直接拒绝,不进入 WebView。必须比对解析后的 origin,不能对 URL 做字符串前缀匹配——https://evil.com/?x=applet.ssemarket.cn 在前缀匹配下会被放行。
主站令牌只注入给自家托管的小程序,条件是 https + 主机 applet.ssemarket.cn + 路径以 /mp/ 开头:
1 | // lib/core/miniprogram/mini_program_runtime.dart |
注入方式是在页面里设置 window.__SSE_MAIN_TOKEN__ 并广播事件。注入的是短期 access token:只读业务接口、几小时过期;refresh token 能换新令牌,泄露等同于账号被接管,不下发给 WebView。注入脚本要用 try/catch 包住,目标页若 CSP 禁止内联脚本,runJavaScript 抛异常会中断整个打开流程。
容器内三条约定:_onBridgeMessage 处理关闭、跳转、标题变更;handleBack 先把返回键交给页面,再退出容器;pauseMedia 在小程序切走时暂停音频。返回键直接退出,用户会误以为关掉了小程序,实际只是回上一页。registerDevice / updateSubscriptions 把 deviceID 与订阅关系上报平台,推送由平台按订阅下发。
本地能力
音乐播放基于 just_audio,music_player_service.dart 暴露 play / pause / toggle / stop,状态用 ValueNotifier 通知界面。dispose 必须释放播放器实例,只置空引用,音频焦点不会归还,别的声音会被压低;macOS 另有独立分支。正文里的 ::music <id>:: 被解析成卡片,播放与页面解绑,离开详情页仍继续。
缓存由 media_cache_service.dart 管理,cache_management_page.dart 展示占用并可清理;必须设上限与 LRU,只增不减长期会到 GB 级。浏览历史、稍后再看是本地存储加服务端同步;skins/ 定义主题,desktop_layout_preference_service.dart 记住桌面端布局。
面试速答
- 多端:六平台加 Web、九种产物;七套宿主共用
lib/,差异收敛在core/services与core/miniprogram。 - OHOS:独立
pubspec_overrides.ohos.yaml,构建其他平台必须移除;通知走原生MethodChannel。 - 平台差异:桌面用
--app=开浏览器应用窗口,移动内嵌 WebView;桌面不能叠加载遮罩;保活只在 Android。 - 身份:
shared_preferences存 access / refresh / expiry 三键;更严场景用 Keychain / Keystore。 - 心跳:60 秒单例心跳,切场景立即补报,
_inFlight防重入。 - 小程序:预取票据(60s TTL)→ origin 白名单 → 仅自家
/mp/页面注入 access token。
→ 下一篇:招聘:双选、答辩与席位





