优惠码 第111页

DevEco Studio仅针对Lite Wearable提供预览器的功能。预览器支持代码热加载，在开发应用的同时，只要将开发的代码保存到源码中，即可在预览器中实时查看应用效果，方便开发者随时调整代码。 在使用预览器查看应用界面的UI效果前，需要确保 HarmonyOS SDK > SDK Tool**s** 中，已下载 Previewer 资源，详情请参考 下载HarmonyOS SDK。 打开预览器有两种方式，显示效果如下图所示。 通过菜单栏，点击 View>Tool Windows>Previewer，打开预览器。 在编辑窗口右上角的侧边工具栏，点击 Previewer，打开预览器。 预览器还提供 Lite Wearable 的场景化数据注入功能，如点亮/关闭屏幕，调节屏幕亮度，向应用注入步数、心率、经纬度等信息，可以在开发阶段模拟真实的使用场景，便于开发者验证应用使用体验。

HarmonyOS IDL 简介 HarmonyOS Interface Definition Language（简称 HarmonyOS IDL）是 HarmonyOS 的接口描述语言。HarmonyOS IDL 与其他接口语言类似，通过 HarmonyOS IDL 定义客户端与服务端均认可的编程接口，可以实现在二者间的跨进程通信（IPC，Inter-Process Communication）。跨进程通信意味着我们可以在一个进程访问另一个进程的数据，或调用另一个进程的方法。 通常我们把应用接口提供方（供调用）称为服务端，调用方称为客户端。客户端通过绑定服务端的 Ability 来与之进行交互，类似于绑定服务。关于 DevEco Studio 接口语言的详细描述请参考HarmonyOS IDL 接口使用规范。 说明 只能使用 Java 或 C++ 语言构建 .idl 文件，因此仅 Java、Java+JS、C/C++ 工程支持IDL。 创建 .idl 文件 在已经创建/打开的 HarmonyOS 工程中，选择 module 目录或其子目录，点击鼠标右键，选择 New>Idl File。 创建 IDL File。可以直接输入 IDL 接口名称，也可以通过包名格式定义 idl 接口名称。两种方式的差异仅在于 .idl 文件的文件目录结构。 按名称创建，创建 IDL File 时，输入接口名称，直接点击 OK。 DevEco Studio 在相应“module”的 src>main 路径下生成 idl 文件夹，并按照对应模块的包名生成同样的目录结构及 IDL 文件。 按包名创建，自定义 .idl 文件存储路径和接口名称。创建“IDL File”时，按照包名创建 IDL 文件。包名利用“.”作为分隔符，如输入“com.huawei.test.MyIdlInterface”。 DevEco Studio 在相应“module”的 src>main 路径下生成 idl 文件夹，并按照输入的包名生成相应目录结构及 IDL 文件。可以在此路径继续新增 IDL 文件。 点击工程右边栏的 Gradle，在Tasks > ohos 中选择 compileDebugIdl 或 compileReleaseIdl，对模块下的 IDL 文件进行编译。 编译完成后，在 build > generated > source > Idl> {Package Name} 目录下，生成对应的接口类、桩类和代理类，如下图所示。 实现 HarmonyOS IDL 接口 开发者可以使用 Java 或 C++ 编程语言构建 .idl 文件，关于 HarmonyOS IDL 接口的实现请参考IDL开发指南。

在支持 JS 语言的工程中，支持添加新的 JS Component 和 JS Page，在此之前，需要了解它们的基本概念。 JS Component：在 JS 工程中，可以存在多个JS Component（例如js目录下的 default 文件夹就是一个 JS Component），一个 JS FA 对应一个 JS Component，可以独立编译、运行和调试。 说明 轻量级智能穿戴对应的 JS 工程，只存在一个 JS FA，因此，轻量级智能穿戴的 JS 工程不允许创建新的 JS Component。 JS Page：Page 是表示 JS FA 的一个前台页面，由 JS、HML 和 CSS 文件组成，是 Component 的最基本单元，构成了 JS FA 的每一个界面。 添加 JS Component 在 JS 工程目录中，选中 js 文件夹，然后点击鼠标右键，选择 New > JS Component，输入 JS Component Name，点击 Finish 完成添加。 添加 JS Page 在 JS 工程目录中，选择需要添加 Page的Component 下的 pages 文件夹，然后点击鼠标右键，选择 New > JS Page，输入 JS Page Name，点击 Finish 完成添加。

