本页目录展开
  1. 七套宿主,九种产物
  2. 能力差异与 HarmonyOS 依赖覆盖
  3. 桌面开窗,移动内嵌
  4. 网络与身份
  5. 主站功能
  6. 小程序容器
  7. 本地能力
  8. 面试速答

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
2
3
4
android/ ios/ ohos/ linux/ macos/ windows/ web/   ← 七套宿主工程
lib/core/ api / models / router / services / miniprogram / skins
lib/views/ auth / home / post / chat / notice / coin / shop / miniprogram / profile / xiaoqiu / todo
lib/shared/ components / theme

七套宿主共用 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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
Future<void> _openDesktopWindow(Uri uri) async {
final url = uri.toString();
if (!kIsWeb && Platform.isWindows) {
final pf = Platform.environment['ProgramFiles'] ?? r'C://Program Files';
final pf86 = Platform.environment['ProgramFiles(x86)'] ?? r'C://Program Files (x86)';
final candidates = <String>[
'$pf86\\Microsoft\\Edge\\Application\\msedge.exe',
'$pf\\Google\\Chrome\\Application\\chrome.exe',
'$pf\\BraveSoftware\\Brave-Browser\\Application\\brave.exe',
];
for (final path in candidates) {
if (File(path).existsSync()) {
await Process.start(path, <String>['--new-window', '--app=$url'],
mode: ProcessStartMode.detached);
return;
}
}
}
await launchUrl(uri, mode: LaunchMode.externalApplication);
}

好处是看起来像独立客户端,代价是依赖用户装了 Chromium 系浏览器。开窗由外部进程完成,不能在主窗口叠加载入遮罩,否则等不到回调,界面一直转圈。

Android 额外用生命周期通道做保活,让小程序音频在切后台后继续播放:

1
2
3
4
5
6
Future<void> _setKeepAlive(bool on) async {
if (on == _keepAliveStarted) return;
_keepAliveStarted = on;
if (!Platform.isAndroid) return;
await _lifecycle.invokeMethod<bool>(on ? 'start' : 'stop');
}

保活必须与「离开容器」成对调用。只 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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// lib/core/services/presence_service.dart
static const Duration _defaultInterval = Duration(seconds: 60);

void start(ApiService api) {
_api = api;
if (!StorageService().isLoggedIn) return;
if (_timer != null) return;
_active = true;
unawaited(beat());
_timer = Timer.periodic(_defaultInterval, (_) => unawaited(beat()));
}

void setTarget(String scene, {int targetID = 0}) {
_scene = scene;
_targetID = scene == 'home' ? 0 : targetID;
if (_active) unawaited(beat()); // 切场景立即补一次
}

beat 里用 _inFlight 防重入:弱网下请求悬挂,定时器每 60 秒再发一次,会堆出一串并发请求。切后台时暂停心跳。投币弹窗与流水在 views/coin,打分专区入口是 views/todo/score_page.dart(目录名是历史命名,内容是打分)。

小程序容器

客户端拉目录并缓存,prefetchTickets 提前申请票据,点开时直接取。票据只有 60 秒 TTL,缓存必须带过期判断,不能直接复用。

票据申请调 POST /v1/launch-tickets,带上 appKey、deviceID 和可选的 origin:

1
2
3
4
5
6
7
8
9
10
11
12
Future<MPLaunchTicket> launchTicket({required String appKey, String? origin}) async {
final data = await _request('POST', '/v1/launch-tickets', body: {
'appKey': appKey,
'deviceID': await deviceId,
if (origin != null && origin.isNotEmpty) 'origin': origin,
});
return MPLaunchTicket(
ticket: data['ticket']?.toString() ?? '',
launchUrl: data['launchURL']?.toString() ?? '',
expiresIn: (data['expiresIn'] as num?)?.toInt() ?? 60,
);
}

打开前用 _isAllowed(app, uri) 比对应用配置的 origin 白名单,不匹配直接拒绝,不进入 WebView。必须比对解析后的 origin,不能对 URL 做字符串前缀匹配——https://evil.com/?x=applet.ssemarket.cn 在前缀匹配下会被放行。

主站令牌只注入给自家托管的小程序,条件是 https + 主机 applet.ssemarket.cn + 路径以 /mp/ 开头:

1
2
3
4
5
6
7
8
// lib/core/miniprogram/mini_program_runtime.dart
bool _isInternalMpUrl(String url) {
final uri = Uri.tryParse(url);
if (uri == null) return false;
return uri.scheme == 'https' &&
uri.host == 'applet.ssemarket.cn' &&
uri.path.startsWith('/mp/');
}

注入方式是在页面里设置 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。

→ 下一篇:招聘:双选、答辩与席位