平台别名在 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