登录/ 注册
 找回密码
 立即注册
关闭

CSDN热搜

程序园 精品问答 技术交流 资源下载
返回列表 发新帖
首页 › 业界区 › 业界 ›ArkUI-X在Android上使用Fragment开发指南

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

度阡舅 2025-6-12 21:04:55
本文介绍将ArkUI框架的UIAbility跨平台部署至Android平台Fragment的使用说明，实现Android原生Fragment和ArkUI跨平台Fragment的混合开发，方便开发者灵活部署跨平台界面。
Android工程配置

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

请在Android应用的gradle.properties文件，使能AndroidX：
  1. android.useAndroidX=true
复制代码
请在Android应用的build.gradle文件增加AndroidX Fragment库的依赖项：
  1. dependencies {
  2.     implementation  'androidx.appcompat:appcompat:1.4.1'
  3. }
复制代码
ArkUI-X和Android平台集成所用关键类

应用工程Android逻辑部分的StageApplication

应用需要继承arkui_android_adapter.jar包所提供的StageApplication。StageApplication用于初始化资源路径以及加载配置信息，例如：
  1. package com.example.myapplication;
  2. import ohos.stage.ability.adapter.StageApplication;
  4. public class MyApplication extends StageApplication {
  5.        
  6. }
复制代码
应用工程Android逻辑部分Fragment的宿主Activity

原生Activity需要继承androidx.fragment.app.FragmentActivity，绑定StageFragment示例如下：
  1. package com.example.myapplication;
  3. import android.os.Bundle;
  5. import androidx.fragment.app.FragmentActivity;
  6. import androidx.fragment.app.FragmentManager;
  8. import ohos.stage.ability.adapter.StageFragment;
  10. public class MainActivity extends FragmentActivity {
  11.     @Override
  12.     protected void onCreate(Bundle savedInstanceState) {
  13. <?xml version="1.0" encoding="utf-8"?>
  14. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  15.     android:orientation="vertical"
  16.     android:layout_width="match_parent"
  17.     android:layout_height="match_parent">
  19.     <LinearLayout
  20.         android:id="@+id/frag"
  21.         android:layout_width="match_parent"
  22.         android:layout_height="match_parent"
  23.         android:orientation="horizontal">
  24.     </LinearLayout>
  26. </LinearLayout>super.onCreate(savedInstanceState);
  27. <?xml version="1.0" encoding="utf-8"?>
  28. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  29.     android:orientation="vertical"
  30.     android:layout_width="match_parent"
  31.     android:layout_height="match_parent">
  33.     <LinearLayout
  34.         android:id="@+id/frag"
  35.         android:layout_width="match_parent"
  36.         android:layout_height="match_parent"
  37.         android:orientation="horizontal">
  38.     </LinearLayout>
  40. </LinearLayout>setContentView(R.layout.activity_main);
  42. <?xml version="1.0" encoding="utf-8"?>
  43. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  44.     android:orientation="vertical"
  45.     android:layout_width="match_parent"
  46.     android:layout_height="match_parent">
  48.     <LinearLayout
  49.         android:id="@+id/frag"
  50.         android:layout_width="match_parent"
  51.         android:layout_height="match_parent"
  52.         android:orientation="horizontal">
  53.     </LinearLayout>
  55. </LinearLayout>StageFragment fragment = new HiFragment();
  56. <?xml version="1.0" encoding="utf-8"?>
  57. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  58.     android:orientation="vertical"
  59.     android:layout_width="match_parent"
  60.     android:layout_height="match_parent">
  62.     <LinearLayout
  63.         android:id="@+id/frag"
  64.         android:layout_width="match_parent"
  65.         android:layout_height="match_parent"
  66.         android:orientation="horizontal">
  67.     </LinearLayout>
  69. </LinearLayout>FragmentManager manager = getSupportFragmentManager();
  70. <?xml version="1.0" encoding="utf-8"?>
  71. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  72.     android:orientation="vertical"
  73.     android:layout_width="match_parent"
  74.     android:layout_height="match_parent">
  76.     <LinearLayout
  77.         android:id="@+id/frag"
  78.         android:layout_width="match_parent"
  79.         android:layout_height="match_parent"
  80.         android:orientation="horizontal">
  81.     </LinearLayout>
  83. </LinearLayout>manager.beginTransaction().add(R.id.frag,fragment).commit();
  84.     }
  85. }
