鴻蒙OS lAbilityDelegator

全局測試實用程序界面，用于添加 IAbilityMonitor 對象并控制功能的生命周期狀態(tài)。

您可以調(diào)用 addAbilityMonitor（java.lang.String） 來添加IAbilityMonitor對象，以監(jiān)視指定功能的生命周期狀態(tài)。您還可以調(diào)用諸如 triggerClickEvent（ohos.aafwk.ability.Ability，ohos.agp.components.Component）之類的方法 來控制能力的生命周期狀態(tài)并調(diào)度輸入事件。

領(lǐng)域摘要

修飾符和類型	領(lǐng)域	描述
靜態(tài)整數(shù)	活性	指示該能力處于活動狀態(tài)。
靜態(tài)整數(shù)	背景	指示該能力處于后臺狀態(tài)。
靜態(tài)整數(shù)	不活躍	指示該能力處于非活動狀態(tài)。
靜態(tài)整數(shù)	初始	指示該能力處于初始狀態(tài)。
靜態(tài)整數(shù)	未定義	表示該能力的生命周期狀態(tài)未定義。

方法總結(jié)

修飾符和類型	方法	描述
IAbilityMonitor	addAbilityMonitor（字符串 abilityName）	基于指定的功能名稱創(chuàng)建 IAbilityMonitor 對象，以監(jiān)視功能的生命周期狀態(tài)變化。
void	clearAllMonitors（）	清除保存在內(nèi)存中的所有IAbilityMonitor對象。
整型	getAbilitySliceState（AbilitySlice targetSlice）	獲取指定能力切片的生命周期狀態(tài)。
整型	getAbilityState(Ability ability)	獲得指定能力的生命周期狀態(tài)。
List<AbilitySlice>	getAllAbilitySlice（(Ability ability)	獲取指定能力的所有能力切片。
AbilitySlice	getCurrentAbilitySlice(Ability ability)	獲得指定能力的最高能力切片。
Ability	getCurrentTopAbility（）	獲得當(dāng)前正在顯示的功能。
整型	getMonitorsNum（）	獲取保存在內(nèi)存中的IAbilityMonitor對象的總數(shù)。
void	print(String msg)	將日志信息打印到單元測試控制臺。
void	removeAbilityMonitor（IAbilityMonitor監(jiān)視器）	從應(yīng)用程序內(nèi)存中刪除指定的IAbilityMonitor對象。
布爾值	runOnUIThreadSync(Runnable task)	在UI線程上運行指定的任務(wù)并阻塞線程，直到任務(wù)完成。
Optional<Ability>	startAbilitySync(Intent intent)	根據(jù)給定的Intent啟動一項功能，并等待2秒鐘以開始運行該功能，然后再返回。
Optional<Ability>	startAbilitySync(Intent intent, long timeout)	根據(jù)給定的Intent啟動一項功能，并等待指定的時間段才能開始運行該功能，然后再返回。
boolean	stopAbility(Ability ability)	消滅指定的能力。
boolean	triggerClickEvent(Ability ability, Component view)	將click事件調(diào)度到給定功能的指定Component對象，并等待對其進行處理。
boolean	triggerKeyEvent(Ability ability, KeyEvent keyEvent)	將按鍵事件分配給給定的功能，然后等待其處理。
boolean	triggerTouchEvent(Ability ability, TouchEvent touchEvent)	將觸摸事件分配給給定的功能，然后等待其處理。
Optional<Ability>	waitAbilityMonitor(IAbilityMonitor monitor)	等待并返回與在給定IAbilityMonitor中設(shè)置的條件匹配的Ability對象。
Optional<Ability>	waitAbilityMonitor(IAbilityMonitor monitor, long timeout)	等待并返回與指定時間段內(nèi)給定IAbilityMonitor中設(shè)置的條件匹配的Ability對象。

領(lǐng)域細節(jié)

活性

static final int有效

指示該能力處于活動狀態(tài)。

也可以看看：

常數(shù)欄位值

背景

靜態(tài)最終int背景

指示該能力處于后臺狀態(tài)。

也可以看看：

常數(shù)欄位值

不活躍

靜態(tài)最終int不活動

指示該能力處于非活動狀態(tài)。

也可以看看：

常數(shù)欄位值

初始

靜態(tài)最終 int INITIAL

指示該能力處于初始狀態(tài)。

也可以看看：

