目录

string资源可视化编辑

功能介绍

在应用开发中,string资源分散于多个目录(如 resources/base/element/string.json、resources/zh_CN/element/string.json、resources/en_US/element/string.json 等),手动切换文件查看和编辑资源效率较低。

string资源可视化是以表格形式统一展示所有string资源的名称和值、所在资源目录等,提升可读性。同时,支持在可视化界面新建资源,在可视化表格编辑资源值、复制/粘贴资源、删除资源等,提升开发效率。该功能适用于多语言/多设备、跨工程/跨模块共享string资源、资源定位相关场景。

操作步骤

  1. 双击资源文件中的string.json文件后,点击编辑界面的Open editor,即可进入string资源可视化编辑页面。

  2. string资源可视化表格的示例如下,其中Name列为资源名称,Resource Folder列为资源目录,base列为默认资源目录的资源值,base后的列(如aa_ET-wearable列)为限定词目录的资源值。

    限定词目录以字母顺序依次排列在base列之后的各列中。

  3. 在可视化界面可以新建string资源、新建限定词目录(Qualifier)、筛选限定词目录、编辑表格内容等。

    • 新建base目录资源

      点击顶部 按钮,打开新建string资源向导,填写Name(资源名称)和Value(资源值),选择Resource folder(资源目录),点击OK。新建完成后,资源会写入相应的string.json文件以及在可视化表格中同步展示。

    • 新建限定词目录资源

      点击顶部按钮,打开新建Qualifier向导,选择Source set(资源目录路径),在Available qualifiers下选择限定词,点击OK。新建完成后,限定词资源会在工程目录和表格中同步展示。

    • 筛选限定词资源目录

      顶部筛选框支持过滤限定词目录,默认为Show All Qualifiers。选择某个Qualifier后,表格会展示Name列、Resource Folder列、base列和筛选的Qualifier列。

    • 编辑资源值

      选中base列或限定词目录列中的单元格后,顶部输入框会显示当前值并支持编辑,或双击资源值单元格直接进入编辑模式,编辑后鼠标离开失焦或点击回车进行保存,资源值会写入对应的string.json文件以及在可视化表格中同步展示。

    • 选择多个资源

      从26.0.1版本开始支持。通过如下键鼠组合可同时选中表格多行,选中多行后可执行批量复制和粘贴、批量删除等操作。

      • Ctrl+单击(macOS中为Command+单击):选中某行或取消选中某行,实现切换该行选中状态。
      • Ctrl+Shift+单击(macOS中为Command+Shift+单击):从当前点击行至目标行连续选中。
      • 单击:取消多行选择,切换为单选单元格模式。

        点击刷新按钮,会取消多行选择。

    • 复制资源

      从26.0.1版本开始支持。选中表格单元格或行后右键,点击Copy Line会将选中的数据序列化为JSON格式并写入系统剪贴板,支持单行复制和多行复制。

    • 粘贴资源

      从26.0.1版本开始支持。在目标模块或工程的可视化表格中右键,选择Create & Paste Line,即可粘贴已复制的资源内容。粘贴时,资源仅会添加到目标模块或工程中已有的限定词目录下。

      当粘贴数据中存在与当前表格同名资源时,会有弹窗提示:

      • Cancel:取消粘贴。
      • Ignore:只创建无冲突项,跳过同名资源。
      • Overwrite:用新值覆盖同名资源。

    • 跳转至string.json源文件和资源声明位置

      选择非空单元格后右键,点击Go to Declaration,可打开对应的string.json源文件并定位到string声明的位置。

      其中,选择Name列、Resource Folder列和base列单元格,会跳转至base目录下的string.json文件中;限定词目录列(如aa)会跳转至限定词目录下的string.json文件中。

    • 删除资源值

      选中base目录或限定词下的资源值后右键,点击Delete string,即可删除选中的资源值。

    • 删除资源

      选中Name列或Resource Folder列某个单元格后右键,点击Delete key,在弹出的确认对话框中点击OK,即可删除base目录和限定词目录下的对应资源。

      从26.0.1版本开始支持。选中可视化表格多行后右键,点击Delete key,在弹出的确认对话框中点击OK,即可批量删除base目录和限定词目录下的对应资源。