（五）HarmonyOS Design 的开发指南 原创

HarmonyOS Design 的开发指南

在 HarmonyOS 生态蓬勃发展的当下，遵循 HarmonyOS Design 的开发指南进行应用开发，对于打造卓越用户体验、融入 HarmonyOS 生态体系至关重要。以下将从 UI 开发规范和适配指南两方面详细介绍。

一、UI 开发规范

（一）界面布局规范

1. 布局结构：HarmonyOS Design 倡导简洁、清晰的布局结构。在应用开发中，常使用 LinearLayout、RelativeLayout 等布局容器构建页面。例如，使用 LinearLayout 实现垂直布局：

​​<LinearLayout​​

​​xmlns:ohos="http://schemas.huawei.com/res/ohos"​​

​​ohos:layout_width="match_parent"​​

​​ohos:layout_height="match_parent"​​

​​ohos:orientation="vertical">​​

​​<Button​​

​​ohos:id="@+id/button1"​​

​​ohos:layout_width="wrap_content"​​

​​ohos:layout_height="wrap_content"​​

​​ohos:text="按钮1"/>​​

​​<Button​​

​​ohos:id="@+id/button2"​​

​​ohos:layout_width="wrap_content"​​

​​ohos:layout_height="wrap_content"​​

​​ohos:text="按钮2"/>​​

​​</LinearLayout>​​

在这个示例中，通过ohos:orientation="vertical"指定了 LinearLayout 为垂直布局，两个按钮依次排列。

2. 间距与对齐：规范明确了元素间的间距和对齐方式，以提升界面的美观度和可读性。各组件间的间距通常遵循 8dp 的倍数原则，如按钮与按钮之间、按钮与文本框之间的间距。在对齐方面，常见的有水平居中对齐、垂直居中对齐等。以下代码展示了将按钮在父容器中水平居中对齐：

​​<Button​​

​​ohos:id="@+id/center_button"​​

​​ohos:layout_width="wrap_content"​​

​​ohos:layout_height="wrap_content"​​

​​ohos:text="居中按钮"​​

​​ohos:layout_gravity="center_horizontal"/>​​

通过ohos:layout_gravity="center_horizontal"实现了按钮在水平方向上的居中对齐。

（二）交互逻辑规范

1. 按钮交互：按钮在不同状态下（正常、按下、禁用）有着明确的视觉反馈规范。正常状态下，按钮呈现标准样式；按下时，通常有颜色变深或轻微缩放的动画效果；禁用状态下，按钮颜色变灰且无法点击。在代码实现上，可通过设置 selector 来定义按钮的不同状态样式，示例如下：

​​<selector xmlns:ohos="http://schemas.huawei.com/res/ohos">​​

​​<item ohos:state_pressed="true">​​

​​<shape>​​

​​<solid ohos:color="#FF0000"/> <!-- 按下时的颜色 -->​​

​​</shape>​​

​​</item>​​

​​<item ohos:state_enabled="false">​​

​​<shape>​​

​​<solid ohos:color="#808080"/> <!-- 禁用时的颜色 -->​​

​​</shape>​​

​​</item>​​

​​<item>​​

​​<shape>​​

​​<solid ohos:color="#007DFF"/> <!-- 正常状态下的颜色 -->​​

​​</shape>​​

​​</item>​​

​​</selector>​​

然后在按钮的android:background属性中引用该 selector：

​​<Button​​

​​android:id="@+id/interactive_button"​​

​​android:layout_width="wrap_content"​​

​​android:layout_height="wrap_content"​​

​​android:text="交互按钮"​​

​​android:background="@drawable/button_selector"/>​​

1. 页面导航交互：HarmonyOS Design 规范了多种导航方式，如底部导航栏、侧边栏、顶部导航栏等。以底部导航栏为例，切换页面时应伴有平滑的动画效果，让用户清晰感知页面切换。在代码中，通过设置FragmentTransaction的动画效果来实现：

​​FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();​​

​​transaction.setCustomAnimations(R.anim.slide_in_right, R.anim.slide_out_left);​​

​​transaction.replace(R.id.fragment_container, new HomeFragment());​​

​​transaction.addToBackStack(null);​​

​​transaction.commit();​​

其中R.anim.slide_in_right和R.anim.slide_out_left是自定义的动画资源，实现了页面从右侧滑入、左侧滑出的导航动画效果。

二、适配指南

（一）多设备适配

1. 屏幕尺寸适配：HarmonyOS 设备涵盖手机、平板、智能穿戴、智慧屏等多种类型，屏幕尺寸差异较大。在开发中，应使用dp（density - independent pixel）作为尺寸单位，以确保在不同分辨率屏幕上的显示一致性。例如，设置按钮的宽度为 100dp：

​​<Button​​

​​android:id="@+id/size_adapt_button"​​

​​android:layout_width="100dp"​​

​​android:layout_height="wrap_content"​​

​​android:text="尺寸适配按钮"/>​​

同时，可利用ConstraintLayout等灵活布局容器，根据屏幕尺寸动态调整组件位置和大小。通过设置layout_constraintLeft_toLeftOf、layout_constraintTop_toTopOf等约束属性，让组件在不同屏幕上保持相对位置不变。

2. 设备特性适配：不同设备具有不同特性，如智能手表的小屏幕和有限交互方式、平板的大屏幕适合多任务处理等。对于智能手表应用，应简化界面设计，采用大图标和简洁文字，方便用户操作。在代码实现上，可根据设备类型加载不同的布局文件，示例如下：

​​Resources resources = getResources();​​

​​Configuration configuration = resources.getConfiguration();​​

​​if (configuration.smallestScreenWidthDp <= 320) {​​

​​// 加载适用于小屏幕设备（如智能手表）的布局​​

​​setContentView(R.layout.layout_small_device);​​

​​} else {​​

​​// 加载适用于普通屏幕设备的布局​​

​​setContentView(R.layout.layout_normal_device);​​

​​}​​

（二）系统版本适配

1. API 兼容性：随着 HarmonyOS 系统的不断更新，新的 API 不断推出。在开发应用时，要确保应用在不同系统版本上的兼容性。例如，在使用新的系统功能时，应先检查系统版本，再决定是否调用相关 API。以使用 HarmonyOS 的新通知权限 API 为例：

​​if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {​​

​​// 系统版本支持新通知权限API​​

​​NotificationManagerCompat.from(context).areNotificationsEnabled();​​

​​} else {​​

​​// 旧版本系统，采用其他方式处理通知权限​​

​​}​​

1. 资源适配：不同系统版本可能对资源文件的要求有所不同。例如，某些系统版本可能对图片格式、字体资源有特定要求。开发者应根据系统版本提供相应的资源文件，在res目录下创建不同版本的资源文件夹，如drawable - v21存放适用于 API 21 及以上版本的图片资源，确保应用在不同系统版本上都能正常显示和运行。

遵循 HarmonyOS Design 的 UI 开发规范和适配指南，能够帮助开发者打造出符合 HarmonyOS 生态标准、​​用户体验​​出色的应用，更好地融入 HarmonyOS 的广阔生态体系，为用户带来优质的服务。