一次开发多端部署技术白皮书

版权所有©华为终端有限公司2022。保留一切权利。本材料所载内容受著作权法的保护，著作权由华为公司或其许可人拥有，但注明引用其他方的内容除外。未经华为公司或其许可人事先书面许可，任何人不得将本材料中的任何内容以任何方式进行复制、经销、翻印、播放、以超级链路连接或传送、存储于信息检索系统或者其他任何商业目的的使用。商标声明以上为华为公司的商标（非详尽清单），未经华为公司书面事先明示许可，任何第三方不得以任何形式使用。注意华为会不定期对本文档的内容进行更新。本文档仅作为使用指导，文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。华为终端有限公司地址：广东省东莞市松山湖园区新城路2号网址：https://consumer.huawei.com CONTENT万物互联时代应用开发面临的挑战与机遇鸿蒙应用多设备开发核心理念应用用户体验设计1）多设备体验设计指南2）响应式设计方法开发1）架构设计2）界面开发3）业务逻辑开发4）开发环境和工具……………………………………07…………………………………………09…………………………………………………13…………………………………………………15………………………………………………51…………………………………………55 O5O6O8O7 面向多设备的应用体验升级多设备应用测试应用上架与发布1）上架流程2）多设备上架配置3）上架审核4）应用分发术语1）平板2）PC/2in13）智慧屏1）自动化测试2）云测试…………………………………………………………70……………………………………………………77……………………………………………………91……………………………………………108……………………………………………………109………………………………………………111………………………………………112………………………………………………112………………………………………………113 万物互联时代应用开发面临的挑战与机遇Chapter1 2纵观移动设备的发展历程，早期的功能机时代，移动通信设备笨重且功能单一，只能用于语音通话，为了满足移动便携诉求，逐渐向小型化和便携化演进。随着3G通信技术的到来，手机开始配备高分辨率屏幕，显示效果也得到提升，支持简单的互联网接入，部分手机增加了摄像头支持视频通话。随着智能手机诞生至今，随着软硬件能力的突破，手机的屏幕由3.5英寸逐渐越来越大，屏幕比例也从起初的3:2，增加了16:9、18:9、21:9的比例。2025年，华为开创性的上市了具有16:10比例屏幕的Pura X，以打造观影和阅读的最佳体验。这些年，手机业界始终围绕用户体验来定义智能手机的形态，核心变化点始终是“屏幕”。从信息获取效率的角度出发，用户始终期待拥有更大的屏幕，同时又想享受随身携带的便携性，折叠手机这种新形态应运而生。预计2025年会有千万量级的新增折叠机用户，这证明了能够同时满足大屏幕和便携性的设计开始赢得用户的青睐和市场。折叠机对消费者是福音，但是对开发者来说却是一种挑战，因为每个应用都要为各种折叠形态、用户握持方式、摄像头翻转、传感器方向进行适配开发，极大增加了开发的工作量。如果不针对设备进行适配，用户体验又会大打折扣。 3随着创新硬件的不断产生，折叠手机、平板电脑、个人电脑、智能座舱、智能电视的边界开始变得越来越模糊，用户越来越希望这些智能终端的体验融合一致，提升设备之间的连通性、降低学习成本，真正的实现以人为中心的万物互联体验。随着HarmonyOS的出现，技术上使得融合一致体验的实现成为可能。终端产品形态多样化，人均智能终端数量不断增长，全场景的用户体验诉求为开发者者带来了全新的挑战：l要为不同操作系统，开发并维护多套应用版本；l针对一款创新硬件设备，在适配开发带来的高成本和不适配开发带来的差用户体验间焦虑；l多种语言技术栈，多种程序框架，不同的开发范式，对开发人员技能要求高；l多设备、多操作系统下如何保持应用的用户界面和交互一致体验；l对于已维护多年的直板机应用，如何对体验进行重新设计，为其他多元化屏幕比例和设备提供更佳的用户体验；未来的终端场景下，更加个性化的智能服务、更加沉浸的影音娱乐体验、更高效的智慧办公、更加以人为本的居家体验，多个设备间的场景化体验越来越重要，通过发挥不同形态设备的各自优势，为用户带来全新的体验跃升，这也是操作系统之上众多应用的全新机遇。万物互联之下，全场景的最佳用户体验，有助于进一步提升应用的用户粘性，吸引潜在新用户。新形态设备有助于催化应用体验二次创新，实现业务的再次突破，获得更大的商业回报。 鸿蒙应用多设备开发核心技术理念Chapter2 5在HarmonyOS面世之前，操作系统通常是为特定设备类型设计的，比如面向手机、PC和穿戴设备的操作系统。由于操作系统间的差异，开发者不得不学习多套编程语言，并为不同设备的差异化体验建立多个研发团队。技术栈差异和团队间的隔阂，使得应用在不同设备上的体验出现割裂。应用内容无法跨设备复用，增加了开发者在多设备体验一致性上的投入。HarmonyOS从诞生起就旨在构建全场景多设备环境下的操作系统，是业界首个能够支持多种设备类型的操作系统。这一原生的统一操作系统为构建多设备统一生态环境奠定了基础。HarmonyOS多设备应用开发的核心理念是“一次开发，多端部署“，一个研发团队使用一套技术实现多设备差异化体验的应用开发。应用开发者在设计之初就为全场景设备做好体验设计，逐步落地开发，真正实现小投入大收益。为了达成这一目标，HarmonyOS提供了多维度统一的系统能力，简化了应用在多设备应用上的开发和维护复杂度，使开发者能集中精力于业务创新。l统一操作系统：即HarmonyOS操作系统，支持在鸿蒙全场景设备上运行，为应用提供一致的运行环境。l统一集成开发环境：HarmonyOS提供的DevEco Studio集成开发环境，包含一系列多设备一致的开发者工具链，如工程管理、编译构建、预览调测、模拟器调测等，多端同显的预览器和模拟器支持多设备同时调试，效率大幅提升。l统一编程语言和统一编程框架：通过学习ArkUI编程框架和ArkTS编程语言，开发者可以完成适用于多种设备的应用开发，释放开发者的技能学习和知识储备焦虑。l统一SDK：HarmonyOS SDK支持全场景设备的开发，多个设备类型使用相同的SDK和API进行功能开发，免除切换的困扰，让开发者专注于业务逻辑的开发。l统一交互逻辑：为了保障全场景跨设备体验一致性，开发者只需要维护一套用户界面代码。通过统一的断点系统，开盒即用的多态组件能力，开发者无需感知屏幕尺寸，最大化复用界面功能和业务逻辑，避免为不同设备重复开发。l统一工程和统一维护：开发者在同一个工程内处理应用功能代码的编写和管理，无需为每个设备维护独立的代码工程，无需构建多套编译构建和发布的任务链，更简单高效。l统一上架和分发：开发者通过统一流程构建的应用安装包，只需将其上架到应用市场，应用市场自动针对目标设备进行安装包的优化和分发处理，简化了复杂的分发流程。除了这些统一的系统能力，HarmonyOS开发者社区还提供了面向多设备的设计指南、最佳体验设计实践，以及场景化的开发最佳实践等，加速开发者掌握HarmonyOS应用开发技能。通过这些能力的支持，开发者能够更快地积累经验，轻松应对各种设备类型、不同屏幕尺寸、折叠开合状态以及横竖屏切换等典型应用场景。 多设备应用体验设计Chapter3-1）多设备体验设计标准-2）响应式设计方法 7HarmonyOS全场景设备带来了屏幕尺寸的多样化和设备使用场景的差异化，这些因素影响了用户体验设计的复杂度。为此，HarmonyOS提供了一系列面向多设备的用户界面设计指南、方法和最佳实践供开发者参考和学习。1）多设备体验设计标准随着终端设备形态日益多样化，应用设计需要考虑界面布局协调性与设备最佳体验的问题，平衡应用功能与不同的屏幕尺寸之间的先后关系。为了保持多设备体验的连续性，HarmonyOS在设计之初就面向全场景、全设备进行定义。要保留应用体验带给用户的熟悉感，也要兼顾在不同设备、产品类型上的最佳体验。HarmonyOS在系统底层设计上兼顾了不同设备之间的差异化，保证基础交互归一、高端视效DNA的延续，确保不同终端（手机、平板、手表、电脑、座舱等）的交互逻辑和视觉风格高度统一，开发者无需重复学习，保证体验最优解。在不同比例屏幕的适配过程中，我们提炼了如下原则来确保设计的完整性。布局完整：设备在折叠/展开或横竖屏切换时，应用窗口内的组件、图片、视频等元素应避免出现错位、截断、变形、模糊等问题。响应式设计：避免使用固定像素来作为界面布局或元素尺寸的定义，对于留白空间可以使用弹性布局或增加Blank等组件来实现动态伸缩。配合媒体查询、宽度及高度断点来进行动态判断，尽量使用流式排版来进行布局定义。 8移动优先：将应用需要适配的设备类型或断点区间进行汇总，按照最小到最大的比例进行优先级适配，先保证最小屏幕的内容、功能及界面布局完整性后，再逐步向更大比例设备进行延展和功能适配。极端情况下，需要牺牲部分功能体验，确保最小集的完整呈现。多设备断点系统除穿戴、IoT这些设备以外，移动端设备的尺寸形态也在逐步演进中。界面布局不应该是静态且固定的，当显示环境发生变化时，如横竖屏切换、调节字体大小、应用分屏等，都需要及时调整内容的布局方式进行适应变化。开发者可以通过调用断点系统、栅格系统、响应式布局和媒体查询等判断逻辑，根据界面具体的展示内容进行更合理的变化，根据内容的优先级、最佳比例和响应式规格进行适配。断点是以应用窗口宽度为参照，将宽度和高度这两个维度拆分成了几个不同的区间(即不同的断点)，在不同的区间下，可根据设计方案实现不同的页面布局效果。图断点系统新增纵向区间多设备交互归一为了让应用在全场景设备上都能获得一致自然的交互体验，设计时需要为不同交互状态下的各种输入设备设计适合的交互方式。在传统的开发模式中需要为不同的输入设备进行适配开发，工作量巨大。可交互的用户界面广泛存在于智能手机、平板、电脑（PC）、智能 9穿戴、智慧屏等设备上。应用可能在多种设备上运行或在单一设备上被用户通过多种输入方式操控，这需要用户界面能够自动识别和支持不同的输入设备，以便用户以习惯的、舒适的方法与其进行交互。针对这一问题，HarmonyOS提出了交互事件归一思想，旨在保证全场景下应用交互体验一致性的同时，降低设计和开发的工作量。交互事件归一是一种适配多设备输入的交互响应框架，通过将不同设备的交互行为转化为同一个交互事件，保证控件在不同交互场景下的体验一致性。开发者只需要调用所需的交互事件接口，无需为每个输入设备单独适配，从而简化开发流程。该接口涵盖用户基础的交互任务，并遵循了用户在触控、鼠标、触控板等设备的交互习惯。以手势交互为例，当应用运行在触屏设备上时，用户可以通过手指长按进入预览状态打开长按菜单；当应用运行在PC上时，用户则可以通过单击鼠标右键打开该菜单。典型的输入方式包括但不限于触屏上手指/手写笔等直接交互、鼠标/触摸板/键盘/表冠/遥控器/车机摇杆/旋钮/手柄/隔空手势等间接交互、以及语音交互。HarmonyOS提炼、总结这些一多交互能力及规格，并将其沉淀下去。2）响应式设计方法基于设备差异展现最佳体验设计一直是HamronyOS设计的核心初衷。不同设备场景下的响应式设计需要协调界面本身的自适应规则，并结合设备硬件屏幕展示空间的约束共同定义。横向与纵向断点的判断只是一种处理手段和方式，应用自身需要避免硬编码的处理方式，减少硬编码带来的各种截断、操作不便、比例不协调问题。 10以启动页为例，布局会在多个窗口尺寸、组合之间切换，首要条件是界面自身布局要定义一套展示规则，例如按照窗口尺寸拆分占比，并定义好对齐和展示规则。接下来根据设备布局差异，在断点网格中匹配对应的响应式规则。上下结构的启动页使用一套布局进行适配，在极端的窗口比例下，可以选择隐藏部分元素或缩小所占比