鸿蒙如何打包应用程序

总结鸿蒙应用程序包

之前文章详细讲解了关于三种程序包的内容，现在简单总结一下：

1. 总结

• 首先需要搞清楚鸿蒙项目的模块Module的分类: Module分为**"Ability"** 和**"Library"**两种类型

• HAP

  1. HAP: Harmony Ability Package , 叫做鸿蒙Ability包。

  2. "Ability"类型的Module编译后叫做HAP。

  3. 一个HAP , 它是由代码、资源、第三方库及应用/服务配置文件组成，HAP可以分为Entry和Feature两种类型。

  4. Entry是主模块 , Feature是动态特性模块。

• HAR

  1. HAR: Harmony Archive /ˈɑːkaɪv/, 叫做鸿蒙静态共享包。

  2. "Library"类型的Module编译后叫做HAR , 或者 HSP。

  3. 一个HAR , 它可以包含代码、C++库、资源和配置文件。

  4. HAR不同于HAP，不能独立安装运行在设备上，只能作为应用模块的依赖项被引用。

• HSP

  1. HSP: Harmony Shared Package , 叫做鸿蒙动态共享包。

  2. 一个HSP , 它可以包含代码、C++库、资源和配置文件。

  3. HSP依然不能独立运行 , 需要作为HAP的依赖项。

  4. HSP不同于HAR , 可以被多个HAP同时引用 , HSP旨在解决多个模块引用相同的HAR，导致APP包大小膨胀的问题。

2. 其它问题

2.1. 都是资源包，hsp和har有什么不一样？

解决多个多个hap引用相同的har包会出现多次重复拷贝，导致app包体积膨胀的问题，（har是安装包直接安装在进程里）。

2.2. 程序怎么打包

2.2.1. 使用编译器打包

一般应用直接使用DevEco进行打包即可: Build -> Hap(s),如图：

2.2.2. 单独编写脚本打包

• 如果此应用针对不同应用市场 , 有不同的调整 , 比如应用闪屏 , 那么就需要使用脚本打包

  • 具体介绍:

    • 除了使用DevEco Studio一键式构建应用/服务外，还可以使用命令行工具来调用Hvigor任务进行构建

    • 首选需要搭建构建环境 , 安装node.js , jdk , sdkmgr

    • 配置sdk环境变量

    • 最终编写打包脚本: ./hvigorw clean assembleApp --no-daemon