常數(shù)欄位值

未定義

static final int 未定義

表示該能力的生命周期狀態(tài)未定義。

也可以看看：

常數(shù)欄位值

方法細節(jié)

等待能力監(jiān)控器

可選的 < Ability > waitAbilityMonitor（IAbilityMonitor監(jiān)視器）

等待并返回與在給定IAbilityMonitor中設(shè)置的條件匹配的Ability對象 。

如果成功獲得匹配的能力，則指定的IAbilityMonitor對象將無效。否則，您可以繼續(xù)在waitAbilityMonitor（ohos.aafwk.ability.delegation.IAbilityMonitor）或waitAbilityMonitor（ohos.aafwk.ability.delegation.IAbilityMonitor，long）中使用它以獲得技能。

參數(shù)：

參數(shù)名稱	參數(shù)說明
監(jiān)控	指示用于監(jiān)視功能的生命周期狀態(tài)變化的IAbilityMonitor對象。

返回值：

如果其生命周期狀態(tài)已更改并且與給定監(jiān)視器匹配，則返回包含Ability對象的Optional對象；否則返回一個空的Optional對象。

等待能力監(jiān)控器

Optional<Ability> waitAbilityMonitor(IAbilityMonitor monitor, long timeout)等待并返回與指定時間段內(nèi)給定IAbilityMonitor中設(shè)置的條件匹配的Ability對象 。

如果成功獲得匹配的能力，則指定的IAbilityMonitor對象將無效。否則，您可以繼續(xù)在waitAbilityMonitor（ohos.aafwk.ability.delegation.IAbilityMonitor）或waitAbilityMonitor（ohos.aafwk.ability.delegation.IAbilityMonitor，long）中使用它以獲得技能。

參數(shù)：

參數(shù)名稱	參數(shù)說明
監(jiān)控	指示用于監(jiān)視功能的生命周期狀態(tài)變化的IAbilityMonitor對象。
超時	指示等待的最長時間（以毫秒為單位）。該值必須是一個正整數(shù)。

返回值：

如果其生命周期狀態(tài)已更改并且與給定監(jiān)視器匹配，則返回包含Ability對象的Optional對象；否則返回一個空的Optional對象。

啟動能力同步

可選的 < Ability > startAbilitySync（Intent intent）

根據(jù)給定的Intent啟動一項功能，并等待2秒鐘以開始運行該功能，然后再返回。

如果2秒鐘內(nèi)沒有啟動任何功能，則將返回一個空的Optional對象。

參數(shù)：

參數(shù)名稱	參數(shù)說明
意圖	指示啟動該能力的意圖。

返回值：

如果在2秒內(nèi)成功啟動了包含啟動的 Ability 對象的 Optional 對象，則返回該對象；否則返回一個空的 Optional 對象。

在UI線程同步上運行

boolean runOnUIThreadSync(Runnable task)

在 UI 線程上運行指定的任務(wù)并阻塞線程，直到任務(wù)完成。

參數(shù)：

參數(shù)名稱	參數(shù)說明
任務(wù)	指示要運行的可運行任務(wù)。

返回值：

如果任務(wù)在 UI 線程上成功執(zhí)行，則返回true；否則，返回 true。否則返回 false。

啟動能力同步

Optional<Ability> startAbilitySync(Intent intent, long timeout)

根據(jù)給定的Intent啟動一項功能，并等待指定的時間段才能開始運行該功能，然后再返回。

如果在超時指定的時間內(nèi)沒有啟動任何能力，則將返回一個空的Optional對象。

參數(shù)：

參數(shù)名稱	參數(shù)說明
意圖	指示啟動該能力的意圖。
超時	指示等待的最長時間（以毫秒為單位）。該值必須是一個正整數(shù)。

返回值：

如果在指定時間內(nèi)成功啟動了包含啟動的 Ability 對象的 Optional 對象，則返回該對象；否則返回一個空的 Optional 對象。

停止能力

boolean stopAbility(Ability ability)

消滅指定的能力。

參數(shù)：

參數(shù)名稱	參數(shù)說明
能力	指示要銷毀的能力對象。

返回值：

如果該能力被成功銷毀，則返回true；否則返回true。否則返回false。

觸發(fā)觸摸事件

