文件组织 目录结构 JS FA应用的 JS 模块(entry/src/main/js/module)的典型开发目录结构如下： 图1 目录结构 目录结构中文件分类如下： .hml结尾的HML模板文件，这个文件用来描述当前页面的文件布局结构。 .css结尾的CSS样式文件，这个文件用于描述页面样式。 .js结尾的JS文件，这个文件用于处理页面和用户的交互。 各个文件夹的作用： app.js文件用于全局JavaScript逻辑和应用生命周期管理。 pages目录用于存放所有组件页面。 common目录用于存放公共资源文件，比如：媒体资源，自定义组件和JS文件。 resources目录用于存放资源配置文件，比如：全局样式、多分辨率加载等配置文件。 i18n目录用于配置不同语言场景资源内容，比如应用文本词条，图片路径等资源。 说明 i18n和resources是开发保留文件夹，不可重命名。 应用资源访问规则 应用资源可通过绝对路径或相对路径的方式进行访问，本开发框架中绝对路径以”/”开头，相对路径以”./”或”../”。具体访问规则如下： 引用代码文件，需使用相对路径，比如：../common/utils.js。 引用资源文件，推荐使用绝对路径。比如：/common/xxx.png。 公共代码文件和资源文件推荐放在common下，通过规则1和规则2进行访问。 CSS样式文件中通过url()函数创建<url>数据类型，如：url(/common/xxx.png)。 说明 当代码文件A需要引用代码文件B时： 如果代码文件A和文件B位于同一目录，则代码文件B引用资源文件时可使用相对路径，也可使用绝对路径。 如果代码文件A和文件B位于不同目录，则代码文件B引用资源文件时必须使用绝对路径。因为Webpack打包时，代码文件B的目录会发生变化。 存储目录定义 应用使用文件存储接口访问文件时，可以通过使用特定scheme（只支持internal）来访问预定义的一些文件存取目录。对于不在下列目录下的文件访问将被拒绝（禁止使用../等方式访问父目录）。 目录类型 路径前缀 访问可见性 说明 临时目录 internal://cache/ 仅本应用可见 可读写，随时可能清除，不保证持久性。一般用作下载临时目录或缓存目录。 应用私有目录 internal://app/ 仅本应用可见 随应用卸载删除。 外部存储 internal://share/ 所有应用可见 随应用卸载删除。其他应用在有相应权限的情况下可读写此目录下的文件。
测试框架的基类。 如果要实现自己的单元测试框架，则必须继承此类并覆盖其所有方法。 构造器摘要 建设者 描述 TestRunner（） 方法总结 修饰符和类型 方法 描述 抽象布尔 准备（） 准备用于运行测试用例的单元测试环境。 抽象 void 运行（） 运行所有测试用例。 从类 java.lang 继承的方法。目的 clone，equals，finalize，getClass，hashCode，notify，notifyAll，toString，wait，wait，wait 构造器详细信息 TestRunner 公共 TestRunner（） 方法细节 准备 公共抽象布尔准备（） 准备用于运行测试用例的单元测试环境。 返回值： 如果成功初始化了环境，则返回 true；否则，返回 true。否则返回 false。 跑 公共抽象无效运行（） 运行所有测试用例。
为您提供测试能力的框架。 您可以继承此类以构造您自己的测试用例并控制某项功能的所有操作。 构造器摘要 建设者 描述 AbilityTestCase（） 方法总结 修饰符和类型 方法 描述 受保护的能力委托 getAbilityDelegation（） 获取一个 AbilityDelegation 实例，以控制对该功能的所有操作。 受保护的空白 输出（字符串msg） 打印出测试用例执行结果。 从类 java.lang 继承的方法。目的 clone，equals，finalize，getClass，hashCode，notify，notifyAll，toString，wait，wait，wait 构造器详细信息 能力测试案例 公共 AbilityTestCase（） 方法细节 获得能力委派 受保护的 AbilityDelegation getAbilityDelegation（） 获取一个 AbilityDelegation 实例，以控制对该功能的所有操作。 返回值： 如果已初始化，则返回 AbilityDelegation 实例；否则返回 null。 输出 受保护的 void 输出（字符串 msg） 打印出测试用例执行结果。 此方法与 AbilityDelegation＃output（String）方法具有相同的功能。 参数： 参数名称 参数说明 味精 指示测试用例执行结果。
全局寄存器，用于存储在应用程序启动期间注册的 IAbilityDelegator 和 IAbilityDelegatorArgs 对象。 解析 TestRunner 参数时，应用程序将注册IAbilityDelegator 和 IAbilityDelegatorArgs 对象。在编写测试用例时，可以使用此类获取您自己的应用程序的 IAbilityDelegator 和 IAbilityDelegatorArgs 对象。IAbilityDelegator 可用于控制能力的生命周期状态。和 IAbilityDelegatorArgs 用于存储单元测试的所有参数。 方法总结 修饰符和类型 方法 描述 静态 IAbilityDelegator getAbilityDelegator（） 获取应用程序的 IAbilityDelegator 对象。 静态 IAbilityDelegatorArgs getArguments（） 获取存储在 IAbilityDelegatorArgs 对象中的单元测试参数。 静态空隙 registerInstance（（IAbilityDelegator 委托人，IAbilityDelegatorArgs args） 将实现 IAbilityDelegator 和 IAbilityDelegatorArgs 的类的实例注册为全局唯一实例。 从类 java.lang 继承的方法。目的 clone，equals，finalize，getClass，hashCode，notify，notifyAll，toString，wait，wait，wait 方法细节 获得能力代表 公共静态 IAbilityDelegator getAbilityDelegator（） 获取应用程序的 IAbilityDelegator 对象。 返回值： 返回启动应用程序时初始化的 IAbilityDelegator 对象。 抛出： 抛出名称 抛出说明 IllegalStateException 如果应用程序不需要运行单元测试，则抛出此异常。 获取参数 公共静态 IAbilityDelegatorArgs getArguments（） 获取存储在 IAbilityDelegatorArgs 对象中的单元测试参数 。 返回值： 返回先前注册的 IAbilityDelegatorArgs 对象。 抛出： 抛出名称 抛出说明 IllegalStateException 如果应用程序不需要运行单元测试，则抛出此异常。 注册实例 公共静态无效寄存器实例（IAbilityDelegator 委托者，IAbilityDelegatorArgs args） 将实现 IAbilityDelegator 和 IAbilityDelegatorArgs 的类的实例注册 为全局唯一实例。 在应用程序启动期间调用此方法以初始化测试环境。 参数： 参数名称 参数说明 委托人 指示实现 IAbilityDelegator 的类的实例。 args 指示实现 IAbilityDelegatorArgs 的类的实例。
应用程序的测试实用程序类。 此类提供了用于获取应用程序内部对象的方法，并且可以操作这些对象。例如，它可以控制 Ability 的生命周期调度，控制 AbilitySlice 的转换和返回以及向 UI 发送指定的输入事件。 您可以基于该类实现自己的测试类。您的测试类必须继承 AbilityTestCase 类，并且与要测试的应用程序处于同一过程中。AbilityDelegation 充当观察者，以监视应用程序的运行状态。它还可以控制应用程序的行为以模拟用户行为以进行测试。 领域摘要 修饰符和类型 领域 描述 静态整数 活性 定义活动生命周期状态。 静态整数 背景 定义背景生命周期状态。 静态整数 不活跃 定义非活动生命周期状态。 静态整数 初始 定义INITIAL生命周期状态。 静态字符串 LIB_PATH 定义包含测试用例资源的JAR包的绝对路径。 静态字符串 RUN_TEST 定义用于启动测试用例的类，该类在启动 Ability 时由 Intent 传递。 静态整数 未定义 定义未定义的生命周期状态。 构造器摘要 建设者 描述 AbilityDelegation（） 方法总结 修饰符和类型 方法 描述 abstract void doAbilityActive（） 将能力的生命周期状态从不活动更改为活动。 abstract void doAbilityBackground（） 将能力的生命周期状态从不活动更改为背景。 abstract void doAbilityForeground（意图意图） 将能力的生命周期状态从背景更改为不活动。 abstract void doAbilityInactive（） 将能力的生命周期状态从活动更改为不活动。 abstract void doAbilitySliceActive（） 将能力切片的生命周期状态从不活动更改为活动。 abstract void doAbilitySliceBackground（） 将能力切片的生命周期状态从不活动更改为背景。 abstract void doAbilitySliceForeground（意图意图） 将能力切片的生命周期状态从“背景”更改为“不活动”。 abstract void doAbilitySliceInactive（） 将能力切片的生命周期状态从“活动”更改为“不活动”。 abstract void doAbilitySliceStart（意图意图） 将能力切片的生命周期状态从 INITIAL 更改为 INACTIVE。 abstract void doAbilitySliceStop（） 将能力切片的生命周期状态从背景更改为初始。 abstract void doAbilityStart（意图意图） 将能力的生命周期状态从初始更改为不活动。 abstract void doAbilityStop（） 将能力的生命周期状态从背景更改为初始。 抽象能力 getAbility（） 在当前进程中获得前台的功能。 抽象能力信息 getAbilityInfo（） 获取一个功能的内部 AbilityInfo 对象。 抽象列表 < AbilitySlice > getAbilitySlice（字符串名称） 从当前能力中获得具有给定名称的能力切片。 抽象整数 getAbilitySliceState（AbilitySlice targetSlice） 获取能力切片的生命周期状态。 抽象整数 getAbilityState（） 获得能力的生命周期状态。 抽象列表 < AbilitySlice > getAllAbilitySlice（） 获取当前能力中包含的所有能力切片。 抽象AbilitySlice getCurrentAbilitySlice（） 在当前能力中获得前景能力切片。 抽象能力 getCurrentTopAbility（） 返回此应用程序的顶级功能 抽象意图 getIntent（） 获取包含有关当前功能的启动信息的 Intent 对象。 abstract void 输出（字符串msg） 打印出测试用例执行的详细信息。 abstract void runOnUIThreadSync（Runnable的任务） 在 UI 线程上执行同步任务。 抽象布尔 triggerClickEvent（组件视图） 触发单击事件，并将其发送到指定的 UI 组件以模拟用户输入。 抽象布尔 triggerKeyEvent（KeyEvent 键） 触发按键事件并将其发送到前台功能。...
提供用于匹配满足指定条件的受监视 Ability 对象的方法 。最近匹配的 Ability 对象将保存在 IAbilityMonitor 对象中。 您可以拨打 IAbilityDelegator＃addAbilityMonitor（字符串）添加能力的监视对象，然后使用提供的方法IAbilityMonitor 获得时newAbility对象开始或监测能力的生命周期状态已经改变了监控能力的对象。 方法总结 修饰符和类型 方法 描述 Ability waitForAbility（） 等待并在5秒内返回与该监视器中指定的条件匹配的状态更改能力对象。 Ability waitForAbility（长时间超时） 等待并返回在指定时间内匹配此监视器中指定条件的状态更改能力对象。 方法细节 等待能力 Ability waitForAbility（长时间超时） 等待并返回在指定时间内匹配此监视器中指定条件的状态更改能力对象。 当前线程将被阻塞，直到 timeoutMillisecond 指定的计时器到期为止。 参数： 参数名称 参数说明 超时毫秒 指示等待的最长时间（以毫秒为单位）。该值必须是一个正整数。 返回值： 如果生命周期状态已更改的任何对象在指定时间内匹配，则返回 Ability 对象；否则，返回 Ability 对象。否则返回 null。 等待能力 Ability waitForAbility（） 等待并在 5 秒内返回与该监视器中指定的条件匹配的状态更改能力对象。 当前线程将被阻止，直到 5 秒钟的默认计时器到期。 返回值： 如果生命周期状态已更改的任何对象在 5 秒钟内匹配，则返回 Ability 对象；否则，返回 Ability 对象。否则返回 null。
存储与单元测试相关的参数，包括类加载器，测试用例名称和测试运行器名称。 您可以调用 AbilityDelegatorRegistry＃getArguments 以获得 IAbilityDelegatorArgs 对象。 方法总结 修饰符和类型 方法 描述 字符串 getTestBundleName（） 获取正在测试的应用程序的捆绑软件名称。 字符串 getTestCaseNames（） 获取所有测试用例的类名。 类加载器 getTestClassLoader（） 获取用于加载和运行测试用例的类加载器。 map < String，Object > getTestParameters（） 获取用于单元测试的参数。 字符串 getTestRunnerClassName（） 获取用于执行测试用例的测试运行程序的类名称。 方法细节 获取测试参数 Map<String,Object> getTestParameters()获取用于单元测试的参数。 返回值： 返回一个映射，该映射包含键-值对中的参数名称和值（如果有）；否则返回一个空的Map对象。 获取测试类加载器 ClassLoader getTestClassLoader（） 获取用于加载和运行测试用例的类加载器。 返回值： 返回要使用的类加载器。 获取测试用例名称 String getTestCaseNames()获取所有测试用例的类名。 返回值： 返回所有测试用例名称，用逗号（，）分隔。 获取测试运行程序类名称 String getTestRunnerClassName()获取用于执行测试用例的测试运行程序的类名称。 返回值： 返回测试运行程序的类名称。 获取测试包名称 String getTestBundleName()获取正在测试的应用程序的捆绑软件名称。 返回值： 返回应用程序包名称。
全局测试实用程序界面，用于添加 IAbilityMonitor 对象并控制功能的生命周期状态。 您可以调用 addAbilityMonitor（java.lang.String） 来添加IAbilityMonitor对象，以监视指定功能的生命周期状态。您还可以调用诸如 triggerClickEvent（ohos.aafwk.ability.Ability，ohos.agp.components.Component）之类的方法 来控制能力的生命周期状态并调度输入事件。 领域摘要 修饰符和类型 领域 描述 静态整数 活性 指示该能力处于活动状态。 静态整数 背景 指示该能力处于后台状态。 静态整数 不活跃 指示该能力处于非活动状态。 静态整数 初始 指示该能力处于初始状态。 静态整数 未定义 表示该能力的生命周期状态未定义。 方法总结 修饰符和类型 方法 描述 IAbilityMonitor addAbilityMonitor（字符串 abilityName） 基于指定的功能名称创建 IAbilityMonitor 对象，以监视功能的生命周期状态变化。 void clearAllMonitors（） 清除保存在内存中的所有IAbilityMonitor对象。 整型 getAbilitySliceState（AbilitySlice targetSlice） 获取指定能力切片的生命周期状态。 整型 getAbilityState(Ability ability) 获得指定能力的生命周期状态。 List<AbilitySlice> getAllAbilitySlice（(Ability ability) 获取指定能力的所有能力切片。 AbilitySlice getCurrentAbilitySlice(Ability ability) 获得指定能力的最高能力切片。 Ability getCurrentTopAbility（） 获得当前正在显示的功能。 整型 getMonitorsNum（） 获取保存在内存中的IAbilityMonitor对象的总数。 void print(String msg) 将日志信息打印到单元测试控制台。 void removeAbilityMonitor（IAbilityMonitor监视器） 从应用程序内存中删除指定的IAbilityMonitor对象。 布尔值 runOnUIThreadSync(Runnable task) 在UI线程上运行指定的任务并阻塞线程，直到任务完成。 Optional<Ability> startAbilitySync(Intent intent) 根据给定的Intent启动一项功能，并等待2秒钟以开始运行该功能，然后再返回。 Optional<Ability> startAbilitySync(Intent intent, long timeout) 根据给定的Intent启动一项功能，并等待指定的时间段才能开始运行该功能，然后再返回。 boolean stopAbility(Ability ability) 消灭指定的能力。 boolean triggerClickEvent(Ability ability, Component view) 将click事件调度到给定功能的指定Component对象，并等待对其进行处理。 boolean triggerKeyEvent(Ability ability, KeyEvent keyEvent) 将按键事件分配给给定的功能，然后等待其处理。 boolean triggerTouchEvent(Ability ability, TouchEvent touchEvent) 将触摸事件分配给给定的功能，然后等待其处理。 Optional<Ability> waitAbilityMonitor(IAbilityMonitor monitor) 等待并返回与在给定IAbilityMonitor中设置的条件匹配的Ability对象。 Optional<Ability> waitAbilityMonitor(IAbilityMonitor monitor, long timeout) 等待并返回与指定时间段内给定IAbilityMonitor中设置的条件匹配的Ability对象。 领域细节 活性 static final int有效 指示该能力处于活动状态。 也可以看看： 常数栏位值 背景 静态最终int背景 指示该能力处于后台状态。 也可以看看： 常数栏位值 不活跃 静态最终int不活动 指示该能力处于非活动状态。 也可以看看： 常数栏位值 初始 静态最终 int INITIAL 指示该能力处于初始状态。 也可以看看： 常数栏位值 未定义 static final int 未定义 表示该能力的生命周期状态未定义。 也可以看看：...
国外主机测评 - 国外VPS，国外服务器，国外云服务器，测评及优惠码