• • 以上所有的步骤 , 都可以通过脚本来处理

    #!/bin/bash
    set -ex
    ​
    NODE_HOME=xxx #指定Node.js的安装目录
    JAVA_HOME=xxx #指定JDK的安装目录
    COMMANDLINE_TOOL_DIR=xxx #命令行工具的安装目录
    HOS_SDK_HOME=xxx #HarmonyOS SDK根路径
    ​
    #下载并配置Node.js
    function init_Node() {
      if [ ! -d "${NODE_HOME}" ]; then 
         mkdir "${NODE_HOME}"
      fi
      cd ${NODE_HOME}
      wget --no-check-certificate -q "${node下载路径}" -O node-linux.tar.xz #下载node，需要替换node下载路径
      tar -vxf node-linux.tar.xz
      NODE_DIR=xxx #node压缩包文件里面的目录
      cd ${NODE_DIR}
      mv -f ./* .[^.]* ../
      cd ..
      rm -rf NODE_DIR node-linux.tar.xz
      export NODE_HOME=${NODE_HOME}
      export PATH=$NODE_HOME/bin:$PATH
      node -v
      npm config set registry=https://repo.huaweicloud.com/repository/npm/
      npm config set @ohos:registry=https://repo.harmonyos.com/npm/
      
      
      
      npm config get @ohos:registry
      npm config set proxy=http://user:password@proxy.server.com:port #配置npm http代理，企业网络受限的情况下需要配置
      npm config set https-proxy=http://user:password@proxy.server.com:port #配置npm https代理，企业网络受限的情况下需要配置
      npm info express
    }
    ​
    #下载并配置JDK
    function init_JDK() {
      if [ ! -d "${JAVA_HOME}" ]; then 
         mkdir "${JAVA_HOME}"
      fi
      cd ${JAVA_HOME}
      wget --no-check-certificate -q "${jdk下载路径}" -O jdk-linux.tar.xz #下载jdk，需要替换jdk下载路径
      tar -vxf jdk-linux.tar.xz
      JDK_DIR=xxx #jdk压缩包文件里面的目录
      cd ${JDK_DIR}
      mv -f ./* .[^.]* ../
      cd ..
      rm -rf JDK_DIR jdk-linux.tar.xz
      export JAVA_HOME=${JAVA_HOME}
      export PATH=$JAVA_HOME/bin:$PATH
      java -version
    }
    ​
     
    #配置SDK（已获取离线SDK并解压完成）
    function init_SDK() {
      export HDC_HOME=/opt/HarmonyOS/SDK/openharmony/10/toolchains #设置hdc工具的环境变量，hdc工具在toolchains所在路径下，请以实际路径为准
      export PATH=$HDC_HOME:$PATH
      export OHOS_NATIVE_HOME=/opt/HarmonyOS/SDK/openharmony/10/native #如果工程中涉及C/C++，才需要设置,指向Native SDK所在的目录
      export HOS_SDK_HOME=${HOS_SDK_HOME}
    }
    # 安装ohpm, 若镜像中已存在ohpm，则无需重新安装
    function init_ohpm() {
        # 初始化ohpm
        OHPM_HOME=${COMMANDLINE_TOOL_DIR}/command-line-tools/ohpm
        export PATH=${OHPM_HOME}/bin:$PATH
        ohpm -v
        # 配置ohpm仓库地址
        
        
        ohpm config set registry=https://ohpm.openharmony.cn/ohpm/
    }
    ​
    # 初始化相关路径
    PROJECT_PATH=xxx  # 工程目录
    # 进入package目录安装依赖
    function ohpm_install {
        cd $1
        ohpm install
    }
    # 环境适配
    function buildHAP() {
        # 根据业务情况适配local.properties
        cd ${PROJECT_PATH}
        echo "hwsdk.dir=${HOS_SDK_HOME}"  > ./local.properties
        # 根据业务情况安装ohpm三方库依赖
        ohpm_install "${PROJECT_PATH}"
        ohpm_install "${PROJECT_PATH}/entry"
        ohpm_install "${PROJECT_PATH}/xxx"
        # 如果构建过程报错 ERR_PNPM_OUTDATED_LOCKFILE，需要增加配置：lockfile=false, 根据node版本选择设置方式：
        # node.version<18
        npm config set lockfile=false # 如果执行此命令报错，建议直接在镜像的.npmrc文件中需要增加一行配置：lockfile=false
        # node.version>=18
        #cat ${HOME}/.npmrc | grep 'lockfile=false' || echo 'lockfile=false' >> ${HOME}/.npmrc
        # 根据业务情况，采用对应的构建命令，可以参考IDE构建日志中的命令
        cd ${PROJECT_PATH}
        chmod +x hvigorw
        ./hvigorw clean --no-daemon
        ./hvigorw assembleHap --mode module -p product=default -p debuggable=false --no-daemon # 流水线构建命令建议末尾加上--no-daemon
    }
    function install_hap() {
        hdc file send "${PROJECT_PATH}/entry/build/default/outputs/default/entry-default-signed.hap" "data/local/tmp/entry-default-signed.hap"
        hdc shell bm install -p "data/local/tmp/entry-default-signed.hap" 
        hdc shell rm -rf "data/local/tmp/entry-default-signed.hap"
        hdc shell aa start -a MainAbility -b com.example.myapplication -m entry
    }
    ​
    # 使用ohpm发布har
    function upload_har {
      ohpm publish pkg.har
    }
    ​
    function main {
      local startTime=$(date '+%s')
      init_Node
      init_JDK
      init_SDK
      init_ohpm
      buildHAP
      install_hap
      upload_har
      local endTime=$(date '+%s')
      local elapsedTime=$(expr $endTime - $startTime)
      echo "build success in ${elapsedTime}s..."
    }

• 参考链接: 文档中心