Ability 是应用所具备的能力的抽象，一个 Module 可以包含一个或多个 Ability。Ability 分为两种类型：FA（Feature Ability）和 PA（Particle Ability），DevEco Studio 支持创建的 Ability 模板和应用场景如下表所示。 Ability类型 Ability模板 使用场景 Particle Ability Empty Data Ability Data Ability 有助于应用管理其自身和其他应用所存储数据的访问，并提供与其他应用共享数据的方法。Data 既可用于同设备不同应用的数据共享，也支持跨设备之间不同应用的数据共享。 Empty Service Ability Service Ability 可在后台长时间运行而不提供用户交互界面。Service 可由其他应用或 Ability 启动，即使用户切换到其他应用，Service 仍将在后台继续运行。 Feature Ability Empty Feature Ability(JS) 用 JS 和 Java 编写带 UI 界面的空模板。 Empty Feature Ability(Java) 用 Java 和 xml 编写带 UI 界面的空模板。 List Feature Ability(JS) 用 JS 和 Java 编写带 UI 界面的目录列表模板。 Tab Feature Ability(JS) 用 JS 和 Java 编写带 UI 界面的表单模板。 创建Particle Ability 选中对应的模块，点击鼠标右键，选择 New > Ability ，然后选择 Empty Data Ability 或者 Empty Service Ability。 根据选择的 Ability 模板，设置 Ability 的基本信息。 Empty Data Ability 基本信息设置： Data Name：Data Ability类名称。 Visible：表示该Ability是否可以被其它应用所调用，勾选上则表示允许被调用。 Package name：新增Ability对应的包名称。 Empty Service Ability 基本信息设置： Service Name：Service Ability 类名称。 Visible：表示该 Ability 是否可以被其它应用所调用，勾选上则表示允许被调用。 Package name：新增 Ability 对应的包名称。 Enable background mode ：指定用于满足特定类型的后台服务， 可以将多个后台服务类型分配给特定服务。 各服务与 config.json 文件的映射关系如下表所示。 Background modes 对应config.json字段名称 描述 Data upload/download, backup/restore data-transfer 通过网络/对端设备进行数据下载，备份分享，传输等业务 Audio playback audio-playback 音频输出业务 Audio recording audio-recording 音频输入业务 Picture-in-picture picture-in-picture 画中画，小窗口播放视频业务 Voice/video call over IP voip 音视频电话、VOIP业务 Location update location 定位，导航业务 Bluetooth communication bluetooth-interaction 蓝牙扫描、连接、传输业务（穿戴） Wifi communication wifi-interaction WLAN扫描、连接、传输业务（多屏，克隆） Screen recording, screenshot screen-fetch 录屏，截屏业务 点击 Finish 完成 Ability 的创建，可以在工程目录对应的模块中查看和编辑 Ability。 创建...

