# 自定义页面开发

该页面旨在指导开发者如何开发具有自定义页面功能的 AddOn 包。

请注意:

本章为入门教程,主要目的是使开发者了解自定义页面的基础知识与基本开发流程。

若需了解如何开发带有具体应用功能、应用于具体工艺场景的 AddOn 自定义页面包,请参考后续的完整案例章节:。

# 关于自定义页面

# 自定义页面是什么

自定义页面是指开发者根据自己的需求,在符合web开发规范的情况下,开发出的除 JAKA App 内已有页面之外的其他页面。

# 自定义页面的作用

在实际的应用场景中,可能需要在不同的App中来回切换,或是在 JAKA App 的不同页面中来回切换,或是停止正在进程中的工作去调试第三方设备。如此一来,可能会对工作节奏和效率产生影响。

若使用 AddOn 自定义页面的话,只需在 JAKA App 页面中即可解决“来回切换”的问题。

# 创建 JAKA_Web

在此处的示范中,我们将创建一个自定义页面类型的AddOn,该 AddOn 的功能是在页面中显示“Hello JAKA!”。

# 步骤一:创建 AddOn 文件夹

首先我们需要创建一份 AddOn 基本文件夹,该文件夹需包含一个.ini格式的配置文件和前端工程文件,我们建议使用 client 作为前端工程的文件夹名称。

您可以从头开始手动创建,也可以使用AddOn开发包仓库中 "Template" (opens new window) 目录下的AddOn模板进行修改。

目录结构

|—4.3-JAKA_Web
   |—client
   |  |—index.html
   |—4.3-JAKA_Web_config.ini

  • index.html
        <!DOCTYPE html>
        <html lang="en">
        <head>
            <meta charset="UTF-8">
            <meta name="viewport" content="width=device-width, initial-scale=1.0">
            <title>HelloJAKA!</title>
        </head>
        <body style="background-color:#f5f6fa;">
            <p style="font-size: 10vh;text-align: center;margin-top: 20%;"> Hello JAKA!</p>
        </body>
        </html>
    
  • 4.3-JAKA_Web_config.ini
    配置文件内容如下:
    [AddOnInfo]
    convention = 3.0
    name = 4.3-JAKA_Web
    description = 在页面中显示“Hello JAKA!”
    version = 1.0
    type = 3
    portal = 10006
    url = http://localhost/4.3-JAKA_Web/client/
    languagetype = node-red
    service = null
    serviceenabled = 0
    

# 步骤二:打包&上传

接下来我们会将步骤一中创建好的文件夹打包,上传至控制器中进行指令块开发,打包的要求格式为.tar.gz

在 Windows 中您可以使用 7z 等打包工具进行二次压缩。

在 App 中附加管理程序页面上传AddOn。

# 步骤三:访问页面

下面将介绍两种方式访问之前制作的页面。

  • 方法1 在附加程序找到JAKA_Web,点击小地球按钮访问 AddOn 中的页面。
  • 方法2 在浏览器中输入http://172.30.2.216/addon/4.3-JAKA_Web/client/,注意将链接IP替换为当前机器人的IP。

# 兼容性

在进行自定义页面开发时,需注意目标浏览器的版本,避免因版本而产生的不兼容。

  • JAKA App 中用来显示自定义页面的 web view 插件使用的浏览器内核为Chromium:74.0.3729.157
上次修改: 2024/2/21 07:49:44