Skip to content
On this page

移动端开发 ​

学习如何开发移动设备上的插件。

在桌面模拟移动设备 ​

您可以直接通过开发者工具模拟 Obsidian 在移动设备上运行。

  1. 打开 开发者工具。
  2. 选择 Console 标签。
  3. 输入以下内容并按 Enter 键。
ts
this.app.emulateMobile(true);

想要禁用移动设备模拟,输入以下内容并按 Enter 键:

ts
this.app.emulateMobile(false);

TIP

要想来回切换移动设备模拟,您可以使用 this.app.isMobile 标签:

ts
this.app.emulateMobile(!this.app.isMobile);

平台的特定功能 ​

使用 Platform 以探测当前您的插件所运行的平台:

ts
import { Platform } from "obsidian";

if (Platform.isIosApp) {
  // ...
}

if (Platform.isAndroidApp) {
  // ...
}

在移动设备上禁用您的插件 ​

如果您的插件需要使用 Node.js 或者 Electron API,您可以阻止用户在移动设备上安装您的插件。

要想仅支持桌面端 app,在 manifest.json 中将 isDesktopOnly 的值设置为 true。

故障排除 ​

这部分罗列了在开发移动端插件时常见的一些问题。

Node 以及 Electron APIs ​

Node.js 以及 Electron API 在移动端设备上无法获取。任何对它们的调用都会导致您的插件崩溃。

正则表达式中的后行断言(lookbehind) ​

目前在 iOS 中不支持正则表达式中的后行断言(lookbehind)。要想兼容 iOS 用户,请查阅 平台的特定功能。

有关最新支持状态,请查阅 Can I Use。查看 "Safari on iOS" 部分。