总结鸿蒙应用程序包

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

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}"ficd ${NODE_HOME}wget --no-check-certificate -q "${node下载路径}" -O node-linux.tar.xz #下载node，需要替换node下载路径tar -vxf node-linux.tar.xzNODE_DIR=xxx #node压缩包文件里面的目录cd ${NODE_DIR}mv -f ./* .[^.]* ../cd ..rm -rf NODE_DIR node-linux.tar.xzexport NODE_HOME=${NODE_HOME}export PATH=$NODE_HOME/bin:$PATHnode -vnpm config set registry=https://repo.huaweicloud.com/repository/npm/npm config set @ohos:registry=https://repo.harmonyos.com/npm/npm config get @ohos:registrynpm 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}"ficd ${JAVA_HOME}wget --no-check-certificate -q "${jdk下载路径}" -O jdk-linux.tar.xz #下载jdk，需要替换jdk下载路径tar -vxf jdk-linux.tar.xzJDK_DIR=xxx #jdk压缩包文件里面的目录cd ${JDK_DIR}mv -f ./* .[^.]* ../cd ..rm -rf JDK_DIR jdk-linux.tar.xzexport JAVA_HOME=${JAVA_HOME}export PATH=$JAVA_HOME/bin:$PATHjava -version
    }
    ​#配置SDK（已获取离线SDK并解压完成）
    function init_SDK() {export HDC_HOME=/opt/HarmonyOS/SDK/openharmony/10/toolchains #设置hdc工具的环境变量，hdc工具在toolchains所在路径下，请以实际路径为准export PATH=$HDC_HOME:$PATHexport 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() {# 初始化ohpmOHPM_HOME=${COMMANDLINE_TOOL_DIR}/command-line-tools/ohpmexport PATH=${OHPM_HOME}/bin:$PATHohpm -v# 配置ohpm仓库地址ohpm config set registry=https://ohpm.openharmony.cn/ohpm/
    }
    ​
    # 初始化相关路径
    PROJECT_PATH=xxx  # 工程目录
    # 进入package目录安装依赖
    function ohpm_install {cd $1ohpm install
    }
    # 环境适配
    function buildHAP() {# 根据业务情况适配local.propertiescd ${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<18npm 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_Nodeinit_JDKinit_SDKinit_ohpmbuildHAPinstall_hapupload_harlocal endTime=$(date '+%s')local elapsedTime=$(expr $endTime - $startTime)echo "build success in ${elapsedTime}s..."
    }
    

• 参考链接: 文档中心