ArkUI-X工程编译报错“The structure of the cross-platform project is changed”

问题现象

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

解决措施

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

由于配置位置变更，对于使用历史工程模板的用户，如果使用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。

    

   配置内容示例如下：

   {
     "crossplatform": true,     // 跨平台工程标识
     "modules": [               // 跨平台模块配置
       "entry"
     ]
   }

   工程迁移后结构如下：

   

    

3. 迁移完成后，点击菜单栏File > Sync and Refresh Project同步工程后，重新编译构建。

    

   

    

   完毕

   

关于坚果派

坚果派由坚果创建，团队拥有12个华为HDE，以及若干其他领域的三十余位万粉博主运营。专注于分享的技术包括HarmonyOS/OpenHarmony，ArkUI-X，元服务，服务卡片，华为自研语言，AI、BlueOS操作系统、团队成员聚集在北京，上海，南京，深圳，广州，宁夏等地，欢迎合作。