开发智慧屏快应用

准入条件

在进行快应用开发前，请先完成如下准备工作：

• 在华为开发者联盟上注册成为开发者，并完成实名认证，详细参见“账号注册认证”。
• 完成开发环境的搭建，包括在PC上安装华为快应用IDE、在测试手机安装调试运行在智慧屏上快应用的加载器，详细参见“安装开发工具”。
• 在AppGallery Connect（以下简称AGC）上完成快应用的创建，详细参见“创建快应用”。

连接调试设备

• 连接智慧屏：支持USB连接和局域网连接两种方式，详细操作参见“华为快应用IDE使用指导”的“本地真机”章节。
• 连接Pad：在没有智慧屏的情况下，建议使用USB连接手机/Pad模拟开发智慧屏快应用。

创建项目

1. 打开华为快应用IDE，在欢迎页选择“新建项目 > 快应用”，选择“智慧屏”，点击“下一步”。

   

2. 选择“Hello World”通用模板，点击“下一步”。

   

3. 填写项目信息后，点击“确定”。
   • 应用名称：应用名称，用于在桌面图标、应用市场等处显示。例如：QuickAppDemo。
   • 应用包名：发布的快应用为以.rpk为后缀的文件，此处即定义发布后的包名。推荐采用com.company.module的格式，例如：com.huawei.quickappdemo。
   • 工作空间：项目工程存储路径。

   

编辑代码

1. 设置manifest.json文件中 minPlatformVersion 为1037。
2. 参考快应用规范进行快应用基础功能的开发。

   快应用规范包括：

   • 框架
   • 组件索引中智慧屏支持的组件
   • API索引中智慧屏支持的API

智慧屏没有触摸屏，所以开发智慧屏快应用时，重点要考虑焦点的处理。

焦点是屏幕上需要关注的区域，遥控器是操作智慧屏的主流工具，用户通过遥控器的方向键控制焦点移动。当焦点移动到目标组件后，按下遥控器的确认键即可触发相应事件，从而可以做下一步处理。

快应用在智慧屏提供了focusable属性、onkey/onfocus/onblur事件、focus方法、:focus伪类处理焦点。

• 用户按遥控器方向键时，系统会自动寻找目标方向的组件落焦。必要时开发者可以使用onkey控制下一个落焦的组件。实现onkey事件时，如果返回true会终止系统的自动寻焦逻辑。
• :focus伪类可以用来设计落焦组件的效果，比如放大、加边框等。
• 如果需要进入页面时，某个元素默认落焦，可以在页面的onShow()事件中，使用this.$element('id').focus()获取焦点。

运行调试

1. 选择需要编译调试的文件，点击“运行”。

   

2. 在弹出页面选择已连接的调试设备，点击“确认”。
3. 如果调试设备上没有安装快应用引擎，将在右下角弹出提示框，点击“安装”进行安装。已安装则跳过此步骤。

   

4. 启动调试流程，控制台输出COMPILE RESULT:SUCCESS后切换至DEVTOOL控制台，并启动终端设备投屏。
5. 在DEVTOOL面板下的Runtime.js ->Webpack栏，找到对应的页面文件，设置断点，进行调试。

   

6. 将鼠标移动至投屏区域，或者通过键盘模拟遥控器按键事件。

   键盘和遥控器按键的对应关系如下表所示。

   键盘按键	遥控器按键
   esc	back
   UP	UP
   DOWN	DOWN
   LEFT	LEFT
   RIGHT	RIGHT
   数字键5	CENTER

打包正式版本

确保开发的快应用功能没有问题，即可使用华为快应用IDE打包发布成rpk包，提交华为应用市场进行上架审核，详细打包过程参见“打包快应用”。

相关链接

[h2]FAQ

• 智慧屏图片焦点在一行最右一张图片时，再次按右时如何不跳至下一行第一张图片？
• 智慧屏中如果出现一页显示不完的大段落文字，如何处理？
• 键盘模拟键的code值和真实遥控器的对应关系是什么样？
• 页面布局设置Positon：fixed时，无法落焦，如何处理？
• 开发智慧屏快应用所需的华为移动服务HMS Core的最低版本是多少？
• 智慧屏按下键盘或遥控器为何会触发两次事件？
• 快应用IDE升级到11.4.1后，使用Node.js的核心模块时编译报错，如何处理？

[h2]案例

调用buffer接口报错，提示“Buffer is not defined”

智慧屏运行快应用提示：当前加载器支持1038规范版本，无法运行XXXX。