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/dc/v3/WUjWJXn-R_2-H9KLIuXhcQ/zh-cn_image_0000002654837807.png?HW-CC-KV=V1&HW-CC-Date=20260709T134349Z&HW-CC-Expire=86400&HW-CC-Sign=5277FE52A9DBCAD5B4C3145AC420A0C48DB22C1E534271739951B0EF1BC01980)

**解决措施**

出现该提示的原因是在旧版本的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/4c/v3/qUBhvCQMSRuGlCJD2y6OZQ/zh-cn_image_0000002624478496.png?HW-CC-KV=V1&HW-CC-Date=20260709T134349Z&HW-CC-Expire=86400&HW-CC-Sign=CFC27F31BDB28A08C9F4E00224709CA6AB24A0A418F2097D667D2F13CF9B0B2C)

配置位置变更后，使用历史工程模板的开发者，如果使用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/ea/v3/SnaUOC36Q_2O0WzdGO7XXw/zh-cn_image_0000002654797855.png?HW-CC-KV=V1&HW-CC-Date=20260709T134349Z&HW-CC-Expire=86400&HW-CC-Sign=DDFEA1A1A4AB88FDF57E546F3AB96BFC8F610C7BF402C68E6B89281FFA3393F2)
    
3.  迁移完成后，点击菜单栏 File > Sync and Refresh Project 同步工程，然后重新编译构建。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9c/v3/nsYPy1u4RNeABtBhqktaUg/zh-cn_image_0000002624638400.png?HW-CC-KV=V1&HW-CC-Date=20260709T134349Z&HW-CC-Expire=86400&HW-CC-Sign=0AA420F0BB7E32F15B03D780F4A9A5243A97E3241400534B9A59F4FDB147E45E)