鸿蒙-项目创建及了解

R_ine

已于 2024-03-18 16:32:11 修改

阅读量599

点赞数 4

分类专栏：鸿蒙开发文章标签：鸿蒙华为

于 2024-03-18 15:16:37 首次发布

本文链接：https://blog.csdn.net/R_ine/article/details/136804690

版权

鸿蒙开发专栏收录该内容

3 篇文章 0 订阅

订阅专栏

项目创建

File->new->create Project

1.App普通项目创建

第一个为空白模版。选中可以看到对应的创建能力模版

2.元服务创建

元服务可以理解为卡片式的服务模式。类似下图。

项目结构

这里主要讲的是应用的项目结构.

从上到下。

.hvigor

存储构建配置文件信息。

.idea

存储项目的配置信息。

AppScope

翻译过来是【应用程序范围】。它是存放了全局的资源文件及配置信息
resources为资源文件。app.json5为全局配置信息

{
  "app": {
    "bundleName": "com.application.myapplication",// 标识应用的Bundle名称，用于标识应用的唯一性。
    "bundleType": "app",// 标识应用的Bundle类型，用于区分应用或者原子化服务。如app或者atomicService
    "vendor": "example",//应用开发厂商的描述
    "versionCode": 1000000,//应用的版本号
    "versionName": "1.0.0",//应用版本号的文字描述，用于向用户展示。
    "icon": "$media:app_icon",//应用的图标
    "label": "$string:app_name",//应用的名称
    "description": "$string:description_application",//应用的描述信息
    "minAPIVersion": 9,//应用运行需要的SDK的API最小版本。
    "targetAPIVersion": 9,//应用运行需要的API目标版本。
    "apiReleaseType": "Release",//应用运行需要的API目标版本的类型,(可不填，系统自动填入)Canary：受限发布的版本。  Beta：公开发布的Beta版本。  Release：公开发布的正式版本。
    "debug": false,//标识应用是否可调试，true：可调试。 false：不可调试。
    "car": {  //tablet、tv、wearable、car、phone可以对不对设备单独设置参数，如不设置则默认用公共的
      "minAPIVersion": 8,
    }
  },
}

app.json5

entry

应用模块

EntryAbility.ts

承载Ability生命周期。也是指定了第一个打开的界面

pages

页面

resources

当前应用模块的资源信息

module.json5

{
  "module": {
    "name": "entry",   //当前Module的名称
    "type": "entry",   //标识当前Module的类型。类型有两种，分别： entry：应用的主模块。 feature：应用的动态特性模块。
    "description": "$string:module_desc",  //前Module的描述信息
    "mainElement": "EntryAbility",  //当前Module的入口
    "deviceTypes": [
      //标识当前Module可以运行在哪类设备上
      "phone",
      "tablet"
    ],
    "deliveryWithInstall": true,  //当前Module是否在用户主动安装的时候安装，表示该Module对应的HAP是否跟随应用一起安装。 true：主动安装时安装。 false：主动安装时不安装
    "installationFree": false,  //当前Module是否支持免安装特性。 true：表示支持免安装特性，且符合免安装约束。 false：表示不支持免安装特性。
    "pages": "$profile:main_pages",  //当前Module的profile资源，用于列举每个页面信息。
    "virtualMachine": "ark",   //当前Module运行的目标虚拟机类型，供云端分发使用
    "metadata": [
      //（待确认，暂不了解）当前Module的自定义元信息，标签值为数组类型，只对当前Module、UIAbility、ExtensionAbility生效。
      {
        "name": "string",
        "value": "string",
        "resource": ""
      }
    ],
    "abilities": [
      //当前Module中UIAbility的配置信息,只对当前UIAbility生效。
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ts",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [//标识UIAbility组件或者ExtensionAbility组件能够接收的Want的特征。简而言之就是消息传递用的
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "ohos.want.action.home"
            ]
          }
        ]
      }
    ],
    "extensionAbilities": [//当前Module中ExtensionAbility的配置信息，标签值为数组类型，只对当前ExtensionAbility生效。
    ],
    "requestPermissions": [//当前应用运行时需向系统申请的权限集合。
      {
        "name": "ohos.abilitydemo.permission.PROVIDER",
        "reason": "$string:reason",
        "usedScene": {
          "abilities": [
            "FormAbility"
          ],
          "when": "inuse"
        }
      }
    ]
  }
}