复制代码
其中activity_main.xml文件示例如下：
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  3.     android:orientation="vertical"
  4.     android:layout_width="match_parent"
  5.     android:layout_height="match_parent">
  7.     <LinearLayout
  8.         android:id="@+id/frag"
  9.         android:layout_width="match_parent"
  10.         android:layout_height="match_parent"
  11.         android:orientation="horizontal">
  12.     </LinearLayout>
  14. </LinearLayout>
复制代码
如果当前StageFragment对应的UIAbility涉及页面跳转，Activity需要重写onBackPressed方法，以便在手机back键点击或手势侧滑时逐级返回页面，否则会退出跨平台承载的Activity页面。
  1. @Overridepublic void onBackPressed() {    if(fragment.onBackPressed()) {<?xml version="1.0" encoding="utf-8"?>
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  3.     android:orientation="vertical"
  4.     android:layout_width="match_parent"
  5.     android:layout_height="match_parent">
  7.     <LinearLayout
  8.         android:id="@+id/frag"
  9.         android:layout_width="match_parent"
  10.         android:layout_height="match_parent"
  11.         android:orientation="horizontal">
  12.     </LinearLayout>
  14. </LinearLayout>super.onBackPressed();    }}
复制代码
参数传递

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

key值为params
value为json格式
  1. {    "params":[<?xml version="1.0" encoding="utf-8"?>
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  3.     android:orientation="vertical"
  4.     android:layout_width="match_parent"
  5.     android:layout_height="match_parent">
  7.     <LinearLayout
  8.         android:id="@+id/frag"
  9.         android:layout_width="match_parent"
  10.         android:layout_height="match_parent"
  11.         android:orientation="horizontal">
  12.     </LinearLayout>
  14. </LinearLayout>{<?xml version="1.0" encoding="utf-8"?>
  15. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  16.     android:orientation="vertical"
  17.     android:layout_width="match_parent"
  18.     android:layout_height="match_parent">
  20.     <LinearLayout
  21.         android:id="@+id/frag"
  22.         android:layout_width="match_parent"
  23.         android:layout_height="match_parent"
  24.         android:orientation="horizontal">
  25.     </LinearLayout>
  27. </LinearLayout>    "key":键,<?xml version="1.0" encoding="utf-8"?>
  28. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  29.     android:orientation="vertical"
  30.     android:layout_width="match_parent"
  31.     android:layout_height="match_parent">
  33.     <LinearLayout
  34.         android:id="@+id/frag"
  35.         android:layout_width="match_parent"
  36.         android:layout_height="match_parent"
  37.         android:orientation="horizontal">
  38.     </LinearLayout>
  40. </LinearLayout>    "type":参数类型值,<?xml version="1.0" encoding="utf-8"?>
  41. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  42.     android:orientation="vertical"
  43.     android:layout_width="match_parent"
  44.     android:layout_height="match_parent">
  46.     <LinearLayout
  47.         android:id="@+id/frag"
  48.         android:layout_width="match_parent"
  49.         android:layout_height="match_parent"
  50.         android:orientation="horizontal">
  51.     </LinearLayout>
  53. </LinearLayout>    "value":值<?xml version="1.0" encoding="utf-8"?>
  54. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  55.     android:orientation="vertical"
  56.     android:layout_width="match_parent"
  57.     android:layout_height="match_parent">
  59.     <LinearLayout
  60.         android:id="@+id/frag"
  61.         android:layout_width="match_parent"
  62.         android:layout_height="match_parent"
  63.         android:orientation="horizontal">
  64.     </LinearLayout>
  66. </LinearLayout>},<?xml version="1.0" encoding="utf-8"?>
  67. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  68.     android:orientation="vertical"
  69.     android:layout_width="match_parent"
  70.     android:layout_height="match_parent">
  72.     <LinearLayout
  73.         android:id="@+id/frag"
  74.         android:layout_width="match_parent"
  75.         android:layout_height="match_parent"
  76.         android:orientation="horizontal">
  77.     </LinearLayout>
  79. </LinearLayout>{<?xml version="1.0" encoding="utf-8"?>
  80. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  81.     android:orientation="vertical"
  82.     android:layout_width="match_parent"
  83.     android:layout_height="match_parent">
  85.     <LinearLayout
  86.         android:id="@+id/frag"
  87.         android:layout_width="match_parent"
  88.         android:layout_height="match_parent"
  89.         android:orientation="horizontal">
  90.     </LinearLayout>
  92. </LinearLayout><?xml version="1.0" encoding="utf-8"?>
  93. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  94.     android:orientation="vertical"
  95.     android:layout_width="match_parent"
  96.     android:layout_height="match_parent">
  98.     <LinearLayout
  99.         android:id="@+id/frag"
  100.         android:layout_width="match_parent"
  101.         android:layout_height="match_parent"
  102.         android:orientation="horizontal">
  103.     </LinearLayout>
  105. </LinearLayout>    }    ]}
