鸿蒙HarmonyOS三方件开发指南(1)-PrecentPositionLayout

开发 OpenHarmony
文章由鸿蒙社区产出,想要了解更多内容请前往:51CTO和华为官方战略合作共建的鸿蒙技术社区https://harmonyos.51cto.com/#zz

[[375329]]

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com/#zz

1. PrecentPositionLayout功能介绍

1.1. 组件介绍:

SDK提供了不同布局规范的组件容器,例如以单一方向排列的DirectionalLayout、以相对位置排列的DependentLayout、以确切位置排列的PositionLayout等。

其中PositionLayout中组件的位置是以绝对像素点定义的,无法实现根据屏幕的大小自适应。因此,引入一种以百分比方式定义的PrecentPositionLayout布局容器,通过它可以很方便的实现屏幕自适应。

1.2. 手机模拟器上运行效果:


2. PrecentPositionLayout使用方法

2.1. 新建工程,增加组件Har包依赖

在应用模块中调用HAR,只需要将precentpositionlayout.har复制到entry\libs目录下即可(由于build.gradle中已经依赖libs目录下的*.har,因此不需要再做修改)。

2.2. 修改主页面的布局文件

修改主页面的布局文件ability_main.xml,将跟组件容器修改为com.isoftstone.precentpositionlayout.PrecentPositionLayout,然后再增加5个Text组件,分别位于屏幕的左上,左下,右上,右下和中间,每个组件的长度和宽度都占屏幕的25%。修改后代码如下:

  1. <?xml version="1.0" encoding="utf-8"?> 
  2.  
  3.   
  4.  
  5. <com.isoftstone.precentpositionlayout.PrecentPositionLayout 
  6.  
  7.     xmlns:ohos="http://schemas.huawei.com/res/ohos" 
  8.  
  9.     ohos:height="match_parent" 
  10.  
  11.     ohos:width="match_parent"
  12.  
  13.   
  14.  
  15.     <Text 
  16.  
  17.         ohos:id="$+id:text_helloworld" 
  18.  
  19.         ohos:height="250" 
  20.  
  21.         ohos:width="250" 
  22.  
  23.         ohos:left_margin="0" 
  24.  
  25.         ohos:top_margin="0" 
  26.  
  27.         ohos:background_element="$graphic:background_text" 
  28.  
  29.         ohos:text="左上25%" 
  30.  
  31.         ohos:text_size="50" 
  32.  
  33.         /> 
  34.  
  35.   
  36.  
  37.     <Text 
  38.  
  39.         ohos:id="$+id:text_helloworld" 
  40.  
  41.         ohos:height="250" 
  42.  
  43.         ohos:width="250" 
  44.  
  45.         ohos:left_margin="750" 
  46.  
  47.         ohos:top_margin="0" 
  48.  
  49.         ohos:background_element="$graphic:background_text" 
  50.  
  51.         ohos:text="右上25%" 
  52.  
  53.         ohos:text_size="50" 
  54.  
  55.         /> 
  56.  
  57.   
  58.  
  59.     <Text 
  60.  
  61.         ohos:id="$+id:text_helloworld" 
  62.  
  63.         ohos:height="250" 
  64.  
  65.         ohos:width="250" 
  66.  
  67.         ohos:left_margin="0" 
  68.  
  69.         ohos:top_margin="750" 
  70.  
  71.         ohos:background_element="$graphic:background_text" 
  72.  
  73.         ohos:text="左下25%" 
  74.  
  75.         ohos:text_size="50" 
  76.  
  77.         /> 
  78.  
  79.   
  80.  
  81.     <Text 
  82.  
  83.         ohos:id="$+id:text_helloworld" 
  84.  
  85.         ohos:height="250" 
  86.  
  87.         ohos:width="250" 
  88.  
  89.         ohos:left_margin="750" 
  90.  
  91.         ohos:top_margin="750" 
  92.  
  93.         ohos:background_element="$graphic:background_text" 
  94.  
  95.         ohos:text="右下25%" 
  96.  
  97.         ohos:text_size="50" 
  98.  
  99.         /> 
  100.  
  101.   
  102.  
  103.     <Text 
  104.  
  105.         ohos:id="$+id:text_helloworld" 
  106.  
  107.         ohos:height="250" 
  108.  
  109.         ohos:width="250" 
  110.  
  111.         ohos:left_margin="375" 
  112.  
  113.         ohos:top_margin="375" 
  114.  
  115.         ohos:background_element="$graphic:background_text" 
  116.  
  117.         ohos:text="中心25%" 
  118.  
  119.         ohos:text_size="50" 
  120.  
  121.         /> 
  122.  
  123.   
  124.  
  125. </com.isoftstone.precentpositionlayout.PrecentPositionLayout> 

 2.3. 增加Text组件的背景资源文件

为方便观察,上一步我们将Text组件设置了一个绘制背景graphic:background_text。

这里需要在resources/base/grahic目录下新增一个可绘制资源文件。

右键点击graphic,选择New-File,文件名输入background_text.xml。


文件内容如下:(可复制background_ability_main.xml的内容,修改color值即可)

  1. <?xml version="1.0" encoding="UTF-8" ?> 
  2.  
  3. <shape xmlns:ohos="http://schemas.huawei.com/res/ohos" 
  4.  
  5.        ohos:shape="rectangle"
  6.  
  7.     <solid 
  8.  
  9.         ohos:color="#00FFFF"/> 
  10.  
  11. </shape> 

 2.4. 修改MainAbilitySlince的UI加载代码