当前模块的配置资源

ohosTest

测试用例

hvigorfile.ts

模块级编译构建任务脚本

build-profile.json5

{
  "apiType": 'faMode',  //API类型，支持FA和Stage模型
  "showInServiceCenter": true,  //是否在服务中心展示
  "buildOption": {
    //配置筛选har依赖.so资源文件的过滤规则
    "napiLibFilterOption": {
      //按照.so文件的优先级顺序，打包最高优先级的.so文件
      "pickFirsts": [
        "**/1.so"
      ],
      //按照.so文件的优先级顺序，打包最低优先级的.so 文件
      "pickLasts": [
        "**/2.so"
      ],
      //排除的.so文件
      "excludes": [
        "**/3.so"
      ],
      //允许当.so重名冲突时，使用高优先级的.so文件覆盖低优先级的.so文件
      "enableOverride": true
    },
    //cpp相关编译配置
    "externalNativeOptions": {
      "path": "./src/main/cpp/CMakeLists.txt",  //CMake配置文件，提供CMake构建脚本
      "arguments": "",  //传递给CMake的可选编译参数
      "abiFilters": [  //用于设置本机的ABI编译环境
        "armeabi-v7a",
        "arm64-v8a"
      ],
      "cppFlags": ""  //设置C++编译器的可选参数
    },
  },
  "targets": [  //定义的Target，开发者可以定制不同的Target，具体请参考定制多目标构建产物
    {
      "name": "default",
      "runtimeOS": "HarmonyOS",
    },
    {
      "name": "ohosTest",
    }    
  ]
}

当前的模块信息、编译信息配置项

oh_modules

用于存放三方库依赖信息。关于原npm工程适配ohpm操作

build-profile.json5

{
  "app": { 
    //工程的签名信息，可包含多个签名信息
    "signingConfigs": [  
      {
        "name": "default",  //标识签名方案的名称
        "type": "HarmonyOS",  //标识HarmonyOS应用
        //该方案的签名材料
        "material": {  
          "certpath": "D:\\SigningConfig\\debug_hos.cer",  //调试或发布证书文件，格式为.cer
          "storePassword": "******",  //密钥库密码，以密文形式呈现
          "keyAlias": "debugKey",  //密钥别名信息
          "keyPassword": "******",  //密钥密码，以密文形式呈现
          "profile": "D:\\SigningConfig\\debug_hos.p7b",  //调试或发布证书Profile文件，格式为.p7b
          "signAlg": "SHA256withECDSA",  //密钥库signAlg参数
          "storeFile": "D:\\SigningConfig\\debug_hos.p12"  //密钥库文件，格式为.p12
        }
      }
    ],
    "compileSdkVersion": 9,  //指定HarmonyOS应用/服务编译时的SDK版本
    "compatibleSdkVersion": 9,  //指定HarmonyOS应用/服务兼容的最低SDK版本
    //定义构建的产品品类，如通用默认版、付费版、免费版等
    "products": [  
      {
        "name": "default",  //定义产品的名称，支持定制多product目标产物，具体请参考定制多目标构建产物
        "signingConfig": "default",  //指定当前产品品类对应的签名信息，签名信息需要在signingConfigs中进行定义
      }
    ]
  },
  "modules": [
    {
      "name": "entry",  //模块名称
      "srcPath": "./entry",  //标明模块根目录相对工程根目录的相对路径
      "targets": [  //定义构建的APP产物，由product和各模块定义的targets共同定义
        {
          "name": "default",  //target名称，由各个模块的build-profile.json5中的targets字段定义
          "applyToProducts": [  
            "default"   //表示将该模块下的“default” Target打包到“default” Product中
          ]
        }
      ]
    }
  ]
}

应用级配置信息，包括签名、产品配置等。