-

在进行 HarmonyOS 应用的编译构建前,需要对工程和编译构建的 Module 进行设置,请根据实际情况进行修改。

  • build.gradle:HarmonyOS 应用依赖 gradle 进行构建,需要通过 build.gradle 来对工程编译构建参数进行设置。build.gradle 分为工程级和模块级两种类型,其中工程根目录下的工程级 build.gradle 用于工程的全局设置,各模块下的 build.gradle 只对本模块生效。
  • config.json:应用清单文件,用于描述应用的全局配置信息、在具体设备上的配置信息和HAP的配置信息。

工程级 build.gradle

  • apply plugin:在工程级 Gradle 中引入打包 app 的插件,不需要修改。

  apply plugin: 'com.huawei.ohos.hap'

  • ohos 闭包:工程配置,包括如下配置项:

  • compileSdkVersion:依赖的 SDK 版本。

    compileSdkVersion 3    //应用编译构建的目标 SDK 版本
         defaultConfig {
             compatibleSdkVersion 3    //应用兼容的最低 SDK 版本
     }

  • buildscript 闭包:Gradle 脚本执行依赖,包括 Maven 仓地址和插件。

  buildscript {
      repositories {   
          maven {
              url 'https://mirrors.huaweicloud.com/repository/maven/'
          }
          maven {
              url 'https://developer.huawei.com/repo/'
          }      
          jcenter()
      }
         dependencies {
           classpath 'com.huawei.ohos:hap:2.0.0.6'
      }
  }

  • allprojects 闭包:工程自身所需要的依赖,比如引用第三方库的Maven仓库和依赖包。

  allprojects {
      repositories {
         maven {
              url 'https://mirrors.huaweicloud.com/repository/maven/'
         }
         maven {
              url 'https://developer.huawei.com/repo/'
         }      
         jcenter()
      }
  }

模块级 build.gradle

  • apply plugin:在模块级 Gradle 中引入打包 hap 和 library 的插件,无需修改。

  apply plugin: 'com.huawei.ohos.hap'   //打包hap包的插件
  apply plugin: 'com.huawei.ohos.library'    //将HarmonyOS Library打包为har的插件
  apply plugin: 'com.huawei.ohos.java-library'    //将Java Library打包为jar的插件

  • ohos闭包:模块配置,包括如下配置项:

  • compileSdkVersion:依赖的SDK版本。

    compileSdkVersion 3    //应用编译构建的目标 SDK 版本
         defaultConfig {
             compatibleSdkVersion 3    //应用兼容的最低SDK版本
     }

  • externalNativeBuild:C/C++ 编译构建代码设置项。

    externalNativeBuild {
        path "src/main/cpp/CMakeLists.txt"   //CMake配置入口,提供CMake构建脚本的相对路径
        arguments "-v"    //传递给CMake的可选编译参数
        abiFilters "arm64-v8a"     //用于设置本机的ABI编译环境
        cppFlags ""   //设置C++编译器的可选参数

  • entryModules:该 Feature 模块关联的 Entry 模块。

    entryModules "entry"    

  • mergeJsSrc:跨设备的应用编译构建,是否需要合并 JS 代码。Wearable 和 Lite Wearable 共用一个工程,如下图所示。当进行编译构建时,将 Wearable/Lite Wearable 目录下的 JS 文件与 pages 目录(Wearable 和 Lite Wearable 共用的源码)下的 JS 文件进行合并打包。

 

点击放大

    mergejssrc true    //合并JS代码打包时,请在ohos闭包下手动添加,true表示需要合并JS代码,false表示不需要合并JS代码。

  • annotationEnabled:支持数据库注释。

    compileOptions{ 
             annotationEnabled true   //true表示支持,false表示不支持

  • dependencies闭包:该模块所需的依赖项。

  dependencies {
      entryImplementation project(':entry')    //该Feature模块依赖的Entry模块
      implementation fileTree(dir: 'libs', include: ['*.jar','*.har'])    //该模块依赖的本地库,支持jar和har包
      testCompile'junit:junit:4.12'    //测试用例框架,无需修改
  }

config.json 清单文件

HarmonyOS 应用的每个模块下包含一个 config.json 清单文件,在编译构建前,需要对照检查和修改 config.json 文件,详情请参考 config.json 清单文件介绍