DevEco Studio中如何查看和配置compileSdkVersion ?

DevEco Studio中如何查看和配置compileSdkVersion ? 在 DevEco 里,compileSdkVersion 主要在 build-profile.json5 里配置 / 查看,旧版(API4-7)在 build.gradle。

一、查看与配置(API8+,现在主流)

打开项目根目录下的:

build-profile.json5

找到类似:

{
  "app": {
    "products": [
      {
        "name": "default",
        "compileSdkVersion": "6.1.1(24)",   // 👈 编译SDK版本
        "compatibleSdkVersion": "5.0.0(12)",// 👈 最低兼容版本
        "targetSdkVersion": "6.1.1(24)"
      }
    ]
  }
}
  • compileSdkVersion:编译时用的 SDK 版本,一般和 IDE 自带 SDK 一致。
  • 修改后点右上角 Sync Now 同步。

cke_3307.png

二、旧项目(API4~7)

在模块下的 build.gradle

android { compileSdkVersion 7 defaultConfig { compatibleSdkVersion 7 } }


![cke_6336.png](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/781/678/744/40444AC95DC074658F304CC6A75D0658:015F47B73F038EA7181826C449558F2C504CC0C4271BD523B682DB8170C37E3C.20260509093242.40656384401795713609238916928821:50001231000000:2800:F6155CC411E80FB3735A444282508CD579E4F70693743E1A20A5629BBF3AC7FB.png)

### 三、图形化界面查看 SDK 版本

1. 菜单:**File → Settings → SDKs → HarmonyOS**(macOS:Preferences → SDKs → HarmonyOS)。
2. 这里能看到已下载的 **API Version / Stage(Release/Beta)**。

![cke_9464.png](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/781/678/744/40444AC95DC074658F304CC6A75D0658:015F47B73F038EA7181826C449558F2C504CC0C4271BD523B682DB8170C37E3C.20260509093322.27885998862954508054664994519870:50001231000000:2800:D18EE12216E2ACB6B976778D23D4F25836A4E7F31F5BF8862CF800956E7FFE32.png)

### 四、创建新项目时设置

New Project → Empty Ability → 界面直接选:

- **Compile SDK**(对应 compileSdkVersion)
- **Compatible SDK**(对应 compatibleSdkVersion)

![cke_12230.png](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/781/678/744/40444AC95DC074658F304CC6A75D0658:015F47B73F038EA7181826C449558F2C504CC0C4271BD523B682DB8170C37E3C.20260509093357.34324079062382426522504288144942:50001231000000:2800:940E8D56C53D439C4C8ED769BF9E9D08C0D952A2F620D678DE44A38E22981B5E.png)

### 五、常见说明

- 从 **DevEco NEXT Beta1+** 开始,compileSdkVersion 可不显式配置,默认用 IDE 配套 SDK。
- 若手动配置,**必须等于 IDE 自带 SDK 版本**,不能随意写。
- 想看设备实际 API:
```lua
hdc shell getprop hw_sc.build.os.apiversion

2 回复

在DevEco Studio中,compileSdkVersion配置位于模块级 build-profile.json5 文件的 ohos 节点下。
查看:打开该文件,直接查看 compileSdkVersion 字段值。
配置:修改该字段为所需API版本号(如9或10)。
也可通过菜单 FileProject StructureModuleOhos 选项卡查看和修改。


在 DevEco Studio 中,compileSdkVersion 的查看与配置方式因项目结构而异:

  • 当前主流项目(API 8+):打开项目根目录的 build-profile.json5,在 app.products 数组里找到 "compileSdkVersion" 字段(如 "6.1.1(24)"),修改后点击 Sync Now 即可。
  • 旧版项目(API 4–7):在模块的 build.gradle 文件中,于 android { } 块内通过 compileSdkVersion 7 进行配置。
  • 图形化界面:创建新项目时,在向导中可直接选择 Compile SDK;已打开项目可通过 File → Settings → SDKs → HarmonyOS 查看已安装的 SDK 版本。
  • 注意事项:从 DevEco NEXT Beta1 起可不显式配置,默认使用 IDE 内置 SDK;若手动指定,必须与当前 IDE 自带的 SDK 版本一致,不可随意填写。
回到顶部