# Asuka 与 SwiftUI、Expo 的功能对照

下面每一行都是应用经常需要的一项功能，分别列出 SwiftUI 和 Expo 的做法，以及 Asuka 提供的对应能力。除非该行另有说明，✓ 表示 Asuka 支持的所有平台（iOS、Android、Mac、Windows、Linux 和 Web）都能用；如果某个平台本身不具备某项能力（比如 Mac 没有传感器，浏览器没有主屏幕小组件），对应的包会如实告诉调用方不支持。至于浏览器做不到手机能做的事时各个包会如何替代，见 [Web](https://asuka.egoist.dev/zh/docs/web.md#%E5%8E%9F%E7%94%9F%E6%A8%A1%E5%9D%97)。

SwiftUI 也能在 Mac 上运行。Expo 支持 iOS、Android 和 Web；React Native 则借助微软的 React Native for Windows and macOS 覆盖 Windows 和 Mac，不过这不在 Expo 的范围内。Asuka 与桌面端常用框架（Electron、Tauri、Wails）的对比，见[与桌面端框架对比](#与桌面端框架对比)；桌面应用在窗口之外还需要哪些能力，见[桌面应用的能力](#桌面应用的能力)；与自己绘制 UI 的 MyGo 的对比，见 [Asuka 与 MyGo](https://asuka.egoist.dev/zh/docs/mygo.md)。

✓ 已支持 · ◐ 部分支持（会注明缺什么） · ✗ 尚未支持

## 布局

|                        | SwiftUI                                         | Expo (React Native)                                  | Asuka                                                                                         |
| ---------------------- | ----------------------------------------------- | ---------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| 堆叠、间距、内边距、对齐           | `HStack`、`VStack`、`Spacer`                      | flexbox                                              | ✓ `Row`、`Column`、`Style`（flexbox：`Grow`、`Gap`、`Align`、`Justify`、`Wrap`）                       |
| 覆盖层、绝对定位               | `ZStack`、`.overlay`                             | `position: absolute`                                 | ✓ `Style.Absolute`、`Top`/`Left`/...                                                           |
| 滚动                     | `ScrollView`                                    | `ScrollView`                                         | ✓ `Scroll`（纵向、横向；移出视野的行会离开视图树）                                                                |
| 惰性列表、单元格复用             | `List`、`LazyVStack`                             | `FlatList`                                           | ✓ `List`（用平台自己的：UICollectionView、RecyclerView；在 Mac、Windows、Linux 和 Web 上，由宿主为可见范围内的行绑定数据并复用） |
| 网格                     | `LazyVGrid`                                     | `FlatList numColumns`                                | ✓ `ListProps.Columns`、`Gap`                                                                   |
| 聊天列表：从末尾开始显示，往上加载更早的消息 | `defaultScrollAnchor(.bottom)`、`scrollPosition` | `FlatList inverted`、`maintainVisibleContentPosition` | ✓ `ListProps.Anchor`、`OnStartReached`；在可见内容上方插入行时，可见内容保持不动，所有列表都是如此                           |
| 分区、吸顶标题                | `List` 里的 `Section`                             | `SectionList`、`stickySectionHeadersEnabled`          | ✓ `ListProps.Section`、`Header`（在 plain 和 bare 列表里吸顶）                                          |
| 选择行                    | `List(selection:)`、`EditButton`                 | 社区方案                                                 | ✓ `ListProps.Selecting`、`Selected`、`OnSelect`、`OnSelectBegin`（iOS 的编辑模式和双指拖动；Android 的复选框和长按） |
| 安全区域、键盘                | 自动处理                                            | `SafeAreaView`、`KeyboardAvoidingView`                | ✓ `SafeArea`、`UseEnvironment().Keyboard`                                                      |
| 读取视图的尺寸                | `GeometryReader`                                | `onLayout`                                           | ✓ `ViewProps.OnLayout`                                                                        |
| 宽高比、最小/最大尺寸            | `.aspectRatio`、`.frame(min:max:)`               | 样式                                                   | ✓ `Style`                                                                                     |

## 控件

|                    | SwiftUI                                               | Expo                            | Asuka                                                                                                                                                                                                                                                                                    |
| ------------------ | ----------------------------------------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 文本、带样式的文本、链接       | `Text`、`AttributedString`                             | `Text`                          | ✓ `Text`、`RichText`（文本片段、链接、行内视图、文本选择）、`asuka/sdk/markdown`                                                                                                                                                                                                                              |
| 按钮（变体、图标、菜单）       | `Button`、`Menu`                                       | `Pressable`                     | ✓ `Button`（filled、tinted、gray、bordered；图标；菜单）、`Menu`、上下文菜单；菜单项可以禁用、打勾、放进子菜单或带标题的分区（`Action.Disabled`、`Checked`、`Children`、`Inline`；`ui.Submenu`、`ui.MenuSection`），导航栏按钮也能弹出菜单                                                                                                            |
| 文本框                | `TextField`、`SecureField`、`TextEditor`                | `TextInput`                     | ✓ `TextField`（密码输入、键盘类型、回车键类型、多行）                                                                                                                                                                                                                                                        |
| 光标、在光标处插入          | `TextSelection`                                       | `selection`、`onSelectionChange` | ✓ `TextFieldProps.Selection`、`ui.InsertText`                                                                                                                                                                                                                                             |
| 富文本编辑（比如邮件正文）      | 配合 `AttributedString` 的 `TextEditor`（iOS 26）          | 社区方案（10tap、pell）                | ✓ `TextFieldProps.Rich`、`ToggleFormat`、`SetLink`、`OnFormats`                                                                                                                                                                                                                             |
| 键盘上方的工具条           | `.toolbar { ToolbarItemGroup(placement: .keyboard) }` | `InputAccessoryView`（iOS）       | ✓ `TextFieldProps.Accessory`（两个平台都支持）                                                                                                                                                                                                                                                    |
| 粘贴的图片、键盘里的 GIF 和贴纸 | `onPasteCommand`、`PasteButton`                        | 社区方案（`onPaste`）                 | ✓ `TextFieldProps.PasteTypes`、`OnPaste`（也支持 Android 的 `commitContent`）                                                                                                                                                                                                                   |
| 开关、滑块              | `Toggle`、`Slider`                                     | 社区方案                            | ✓ `Toggle`、`Slider`                                                                                                                                                                                                                                                                      |
| 分段控件               | `Picker(.segmented)`                                  | 社区方案                            | ✓ `Segmented`                                                                                                                                                                                                                                                                            |
| 日期和时间              | `DatePicker`                                          | 社区方案                            | ✓ `DatePicker`（日期、时间，或两者都选）                                                                                                                                                                                                                                                              |
| 进度条、加载指示器          | `ProgressView`                                        | `ActivityIndicator`             | ✓ `Progress`、`ProgressRing`（圆形，有值无值都行）、`Activity`                                                                                                                                                                                                                                        |
| 滚轮选择器、菜单选择器、步进器    | `Picker`、`Stepper`                                    | 社区方案                            | ✓ `Wheel`、`Picker`（iOS 和 Mac 上是弹出按钮，Android 上是 Material 的 exposed dropdown menu）、`Stepper`                                                                                                                                                                                               |
| 颜色选择器              | `ColorPicker`                                         | 社区方案                            | ✓ `ColorPicker`（iOS 上用系统的选择器；Android 没有系统选择器，就用一个 Material 对话框展示 Google 的调色板，支持不透明度）                                                                                                                                                                                                     |
| 图标                 | SF Symbols                                            | `@expo/vector-icons`            | ✓ `Symbol`（iOS 和 Mac 上用 SF Symbols；同样的名字在 Android 和 Web 上对应 Material Symbols，在 Windows 上对应 Segoe Fluent Icons，在 Linux 上对应图标主题里的图标或 Material Symbols：这些是精选出来的一组图标）                                                                                                                        |
| 图片（远程、缓存、占位图）      | `AsyncImage`                                          | `expo-image`                    | ✓ `Image`（内存和磁盘缓存、`Placeholder`、BlurHash 和 ThumbHash 占位图、交叉淡入的 `Transition`；平台能解码时支持 WebP、HEIC 和 AVIF，Windows 上通过 WIC 已安装的编解码器；GIF、APNG 和 WebP 动图在所有平台上播放，支持 `Animated` 和“减弱动态效果”；Mac、Linux 和 Web 上支持 SVG）                                                                               |
| Lottie 动画          | 社区方案（lottie-ios）                                      | `lottie-react-native`           | ✓ `asuka/sdk/lottie`（lottie-ios、lottie-android、lottie-web；Windows 和 Linux 上用自带的渲染器绘制：支持 JSON 和 dotLottie、播放、循环、速度、可读可写的 `Progress`、在 `ui.Animate` 中动画过渡、片段、标记、用于主题和深色模式的 keypath 覆盖、“减弱动态效果”）                                                                                            |
| 视频                 | `VideoPlayer`                                         | `expo-video`                    | ✓ `Video`（iOS 和 Mac 上用 AVKit，Android 上用 Media3，Windows 上用 WebView2，Linux 上用 GStreamer，Web 上用 `<video>`）                                                                                                                                                                                  |
| 网页内容               | `WKWebView`                                           | `react-native-webview`          | ✓ `WebView`（iOS 和 Mac 上是 WKWebView，Android 上是系统的 WebView，Windows 上是 WebView2，Linux 上是 WebKitGTK；支持 URL、HTML、双向消息、先于页面脚本运行的脚本、拦截请求、页面状态和历史记录、下载、新窗口、cookie、获取脚本的返回值；Android 上还能逐个处理请求；在 Web 上，应用自己站点的页面和通过 `postMessage` 配合的页面能用上以上全部功能，其他站点的页面则只能加载）；`asuka/sdk/js` 可以在屏幕之外运行 JavaScript |
| 地图                 | `Map`                                                 | `expo-maps`                     | ✓ `asuka/sdk/maps`（Apple 地图；Google 地图需要 API 密钥：支持区域、标记、用户位置、点按；Linux 上用 libshumate 的 OpenStreetMap 地图；Windows 上由宿主自己绘制 OpenStreetMap 的瓦片）                                                                                                                                                |
| 自定义绘制              | `Shape`、`Path`、`Canvas`                               | `react-native-svg`、Skia         | ✓ `Shape` 和 `Path`（填充、描边、线帽、连接样式、虚线、可做动画的 trim）；`Canvas`（路径、渐变、文本、变换、裁剪、不透明度）；以原生方式绘制的 SVG 图标（`asuka/sdk/svg`）                                                                                                                                                                           |
| 图表                 | Swift Charts                                          | `victory-native`、社区方案           | ✓ `asuka/sdk/chart`（柱状图、折线图、面积图、散点图）                                                                                                                                                                                                                                                     |
| 着色器                | `.colorEffect(ShaderLibrary...)`                      | Skia 的 runtime effect           | ✓ `Shader`（用 Kage 编写，语法与 Go 相同：iOS 和 Mac 上用 Metal，Android 上用 AGSL，Web 上用 WebGL 2，Windows 上用 Direct3D 11，Linux 上用 OpenGL）                                                                                                                                                                 |
| 调用原生代码             | `UIViewRepresentable`                                 | 原生模块                            | ✓ 原生包：在 Go 里声明带类型的模块和视图，在 iOS 和 macOS 上用 Swift 实现，在 Android 上用 Kotlin，在 Web 上用 JavaScript，在 Windows 和 Linux 上用 Go（[原生代码](https://asuka.egoist.dev/zh/docs/native.md)）                                                                                                                    |
| 分页、页面指示点           | `.scrollTargetBehavior(.paging)`、`TabView(.page)`     | `react-native-pager-view`       | ✓ `ScrollProps.Paging`、`PageControl`                                                                                                                                                                                                                                                     |
| 复选框                | `Toggle`（`.checkbox`，macOS）                           | 社区方案                            | ✓ `ToggleProps.Checkbox`                                                                                                                                                                                                                                                                 |

## 导航与呈现

|                                          | SwiftUI                                                        | Expo (expo-router)                                                                              | Asuka                                                                                                                                                                                                                           |
| ---------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 带原生推入、弹出和返回手势的导航栈                        | `NavigationStack`                                              | Stack                                                                                           | ✓ `Stack`、`UseNavigator`                                                                                                                                                                                                        |
| 标签页                                      | `TabView`                                                      | Tabs                                                                                            | ✓ `Tabs`                                                                                                                                                                                                                        |
| 侧边栏、抽屉                                   | `NavigationSplitView`                                          | Drawer                                                                                          | ✓ `SplitView`（iPhone 上是导航栈，Android 上是抽屉；Mac 上是 `NSSplitViewController`，Windows 上是导航窗格，Linux 上是 libadwaita 的分栏视图）                                                                                                                |
| 标签页和侧边栏行上的角标                             | `badge`                                                        | `tabBarBadge`、`drawerItem` 计数                                                                   | ✓ `Tab.Badge`、`Destination.Badge`（`badgeValue`、`BadgeDrawable`、抽屉计数；Mac 上 `NSTabView` 的标签文字、源列表的计数；Fluent 的 `InfoBadge`；libadwaita 的 `badge-number`）                                                                            |
| 导航栏按钮、标题、搜索                              | `.toolbar`、`.searchable`                                       | header 选项                                                                                       | ✓ `ScreenOptions`（`Actions`、`Search`）                                                                                                                                                                                           |
| 底部工具栏、主操作（FAB）                           | `ToolbarItem(placement: .bottomBar)`                           | —                                                                                               | ✓ `ScreenOptions`（`Toolbar`、`Primary`、`PrimaryExtended`）：UIKit 的工具栏加一个醒目的末尾按钮，Material 的 `BottomAppBar` 和（扩展）FAB，Mac 上是窗口工具栏，Windows 上是命令栏，Linux 上是 `GtkActionBar`，Web 上是一个底栏加一个浮动按钮                                            |
| 带停靠高度的弹出面板                               | `.sheet`、`.presentationDetents`                                | modal                                                                                           | ✓ `Sheet`（`Detents`、`Grabber`）                                                                                                                                                                                                  |
| 全屏模态                                     | `.fullScreenCover`                                             | `presentation: "fullScreenModal"`                                                               | ✓ 设置了 `FullScreen` 的 `Sheet`（iOS 的 `.fullScreen`；Material 的全屏对话框，铺满屏幕边缘，支持预测性返回；桌面端是盖住整个窗口内容的弹出面板或窗口；Web 上是盖住整个页面的 `<dialog>`）                                                                                                  |
| 拦截返回、阻止关闭                                | `.navigationBarBackButtonHidden`、`.interactiveDismissDisabled` | `BackHandler`、`usePreventRemove`                                                                | ✓ `OnBack`（页面、弹出面板、整个应用）                                                                                                                                                                                                        |
| 气泡弹窗                                     | `.popover`                                                     | —                                                                                               | ✓ `Popover`（在 iPhone 上也是 popover）                                                                                                                                                                                               |
| 警告框、操作表                                  | `.alert`、`.confirmationDialog`                                 | `Alert`                                                                                         | ✓ `Alert`（两种样式都支持；警告框可以带输入框：`Fields`，密码框用 `Secure`，按钮通过 `Disabled` 跟随输入内容）                                                                                                                                                      |
| Snackbar、toast（带“撤销”的简短提示）               | —                                                              | 社区方案（react-native-paper 的 `Snackbar`）                                                           | ✓ `Snackbar`（Android 上是 Material 的 Snackbar，Linux 上是 `AdwToast`；iOS、macOS、Windows 和 Web 上按平台的样式绘制）                                                                                                                              |
| 深度链接、通用链接和 App Links                     | `.onOpenURL`                                                   | Linking                                                                                         | ✓ `Router` 自己处理能匹配其路由的链接（应用 scheme 的链接、通用链接和 App Links、通知里的 URL），其余交给 `OnOpenURL`；`asuka.json` 里的 scheme 和 links                                                                                                                |
| URL 路由：路径模式、嵌套导航器、链接下方的初始页面、重定向、守卫、未找到页面 | 配合 `Codable` 值的 `NavigationPath`                               | expo-router（`[id]`、`[...rest]`、`unstable_settings`、`<Redirect>`、`Stack.Protected`、`+not-found`） | ✓ `Router` 和 `Route`（`:id`、`*rest`、`Initial`、`Redirect`、`Guard`、`NotFound`；导航栈、标签页、分栏视图、slot 和弹出面板都可以是路由），`Navigate`、`Push`、`Replace`、`Back`、`SetQuery`，`NavLink` 以及视图和按钮上的 `Href`；导航状态能从地址恢复（刷新页面、桌面窗口上次的位置、`asuka dev` 的重新加载） |
| 类型安全的链接                                  | `NavigationPath` 的值                                            | 类型化路由（生成的 `.d.ts`）                                                                              | ✓ `asuka vet` 的 `routes` 检查（没有路由能匹配的常量 href、`HrefOf` 的参数个数）；`ui.HrefOf` 按路由的模式填入参数                                                                                                                                              |
| 下拉刷新、滑动操作                                | `.refreshable`、`.swipeActions`                                 | `RefreshControl`                                                                                | ✓（两侧都支持：`SwipeActions`、`LeadingSwipeActions`）                                                                                                                                                                                   |

## 动画

|          | SwiftUI                                                | Expo (Reanimated)                                                              | Asuka                                                                                                                    |
| -------- | ------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| 为变化添加动画  | `withAnimation`                                        | `withTiming`、`withSpring`                                                      | ✓ `Animate`、`AnimateWith`（缓动、线性、弹簧动画；重复、自动反向）                                                                            |
| 变换       | `.rotationEffect`、`.scaleEffect`、`.offset`             | `transform`                                                                    | ✓ `Style.Transform`                                                                                                      |
| 进入和退出过渡  | `.transition`                                          | entering/exiting                                                               | ✓ `Style.Transition`（`Fade`、`Pop`、`SlideUp`，也可以自定义）                                                                      |
| 逐帧动画     | `TimelineView(.animation)`                             | `useFrameCallback`                                                             | ✓ `OnFrame`                                                                                                              |
| 阴影、渐变、模糊 | `.shadow`、`LinearGradient`、材质                          | 样式、expo-linear-gradient、expo-blur                                              | ✓ `Shadow`、`LinearGradient`、`Material`                                                                                   |
| 手势       | 点按、长按、拖动、缩放、旋转                                         | Gesture Handler                                                                | ✓ 点按、长按、平移、捏合、旋转、轻扫                                                                                                      |
| 硬件键盘的按键  | `.onKeyPress`、`.keyboardShortcut`                      | `onKeyPress`（`TextInput` 上的；React Native for Windows and macOS 上是 `onKeyDown`） | ✓ `ViewProps.Keys`、`TextFieldProps.Keys`（从获得焦点的视图逐层向外传递，先于控件和菜单处理）、`UseKeys`（整个窗口的）                                      |
| 按下和悬停状态  | `ButtonStyle` 的 `isPressed`、`.onHover`                 | `Pressable` 的 `pressed`、`onHoverIn`/`onHoverOut`                               | ✓ `Style.Pressed`、`Hovered` 变体；用 `Interaction` 跟随分组（group）或相邻元素（peer）的状态（`Style.When`）；`OnPressedChange`、`OnHoverChange` |
| 拖放       | `.draggable`、`.dropDestination`                        | （没有内置）                                                                         | ✓ `Drag`、`Drop`（应用内可以拖放 Go 值；与其他应用之间可以拖放文本、链接和文件；`Dragging` 和 `DragOver` 变体）                                             |
| 共享元素过渡   | `matchedGeometryEffect`、`.navigationTransition(.zoom)` | shared transitions                                                             | ✓ `Style.Match`（一个视图从另一个视图的位置和大小中展开）、`ScreenOptions.ZoomFrom`（推入的页面从某个视图中缩放展开：iOS 18 的缩放过渡；Material 的容器变换）               |
| 触感反馈     | `sensoryFeedback`                                      | `expo-haptics`                                                                 | ✓ `Haptic`                                                                                                               |
| 减弱动态效果   | `accessibilityReduceMotion`                            | `useReducedMotion`                                                             | ✓ `Environment.ReduceMotion`（iOS 的过渡改为淡入淡出）                                                                              |

## 数据与服务

|                      | SwiftUI / Apple                                                | Expo                                                                 | Asuka                                                                                                                                                                                                                                                                                                                                                   |
| -------------------- | -------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 状态                   | `@State`、`@Observable`                                         | hooks                                                                | ✓ signal（细粒度：一次写入只更新读取了它的地方）                                                                                                                                                                                                                                                                                                                            |
| 持久化少量数据              | `@AppStorage`                                                  | AsyncStorage                                                         | ✓ `asuka/sdk/store`                                                                                                                                                                                                                                                                                                                                     |
| SQLite               | SwiftData / GRDB                                               | `expo-sqlite`                                                        | ✓ `asuka/sdk/sqlite`（迁移、带类型的查询、事务、在主线程之外写入、实时查询：读取的表被写入时会重新运行，参数变化时也会，见 `WatchWith`；浏览器里也能用，基于 SQLite 的 WebAssembly 版本）                                                                                                                                                                                                                                 |
| 安全存储                 | Keychain                                                       | `expo-secure-store`                                                  | ✓ `asuka/sdk/secure`（在 Web 上：加密后存进 IndexedDB，密钥由浏览器保管、无法导出；并不是真正的钥匙串）                                                                                                                                                                                                                                                                                   |
| 文件、网络                | Foundation                                                     | `expo-file-system`、fetch                                             | ✓ Go 的 `os`、`net/http`                                                                                                                                                                                                                                                                                                                                  |
| 照片                   | `PhotosPicker`                                                 | `expo-image-picker`                                                  | ✓ `device.PickPhotos`                                                                                                                                                                                                                                                                                                                                   |
| 文档                   | `UIDocumentPickerViewController`                               | `expo-document-picker`                                               | ✓ `device.PickFiles`（MIME 类型、多选）                                                                                                                                                                                                                                                                                                                        |
| 相机                   | AVFoundation                                                   | `expo-camera`                                                        | ✓ `asuka/sdk/camera`：`Take`（系统相机；在 Mac、Windows 和 Linux 上是一个带实时预览的对话框；Windows 上用 Media Foundation 的采集引擎；Linux 上用相机 portal，或通过 GStreamer 调用 Video4Linux）、`View`（实时预览，前置或后置摄像头）、`Capture`；`asuka/sdk/camera/record` 可以录制带声音的视频                                                                                                                             |
| 条形码、二维码              | AVFoundation、Vision                                            | `expo-camera` 的扫描功能                                                  | ✓ `asuka/sdk/scan`：可以在 `camera.View` 里实时识别（`Scan: scan.Codes(...)`），也可以识别图片文件（`scan.File`）；Android 上用 ML Kit，只会打包进导入了它的应用；Linux 上用 ZBar；Windows 上用 Asuka 自己用 Go 写的识别器（`internal/barcode`：QR、Data Matrix、EAN、UPC、Code 128、Code 39）                                                                                                                       |
| 定位                   | Core Location                                                  | `expo-location`                                                      | ✓ `asuka/sdk/location`（地名查询：Windows 上用 OpenStreetMap 的 Nominatim）；“使用期间”和“始终”两级权限，精确或大致位置；后台定位更新和地理围栏（相当于 `expo-task-manager` 的任务：iOS 和 Android 上会为这些事件启动应用；系统不提供时，在应用运行期间根据位置计算）                                                                                                                                                                       |
| 翻译、复数、区域格式           | String Catalogs、FormatStyle                                    | `expo-localization`、i18next                                          | ✓ `asuka/i18n`、翻译目录（[多语言](https://asuka.egoist.dev/zh/docs/i18n.md)）                                                                                                                                                                                                                                                                                    |
| 从右到左布局               | `layoutDirection`                                              | `I18nManager`                                                        | ✓ 跟随语言，也可用 `ui.WithDirection` 设置                                                                                                                                                                                                                                                                                                                        |
| 本地通知                 | UserNotifications                                              | `expo-notifications`                                                 | ✓ `asuka/sdk/notify`（立即或定时发送，支持图片；iOS、Android、macOS、Linux；Windows 上是 toast 通知，通过应用的 COM 激活器支持按钮和回复；Web 上通过应用的 service worker 发送，所以页面关闭后通知仍然保留、仍能响应操作；定时通知在应用有页面打开时会按时显示，否则等下次打开页面时再显示：浏览器无法预约通知）                                                                                                                                                        |
| 推送通知                 | APNs                                                           | `expo-notifications`                                                 | ✓ `asuka/sdk/push`（iOS 和 macOS 上用 APNs，另有 Firebase Cloud Messaging，Web 上用基于 VAPID 的 Web Push：获取令牌、接收消息、处理点按；`asuka/sdk/push/webpush` 可以从 Go 服务器发送 Web Push）                                                                                                                                                                                             |
| 通知操作、内联回复            | `UNNotificationCategory`、`UNTextInputNotificationAction`       | `setNotificationCategoryAsync`                                       | ✓ `notify.SetCategories`、`OnAction`（后台操作会运行应用的 Go 代码，应用没在运行时会以无界面方式启动；`Response.Defer`；Android 上回复会被添加回对话里；在 Web 上用 service worker 的通知操作，Chrome 支持的地方还有内联回复）                                                                                                                                                                                            |
| 通知分组、当前显示的通知、角标      | `threadIdentifier`、`getDeliveredNotifications`、`setBadgeCount` | `getPresentedNotificationsAsync`、`setBadgeCountAsync`                | ✓ `Thread`（Android：一个通知组，并保留它的摘要通知）、`notify.Showing`、`Remove`、`RemoveThread`、`SetBadge`（Android：启动器根据通知显示的角标）                                                                                                                                                                                                                                           |
| 前台通知                 | `willPresent`                                                  | `setNotificationHandler`                                             | ✓ `notify.Present`（横幅、静默、隐藏）                                                                                                                                                                                                                                                                                                                            |
| Android 通知渠道         | —                                                              | `setNotificationChannelAsync`                                        | ✓ `notify.SetChannels`、`SetChannelGroups`；推送的 `channel_id`（iOS 没有渠道）                                                                                                                                                                                                                                                                                    |
| 对话类消息                | 通讯通知（`INSendMessageIntent`）                                    | 社区方案                                                                 | ✓ `Notification.From`、`push.Message.From`：iOS 的通讯通知（只给用到它的应用添加 entitlement），Android 的 MessagingStyle 和对话快捷方式；macOS 上显示为普通通知；不支持气泡                                                                                                                                                                                                                       |
| 在推送显示前修改内容           | Notification Service Extension                                 | 社区方案（`expo-notifications` 不支持）                                       | ✓ `push.Rewrite`：iOS 上在扩展里运行应用的 Go 代码（由 `asuka build` 构建并签名），Android 的数据消息则在应用进程里处理                                                                                                                                                                                                                                                                     |
| 剪贴板、分享面板、浏览器         | `UIPasteboard`、`ShareLink`、`SFSafariViewController`            | `expo-clipboard`、`expo-sharing`、`expo-web-browser`                   | ✓ `Copy`、`device.Clipboard`（文本；图片用 `CopyImage`、`ClipboardImage`；`ClipboardHas`、`OnClipboardChange`）、`Share`（文本）、`ShareFiles`（文件，支持 expo-sharing 那样的 MIME 类型、UTI、标题和 iPad 锚点；分享面板关闭时才返回）、`device.Browse`                                                                                                                                                 |
| 预览文件                 | `QLPreviewController`、`.quickLookPreview`                      | `react-native-file-viewer`                                           | ✓ `asuka/sdk/preview`（iOS 和 Mac 上用 Quick Look，支持多个文件和标记（Markup）；Android 上交给查看器应用；Windows 和 Linux 上用默认应用打开）                                                                                                                                                                                                                                              |
| 打印、从 HTML 生成 PDF     | `UIPrintInteractionController`、`UIPrintPageRenderer`           | `expo-print`                                                         | ✓ `asuka/sdk/print`（可以打印文件、HTML 或 WebView，使用系统的打印对话框并拿到结果；`PDF`：自动分页、按地区选择纸张、页边距）                                                                                                                                                                                                                                                                       |
| 邮件和短信编辑界面            | `MFMailComposeViewController`、`MFMessageComposeViewController` | `expo-mail-composer`、`expo-sms`                                      | ✓ `asuka/sdk/compose`（收件人、主题、HTML 正文、附件；iOS 上能知道用户最后做了什么；Android 上只列出邮件应用；Mac 上支持“信息”）                                                                                                                                                                                                                                                                  |
| 保持屏幕常亮、设备信息          | `isIdleTimerDisabled`、`UIDevice`                               | `expo-keep-awake`、`expo-device`                                      | ✓ `device.KeepAwake`、`device.GetInfo`                                                                                                                                                                                                                                                                                                                   |
| 网络状态                 | `NWPathMonitor`                                                | `expo-network`                                                       | ✓ `asuka/sdk/network`（是否在线、Wi-Fi 还是蜂窝网络、是否按流量计费、流量节省程序 / 低数据模式）                                                                                                                                                                                                                                                                                         |
| 保存到相册、下载目录           | `PHPhotoLibrary`                                               | `expo-media-library`                                                 | ✓ `asuka/sdk/library`（Android 上是 MediaStore 的各个集合；iOS 上是“照片”，或“文件”里的 Documents）                                                                                                                                                                                                                                                                         |
| 后台任务                 | `beginBackgroundTask`、`BGTaskScheduler`                        | `expo-task-manager`、`expo-background-task`                           | ✓ `asuka/sdk/background`：Android 会让应用保持运行，进度和按钮显示在一条通知里；iOS 大约给 30 秒；Mac 会让应用保持运行（关闭 App Nap），Linux 和 Windows 会阻止系统休眠。`asuka/sdk/periodic`：由系统不定期运行的任务，以无界面方式启动应用的 Go 代码（BGTaskScheduler、WorkManager；Mac 上在应用运行期间用 `NSBackgroundActivityScheduler`；Linux 和 Windows 上在应用运行期间用定时器）                                                                        |
| 接收其他应用的分享            | Share extension                                                | `expo-sharing`（`useIncomingShare`）                                   | ✓ `ui.OnShare`：文本、链接、图片、视频、音频和文件，单个或多个，附带名称、MIME 类型和大小（由 `asuka.json` 的 `shareTarget` 指定类型和数量上限，并据此生成 Android 的 intent filter 和 iOS 的激活规则；iOS 上由分享扩展打开应用，文件通过 App Group 传递）；`app.ShareSheet`：在发起分享的应用上方显示应用自己的界面（iOS 上是它的分享扩展；Android 上是运行在独立进程里的底部面板），数据与应用共享；不解析链接内容（请用 `net/http`）                                                                   |
| 音频                   | AVAudioPlayer、AVAudioRecorder                                  | `expo-audio`                                                         | ✓ `asuka/sdk/audio`（加载、播放、暂停、跳转、音量、循环）；`asuka/sdk/audio/record`（语音或音乐音质、暂停、电平表）                                                                                                                                                                                                                                                                         |
| 正在播放、锁屏控制、媒体键        | `MPNowPlayingInfoCenter`、`MPRemoteCommandCenter`               | `expo-audio` 的锁屏控制、社区方案（`react-native-track-player`）                 | ✓ `asuka/sdk/nowplaying`（标题、艺人、专辑、封面、时长、由系统推进的播放位置，以及播放、暂停、下一首、上一首、跳转、快进快退、停止，设置了哪些处理函数就启用哪些控制；会自动跟随 `audio.Player`；Android 上用 MediaSession 和媒体播放服务；Mac 上是控制中心，Windows 上是媒体浮出控件，Linux 上是 MPRIS，Web 上是 Media Session API）                                                                                                                                |
| 通过 Apple 登录          | `SignInWithAppleButton`                                        | `expo-apple-authentication`                                          | ✓ `asuka/sdk/appleauth`（Apple 的登录按钮、凭据及其状态；iOS 和 macOS）                                                                                                                                                                                                                                                                                                 |
| Apple Pay、Google Pay | PassKit（`PayWithApplePayButton`）                               | `@stripe/stripe-react-native` 的 Platform Pay、`react-native-payments` | ✓ `asuka/sdk/pay`（钱包的支付面板和按钮；交给应用支付处理商的令牌；修改配送、优惠码和卡片时更新总额；按字段显示错误；订阅、延后扣款和自动充值；iOS、macOS、Android，Safari 中的 Apple Pay 和其他浏览器中的 Google Pay）                                                                                                                                                                                                              |
| 面容 ID、指纹             | LocalAuthentication                                            | `expo-local-authentication`                                          | ✓ `asuka/sdk/biometric`（Windows 上用 Windows Hello；Web 上通过 WebAuthn 调用平台认证器）                                                                                                                                                                                                                                                                              |
| 应用内购买、订阅             | StoreKit 2                                                     | `expo-iap`、`react-native-iap`、RevenueCat                             | ✓ `asuka/sdk/purchase`（带本地化价格和优惠的商品、购买、“询问购买”和待付款、从应用启动起的交易流：续订、退款、在应用外的购买；完成和消耗交易、作为 signal 的已购权益、恢复购买、订阅状态、Play 的升级和降级、管理订阅、申请退款和兑换优惠码的界面、供服务器验证的 JWS 和购买令牌；iOS 和 macOS 上用 StoreKit 2，Android 上用 Play Billing 9，Windows 上用 Microsoft Store，Trusted Web Activity 里用 Digital Goods API；测试用 `fake.Store`）                                                |
| 应用商店评分               | `requestReview`                                                | `expo-store-review`                                                  | ✓ `asuka/sdk/review`（App Store 的评分弹窗，Play 的应用内评价）                                                                                                                                                                                                                                                                                                       |
| 跟踪权限                 | App Tracking Transparency                                      | `expo-tracking-transparency`                                         | ✓ `asuka/sdk/tracking`                                                                                                                                                                                                                                                                                                                                  |
| 应用完整性                | App Attest                                                     | `expo-app-integrity`                                                 | ✓ `asuka/sdk/integrity`（App Attest、Play Integrity）                                                                                                                                                                                                                                                                                                      |
| 年龄段                  | Declared Age Range                                             | `expo-age-range`                                                     | ✓ `asuka/sdk/agerange`（Declared Age Range、Play Age Signals）                                                                                                                                                                                                                                                                                             |
| 传感器                  | Core Motion                                                    | `expo-sensors`                                                       | ✓ `asuka/sdk/sensors`（加速度计、陀螺仪、磁力计、带姿态和朝向的设备运动、气压计、光线、计步器；两个平台上坐标轴和单位一致；Mac 和 Windows 没有传感器；Linux 上是 iio-sensor-proxy 提供的光线和方向）                                                                                                                                                                                                                         |
| NFC 标签               | Core NFC                                                       | `react-native-nfc-manager`                                           | ✓ `asuka/sdk/nfc`（读写 NDEF，支持文本、URI、MIME、外部类型和智能海报（smart poster）记录，可将标签设为只读、查询容量；标签的 ID 和技术类型；ISO 7816 APDU、MIFARE、FeliCa 和 ISO 15693 命令，以及 Android 的 NfcA/B/F/V、IsoDep 和 MIFARE Classic；iOS 的系统面板、Android 的读卡器模式；能打开应用的标签：iOS 通过通用链接，Android 通过 `asuka.json` 中配置的 NDEF_DISCOVERED 和 TECH_DISCOVERED；Web 上是 Chrome for Android 的 Web NFC，仅支持 NDEF；桌面端没有） |
| 低功耗蓝牙                | Core Bluetooth                                                 | 社区方案（`react-native-ble-plx`）                                         | ✓ `asuka/sdk/bluetooth`（按服务过滤的扫描、重复上报和 RSSI、广播数据；连接及其断开原因、服务、读取、带响应和不带响应的写入、通知和指示、MTU、RSSI、Android 的连接优先级；已知设备和系统已连接的设备；广播和 GATT 服务端；iOS 的后台模式和状态恢复、Android 的后台扫描；Windows 上是 Windows.Devices.Bluetooth，Linux 上是 BlueZ；Web 上是 Web Bluetooth 的设备选择器，仅限 Chrome 和 Edge，没有外围设备角色）                                                                            |
| 图片编辑                 | Core Graphics、ImageIO                                          | `expo-image-manipulator`                                             | ✓ `asuka/sdk/imageedit`（缩放、裁剪、旋转、翻转、填充、像素化；可以读入 HEIC，输出 JPEG 或 PNG，方向摆正，并去掉原图的元数据；Linux 上用 GdkPixbuf 的解码器，Windows 上用 WIC 的解码器）                                                                                                                                                                                                                          |
| 识别图片里的文字、人脸和条码       | Vision                                                         | 无                                                                    | ✓ `asuka/sdk/vision`，会给出每一项的位置；Android 上用 ML Kit，只会打包进导入了它的应用；Linux 上用 ZBar 识别条码、Tesseract 识别文字，不支持人脸；Windows 上用系统 OCR 识别文字和人脸，用 Asuka 自己的识别器识别条码                                                                                                                                                                                                       |
| 照片图库                 | PhotoKit                                                       | `expo-media-library`                                                 | ✓ `asuka/sdk/photos`：权限、列出照片、缩略图、原始文件（Windows 上是“图片”文件夹）                                                                                                                                                                                                                                                                                                |
| 视频缩略图                | `AVAssetImageGenerator`                                        | `expo-video-thumbnails`                                              | ✓ `imageedit.VideoFrame`                                                                                                                                                                                                                                                                                                                                |
| 文字转语音                | `AVSpeechSynthesizer`                                          | `expo-speech`                                                        | ✓ `asuka/sdk/speech`（朗读队列、声音、音调、语速、在某个词处暂停）                                                                                                                                                                                                                                                                                                             |
| 通讯录                  | Contacts、ContactsUI                                            | `expo-contacts`                                                      | ✓ `asuka/sdk/contacts`（联系人选择器和新建联系人界面不需要权限；有权限后可以访问通讯录；Windows 上添加联系人会打开一个 vCard，无法访问通讯录）                                                                                                                                                                                                                                                               |
| 日历                   | EventKit、EventKitUI                                            | `expo-calendar`                                                      | ✓ `asuka/sdk/calendar`（事件编辑器不需要权限；有权限后可以访问日历和事件；Windows 上添加事件会打开一个 iCalendar 文件，无法访问日历）                                                                                                                                                                                                                                                                 |
| 主屏幕小组件               | WidgetKit                                                      | `expo-widgets`                                                       | ✓ `asuka/sdk/widget` 和 `asuka.json` 的 `widgets`（所有尺寸共用一个模板，iOS 上还有锁屏小组件；时间线、倒计时、点按时打开 URL）                                                                                                                                                                                                                                                              |
| 实时活动                 | ActivityKit                                                    | `expo-live-activity`                                                 | ✓ `asuka/sdk/liveactivity`（iOS：锁屏和灵动岛；Android：常驻通知，即 Android 16 的实时更新；倒计时、进度、提醒，以及由服务器推送来更新和启动）                                                                                                                                                                                                                                                         |
| App Intents、快捷指令     | App Intents、App Shortcuts                                      | —                                                                    | ✓ `asuka.json` 的 `shortcuts`（iOS 上是带 Siri 短语的 App Shortcuts，会出现在聚焦搜索和“快捷指令”里；Android 上是启动器快捷方式）                                                                                                                                                                                                                                                         |
| 自定义字体                | `.font(.custom)`                                               | `expo-font`                                                          | ✓ `Font.Family`                                                                                                                                                                                                                                                                                                                                         |
| 生命周期                 | `scenePhase`                                                   | AppState                                                             | ✓ `app.OnLifecycle`                                                                                                                                                                                                                                                                                                                                     |
| 启动屏                  | `UILaunchScreen`                                               | `expo-splash-screen`                                                 | ✓ `asuka.json` 的 `splash`；`asuka/sdk/splash` 可以在应用加载期间让它一直显示                                                                                                                                                                                                                                                                                            |
| 状态栏、导航栏              | `statusBarHidden`、`preferredStatusBarStyle`                    | `expo-status-bar`、`expo-navigation-bar`                              | ✓ `asuka/sdk/screen` 的 `SetBars`                                                                                                                                                                                                                                                                                                                        |
| 锁定屏幕方向               | `supportedInterfaceOrientations`                               | `expo-screen-orientation`                                            | ✓ `asuka/sdk/screen` 的 `Lock`                                                                                                                                                                                                                                                                                                                           |
| 截屏                   | `isCaptured`、`userDidTakeScreenshotNotification`               | `expo-screen-capture`                                                | ✓ `asuka/sdk/screen` 的 `PreventCapture`（Android 上截图是空白的；iOS 上录屏时内容会被遮住；macOS 和 Windows 上截图里不包含这些窗口）、`OnScreenshot`（Linux 和 Windows 上通过 Pictures/Screenshots 里新出现的图片来判断）                                                                                                                                                                                 |
| 崩溃报告                 | MetricKit、Crashlytics、Sentry                                   | Sentry、Crashlytics（`@react-native-firebase/crashlytics`）             | ✓ `asuka/sdk/crash`：Go 的 panic 和致命错误、未捕获的异常、MetricKit 记录的崩溃和卡顿、Android 的原生崩溃和 ANR，附带面包屑和自定义值；报告发到哪里由应用决定（没有内置服务）；`asuka build` 会生成 dSYM 和原生调试符号                                                                                                                                                                                                         |

## 外观与无障碍

|                | SwiftUI                                                 | Expo                       | Asuka                                                                            |
| -------------- | ------------------------------------------------------- | -------------------------- | -------------------------------------------------------------------------------- |
| 深色模式、语义色、强调色   | 自动处理                                                    | `useColorScheme`           | ✓ 语义色、`asuka.json` 的强调色（Android 上用 Material 3 动态取色；Mac 上 AppKit 自己的控件保留用户设置的强调色） |
| 动态字体、字体缩放      | 自动处理                                                    | `allowFontScaling`         | ✓ 文本样式和自定义字体都会跟着缩放                                                               |
| 屏幕阅读器的标签、角色、隐藏 | `.accessibilityLabel`...                                | `accessibilityLabel`...    | ✓ `Label`、`Hint`、`Role`、`Decorative`；可点按的视图会被识别为按钮                               |
| 播报             | `AccessibilityNotification.Announcement`                | `announceForAccessibility` | ✓ `Announce`                                                                     |
| 移动屏幕阅读器的焦点     | `@AccessibilityFocusState`                              | `setAccessibilityFocus`    | ✓ `AccessibilityFocus`                                                           |
| 屏幕阅读器是否开启      | `voiceOverEnabled`                                      | `isScreenReaderEnabled`    | ✓ `Environment.ScreenReader`                                                     |
| 自定义操作、可调节控件    | `.accessibilityAction`、`.accessibilityAdjustableAction` | `accessibilityActions`     | ✓ `ViewProps.Actions`、`OnAdjust`（List 的滑动操作也会成为 TalkBack 的操作）                    |

## 工具链

|           | Xcode / Expo           | Asuka                                                                                                                                                                                                |                                                                                     |
| --------- | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| 实时重载并保留状态 | 预览、Fast Refresh        | ✓ `asuka dev`：保存即重载，并保留 signal 的值（在手机上，Go 代码运行在你的电脑上；在桌面端，应用会重新构建并运行；在浏览器里，页面会重新加载）                                                                                                                  |                                                                                     |
| 在手机上运行    | Xcode 的 Run、Expo 的开发构建 | ✓ `asuka dev --device`：iOS 模拟器、Android 模拟器、Android 手机（`adb reverse`），以及通过 USB 或 Wi-Fi 连接的 iPhone（由你的团队签名，描述文件由 Xcode 生成；优先走 usbmuxd 的隧道，否则走局域网）                                                      |                                                                                     |
| 发布构建和签名   | Xcode、EAS Build        | ✓ `asuka build`：`.ipa`、`.aab`、经过签名和公证的通用 `.app`（或 Mac App Store 用的 `.pkg`）、包含已签名 `.exe` 的 Windows 文件夹、附带 `.tar.gz` 和 Flatpak 清单的 Linux 安装前缀、静态网站（[发布](https://asuka.egoist.dev/zh/docs/shipping.md)） |                                                                                     |
| 上传到应用商店   | Xcode、EAS Submit       | ✓ `asuka publish`：TestFlight、App 审核、Google Play 的各个发布轨道；暂不支持 Mac App Store                                                                                                                           |                                                                                     |
| GUI 测试    | XCUITest、Detox、Maestro | ✓ `e2e/`：在 iOS 模拟器、Android 模拟器、Xvfb 下的 Linux 和无头 Chrome 里运行示例；Mac 和 Windows 的宿主测试会驱动真实的 AppKit 视图和 Win32 窗口                                                                                          |                                                                                     |
| 基准测试      | Instruments            | ✓ `bench/`（与 SwiftUI 和 Compose 对比）                                                                                                                                                                   |                                                                                     |
| 嵌入现有应用    | —                      | brownfield（React Native 的方案）                                                                                                                                                                         | ✓ `asuka build --platform ios --xcframework`、`asuka build --platform android --aar` |
| OTA 更新    | —                      | EAS Update：✗                                                                                                                                                                                         |                                                                                     |

## 与桌面端框架对比

在 Mac、Windows 和 Linux 上，很多应用是用 web view 包一层 HTML 做出来的。这些框架和 Asuka 的对比如下：

|          | Electron                   | Tauri                                                  | Wails                     | React Native for Windows and macOS           | Asuka                                                                           |
| -------- | -------------------------- | ------------------------------------------------------ | ------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------- |
| 平台       | Mac、Windows、Linux          | Mac、Windows、Linux；iOS 和 Android（Tauri 2）               | Mac、Windows、Linux         | Windows、Mac（配合 React Native 的 iOS 和 Android） | Mac、Windows、Linux、iOS、Android、Web                                               |
| 界面由什么呈现  | Chromium 里的 HTML 和 CSS     | 系统 web view（WKWebView、WebView2、WebKitGTK）里的 HTML 和 CSS | 系统 web view 里的 HTML 和 CSS | 平台的原生视图                                      | 平台的原生控件：AppKit；Win32 和通用控件，按 Windows 11 的样子绘制；GTK 4 和 libadwaita                |
| 应用使用的语言  | JavaScript（页面之外还有 Node.js） | Rust，加上页面里的 JavaScript                                 | Go，加上页面里的 JavaScript      | JavaScript                                   | Go                                                                              |
| 随应用分发的内容 | Chromium 和 Node.js         | 应用的二进制文件（web view 用系统自带的）                              | 应用的二进制文件（同上）              | 一个 JavaScript 引擎和 React Native 的运行时          | 应用的 Go 二进制文件（Linux 上的 GTK 4 和 libadwaita 由系统提供）；除非应用显示了 `WebView`，否则不带 web view |

web view 应用在所有系统上都长得一样，完全按它的 HTML 和 CSS 呈现，并且能用上 Web 生态里的各种库。Asuka 应用则和各平台的原生应用看起来一样（不设置任何样式的应用，在 Mac 上就是一个 Mac 应用，在 Linux 上就是一个 GNOME 应用，在 Windows 上就是一个 Windows 11 应用），也能获得它们的无障碍支持、文本输入和菜单，同时所有平台共用一套用 Go 写的布局引擎。桌面宿主在应用自己的进程里运行 Go 代码，不借助 cgo 就能调用平台接口，所以 `asuka build` 在任何系统上都能构建 Windows 和 Linux 版本。

## 桌面应用的能力

桌面应用在窗口和菜单栏之外还需要哪些能力，这里与 Electron 和 MyGo 做个对比（见[桌面端](https://asuka.egoist.dev/zh/docs/desktop.md)）。除非该行另有说明，✓ 表示 Mac、Windows 和 Linux 都支持。

|                                | Electron                                             | MyGo                                    | Asuka                                                                                                                                                                                                                                               |
| ------------------------------ | ---------------------------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 控制窗口                           | `BrowserWindow`                                      | `Window`                                | ✓ `ui.UseWindow`、`ui.MainWindow`：显示、隐藏、聚焦、最小化、最大化、全屏、大小、位置、置顶，窗口状态以 signal 形式提供；`OnCloseRequest`；按 `StateKey` 记住窗口位置；子窗口和模态窗口；隐藏标题栏（Wayland 上无法设置位置、居中和置顶，这些由合成器决定；X11 上通过 Xlib 实现）                                                                 |
| 托盘图标                           | `Tray`                                               | 托盘图标                                    | ✓ `tray.Show`（Mac 上是 `NSStatusItem`；Windows 上是通知区域；Linux 上是 StatusNotifierItem）：图标或符号、标题、悬停提示、菜单、点击                                                                                                                                                 |
| 子菜单、退出菜单项                      | `MenuItem.submenu`、roles                             | roles、子菜单                               | ✓ `MenuItem.Submenu`、`ui.MenuQuit`，可用于菜单栏、托盘菜单和程序坞菜单                                                                                                                                                                                                |
| 程序坞菜单、跳转列表任务                   | `app.dock.setMenu`、`setUserTasks`                    | 程序坞菜单、跳转列表                              | ✓ `tray.DockMenu`（程序坞菜单、跳转列表里的“任务”、Linux 启动器的快捷列表）                                                                                                                                                                                                  |
| 在后台运行的应用                       | `app.dock.hide`，以及在 `window-all-closed` 时不退出         | 后台应用                                    | ✓ `app.KeepRunning`、`app.RunInBackground`、`asuka.json` 的 `background`                                                                                                                                                                               |
| Flyout：从托盘图标弹出的窗口              | 由应用自己把无边框的 `BrowserWindow` 摆到 `tray.getBounds()` 的位置 | flyout                                  | ✓ `WindowProps.Flyout`，从 `tray.Icon.Anchor()` 或所在窗口的某个矩形区域弹出：在显示器范围内摆放，放不下时翻转方向，点击别处或按 Escape 关闭，上面还可以再打开模态对话框（Linux 上只有 X11 能定位）                                                                                                                   |
| 启动器面板                          | `type: 'panel'`（macOS）                               | 面板                                      | ✓ `Panel`：浮在所有应用和所有桌面空间（Space）之上，在 Mac 上能接收键盘输入而不激活应用，按 Escape 或点击别处时关闭（Linux 的 Wayland 下就是普通窗口）                                                                                                                                                    |
| 窗口大小随内容变化                      | 由应用自己调用 `setContentSize`                             | `FitContent`                            | ✓ `FitContent`：内容变化时，由核心的布局来决定窗口大小                                                                                                                                                                                                                  |
| 点击穿透窗口                         | `setIgnoreMouseEvents`                               | `SetIgnoreMouseEvents`、`SetInputRegion` | ✓ `ClickThrough`、`WindowHandle.SetClickThrough`（作用于整个窗口）                                                                                                                                                                                            |
| 列出已安装的应用（用于启动器）                | 无                                                    | `InstalledApps`、`FileIcon`、`LaunchApp`  | ✓ `asuka/sdk/apps` 的 `List`、`Search`、`Icon`、`Open`                                                                                                                                                                                                  |
| 全局快捷键                          | `globalShortcut`                                     | 全局快捷键                                   | ✓ `hotkey.Register`（Mac 上用 Carbon 的热键；Windows 上用 `RegisterHotKey`；Linux 上用 X11 的按键抓取或 Wayland 的 GlobalShortcuts portal）                                                                                                                             |
| 打开、保存、选择文件夹对话框                 | `dialog.showOpenDialog`、`showSaveDialog`             | 对话框                                     | ✓ `asuka/sdk/dialog` 的 `Open`、`Save`、`Folder`（Mac 上以 sheet 显示；Web 上用 File System Access 选择器或文件输入框；手机上只支持 `Open`）                                                                                                                                    |
| 在文件夹中显示、用默认应用打开、移到废纸篓          | `shell.showItemInFolder`、`openPath`、`trashItem`      | shell                                   | ✓ `asuka/sdk/shell` 的 `Reveal`、`Open`、`Trash`、`Beep`                                                                                                                                                                                                |
| 文件关联                           | `fileAssociations`（electron-builder）、`open-file`     | 文件关联                                    | ✓ `asuka.json` 的 `fileTypes`、`ui.OnOpenFiles`（iOS、Android 和已安装的 Web 应用也支持）                                                                                                                                                                          |
| 单实例，以及处理再次启动                   | `requestSingleInstanceLock`、`second-instance`        | 单实例                                     | ✓ `app.OnSecondInstance`、`asuka.json` 的 `singleInstance`（Mac 上传过来的是文件，而不是命令行参数）                                                                                                                                                                     |
| 退出，以及退出前询问                     | `app.quit`、`before-quit`                             | 退出                                      | ✓ `app.Quit`、`app.OnQuit`（`Cancel`、`SessionEnding`）                                                                                                                                                                                                 |
| 应用的各类目录                        | `app.getPath`                                        | 目录                                      | ✓ `app.DataDir`、`ConfigDir`、`CacheDir`、`LogDir`（所有平台都可用）                                                                                                                                                                                            |
| 最近使用的文档                        | `app.addRecentDocument`                              | 最近使用的文档                                 | ✓ `asuka/sdk/recent`（Mac 上的“打开最近使用”、Windows 的跳转列表、Linux 上用户的最近文件）                                                                                                                                                                                   |
| 基于文档的应用                        | —                                                    | 文档                                      | ✓ `asuka/sdk/document`：每个文件一个窗口、File 菜单、自动保存、恢复副本、关闭和退出时询问是否保存、处理被其他应用改动的文件（手机和 Web 上一次只能打开一个文档，原地保存）                                                                                                                                               |
| 登录时启动                          | `app.setLoginItemSettings`                           | 登录时启动                                   | ✓ `asuka/sdk/login`（Mac 上用 `SMAppService`，需要 macOS 13+；Windows 上用注册表的 Run 键；Linux 上用 XDG autostart 或 Background portal）                                                                                                                             |
| 监视文件                           | Node 的 `fs.watch`（chokidar）                          | `WatchFiles`、watch 插件                   | ✓ `asuka/sdk/watch` 的 `Path`、`New`（FSEvents、inotify、`ReadDirectoryChangesW`；也支持 iOS 的 kqueue、Android 的 inotify，以及 Web 上应用自己的文件）：重命名会成对报告，原子保存视为一次写入，短时间内的连续变化会合并                                                                                    |
| 显示器                            | `screen`                                             | 显示器                                     | ✓ `screen.UseDisplays`、`Nearest`、`Matching`（Wayland 上拿不到工作区域；手机和 Web 上返回各自的屏幕）                                                                                                                                                                      |
| 睡眠、唤醒、锁屏、空闲时间、电池               | `powerMonitor`                                       | 电源                                      | ✓ `asuka/sdk/power`（手机上支持电池、低电量模式和锁屏；Web 上只有电池）                                                                                                                                                                                                     |
| 应用图标上的进度和提醒                    | `setProgressBar`、`flashFrame`、`dock.bounce`          | 程序坞和任务栏                                 | ✓ `dock.SetProgress`、`RequestAttention`（Linux 上需要 dock 支持 Unity launcher API）                                                                                                                                                                       |
| 强调色、增强对比度、降低透明度                | `systemPreferences`                                  | 强调色和无障碍设置                               | ✓ `asuka/sdk/appearance`（Linux 上没有降低透明度）                                                                                                                                                                                                            |
| 正在播放和媒体键                       | （无：只能用页面里的 `navigator.mediaSession`）                 | 正在播放                                    | ✓ `asuka/sdk/nowplaying`（Mac 上用 `MPNowPlayingInfoCenter`；Windows 上用窗口的 SystemMediaTransportControls；Linux 上是一个 MPRIS 播放器）                                                                                                                           |
| 自动更新：签名发布、增量更新、Sparkle 那样的更新窗口 | `autoUpdater`（Squirrel）、electron-updater             | 更新器及其插件                                 | ✓ `asuka/sdk/update`（`Window`、`CheckForUpdates`、`Check`、`Install`、`Relaunch`；Ed25519 签名、增量更新、更新渠道；可以发布到 GitHub releases、S3 存储桶、任意 HTTPS 目录，或者你自己的服务器；`asuka publish --platform mac\|windows\|linux`）；通过系统包管理器、Flatpak 或应用商店安装的应用由它们负责更新；Web 则重新加载页面 |

MyGo 有而 Asuka 还没有的：文档方面，缺少版本（Mac 上的“浏览所有版本”）和锁定；点击穿透窗口方面，缺少输入区域（也就是窗口里仍然接收点击的那部分：Asuka 的窗口要么整个让鼠标穿过，要么完全不穿过）。

## 尚未支持

按应用最常缺的程度排序：带参数和实体的 App Intents（目前的快捷指令都不能带参数）、使用应用自定义布局的小组件（目前只有一个模板），以及 OTA 更新（即 EAS Update 那样的功能；Asuka 应用是编译好的 Go 代码，而应用商店不允许应用自行替换它）。Mac 上还缺：`ScreenOptions.ZoomFrom` 的缩放效果（推入时改为滑动）、用手势开始列表的多选，以及用 `asuka publish` 上传到 Mac App Store（目前请用 Transporter 上传 `.pkg`）。