boolean triggerTouchEvent(Ability ability,TouchEvent touchEvent）

將觸摸事件分配給給定的功能，然后等待其處理。

此方法是同步的，不能在UI線程上運行。否則，UI線程將被掛起。

參數(shù)：

參數(shù)名稱	參數(shù)說明
能力	指示能力對象。
觸摸事件	指示要調(diào)度的觸摸事件。

返回值：

如果成功調(diào)度touch事件，則返回true；否則，返回false。否則返回false。

布爾觸發(fā)器Click事件

boolean triggerClickEvent(Ability ability, Component view)

將 click 事件調(diào)度到給定功能的指定 Component 對象，并等待對其進行處理。

此方法是同步的，不能在UI線程上運行。否則，UI線程將被掛起。

參數(shù)：

參數(shù)名稱	參數(shù)說明
能力	指示能力對象。
視圖	指示點擊功能的組成部分。

返回值：

如果成功調(diào)度了click事件，則返回true；否則，返回true。否則返回false。

觸發(fā)按鍵事件

boolean triggerKeyEvent（能力，KeyEvent keyEvent）

將按鍵事件分配給給定的功能，然后等待其處理。

此方法是同步的，不能在UI線程上運行。否則，UI線程將被掛起。

參數(shù)：

參數(shù)名稱	參數(shù)說明
ability	指示能力對象。
keyEvent	指示要調(diào)度的關(guān)鍵事件。

返回值：

如果成功調(diào)度關(guān)鍵事件，則返回true；否則，返回true。否則返回false。

添加能力監(jiān)控器

IAbilityMonitor addAbilityMonitor（（字符串標記）

基于指定的功能名稱創(chuàng)建 IAbilityMonitor對象，以監(jiān)視功能的生命周期狀態(tài)變化。

參數(shù)：

參數(shù)名稱	參數(shù)說明
ability Name	指示監(jiān)視功能的名稱。

返回值：

返回創(chuàng)建的IAbilityMonitor對象。

獲取顯示器數(shù)量

int getMonitorsNum（）

獲取保存在內(nèi)存中的IAbilityMonitor對象的總數(shù) 。

返回值：

返回IAbilityMonitor對象的總數(shù)。

清除所有監(jiān)視器

無效clearAllMonitors（）

清除保存在內(nèi)存中的所有 IAbilityMonitor對象。

獲取能力狀態(tài)

int getAbilityState(Ability ability)

獲得指定能力的生命周期狀態(tài)。

參數(shù)：

參數(shù)名稱	參數(shù)說明
ability	指示要獲取其狀態(tài)的Ability對象。

返回值：

返回能力的狀態(tài)，可以是UNDEFINED等等。

刪除能力監(jiān)視器

void removeAbilityMonitor(IAbilityMonitor monitor)

從應(yīng)用程序內(nèi)存中刪除指定的 IAbilityMonitor對象。

參數(shù)：

參數(shù)名稱	參數(shù)說明
monitor	指示要刪除的IAbilityMonitor對象。

打印

無效打?。?a rel="external nofollow" target="_blank" rel="external nofollow" target="_blank" rel="external nofollow" target="_blank" >String msg）

將日志信息打印到單元測試控制臺。

參數(shù)：

參數(shù)名稱	參數(shù)說明
msg	指示要打印的信息。

獲得當(dāng)前最高能力

能力 getCurrentTopAbility（）

獲得當(dāng)前正在顯示的功能。

返回值：

返回當(dāng)前顯示的能力。

獲得能力切片狀態(tài)

int getAbilitySliceState（AbilitySlice targetSlice）

獲取指定能力切片的生命周期狀態(tài)。

參數(shù)：

參數(shù)名稱	參數(shù)說明
targetSlice	指示要獲取其狀態(tài)的AbilitySlice對象。

返回值：

返回能力切片的狀態(tài)，該狀態(tài)可以是未定義的，依此類推。

獲得所有能力切片

獲取指定能力的所有能力切片。

參數(shù)：

參數(shù)名稱	參數(shù)說明
ability	指示能力對象。

返回值：

返回指定能力的所有能力切片的列表。

獲得當(dāng)前能力切片

AbilitySlice getCurrentAbilitySlice(Ability ability)

獲得指定能力的最高能力切片。最高能力切片是指當(dāng)前顯示的能力切片。

參數(shù)：

參數(shù)名稱	參數(shù)說明
ability	指示能力對象。

返回值：

返回指定能力的最高能力切片。