错误信息
Repeated operation.
错误描述
当进行某些重复操作时,系统会报此错误码。
可能原因
窗口已经被创建。
处理步骤
在创建窗口前,检查该窗口是否已经被创建或者是否已经处于当前状态。
错误信息
This window state is abnormal.
错误描述
当窗口状态异常,如未创建或已被销毁时,操作该窗口,会报此错误码。
可能原因
操作窗口时,该窗口未创建或已被销毁。
处理步骤
在对窗口进行操作前,检查该窗口是否存在,确保其已创建且未被销毁,再进行相关操作。
可能原因
开发者在窗口销毁过程中(如onWindowStageDestroy、页面销毁等)调用getLastWindow()接口,导致应用崩溃。
典型日志信息
故障日志格式:
Error Name: Error Error Message: [window][getLastWindow]msg: xxx Error code: 1300002 Stack trace: at window.getLastWindow (WindowManagerService) at MyComponent.onWindowStageDestroy (MyAbility.ts:50)
关键信息:
处理步骤
根据日志堆栈定位getLastWindow()调用位置,检查是否在销毁流程中(onWindowStageDestroy、aboutToDisappear等)。常见场景:窗口创建时未调用loadContent()加载页面,销毁流程中错误调用getLastWindow导致崩溃。
解决要点:
正反案例
错误示例
// 错误:窗口创建时未加载页面,销毁流程中调用getLastWindow
onWindowStageCreate(windowStage: window.WindowStage) {
// 缺失:未调用loadContent加载页面
windowStage.getMainWindow((err, win) => {
win.showWindow(); // 直接显示空窗口
});
}
onWindowStageDestroy() {
let lastWindow = window.getLastWindow(this.context); // 崩溃!
} 正确示例
// 正确:窗口创建时立即加载页面,销毁流程只做资源清理
onWindowStageCreate(windowStage: window.WindowStage) {
windowStage.getMainWindow((err, win) => {
win.loadContent('pages/MainPage'); // 创建时加载页面
});
}
onWindowStageDestroy() {
this.cleanupResources(); // 只做资源清理,不调用getLastWindow
} 可能原因
开发者在子窗口上调用setResizeByDragEnabled()接口设置窗口可拖拽缩放时,返回错误码1300002,无法实现拖拽缩放功能。
典型日志信息
通过DevEco Studio或hdc查看错误日志:
hdc shell hilog | grep -i -E "1300002|setResizeByDragEnabled"
典型日志示例:
SetResizeByDragEnabled: This is not main window or decor enabled sub window
关键信息:
处理步骤
检查创建子窗口时是否在SubWindowOptions中将decorEnabled设置为true。
对于调用该接口的子窗口,要保证子窗口已开启窗口标题栏。
正反案例
错误示例
windowStage.createSubWindowWithOptions('mySubWindow', {
title: "",
decorEnabled: false, // 错误:未开启标题栏
isModal: false,
maximizeSupported: true
}); 正确示例
let options: window.SubWindowOptions = {
title: "",
decorEnabled: true, // 开启窗口标题栏
isModal: false,
maximizeSupported: true
};
windowStage.createSubWindowWithOptions('mySubWindow', options).then((windowClass) => {
// decorEnabled=true时可正常调用
windowClass.setResizeByDragEnabled(true, (err: BusinessError) => {
console.error("setResizeByDragEnabled failed.", ` code: ${err.code}, message: ${err.message}`)
})
}) 可能原因
开发者在调用findWindow()查找不存在的窗口时,导致应用崩溃。
典型日志信息
故障日志格式:
Error Name: Error Error Message: [window][findWindow]msg: The window is not created or destroyed Error code: 1300002 Stack trace: at window.findWindow (WindowManagerService) at MyComponent.onCreate (MyAbility.ts:50)
关键信息:
处理步骤
根据日志堆栈定位findWindow()调用位置,检查窗口名称是否正确。使用以下命令查找findWindow参数信息:
grep -n "findWindow" src/**/*.ts
使用hidumper验证窗口状态:
hdc shell hidumper -s WindowManagerService -a '-a'
正反案例
错误示例
// 错误:查找窗口时传入错误窗口名称
const currWindow = window.findWindow("test_Window");
// 错误:对为空的对象进行函数调用
currWindow.showWindow(); 正确示例
// 正确:findWindow之后对获取到的对象进行空校验
const currWindow = window.findWindow("test_Window");
if (currWindow) {
currWindow.showWindow();
} else {
console.error('Window not found');
} 可能原因
开发者在createSubWindow()创建窗口对象后,使用destroyWindow(),在窗口还未销毁的情况下,再次调用createSubWindow(),且使用相同名称,导致窗口创建失败,报错1300002。
典型日志信息
故障日志格式:
WindowSessionCreateCheck: WindowName(TestSubWindow) already exists. Error code: 1300002
关键信息:
处理步骤
destroyWindow()接口用于销毁对应窗口实例,该接口为异步接口,若createSubWindow接口调用时,需要销毁的窗口实例还未销毁完成,则有可能创建同名,触发1300002错误。
根据日志堆栈定位createSubWindow()调用位置,查找所有createSubWindow调用位置,检查是否有使用相同窗口名称的情况:
grep -n "createSubWindow" src/**/*.ts
在创建窗口失败后,使用hidumper查看当前窗口状态:
hdc shell hidumper -s WindowManagerService -a '-a'
解决要点:
正反案例
错误示例
let windowClass: window.Window | undefined = undefined;
let windowClass = await windowStage.createSubWindow('mySubWindow');
// 错误,destroyWindow为异步接口,却当做同步接口使用
windowClass.destroyWindow();
let newWindow = await windowStage.createSubWindow('mySubWindow'); // 此处可能会返回1300002错误 正确示例
// 正确:等待销毁完成后再创建
let windowClass = await windowStage.createSubWindow('mySubWindow');
// 调用销毁并等待完成
await windowClass.destroyWindow();
// 确保销毁完成后,再创建同名窗口
let newWindow = await windowStage.createSubWindow('mySubWindow'); 或使用不同的窗口名称避免重名:
// 使用时间戳作为窗口名称的一部分,避免重名 let windowName = 'mySubWindow_' + Date.now(); let windowClass = await windowStage.createSubWindow(windowName);
可能原因
开发者在窗口销毁过程中(如onWindowStageDestroy、onDestroy或页面销毁等)调用off('avoidAreaChange')接口,导致应用崩溃。
典型日志信息
Error Name: Error
Error Message: [window][off]msg: Unregister listener failed.
Error code: 1300002
Stack trace:
at windowClass.off('avoidAreaChange') (WindowManagerService)
at MyComponent.onWindowStageDestroy (MyAbility.ts:50) 关键信息:
处理步骤
正反案例
错误示例
// 错误:在onWindowStageDestroy中调用off
onWindowStageDestroy() {
this.windowClass.off('avoidAreaChange'); // 窗口可能已经销毁,1300002崩溃!
} 正确示例
// 取消监听时机:页面隐藏或卸载前(非销毁流程)
onPageHide() {
try {
this.windowClass?.off('avoidAreaChange');
} catch (exception) {
console.error(`Failed to disable the listener. Cause code: ${exception.code}, message: ${exception.message}`);
}
} 错误信息
This window manager service works abnormally.
错误描述
当系统服务工作异常时,会报此错误码。
可能原因
窗口内部服务没有正常启动。
处理步骤
系统服务内部工作异常,请稍后重试,或者重启设备尝试。
错误信息
Unauthorized operation.
错误描述
当对无操作权限的对象进行操作时,会报此错误码。
可能原因
操作了其它进程的窗口对象。
处理步骤
请检查是否非法操作了其它进程的窗口对象,若存在,请删除相关操作。
可能原因
开发者对子窗口调用restore()接口,导致操作失败,报错1300004。
典型日志信息
故障日志:
BusinessError 1300004: Unauthorized operation. Possible cause: Invalid window Type.Only main windows are supported.
处理步骤
restore()接口只能对主窗口进行恢复操作,否则会报1300004错误。
使用hidumper查看窗口类型,确认窗口是否为主窗口:
hdc shell hidumper -s WindowManagerService -a '-a'
在输出中查找目标窗口,根据Type字段判断:
可能原因
开发者在应用子窗口、全局悬浮窗等非应用主窗口上调用getWindowSystemBarProperties()接口,报错1300004。
典型日志信息
Error Name: Error Error Message: [window][getWindowSystemBarProperties]msg: Invalid window type. Only main windows are supported. Error code: 1300004 Stack trace: at windowClass.getWindowSystemBarProperties() (WindowManagerService) at MyComponent.onWindowStageCreate (MyAbility.ts:50)
关键信息:
处理步骤
getWindowSystemBarProperties()接口只适用于应用主窗口调用,否则会报1300004错误。
使用hidumper查看窗口类型,确认当前窗口是否为应用主窗口:
hdc shell hidumper -s WindowManagerService -a '-a'
在输出中查找目标窗口,根据Type字段判断。若Type为1,则对应为主窗口,可以调用getWindowSystemBarProperties();否则不可以调用getWindowSystemBarProperties()。
正反案例
错误示例
windowStage.createSubWindow('mySubWindow', (err: BusinessError, data) => {
const errCode: number = err.code;
if (errCode) {
console.error(`Failed to create the subwindow. Cause code: ${err.code}, message: ${err.message}`);
return;
}
windowClass = data;
console.info(`Succeeded in creating the subwindow. Data: ${JSON.stringify(data)}`);
if (!windowClass) {
console.info('Failed to load the content. Cause: windowClass is null');
}
let systemBarProperty = windowClass.getWindowSystemBarProperties()
}); 正确示例
onWindowStageCreate(windowStage: window.WindowStage) {
let windowClass = windowStage.getMainWindowSync();
try {
let systemBarProperty = windowClass.getWindowSystemBarProperties();
console.info('Success in obtaining system bar properties. Property: ' + JSON.stringify(systemBarProperty));
} catch (err) {
console.error(`Failed to get system bar properties. Code: ${err.code}, message: ${err.message}`);
}
} 错误信息
This window stage is abnormal.
错误描述
当WindowStage异常,如已被销毁时,操作该WindowStage,会报此错误码。
可能原因
该WindowStage没有被创建或者已经被销毁。
处理步骤
在对WindowStage进行操作前,检查该WindowStage是否存在,若已被销毁,请释放该WindowStage下的窗口。
错误信息
This window context is abnormal.
错误描述
当窗口上下文异常,如已被销毁时,操作该窗口上下文,会报此错误码。
可能原因
操作窗口上下文时,该窗口上下文已被销毁。
处理步骤
在对窗口上下文进行操作前,检查该窗口上下文是否存在,确保其未被销毁,再进行相关操作。
错误信息
Restore parent main window failed.
错误描述
恢复当前窗口的主窗口到前台显示失败。
可能原因
主窗口处于PAUSED生命周期状态。
处理步骤
确保主窗口生命周期状态正常,再进行相关操作。
错误信息
The display device is abnormal.
错误描述
显示设备异常。
可能原因
显示设备没有准备好。
显示设备被移除。
处理步骤
确保显示设备正常,再进行相关开发。
错误信息
The parent window is invalid.
错误描述
父窗口无效。
可能原因
子窗口没有绑定父窗口。
处理步骤
检查确保子窗口成功绑定父窗口。
错误信息
The operation in the current window status is invalid.
错误描述
当前窗口模式不支持该操作。
可能原因
对全屏或分屏窗口进行move操作。
处理步骤
不要对全屏或分屏窗口进行move操作。
错误信息
The PiP window state is abnormal.
错误描述
画中画窗口状态异常。
可能原因
画中画窗口已被销毁,但代码仍在尝试访问该窗口。
画中画窗口处于无效状态(如尚未创建、已关闭、正在销毁)。
在画中画窗口销毁后,异步任务或回调中访问了窗口对象。
处理步骤
在画中画生命周期状态为ABOUT_TO_STOP或STOPPED时不可调用stopPiP()接口。
在画中画生命周期状态为ABOUT_TO_START或STARTED时不可调用startPiP()接口。
可能原因
开发者在画中画窗口销毁后(如用户退出画中画、窗口生命周期结束等)调用画中画窗口stopPiP()接口,触发错误码1300012。
典型日志信息
Error Name: Error Error Message: [PiPWindow][stopPiP]msg: The window is not created or destroyed. Error code: 1300012
处理步骤
是否在画中画生命周期状态为ABOUT_TO_STOP或STOPPED时调用stopPiP()接口。
在以上状态时,代表画中画窗口即将停止或已经停止,此时不可调用stopPiP()接口。
是否在setTimeout、Promise等异步回调中调用stopPiP(),且回调执行时窗口可能已销毁。
在异步回调中,画中画窗口可能已被销毁,代码中没有对画中画窗口状态进行校验,此时调用stopPiP()接口会导致错误。
正反案例
错误示例
// 错误:异步任务在窗口销毁后调用stopPiP()接口
stopPiPTimer() {
setTimeout(() => {
this.pipController?.stopPiP();
}, 1000);
} 正确示例
async stopPiPSafely(pipController: PiPController) {
let state: string = 'undefined';
pipController.on('stateChange', (newState: string, reason: string) => {
state = newState;
if (state === 'STARTED') {
pipController?.stopPiP();
}
});
} 可能原因
开发者在画中画窗口处于已经启动或正在启动中的状态时,调用画中画窗口startPiP()接口,触发错误码1300012。
典型日志信息
Error Name: Error Error Message: [PiPWindow][startPiP]msg: The window is already started or is about to start. Error code: 1300012
处理步骤
是否在画中画生命周期状态为ABOUT_TO_START或STARTED时调用startPiP()接口。
在该状态时,代表画中画窗口即将启动或已经启动,此时不可调用startPiP()接口。
是否在setTimeout、Promise等异步回调中调用startPiP(),且回调执行时窗口可能已启动。
在异步回调中,画中画窗口可能已经启动或正在启动中,代码中没有对画中画窗口状态进行校验,此时调用startPiP()接口会导致错误。
正反案例
错误示例
// 错误:异步任务在窗口已创建后调用startPiP()接口
startPiPTimer() {
setTimeout(() => {
this.pipController?.startPiP();
}, 1000);
} 正确示例
async startPiPSafely(pipController: PiPController) {
let state: string = 'undefined';
pipController.on('stateChange', (newState: string, reason: string) => {
state = newState;
if (state === 'STOPPED') {
pipController?.startPiP();
}
});
} 错误信息
Failed to create the PiP window.
错误描述
创建画中画窗口失败。
可能原因
启动画中画时传入参数有误。
处理步骤
检查启动画中画参数。
错误信息
Repeated PiP operation.
错误描述
重复操作画中画。
可能原因
这个画中画已经被拉起或者已经被关闭。
处理步骤
不要重复启动/停止画中画。
错误信息
Parameter error.
错误描述
参数错误,如值超出允许的范围、字符串/数组的长度不符合要求、参数格式不正确等。
可能原因
参数的值超出允许的范围。
参数的长度超出允许的长度。
参数的格式不正确。
处理步骤
检查参数是否符合规范。
错误信息
API call timed out.
错误描述
接口调用超时。
可能原因
同步接口调用等待时间超出了限制范围。
处理步骤
需根据具体业务场景而定,常见的几种处理方式:
API接口在有限次数内进行重新调用。
降级处理,使用缓存或执行其他业务逻辑。
中断本次逻辑处理。
错误信息
Wrong parameters for operating the floating ball.
错误描述
参数错误,包括值超出范围、字符串或数组长度不符、参数格式不正确。
可能原因
参数的值超出允许的范围。
参数的长度超出允许的长度。
参数的格式不正确。
必传的参数没有传入。
处理步骤
参数值应处于允许的范围内。
参数的长度应处于允许的长度范围内。
参数应使用正确的格式。
检查是否有未传入的必传参数。
闪控球相关参数具体可见FloatingBallParams。
错误信息
Failed to create the floating ball window.
错误描述
创建闪控球窗口失败。
可能原因
启动闪控球时参数有误。
在不支持的设备上启动闪控球。
应用在后台时启动闪控球。
处理步骤
启动闪控球前,请检查参数。
启动闪控球前,请检查设备环境是否支持。
在拉起闪控球前,判断应用是否处于前台。
错误信息
Failed to start multiple floating ball windows.
错误描述
启动多个闪控球失败。
可能原因
同一应用创建多个闪控球控制器启动闪控球。
处理步骤
同一应用应仅创建一个闪控球控制器以启动闪控球,建议使用单例模式来持有闪控球控制器。
错误信息
Repeated floating ball operation.
错误描述
重复操作闪控球。
可能原因
闪控球在启动状态下再次启动。
闪控球停止后,再次停止无效。
重复注册闪控球回调。
处理步骤
在启动操作前,检查闪控球是否已启动。
在停止操作前,检查闪控球是否已停止。
在注册闪控球回调操作前,确保回调未注册。
错误信息
Floating ball internal error.
错误描述
闪控球内部错误。
可能原因
闪控球依赖的窗口异常,可能为空。
闪控球控制器异常,可能是控制器为空。
处理步骤
检查闪控球的窗口,确保其非空。
检查闪控球控制器的状态,确保其不为空。
错误信息
The floating ball window state is abnormal.
错误描述
闪控球窗口状态异常。
可能原因
闪控球窗口状态异常,可能未创建或已被销毁。
处理步骤
检查闪控球的窗口状态,确保窗口已创建且未被销毁。
错误信息
The floating ball state does not support this operation.
错误描述
闪控球状态不支持该操作。
可能原因
在闪控球未启动时进行更新操作。
闪控球未启动时,查询窗口信息。
闪控球未启动时,拉起应用窗口。
调用闪控球停止接口,流程未完成时启动闪控球。
处理步骤
进行更新操作前,检查闪控球是否已启动。
进行查询闪控球窗口信息操作时,检查闪控球是否已启动。
进行拉起应用窗口操作时,检查闪控球是否已启动。
等待闪控球回调停止后,再次启动闪控球。
错误信息
Failed to restore the main window.
错误描述
闪控球拉起应用窗口失败。
可能原因
传入参数有误。
应用未申请ohos.permission.AUTO_RESTORE_MAIN_WINDOW权限的情况下,拉起应用窗口前未点击闪控球。
拉起非本应用的窗口。
处理步骤
请检查应用窗口的拉起参数。
若希望不与用户交互直接拉起应用窗口,请申请ohos.permission.AUTO_RESTORE_MAIN_WINDOW权限。否则,请在点击闪控球之后再拉起应用窗口。
仅拉起本应用窗口。
错误信息
When updating the floating ball, the template type cannot be changed.
错误描述
更新闪控球时,模板类型与创建时不同。
可能原因
更新闪控球与创建闪控球时的模板类型不一致。
处理步骤
请确保在更新闪控球时,模板类型与创建闪控球时的模板类型一致。
错误信息
Updating static template-based floating balls is not supported.
错误描述
不支持更新静态模板类型闪控球。
可能原因
更新静态模板类型的闪控球。
处理步骤
请删除已有的静态模板类型闪控球,然后创建新的闪控球。
错误信息
Repeated operations on the float view.
错误描述
重复操作闪控窗。
可能原因
闪控窗正在启动中或处于已启动的状态时,重复启动闪控窗。
闪控窗正在停止中或处于已停止的状态时,重复停止闪控窗。
重复注册闪控窗回调。
处理步骤
建议通过onStateChange获取当前状态变化。启动闪控窗前,检查闪控窗是否处于已启动的状态。
建议通过onStateChange获取当前状态变化。停止闪控窗前,检查闪控窗是否处于已停止的状态。
注册闪控窗回调前,确保回调未注册。
错误信息
The floatView state does not support this operation.
错误描述
闪控窗状态不支持该操作。
可能原因
闪控窗已启动但未停止时,执行要求停止态的操作(例如绑定、解绑等)。
闪控窗未启动时,执行需要启动态的操作(例如停止、恢复主窗口或获取窗口属性)。
闪控窗处于正在停止状态时,执行启动操作。
处理步骤
操作前检查闪控窗当前状态,确保其满足接口的状态要求。
如需停止闪控窗,请先确保闪控窗已启动。
等待闪控窗停止完成(通过状态变化回调确认)后再执行后续操作。
错误信息
Failed to restore the main window.
错误描述
闪控窗拉起应用主窗口失败。
可能原因
用户从未点击过闪控窗窗口。
闪控窗窗口不在前台。
主窗口处于PAUSED生命周期状态。
主窗口处于多任务界面中。
处理步骤
引导用户先点击闪控窗窗口,再尝试恢复主窗口。
检查闪控窗窗口是否在前台显示。
检查主窗口生命周期状态,避免在PAUSED状态下调用恢复接口。
确保主窗口不处于多任务状态,再尝试恢复。
错误信息
Failed to start float view.
错误描述
启动闪控窗失败。
可能原因
同一应用重复启动了多个闪控窗。
启动闪控窗时,context关联的主窗口不在前台。
处理步骤
同一应用只能启动一个闪控窗,请避免同时启动多个闪控窗。
启动闪控窗前,请确保传入context的应用窗口处于前台。
错误信息
This operation conflicts with other floating windows.
错误描述
该操作与其他悬浮窗口冲突。
可能原因
应用已启动闪控球窗口或画中画窗口。
处理步骤
启动闪控窗前,请先停止闪控球窗口和画中画窗口。
错误信息
Creating a subwindow is not allowed in the current context.
错误描述
当前上下文不允许创建子窗口。
可能原因
应用Ability继承自AgentUIExtensionAbility。
处理步骤
创建子窗口前,检查应用Ability是否继承自AgentUIExtensionAbility。
错误信息
A window null pointer occurs.
错误描述
窗口空指针异常,如出现空指针时,操作该窗口,会报此错误码。
可能原因
操作窗口时,出现空指针。
处理步骤
在对窗口进行操作前,检查该窗口是否存在空指针,确保其不存在空指针,再进行相关操作。
错误信息
This window type is invalid.
错误描述
窗口类型无效。
可能原因
使用了无效的窗口类型,有效的窗口类型见WindowType。
处理步骤
请使用WindowType支持的窗口类型,再进行相关操作。
错误信息
This window parameter is invalid.
错误描述
当窗口参数无效时,操作该窗口,会报此错误码。
可能原因
操作窗口时,该窗口参数无效。
处理步骤
在对窗口进行操作前,检查该窗口参数是否有效,确保其参数有效,再进行相关操作。
错误信息
This system ability service works abnormally.
错误描述
当元能力服务工作异常时,会报此错误码。
可能原因
当销毁窗口时,如初始化proxy失败。
处理步骤
元能力服务异常,重启设备尝试。