HarmonyOS的窗口模块将窗口界面分为系统窗口、应用窗口两种基本类型。
ArkTS与Native跨语言交互开发详见使用Node-API实现跨语言交互开发流程。
实现Native侧获取窗口ID可参考如下步骤:
onWindowStageCreate(windowStage: window.WindowStage): void {
// Main window is created,set main page for this ability
hilog.info(0x0000, 'testTag', '%{public}s','Ability onWindowStageCreate');
// 1.获取应用主窗口。
let windowClass: window.Window | null = null;
windowStage.getMainWindow((err: BusinessError, data) => {
let errCode: number = err.code;
if (errCode) {
console.error(`Failed to obtain the main window. CCode:${err.code}, message:${err.message}`);
return;
}
windowClass = data;
// 通过windowClass的getWindowProperties方法获取id信息
this.windowID = windowClass.getWindowProperties().id;
AppStorage.setOrCreate<number>('windowID', this.windowID);
console.info(`Succeeded in obtaining the main window. Result:${data}`);
});
windowStage.loadContent('pages/Index', (err) => {
if (err.code) {
hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
return;
}
hilog.info(0x0000, 'testTag', 'Succeeded in loading the content.');
});
}
import testNapi from 'libentry.so';
@Entry
@Component
struct Index {
@StorageLink('windowID') windowID: number = 0;
build() {
Row() {
Column() {
Text('setWindowID')
.fontSize($r('app.float.page_text_font_size'))
.fontWeight(FontWeight.Bold)
.onClick(() => {
testNapi.setWindowID(this.windowID);
});
}
.width('100%');
}
.height('100%');
}
}
int32_t g_WindowID;
static napi_value setWindowID(napi_env env, napi_callback_info info)
{
size_t argc = 1;
napi_value args[1] = {nullptr};
napi_typedarray_type type_napi;
napi_get_cb_info(env, info, &argc, args, nullptr, nullptr);
napi_get_value_int32(env, args[0], &g_WindowID);
OH_LOG_Print(LOG_APP, LOG_INFO, 0x0, "setWindowID", "get windowID %{public}d", g_WindowID);
return nullptr;
}
完整代码:
entry>src>main>ets>entryability>EntryAbility.ets:
import { ConfigurationConstant, UIAbility } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';
const DOMAIN = 0x0000;
export default class EntryAbility extends UIAbility {
windowID: number = 0;
onCreate(): void {
this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
}
onDestroy(): void {
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onDestroy');
}
onWindowStageCreate(windowStage: window.WindowStage): void {
// Main window is created,set main page for this ability
hilog.info(0x0000, 'testTag', '%{public}s','Ability onWindowStageCreate');
// 1.获取应用主窗口。
let windowClass: window.Window | null = null;
windowStage.getMainWindow((err: BusinessError, data) => {
let errCode: number = err.code;
if (errCode) {
console.error(`Failed to obtain the main window. CCode:${err.code}, message:${err.message}`);
return;
}
windowClass = data;
// 通过windowClass的getWindowProperties方法获取id信息
this.windowID = windowClass.getWindowProperties().id;
AppStorage.setOrCreate<number>('windowID', this.windowID);
console.info(`Succeeded in obtaining the main window. Result:${data}`);
});
windowStage.loadContent('pages/Index', (err) => {
if (err.code) {
hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
return;
}
hilog.info(0x0000, 'testTag', 'Succeeded in loading the content.');
});
}
onWindowStageDestroy(): void {
// Main window is destroyed, release UI related resources
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
}
onForeground(): void {
// Ability has brought to foreground
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
}
onBackground(): void {
// Ability has back to background
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground');
}
}; entry>src>main>ets>pages>Index.ets:
import testNapi from 'libentry.so';
@Entry
@Component
struct Index {
@StorageLink('windowID') windowID: number = 0;
build() {
Row() {
Column() {
Text('setWindowID')
.fontSize($r('app.float.page_text_font_size'))
.fontWeight(FontWeight.Bold)
.onClick(() => {
testNapi.setWindowID(this.windowID);
});
}
.width('100%');
}
.height('100%');
}
}
entry>src>main>cpp>types>libentry>index.d.ts:
export const setWindowID: (windowID: number) => void;
entry>src>main>cpp>napi_init.cpp:
/*
* Copyright (c) Huawei Technologies Co., Ltd. 2025. All rights reserved.
*/
#include "napi/native_api.h"
#include "hilog/log.h"
int32_t g_WindowID;
static napi_value setWindowID(napi_env env, napi_callback_info info)
{
size_t argc = 1;
napi_value args[1] = {nullptr};
napi_typedarray_type type_napi;
napi_get_cb_info(env, info, &argc, args, nullptr, nullptr);
napi_get_value_int32(env, args[0], &g_WindowID);
OH_LOG_Print(LOG_APP, LOG_INFO, 0x0, "setWindowID", "get windowID %{public}d", g_WindowID);
return nullptr;
}
EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports)
{
napi_property_descriptor desc[] = {
{ "setWindowID", nullptr, setWindowID, nullptr, nullptr, nullptr, napi_default, nullptr }
};
napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
return exports;
}
EXTERN_C_END
static napi_module demoModule = {
.nm_version = 1,
.nm_flags = 0,
.nm_filename = nullptr,
.nm_register_func = Init,
.nm_modname = "entry",
.nm_priv = ((void*)0),
.reserved = { 0 },
};
extern "C" __attribute__((constructor)) void RegisterEntryModule(void)
{
napi_module_register(&demoModule);
}
Q:Native侧有办法对窗口进行管理和控制么?
A:可以通过WindowManager模块的C API对窗口进行控制,由于其接口均需要windowID作为入参,需要在调用前获取到windowID。
Q:如何传入多个windowID?
A:如果需要传入多个windowID可以通过构建Int32Array进行填充,在Native侧创建数组接收。