DevEco Studio 支持多种语言进行 HarmonyOS 应用的开发，包括 Java、JS 和 C/C++。在编写应用阶段，您可以通过掌握各种代码编写的各种常用技巧，来提升编码效率。 代码高亮 支持对代码关键字、运算符、字符串、类名称、接口名、枚举值等进行高亮颜色显示，可以在菜单栏打开 File > Settings（或快捷键 Ctrl+Alt+S）面板，在Editor > Color Scheme 自定义各语言高亮显示颜色。 同时还可以动态的对变量名和参数名进行语义高亮，默认情况下为关闭状态，可以在菜单栏打开 File > Settings（或快捷键 Ctrl+Alt+S）面板，在 Editor > Color Scheme > Language Defaults > Semantic highlighting 中，打开语义高亮开关。 代码智能补齐 编辑器工具会分析上下文并理解项目内容，并根据输入的内容，提示可补齐的类，方法，字段和关键字的名称等。 代码错误检查 如果输入的语法不符合编码规范，或者出现拼写错误，编辑器会实时的进行代码分析，并在代码中突出显示错误或警告，并给出对应的修改建议。 代码自动跳转 在编辑器中，可以按住 Ctrl 键，鼠标点击代码中的类、方法、参数、变量等名称，可以自动跳转到定义处。 代码格式化 支持对选定范围的代码或者当前整个文件进行代码格式化操作，可以很好的提升代码的美观度和可读性。 使用快捷键 Ctrl + Alt + L 可以快速对选定范围的代码进行格式化。 使用快捷件 Ctrl + Alt + Shift + L 可以快速对当前整个文件进行格式化。 如果在进行格式化时，对于部分代码片段不需要进行自动的格式化处理，可以通过如下方式进行设置： 首先，在 File>Settings>Editor>Code Style，点击 “Formatter Control”，勾选 “Enable formatter markers in comments”。 其次，在 Java 或 C/C++ 代码中，对不需要进行格式化操作的代码块前增加“//@formatter:off”，对不格式化代码块的最后增加“//@formatter:on”，即表示对该范围的代码块不需要进行格式化操作。 代码折叠 支持对代码块的快速折叠和展开，可以使用快捷键 Ctrl + NumPad+ 快速展开已折叠的代码；使用快捷键 Ctrl + NumPad-折叠已展开的代码块。 代码快速注释 支持对选择的代码块进行快速注释，使用快捷键 Ctrl+/ 快速进行注释。对于已注释的代码快，再次使用快捷键 Ctrl+/ 取消注释。 代码结构树 支持快速查看代码文档的结构树，包括全局变量和函数，类成员变量和方法等，并可以跳转到对应代码行。可使用快捷键 Alt + 7 / Ctrl + F12 快速打开代码结构树。 代码查找 通过对符号、类或文件的即时导航来查找代码。检查调用或类型层次结构，轻松地搜索工程里的所有内容。通过使用连续按压两次 Shift 快捷键，打开代码查找界面。 查看 Java 接口文档 在 Java 代码选中 HarmonyOS API 或选中 Java 类时，使用快捷键 Ctrl+Q，在弹出的“Documentation”最下方，会显示相应文档的链接。 例如：图示红框中的“‘AbilityPackage’on D” 点击文档的链接，比如：“‘AbilityPackage’on...

Module 是 HarmonyOS 应用的基本功能单元，包含了源代码、资源文件、第三方库及应用清单文件，每一个 Module 都可以独立进行编译和运行。一个 HarmonyOS 应用通常会包含一个或多个 Module，因此，可以在工程中，创建多个 Module，每个 Module 分为 Ability 和 Library （HarmonyOS Library 和 Java Library）两种类型。 如 HarmonyOS工程介绍，在一个 APP 中，对于同一类型设备有且只有一个 Entry Module，其余 Module 的类型均为 Feature。因此，在创建一个类型为 Ability 的 Module 时，遵循如下原则： 若新增 Module 的设备类型为已有设备时，则 Module 的类型将自动设置为“Feature”。 若新增 Module 的设备类型为当前还没有创建 Module，则 Module 的类型将自动设置为“Entry”。 新增 Module 通过如下两种方法，在工程中添加新的 Module。 方法1：鼠标移到工程目录顶部，点击鼠标右键，选择 New>Module，开始创建新的 Module。 方法2：在菜单栏选择 File > New > Module，开始创建新的 Module。 在 New Project Module 界面中，选择 Module 对应的设备类型和模板。 点击 Next，在 Module 配置页面，设置新增 Module 的基本信息。 Module 类型为 Ability 或者 HarmonyOS Library 时，请根据如下内容进行设置，然后点击Next。 Application/Library name：新增 Module 所属的类名称。 Module name：新增模块的名称。 Module Type：仅 Module 类型为 Ability 时存在，工具自动根据设备类型下的模块进行设置。 Package name：软件包名称，可以点击 Edit 修改默认包名称，需全局唯一。 Compatible SDK：兼容的 SDK 版本。 Module 类型为 Java Library 时，请根据如下内容进行设置，然后点击 Finish 完成创建。 Library Name：Java Library 类名称。 Java package name：软件包名称，可以点击 Edit 修改默认包名称，需全局唯一。 Java class name：class 文件名称。 Create.gitignore file：是否自动创建...

