解决 createWindow 参数类型错误及 Configuration 类型说明

问题分析

错误信息显示您传递给 window.createWindow() 的参数类型不正确。第一个参数应该是 Configuration 类型，但您传递了一个字符串。

解决方案

1. 正确使用 createWindow 方法

根据鸿蒙文档，createWindow 方法需要传递一个 Configuration 对象作为第一个参数，而不是字符串：

import { window } from '@kit.ArkUI';
import { common } from '@kit.AbilityKit';

@Entry
@Component
struct Index {
  async aboutToAppear() {
    // 创建正确的 Configuration 对象
    let config: window.Configuration = {
      name: "demo", // 窗口名称
      windowType: window.WindowType.TYPE_FLOAT, // 窗口类型
      ctx: getContext() // 上下文对象，需要从UIAbility获取
    };

    try {
      const win = await window.createWindow(config);
      // 使用创建的窗口进行后续操作
    } catch (error) {
      console.error(`Failed to create window. Code: ${error.code}, message: ${error.message}`);
    }
  }

  build() {
    Column() {
      Text('Hello')
        .fontSize(30)
    }
  }
}

2. 在 UIAbility 中正确创建窗口

根据鸿蒙文档示例，创建窗口通常在 UIAbility 的 onWindowStageCreate 方法中进行：

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  onWindowStageCreate(windowStage: window.WindowStage): void {
    let config: window.Configuration = {
      name: "demo",
      windowType: window.WindowType.TYPE_FLOAT,
      ctx: this.context // 使用UIAbility的context
    };
    
    try {
      window.createWindow(config).then((win: window.Window) => {
        console.info('Succeeded in creating the window.');
        // 可以在这里进行窗口操作，如调整大小
        win.resize(500, 1000);
      }).catch((err: BusinessError) => {
        console.error(`Failed to create the window. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to create the window. Cause code: ${exception.code}, message: ${exception.message}`);
    }
    
    // 加载主窗口内容
    windowStage.loadContent("pages/Index", (err) => {
      if (err.code) {
        console.error('Failed to load the content. Cause:' + JSON.stringify(err));
        return;
      }
      console.info('Succeeded in loading the content.');
    });
  }
}

Configuration 类型说明

根据鸿蒙文档，Configuration 是一个接口类型，包含以下属性：

WindowType 枚举值

• TYPE_APP: 应用窗口
• TYPE_SYSTEM_ALERT: 系统警告窗口
• TYPE_TOAST: toast窗口
• TYPE_DIALOG: 对话框窗口
• TYPE_FLOAT: 浮动窗口

注意事项

1. 创建 TYPE_FLOAT 类型窗口需要申请 ohos.permission.SYSTEM_FLOAT_WINDOW 权限
2. 需要在 module.json5 中声明所需权限：

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.SYSTEM_FLOAT_WINDOW"
      }
    ]
  }
}