平台别名

为不同平台配置简短别名,简化命令行操作

平台别名在 unh.config.ts 的 platform.alias 里配置。别名用于简化命令行操作,也用于精简 package.json 的 scripts。

配置

unh.config.ts
import { defineConfig } from '@uni-helper/unh'

export default defineConfig({
  platform: {
    // 设置默认平台
    default: 'h5',
    // 配置平台别名,一个平台可以配多个
    alias: {
      'mp-weixin': ['wx'],
      'mp-alipay': ['ali', 'alipay'],
    },
  },
})

使用

不写平台时,unh dev 使用 platform.default:

terminal
unh dev
# 等同于: unh dev h5

写别名时,unh 先解析成完整平台名:

terminal
unh dev wx
# 等同于: unh dev mp-weixin

unh dev ali
# 等同于: unh dev mp-alipay

unh dev alipay
# 等同于: unh dev mp-alipay

配置项

platform.default

default
Platform
未指定平台时使用的平台

platform.alias

alias
Record<Platform, string | string[]>
平台别名。每个平台可以配一个别名,也可以配多个

内置平台

平台清单来自 src/constants/platform.ts。unh platform 会用表格列出同一份数据。

export const PLATFORM_DESCRIPTIONS = {
  // 应用
  'app': '通用应用平台',
  'app-plus': 'uni-app 应用平台',
  'app-android': 'Android 应用平台',
  'app-ios': 'iOS 应用平台',
  'app-harmony': '鸿蒙应用平台',

  // 自定义
  'custom': '自定义平台',

  // h5
  'h5': 'HTML5 网页平台',
  'h5:ssr': 'HTML5 服务端渲染平台',

  // 小程序
  'mp-alipay': '支付宝小程序',
  'mp-baidu': '百度小程序',
  'mp-harmony': '鸿蒙小程序',
  'mp-jd': '京东小程序',
  'mp-kuaishou': '快手小程序',
  'mp-lark': '飞书小程序',
  'mp-qq': 'QQ小程序',
  'mp-toutiao': '字节跳动小程序',
  'mp-weixin': '微信小程序',
  'mp-xhs': '小红书小程序',

  // 快应用
  'quickapp-webview': '快应用 WebView',
  'quickapp-webview-huawei': '华为快应用',
  'quickapp-webview-union': '快应用联盟',
} as const