当开始开发一个 HarmonyOS 应用时，首先需要根据工程创建向导，创建一个新的工程，工具会自动生成对应的代码和资源模板。 如果创建的工程包含 JS 语言，请确保已经下载了 JS SDK 包，具体可参考下载HarmonyOS SDK。 说明 在运行 DevEco Studio 工程时，建议每一个运行窗口有 2GB 以上的可用内存空间。 创建和配置新工程 通过如下两种方式，打开工程创建向导界面。 如果当前未打开任何工程，可以在 DevEco Studio 的欢迎页，选择 Create HarmonyOS Project 开始创建一个新工程。 如果已经打开了工程，可以在菜单栏选择 File > New > New Project 来创建一个新工程。 根据工程创建向导，选择需要进行开发的设备类型，然后选择对应的 Ability 模板。 点击 Next，进入到工程配置阶段，需要根据向导配置工程的基本信息。 Project name：工程的名称，可以自定义。 Package name：软件包名称，默认情况下，应用 ID 也会使用该名称，应用发布时，应用 ID 需要唯一。 Save location：工程文件本地存储路径。 Compatible SDK：兼容的 SDK 版本。 点击 Finish，工具会自动生成示例代码和相关资源，等待工程创建完成。 导入现有工程 导入现有工程分为以下两种情况： 导入 DevEco Studio 创建的 HarmonyOS 应用工程： 如果当前未打开任何工程，可以在 DevEco Studio 的欢迎页，选择 Open Project 打开现有工程。 如果已经打开了工程，可以在菜单栏选择 File > Open 来打开现有工程。 导入其它 IDE 创建的工程，比如导入 Visual Studio Code 创建的轻量级智能穿戴 HarmonyOS 应用工程： 如果当前未打开任何工程，可以在 DevEco Studio 的欢迎页，选择 Import Project 导入现有工程。 如果已经打开了工程，可以在菜单栏选择 File > Import Project 导入现有工程。 导入现有工程时，DevEco Studio 会提醒您可以选择在新的窗口打开工程，或者选择在当前窗口打开工程。

DevEco Studio 支持包括智慧屏、智能穿戴和轻量级智能穿戴的 HarmonyOS 应用开发，可以根据工程向导轻松创建适应于各类设备的工程，并自动生成对应的代码和资源模板。同时，DevEco Studio 还提供了多种编程语言供开发者进行 HarmonyOS 应用开发，包括 Java、JS 和 C/C++ 三种编程语言，并支持多种语言的混合开发场景。因此，在创建对应设备的工程时，工具会预置多种 Ability 的模板，并推荐您使用适合的开发语言。 支持的各设备类型工程模板和对应开发语言的对应关系，如下表所示。 Device 工程模板 TV Empty Feature Ability（JS） Empty Feature Ability（Java） List Container Ability（Java） List Feature Ability（JS） Split Panel Ability（Java） Tab Feature Ability（JS） Wearable Empty Feature Ability（JS） Empty Feature Ability（Java） List Feature Ability（JS） Lite Wearable Empty Feature Ability List Feature Ability

