创建一个新的工程
========

当您开始开发一个应用/元服务时，首先需要根据工程创建向导，创建一个新的工程，工具会自动生成对应的代码和资源模板。

DevEco Studio提供了基础的工程模板资源，不同模板支持的设备类型、API Version可能不同，在创建新工程前，请提前了解各模板的相关信息，具体请参考[工程模板介绍](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-template)。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1f/v3/XVt6byHITSqEppaw4X4KTw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073817Z&HW-CC-Expire=86400&HW-CC-Sign=BA4605A2A900757F7422E965B5358F75127CDF2E9FDF45A0B7A72B4C11B54F4A)

在运行DevEco Studio工程时，建议每一个运行窗口有2GB以上的可用内存空间。

#### 创建HarmonyOS工程

1.  通过如下两种方式，打开工程创建向导界面。
    
    *   如果当前未打开任何工程，可以在DevEco Studio的欢迎页，选择**Create Project**开始创建一个新工程。
    *   如果已经打开了工程，可以在菜单栏选择**File > New > Create Project**来创建一个新工程。
    
2.  根据工程创建向导，选择创建Application或[Atomic Service](https://developer.huawei.com/consumer/cn/doc/atomic-guides/atomic-service-create-project)。再选择需要的Ability工程模板，然后单击**Next**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f/v3/Dj2QRQhKRSuFLH_d9k7M4A/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073817Z&HW-CC-Expire=86400&HW-CC-Sign=2A35D3E4E3F50367257DF0D83E54D49B102C568295620A7CE7196E45746A9CAB)
    
    *   从API 11版本开始支持Atomic Service元服务工程开发。
    *   Atomic Service元服务工程暂不支持Native开发。
    *   \[CloudDev\]Empty Ability模板：该功能仅支持中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5d/v3/khxFFZGhQ0e-iD-hz0eseA/zh-cn_image_0000002624994087.png?HW-CC-KV=V1&HW-CC-Date=20260612T073817Z&HW-CC-Expire=86400&HW-CC-Sign=A5A76AD43CDBCC8EB95A48BE8A7A7462C57DFFA85354C643EF0F3CBCB6252C46)
    
3.  在工程配置页面，需要根据向导配置工程的基本信息。
    
    *   **Project name**：工程的名称，可以自定义，由大小写字母、数字和下划线组成，必须由大小写字母开头，长度为1~200个字符。
    *   **Bundle name**：标识应用的包名，用于标识应用的唯一性。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3f/v3/drSzhZnKQTmJ7xKWnZeyIw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073817Z&HW-CC-Expire=86400&HW-CC-Sign=B7974DEF7CECDC5B2817E1D47B7ABFCAA61E534CC4E2B174C922E9429A6B1209)
        
        应用包名要求：
        
        *   必须为以点号（.）分隔的字符串，且至少包含三段，每段中仅允许使用英文字母、数字、下划线（\_），如“com.example.myapplication ”。
        *   首段以英文字母开头，非首段以数字或英文字母开头，每一段以数字或者英文字母结尾，如“com.01example.myapplication”。
        *   不允许多个点号（.）连续出现，如“com.example..myapplication ”。
        *   长度为7~128个字符。
        
    *   **Save location**：工程文件本地存储路径，由大小写字母、数字和下划线等组成，不能包含中文字符。
    *   **Compatible SDK**：兼容的最低API Version。
    *   **Module name**： 模块的名称。
    *   **Device type：**该工程模板支持的设备类型。设备类型说明请参考[deviceTypes标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#devicetypes标签)。
    *   **C++ Standard：**C++标准库。从DevEco Studio 6.0.1 Beta1开始，支持选择不同版本，取值包括：Toolchain Default、C++11、C++14。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8a/v3/umlZ1iSfQe2ttEzGFDyJQg/zh-cn_image_0000002594474728.png?HW-CC-KV=V1&HW-CC-Date=20260612T073817Z&HW-CC-Expire=86400&HW-CC-Sign=912564176A5AFA50440EE6F0D3B9EA604498592B312DAC588B6D3A55574A0DA4)
    
4.  单击**Finish**，工具会自动生成示例代码和相关资源，等待工程创建完成。

#### （可选）创建OpenHarmony工程

如需创建OpenHarmony工程进行应用开发，请按照以下步骤操作。

1.  在完成[创建HarmonyOS工程](#section11644183711342)后，根据如下操作修改工程级build-profile.json5文件中相关字段：
    
    **API 26.0.0及之后版本：**
    
    1.  在工程级build-profile.json5文件添加**compileSdkVersion**字段，并赋值为字符串类型。
    2.  将runtimeOS从"HarmonyOS"修改为**"OpenHarmony"**。
    
    "app": {
      "signingConfigs": \[\],
      "products": \[
        {
          "name": "default",
          "signingConfig": "default",
          "compileSdkVersion": "26.0.0",    //指定OpenHarmony应用编译时的版本，当前以API 26.0.0为例
          "targetSdkVersion": "26.0.0",     //指定OpenHarmony应用运行所需的目标SDK版本，当前以API 26.0.0为例
          "compatibleSdkVersion": "26.0.0", //指定OpenHarmony应用兼容的最低版本，当前以API 26.0.0为例
          "runtimeOS": "OpenHarmony",
          "buildOption": {
            "strictMode": {
              "caseSensitiveCheck": true,
              "useNormalizedOHMUrl": true
            }
          }
        }
      \],
    
    **API 26.0.0之前版本：**
    
    1.  在工程级build-profile.json5文件添加**compileSdkVersion**字段。
    2.  将**compatibleSdkVersion**、**compileSdkVersion**、**targetSdkVersion**（若有）字段赋值为数值类型。
    3.  将runtimeOS从"HarmonyOS"修改为**"OpenHarmony"**。
    
    "app": {
      "signingConfigs": \[\],
      "products": \[
        {
          "name": "default",
          "signingConfig": "default",
          "compileSdkVersion": 24,    //指定OpenHarmony应用编译时的版本，当前以API 24为例
          "targetSdkVersion": 24,     //指定OpenHarmony应用运行所需的目标SDK版本，当前以API 24为例
          "compatibleSdkVersion": 24, //指定OpenHarmony应用兼容的最低版本，当前以API 24为例
          "runtimeOS": "OpenHarmony",
          "buildOption": {
            "strictMode": {
              "caseSensitiveCheck": true,
              "useNormalizedOHMUrl": true
            }
          }
        }
      \],
    
2.  单击Sync Now进行同步。在Sync Check弹窗中点击**Yes**，同意将module.json5/config.json文件中的phone切换为OpenHarmony支持的default类型，并删除在OpenHarmony不适用的其他设备类型，同步成功无其他报错则工程创建完成。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/be/v3/v6zNRtznSRWRXJ0mrwWe_w/zh-cn_image_0000002594634652.png?HW-CC-KV=V1&HW-CC-Date=20260612T073817Z&HW-CC-Expire=86400&HW-CC-Sign=D813222E283B788A201B3C053CECE79D8C1D9565CC07E204E2D08039415F90D4)
    

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ac/v3/Vpes4A5BS5-CSq6_VDAT-w/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073817Z&HW-CC-Expire=86400&HW-CC-Sign=3939B64338E72A094B76673D3A3EBC13F1A2322DEC4FE8343535F9D30E3CD435)

若选择Native C++模板创建OpenHarmony应用，且应用需要在RK开发板上运行，则需在对应Native模块的build-profile.json5文件buildOption/externalNativeOptions字段下，新增abiFilters字段并赋值为"armeabi-v7a"。