在MainAbilitySlince类的onStart函数中,增加如下代码。

  1. public void onStart(Intent intent) { 
  2.  
  3.     super.onStart(intent); 
  4.  
  5.     // 解析xml获得PrecentPositionLayout对象 
  6.  
  7.     PrecentPositionLayout precentPositionLayout = (PrecentPositionLayout) LayoutScatter.getInstance(getContext()).parse(ResourceTable.Layout_ability_main, nullfalse); 
  8.  
  9.   
  10.  
  11.     // 自动调整组件的百分比 
  12.  
  13.     precentPositionLayout.AutoSize(); 
  14.  
  15.   
  16.  
  17.     // 设置到UI 
  18.  
  19.     super.setUIContent(precentPositionLayout); 
  20.  
  21.     //super.setUIContent(ResourceTable.Layout_ability_main); 
  22.  

 3. PrecentPositionLayout开发实现

3.1. 新建一个Module

新建一个Module,类型选择HarmonyOS Library,模块名为precentpositionlayout,如图:


3.2. 新建一个PrecentPositionLayout类

新建一个PrecentPositionLayout类,继承自PositionLayout类,并增加AutoSize()方法。

  1. /* 调整各组件的大小,按照百分比调整 
  2.  
  3.  *  将原来组件的起始位置,宽度和高度都视作相对于整个屏幕的百分比值,然后根据屏幕的分辨率转换为实际的像素值。 
  4.  
  5.  *  注:考虑到使用0-100配置百分比的话,范围太小不够精确,因此配置范围设置为0-1000, 
  6.  
  7.  *  比如当前屏幕是1920 * 1060, 某个组件的宽度和高度配置的是200,则表示改组件的宽和高都占整个屏幕的20%。 
  8.  
  9.  *  因此,调整后改组件的实际大小为384 * 212. 
  10.  
  11.  */ 
  12.  
  13. public void AutoSize() { 
  14.  
  15.     // 获取屏幕分辨率 
  16.  
  17.     Optional<Display> display = DisplayManager.getInstance().getDefaultDisplay(this.getContext()); 
  18.  
  19.     Point pt = new Point(); 
  20.  
  21.     display.get().getSize(pt); 
  22.  
  23.   
  24.  
  25.     // 去除上面标题栏和下面导航栏的高度 
  26.  
  27.     pt.modify(pt.getPointX(), pt.getPointY() - 160); 
  28.  
  29.   
  30.  
  31.     // 调增各组件的大小 
  32.  
  33.     int childCount = getChildCount(); 
  34.  
  35.     for (int i = 0; i < childCount; i++) { 
  36.  
  37.         Component component = getComponentAt(i); 
  38.  
  39.         ComponentContainer.LayoutConfig config = component.getLayoutConfig(); 
  40.  
  41.         component.setLeft(config.getMarginLeft() * pt.getPointXToInt() / 1000); 
  42.  
  43.         component.setTop(config.getMarginTop() * pt.getPointYToInt() / 1000); 
  44.  
  45.         component.setWidth(config.width * pt.getPointXToInt()  / 1000); 
  46.  
  47.         component.setHeight(config.height * pt.getPointYToInt()  / 1000); 
  48.  
  49.     } 
  50.  
  51.   

 3.3. 编译HAR包

利用Gradle可以将HarmonyOS Library库模块构建为HAR包,构建HAR包的方法如下:

在Gradle构建任务中,双击PackageDebugHar或PackageReleaseHar任务,构建Debug类型或Release类型的HAR。

待构建任务完成后,可以在PrecentPositionLayout> bulid > outputs > har目录中,获取生成的HAR包。


项目源代码地址:https://github.com/isoftstone-dev/PersentPositionLayout_HarmonOS

©著作权归作者和HarmonyOS技术社区共同所有,如需转载,请注明出处,否则将追究法律责任

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com/#zz

 

责任编辑:jianghua 来源: 鸿蒙社区
相关推荐

2021-03-01 09:48:24

鸿蒙HarmonyOS应用开发

2021-02-24 15:22:47

鸿蒙HarmonyOS应用开发

2021-04-16 09:28:18

鸿蒙HarmonyOS应用

2021-02-04 13:06:38

鸿蒙HarmonyOS应用开发

2021-01-12 12:04:40

鸿蒙HarmonyOS应用开发

2021-01-21 13:21:18

鸿蒙HarmonyOSPhotoview组件

2021-01-20 09:54:56

鸿蒙HarmonyOS开发

2021-02-04 09:45:19

鸿蒙HarmonyOS应用开发

2021-06-28 14:48:03

鸿蒙HarmonyOS应用

2021-02-26 14:15:27

鸿蒙HarmonyOS应用开发

2021-01-18 09:52:20

鸿蒙HarmonyOS开发

2021-03-01 14:01:41

鸿蒙HarmonyOS应用开发

2021-01-22 17:33:03

鸿蒙HarmonyOS应用开发

2021-04-12 09:36:54

鸿蒙HarmonyOS应用

2021-05-12 15:17:39

鸿蒙HarmonyOS应用

2021-03-31 09:50:25

鸿蒙HarmonyOS应用开发

2021-03-19 17:42:01

鸿蒙HarmonyOS应用开发

2021-04-20 09:42:20

鸿蒙HarmonyOS应用开发

2021-08-26 16:07:46

鸿蒙HarmonyOS应用

2021-06-21 15:21:52

鸿蒙HarmonyOS应用开发
点赞
收藏

51CTO技术栈公众号