ArkUI-X工程编译报错“The ArkUI-X project's structure has been changed”
===============================================================

**问题现象**

使用DevEco Studio 4.0.0.700及以上版本打开ArkUI-X历史工程时，工程同步或构建会提示“ERROR: The ArkUI-X project's structure has been changed. Migrate and adapt the project as instructed in FAQs.”。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/37/v3/PLFYE8MrQPyu4CiDGpSV2Q/zh-cn_image_0000002194158592.png?HW-CC-KV=V1&HW-CC-Date=20260612T074807Z&HW-CC-Expire=86400&HW-CC-Sign=E47D6CFF5C9337F5EF690196C0527AAA626559F796DEB9E1577FB7B6056434EB)

**解决措施**

出现该提示的原因是在旧版本的ArkUI-X工程模板中，ArkUI-X工程标识（"crossplatform": true）配置在工程目录下build-profile.json5中，在DevEco Studio 4.0.0.700及以上版本需要在工程目录下.arkui-x/arkui-x-config.json5文件中配置ArkUI-X工程模块、工程标识等信息。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cb/v3/hLVsYvzZSPG8MssWq3BVBA/zh-cn_image_0000002229758465.png?HW-CC-KV=V1&HW-CC-Date=20260612T074807Z&HW-CC-Expire=86400&HW-CC-Sign=95A736B221C5212F10878585881DDF7C2BD77B06291F9B41C280BAF9D5393334)

配置位置变更后，使用历史工程模板的开发者，如果使用DevEco Studio 4.0.0.700及以上版本，需手动迁移适配新的工程结构。迁移步骤如下：

1.  删除工程目录下build-profile.json5中的ArkUI-X工程标识（"crossplatform": true）。
2.  在工程下.arkui-x目录中新建arkui-x-config.json5文件，配置内容为 "crossplatform": true, "modules"中配置工程中所有ArkUI-X模块的module name。
    
    工程迁移后结构如下：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e5/v3/1AZbIkMASo2rmCZLb5qKKQ/zh-cn_image_0000002229758461.png?HW-CC-KV=V1&HW-CC-Date=20260612T074807Z&HW-CC-Expire=86400&HW-CC-Sign=A57990B4E2D5D5150B52FF894F30D82F947FA73C650D94B2890DCF7B78AD75F5)
    
3.  迁移完成后，点击菜单栏 File > Sync and Refresh Project 同步工程，然后重新编译构建。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/91/v3/1bKv-JHgSPam-KKPJg7Eeg/zh-cn_image_0000002229603993.png?HW-CC-KV=V1&HW-CC-Date=20260612T074807Z&HW-CC-Expire=86400&HW-CC-Sign=06007F52DBF96346C14E51AFA6579404D3C56B6B315B27550C92865B8B632A37)