HarmonyOS APP工程结构 在进行 HarmonyOS 应用开发前，您应该掌握 HarmonyOS 应用的逻辑结构。 HarmonyOS 应用发布形态为 APP Pack （Application Package，简称 APP），它是由一个或多个 HAP（HarmonyOS Ability Package）包以及描述 APP Pack 属性的 pack.info 文件组成。 一个 HAP 在工程目录中对应一个 Module，它是由代码、资源、第三方库及应用清单文件组成，可以分为 Entry 和 Feature 两种类型。 Entry：应用的主模块。一个 APP 中，对于同一设备类型必须有且只有一个 entry 类型的HAP，可独立安装运行。 Feature：应用的动态特性模块。一个 APP 可以包含一个或多个 feature 类型的 HAP，也可以不含。 HAP 是 Ability 的部署包，HarmonyOS 应用代码围绕 Ability 组件展开，它是由一个或多个 Ability 组成。Ability 分为两种类型：FA（Feature Ability）和 PA（Particle Ability）。FA/PA 是应用的基本组成单元，能够实现特定的业务功能。FA 有 UI 界面，而 PA 无 UI 界面。 工程目录结构 Java工程目录结构 Java 工程目录结构如下图所示。 .gradle：Gradle 配置文件，由系统自动生成，一般情况下不需要进行修改。 entry ：默认启动模块（主模块），开发者用于编写源码文件以及开发资源文件的目录。 entry>libs：用于存放 entry 模块的依赖文件。 entry>.gitgnore：标识 git 版本管理需要忽略的文件。 entry>build.gradle：entry 模块的编译配置文件。 entry>src>main>Java：用于存放 Java 源码。 entry>src>main>resources：用于存放资源文件。 entry>src>main>config.json：HAP 清单文件，详细说明请参考config.json清单文件介绍。 entry>src>test：编写测试文件的目录。 JS工程目录结构 JS 工程目录结构如下图所示。 pages 目录： pages 文件夹下可以包含 1 个或多个页面，每个页面都需要创建一个文件夹（如图中的 index）。页面文件夹下主要包含 3 种文件类型：css、js 和 hml 文件。 pages > index > index.hml文件：hml 文件定义了页面的布局结构，使用到的组件，以及这些组件的层级关系。 pages > index > index.css文件：css 文件定义了页面的样式与布局，包含样式选择器和各种样式属性等。 pages > index > index.js文件：js 文件描述了页面的行为逻辑，此文件里定义了页面里所用到的所有的逻辑关系，比如数据、事件等。 app.js文件：全局的 JavaScript...

DevEco Studio 开发环境配置完成后，可以通过运行 HelloWorld 工程来验证环境设置是否正确。以 Wearable 工程为例，在 Wearable 远程模拟器中运行该工程。 打开 DevEco Studio，在欢迎页点击 Create HarmonyOS Project，创建一个新工程。 选择设备类型和模板，以 Wearable 为例，选择 Empty Feature Ability(Java)，点击 Next。 填写项目相关信息，保持默认值即可，点击 Finish。 工程创建完成后，DevEco Studio 会自动进行工程的同步，同步成功如下图所示。首次创建工程时，会自动下载 Gradle 工具（Gradle 下载失败如何解决?），时间较长，请耐心等待。 在DevEco Studio 菜单栏，点击Tools > HVD Manager。首次使用模拟器，需下载模拟器相关资源，请点击 OK，等待资源下载完成后，点击模拟器界面左下角的 Refresh 按钮。（查看使用远程模拟器的常见问题） 在浏览器中弹出华为帐号登录界面，请输入已实名认证的华为帐号的用户名和密码进行登录。 说明 推荐使用 Chrome 浏览器，如果使用 Safari、360 等其他浏览器，要取消 阻止跨站跟踪 和 阻止所有Cookie 功能。 登录后，请点击界面的 允许 按钮进行授权。 在设备列表中，选择Wearable设备，并点击按钮，运行模拟器。 点击 DevEco Studio 工具栏中的按钮运行工程，或使用默认快捷键 Shift+F10 运行工程。 在弹出的 Select Deployment Target 界面选择 Connected Devices，点击 OK 按钮。 DevEco Studio 会启动应用的编译构建，完成后应用即可运行在 Remote Device 上。