复制代码
支持的参数类型列表
参数类型参数类型值boolean1int5double9string10示例：
  1. StageFragment fragment = new HiFragment();
  2. Bundle args = new Bundle();
  3. args.putString("params", "{"params":[{"key":"path","type":10,"value":"local"}]}");
  4. fragment.setArguments(args);
复制代码
应用工程Android逻辑部分的StageFragment

Fragment需要继承arkui_android_adapter.jar包所提供的StageFragment，StageFragment主要功能是将Android中Fragment的生命周期与OpenHarmony中UIAbility的生命周期进行映射，例如：
  1. package com.example.myapplication;import ohos.stage.ability.adapter.StageFragment;public class HiFragment extends StageFragment {    @Override    protected void onCreate(Bundle savedInstanceState) {<?xml version="1.0" encoding="utf-8"?>
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  3.     android:orientation="vertical"
  4.     android:layout_width="match_parent"
  5.     android:layout_height="match_parent">
  7.     <LinearLayout
  8.         android:id="@+id/frag"
  9.         android:layout_width="match_parent"
  10.         android:layout_height="match_parent"
  11.         android:orientation="horizontal">
  12.     </LinearLayout>
  14. </LinearLayout>super.setInstanceName("com.example.myapplication:entry:EntryAbility:");<?xml version="1.0" encoding="utf-8"?>
  15. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  16.     android:orientation="vertical"
  17.     android:layout_width="match_parent"
  18.     android:layout_height="match_parent">
  20.     <LinearLayout
  21.         android:id="@+id/frag"
  22.         android:layout_width="match_parent"
  23.         android:layout_height="match_parent"
  24.         android:orientation="horizontal">
  25.     </LinearLayout>
  27. </LinearLayout>super.onCreate(savedInstanceState);    }}
复制代码
为了将Fragment和UIAbility进行关联，需要重写StageFragment中的onCreate事件，在super.onCreate(savedInstanceState)之前设置instanceName，规则如下：
  1. bundleName:moduleName:abilityName:
复制代码
其中bundleName的值来自于OpenHarmony应用中app.json5配置文件，moduleName、abilityName的值来自于OpenHarmony应用中的module.json5配置文件。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

使用道具 举报
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册
发帖
度阡舅
2025-6-12 21:04:55

0

粉丝关注

18

主题发布

板块介绍填写区域，请于后台编辑
微信扫一扫