平台检测

isPlatform

isPlatform 方法可用于检测您的应用是否运行在特定平台上：

import { isPlatform } from '@ionic/vue';

isPlatform('ios'); // 在 iOS 设备上运行时返回 true

根据用户所在的平台，isPlatform(platformName) 会返回 true 或 false。请注意，同一个应用可能对多个平台名称返回 true。例如，在 iPad 上运行的应用会对以下平台名称返回 true：mobile、ios、ipad 和 tablet。此外，如果应用运行在 Cordova 环境中，则 cordova 也会返回 true。

getPlatforms

getPlatforms 方法可用于确定您的应用当前运行在哪些平台上。

import { getPlatforms } from '@ionic/vue';

getPlatforms(); // 在 iPhone 上返回 ["iphone", "ios", "mobile", "mobileweb"]

根据您使用的设备，getPlatforms 可能返回多个值。每个可能的值代表一个平台层级。例如，在 iPhone 上，它会返回 mobile、ios 和 iphone。

平台列表

下表列出了所有可能的平台值及其对应描述。

平台名称	描述
android	运行 Android 的设备
capacitor	运行 Capacitor 的设备
cordova	运行 Cordova 的设备
desktop	桌面设备
electron	运行 Electron 的桌面设备
hybrid	运行 Capacitor 或 Cordova 的设备
ios	运行 iOS 的设备
ipad	iPad 设备
iphone	iPhone 设备
mobile	移动设备
mobileweb	移动设备中的网页浏览器
phablet	平板手机设备
pwa	PWA 应用
tablet	平板设备

自定义平台检测函数

可以通过在全局 Ionic 配置 中提供替代函数来覆盖用于检测特定平台的函数。每个函数以 window 作为参数并返回布尔值。

createApp(App).use(IonicVue, {
  platform: {
    /** 默认的 `desktop` 函数对带触摸屏的设备返回 false。
     * 这并不总是我们想要的，因此这个函数改为检测用户代理。
     **/
    desktop: (win) => {
      const isMobile = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(win.navigator.userAgent);
      return !isMobile;
    },
  },
});

type PlatformConfig = {
  android?: ((win: Window) => boolean) | undefined;
  capacitor?: ((win: Window) => boolean) | undefined;
  cordova?: ((win: Window) => boolean) | undefined;
  desktop?: ((win: Window) => boolean) | undefined;
  electron?: ((win: Window) => boolean) | undefined;
  hybrid?: ((win: Window) => boolean) | undefined;
  ios?: ((win: Window) => boolean) | undefined;
  ipad?: ((win: Window) => boolean) | undefined;
  iphone?: ((win: Window) => boolean) | undefined;
  mobile?: ((win: Window) => boolean) | undefined;
  mobileweb?: ((win: Window) => boolean) | undefined;
  phablet?: ((win: Window) => boolean) | undefined;
  pwa?: ((win: Window) => boolean) | undefined;
  tablet?: ((win: Window) => boolean) | undefined;
};