应用UI生成
======

UI Generator用于快速生成可编译、可运行的HarmonyOS UI工程，支持基于已有UI布局文件（XML），快速生成对应的HarmonyOS UI代码，其中包含HarmonyOS基础工程、页面布局、组件及属性和资源文件等。

#### 使用约束

建议使用DevEco Studio 5.0.3.700及以上版本。

#### 启用插件

1.  在DevEco Studio菜单栏，点击**File > Setting****s...**（macOS为**DevEco Studio > Preferences****/Settings**）**\> Plugins**，在Installed列表中找到UI Generator插件，点击**Enable**启用。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b8/v3/qkaSoKoYQOO00IDxtrwXvQ/zh-cn_image_0000002594635068.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=389139D0789755AF16F519ABADCB25ECE8B5AC98051E4BBD04098597623C11F7)
    
2.  单击OK并关闭设置窗口，插件启用成功。

#### 开始使用

1.  在DevEco Studio菜单栏点击**Tools > Generate Project From...**打开UI Generator工具，首次使用需要阅读并确认用户协议，确认后可继续使用。
2.  输入待配置项路径，点击**Next**进入下一步。
    
    | 
    待配置项
    
     | 
    
    说明
    
     |
    | :-- | :-- |
    | 
    
    Installation package path
    
     | 
    
    待转换的APK应用包的路径，请提供未混淆的Debug版本应用包。
    
     |
    | 
    
    SDK path
    
     | 
    
    等于或高于编译应用包所使用版本的SDK路径。
    
     |
    | 
    
    Git Bash path
    
     | 
    
    Git Bash工具存放路径。若本地已下载安装Git Bash，插件将自动获取其路径。
    
     |
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6d/v3/hAsIQbuNTIa7xBc9aW4ZZg/zh-cn_image_0000002594635064.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=0B2AF455361E157F11F163842E74C538ED2403D58F33AE89AFC99C2D76985F2B)
    
3.  选择将要生成的XML页面（可在搜索框进行搜索），勾选后点击向右箭头将选中的XML导入至右侧。点击**Next**开始生成。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e2/v3/5i3TmJRnQkCXko4fxO4ePw/zh-cn_image_0000002625074637.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=EA272E2682E128BD745F81AF492A119925BF06FBE6BC8787A826E4E6D54A352B)
    
4.  配置输出工程待配置项，点击**Finish**进行生成。
    
    | 
    待配置项
    
     | 
    
    说明
    
     |
    | :-- | :-- |
    | 
    
    Destination Path
    
     | 
    
    生成新工程的保存路径（默认生成到用户目录下UIGenerationProjects，用户可根据需要自行更改）
    
     |
    | 
    
    Compatible SDK
    
     | 
    
    生成的新工程所使用的SDK版本
    
     |
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a3/v3/GFIOfzXaRfy0NZFxwVKOrg/zh-cn_image_0000002594475140.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=AA825070AA6BF7EB9AC1DD9997811EFF819AE4F7828F4F0790EF3B5FFEEC837B)
    
5.  （可选）如果所选XML无有效根节点，需要选择根节点信息。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dc/v3/8z5xGg3LSpSSWItwHI8iGA/zh-cn_image_0000002594475142.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=00DD3D2099F252C25D4639A76A22C93211EFAE92AB1CDF88FEA36C3CD9B8F709)
    
6.  点击**Finish**，在弹窗中点击确认，打开新工程。
    
    生成的页面位于entry > src > main > ets > pages目录下，可以点击Previewer查看页面预览效果。不支持生成的组件、属性会以注释的形式给出，方便后续定位修改。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2c/v3/h9Ba0QnySXq0bKj3hnsYcQ/zh-cn_image_0000002624994501.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=0320604171EB94EFDF63284121C966663B1109FBE58E970436E7E16887ED8D4C)
    
7.  生成的新工程内的entry > src > main > resources目录包含文本、图像、颜色资源。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/16/v3/FlsPVaEESb6ejy08BB0fdA/zh-cn_image_0000002625074641.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=53678BDEA0715B467BB9CBD4355059AE6C4E738AD4B3F7BE5943B3D33C47C121 "点击放大")
    
    更多操作指导，请参考视频课程：[毕方HarmonyOS UI代码生成工具](https://developer.huawei.com/consumer/cn/training/course/live/C101731322888995220)。