运行时配置

此 API 仍在开发中，更多功能即将推出！

在 <srcDir>/app.config.ts 中统一定义运行时配置：

import { defineAppConfig } from '#imports';

// 为配置定义类型
declare module 'wxt/utils/define-app-config' {
  export interface WxtAppConfig {
    theme?: 'light' | 'dark';
  }
}

export default defineAppConfig({
  theme: 'dark',
});

WARNING

此文件会提交到代码仓库，因此不要在这里存放任何敏感信息。请改用环境变量。

要访问运行时配置，WXT 提供了 getAppConfig 函数：

import { getAppConfig } from '#imports';

console.log(getAppConfig()); // { theme: "dark" }

在 App Config 中使用环境变量

你可以在 app.config.ts 文件中使用环境变量。

declare module 'wxt/utils/define-app-config' {
  export interface WxtAppConfig {
    apiKey?: string;
    skipWelcome: boolean;
  }
}

export default defineAppConfig({
  apiKey: import.meta.env.WXT_API_KEY,
  skipWelcome: import.meta.env.WXT_SKIP_WELCOME === 'true',
});

这样做有以下几个优势：

• 在单个文件中定义所有需要的环境变量
• 将字符串转换为其他类型，如布尔值或数组
• 在未提供环境变量时提供默认值