ArkUI-X 通过 Stage 模型开发 Android 端应用指南 (一)

简介

本文介绍将 ArkUI 框架扩展到 Android 平台所需要的必要的类及其使用说明，开发者基于 OpenHarmony，可复用大部分的应用代码（生命周期等）并可以部署到 Android 平台，降低跨平台应用开发成本。

AndroidStudio 配置

使用 AndroidStudio 所创建 Android 工程的 PackageName 需要与 OpenHarmony 工程的 BundleName 一致。

注: AndroidStudio:Android 应用的开发工具。

ArkUI-X 和 Android 平台集成所用关键类

应用工程 Android 逻辑部分的 StageApplication

应用需要继承 arkui_android_adapter.jar 包所提供的 StageApplication。StageApplication 用于初始化资源路径以及加载配置信息，例如：

package com.example.myapplication;import ohos.stage.ability.adapter.StageApplication;
public class HiStageApplication extends StageApplication {
}

应用工程 Android 逻辑部分的 StageActivity

Activity 需要继承 arkui_android_adapter.jar 包所提供的 StageActivity，StageActivity 主要功能是将 Android 中 Activity 的生命周期与 OpenHarmony 中 Ability 的生命周期进行映射，例如：

package com.example.myapplication;import ohos.stage.ability.adapter.StageActivity;
public class EntryMainAbilityActivity extends StageActivity {    @Override    protected void onCreate(Bundle savedInstanceState) {        super.setInstanceName("com.example.myapplication:entry:MainAbility:");        super.onCreate(savedInstanceState);    }}

为了将 Activity 和 ability 进行关联，需要重写 StageActivity 中的 onCreate 事件，在 super.onCreate(savedInstanceState)之前设置 instanceName，规则如下：

bundleName:moduleName:abilityName:

其中 bundleName 的值来自于 OpenHarmony 应用中 app.json5 配置文件，moduleName、abilityName 的值来自于 OpenHarmony 应用中的 module.json5 配置文件。

Ability 与 Activity 对应规则

Android 端应用内的 Activity 的 packageName 需要与 Ability 的 bundleName 一致。

Android 端应用内的 Activity 的 activityName 组成规则：Ability 的 moduleName + Ability 的 abilityName + “Activity”。

示例如图：