ArkUI-X在Android上使用Fragment开发指南

本文介绍将ArkUI框架的UIAbility跨平台部署至Android平台Fragment的使用说明，实现Android原生Fragment和ArkUI跨平台Fragment的混合开发，方便开发者灵活部署跨平台界面。

Android工程配置

Android工程的PackageName需要与OpenHarmony工程的BundleName一致；

请在Android应用的gradle.properties文件，使能AndroidX：

android.useAndroidX=true 

请在Android应用的build.gradle文件增加AndroidX Fragment库的依赖项：

dependencies {     implementation  'androidx.appcompat:appcompat:1.4.1' } 

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

应用工程Android逻辑部分的StageApplication

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

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

应用工程Android逻辑部分Fragment的宿主Activity

原生Activity需要继承androidx.fragment.app.FragmentActivity，绑定StageFragment示例如下：

package com.example.myapplication;  import android.os.Bundle;  import androidx.fragment.app.FragmentActivity; import androidx.fragment.app.FragmentManager;  import ohos.stage.ability.adapter.StageFragment;  public class MainActivity extends FragmentActivity {     @Override     protected void onCreate(Bundle savedInstanceState) {         super.onCreate(savedInstanceState);         setContentView(R.layout.activity_main);          StageFragment fragment = new HiFragment();         FragmentManager manager = getSupportFragmentManager();         manager.beginTransaction().add(R.id.frag,fragment).commit();     } } 

其中activity_main.xml文件示例如下：

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"     android:orientation="vertical"     android:layout_width="match_parent"     android:layout_height="match_parent">      <LinearLayout         android:id="@+id/frag"         android:layout_width="match_parent"         android:layout_height="match_parent"         android:orientation="horizontal">     </LinearLayout>  </LinearLayout> 

如果当前StageFragment对应的UIAbility涉及页面跳转，Activity需要重写onBackPressed方法，以便在手机back键点击或手势侧滑时逐级返回页面，否则会退出跨平台承载的Activity页面。

@Override public void onBackPressed() {     if(fragment.onBackPressed()) {         super.onBackPressed();     } } 

参数传递

StageFragment支持传递参数，参数的传递需要通过setArguments()进行设置，规则如下：

key值为params
value为json格式

{     "params":[         {             "key":键,             "type":参数类型值,             "value":值         },         {                      }     ] } 

支持的参数类型列表

参数类型	参数类型值
boolean	1
int	5
double	9
string	10

示例：

StageFragment fragment = new HiFragment(); Bundle args = new Bundle(); args.putString("params", "{"params":[{"key":"path","type":10,"value":"local"}]}"); fragment.setArguments(args); 

应用工程Android逻辑部分的StageFragment

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

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

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

bundleName:moduleName:abilityName: 

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