【一起来学习鸿蒙开发】Stage模型应用程序包结构

如果你也对鸿蒙开发感兴趣,欢迎跟着我一起学习鸿蒙开发! 即日起至12月31日,加入班级并成功考取【HarmonyOS开发者基础/高级证书】+发布一篇技术文章,即可解锁“通关成就”,有机会赢取官方限定礼品! 礼品数量有限,手速要快!点击加入,让你的努力闪闪发光!✨

为了让开发者能对应用程序包在不同阶段的形态有更加清晰的认知,分别对开发态、编译态、发布态的应用程序结构展开介绍。

开发态包结构

在DevEco Studio上创建项目工程,并尝试创建多个不同类型的Module。根据实际工程中的目录对照本章节进行学习,可以有助于理解开发态的应用程序结构。

图1 项目工程结构示意图(以实际为准)

说明

  • AppScope目录由DevEco Studio自动生成,该目录名称更改会导致当前目录下配置文件和资源加载不到,导致编译报错问题,因此该目录名称请勿修改。
  • Module目录名称可以由DevEco Studio自动生成(比如entry、library等),也可以自定义。为了便于说明,下表中统一采用ModuleName表示。

工程结构主要包含的文件类型及用途如下:

文件类型说明
配置文件

包括应用级配置信息、以及Module级配置信息:

AppScope > app.json5app.json5配置文件,用于声明应用的全局配置信息,比如应用Bundle名称、应用名称、应用图标、应用版本号等。

ModuleName > src > main > module.json5module.json5配置文件,用于声明Module基本信息、支持的设备类型、所含的组件信息、运行所需申请的权限等。

ArkTS源码文件ModuleName > src > main > ets:用于存放Module的ArkTS源码文件(.ets文件)。
资源文件

包括应用级资源文件、以及Module级资源文件,支持图形、多媒体、字符串、布局文件等,详见资源分类与访问

AppScope > resources :用于存放应用需要用到的资源文件。

ModuleName > src > main > resources :用于存放该Module需要用到的资源文件。

其他配置文件

用于编译构建,包括构建配置文件、编译构建任务脚本、混淆规则文件、依赖的共享包信息等。

build-profile.json5工程级Module级的构建配置文件,包括应用签名、产品配置等。

hvigorfile.ts:工程级或Module级的编译构建任务脚本,开发者可以自定义编译构建工具版本、控制构建行为的配置参数。

obfuscation-rules.txt:混淆规则文件。混淆开启后,在使用Release模式进行编译时,会对代码进行编译、混淆及压缩处理,保护代码资产。

oh-package.json5:用于存放依赖库的信息,包括所依赖的三方库和共享包。

编译态包结构

不同类型的Module编译后会生成对应的HAP、HAR、HSP等文件,开发态视图与编译态视图的对照关系如下:

图2 开发态与编译态的工程结构视图

从开发态到编译态,Module文件变更如下:

  • ets目录:ArkTS源码编译生成.abc文件。
  • resources目录:AppScope目录下的资源文件会合入到Module下面资源目录中,如果两个目录下存在重名文件,编译打包后只会保留AppScope目录下的资源文件。
  • module配置文件:AppScope目录下的app.json5文件字段会合入到Module下面的module.json5文件之中,编译后生成HAP或HSP最终的module.json文件。

说明

在编译HAP和HSP时,会把它们所依赖的HAR直接编译到HAP和HSP中。

发布态包结构

每个应用中至少包含一个.hap文件,可能包含若干个.hsp文件、也可能不含,一个应用中的所有.hap与.hsp文件合在一起称为Bundle,其对应的bundleName是应用的唯一标识(详见app.json5配置文件中的bundleName标签)。

当应用发布上架到应用市场时,需要将Bundle打包为一个.app后缀的文件用于上架,这个.app文件称为App Pack(Application Package),与此同时,DevEco Studio工具自动会生成一个pack.info文件。pack.info文件描述了App Pack中每个HAP和HSP的属性,包含APP中的bundleName和versionCode信息、以及Module中的name、type和abilities等信息。

说明

  • App Pack是发布上架到应用市场的基本单元,但是不能在设备上直接安装和运行。
  • 应用签名、云端分发、端侧安装时,都是以HAP/HSP为单位进行签名、分发和安装的。

图3 编译发布与上架部署流程图

文章来源:华为开发者联盟

<think>嗯,用户想要用鸿蒙的ArkTSStage模型开发一个记账助手App。首先,我得回忆一下ArkTS的基本结构Stage模型的特点。Stage模型鸿蒙推荐的应用模型,强调Ability的划分和模块化开发。ArkTS是基于TypeScript的,所以语法上应该类似,但可能有一些鸿蒙特有的组件和API。首先,记账助手App需要的主要功能可能包括:记录收支、分类管理、数据统计、历史记录查看等。我需要考虑如何用ArkTS的UI组件来构建界面。比如,主页面可能有底部导航,分几个模块,比如首页、记账、统计、我的等。然后,数据存储方面,鸿蒙提供了关系型数据库、首选项等。记账数据需要持久化,所以可能需要用关系型数据库来存储每一笔账单,包括金额、类型、分类、时间等字段。需要设计数据库表结构,并实现增删改查的操作。UI部分,首页可能需要展示最近的账单列表,使用List组件。记账页面需要表单输入,包括金额、分类选择、时间选择器等。统计页面可能需要图表展示,比如饼图显示各类别的支出占比,可以用鸿蒙的图表组件或者自定义绘制。状态管理方面,ArkTS可以使用AppStorage或者LocalStorage来管理全局状态,比如用户选择的月份、分类筛选条件等。需要确保不同页面之间数据同步。另外,权限申请也是必要的,比如访问存储权限,如果涉及到备份功能的话。不过记账应用可能不需要太多权限,但需要确认。接下来,代码结构方面,Stage模型通常有EntryAbility、页面组件、自定义组件等。每个页面对应一个ArkTS文件,使用@Entry装饰器标记入口组件。需要合理组织代码结构,比如将数据库操作封装成模块,UI组件拆分复用。 可能遇到的问题包括:鸿蒙组件的使用不熟悉,比如如何实现日期选择器,如何绑定数据到UI组件,以及如何处理用户输入事件。需要查阅鸿蒙的官方文档,确认相关组件的用法。 测试方面,需要在鸿蒙的模拟器或真机上运行,查看UI交互是否流畅,数据是否正确存储和显示。现在,根据这些思考,给出一个简单的示例代码,比如主页面和记账页面的UI结构,以及数据库的操作。然后解释代码的结构和功能,确保用户能够理解如何扩展其他功能。</think>基于鸿蒙ArkTS Stage模型的记账助手App开发方案如下: (一)数据模型设计 ```typescript // model/Bill.ets export class Bill { id?: number; // 账单ID amount: number = 0; // 金额 type: number = 0; // 类型 0-支出 1-收入 category: string = ''; // 分类 time: number = 0; // 时间戳 remark: string = ''; // 备注 } ``` (二)数据库操作 ```typescript // database/BillDao.ets import relationalStore from '@ohos.data.relationalStore'; import { Bill } from '../model/Bill'; const STORE_CONFIG = { name: 'Bill.db', securityLevel: relationalStore.SecurityLevel.S1 }; const SQL_CREATE_TABLE = ` CREATE TABLE IF NOT EXISTS bill ( id INTEGER PRIMARY KEY AUTOINCREMENT, amount REAL NOT NULL, type INTEGER NOT NULL, category TEXT NOT NULL, time INTEGER NOT NULL, remark TEXT )`; export class BillDao { private rdbStore: relationalStore.RdbStore | null = null; async initRdbStore() { this.rdbStore = await relationalStore.getRdbStore(globalThis.context, STORE_CONFIG); await this.rdbStore.executeSql(SQL_CREATE_TABLE); } async insertBill(bill: Bill): Promise<number> { const valueBucket = { 'amount': bill.amount, 'type': bill.type, 'category': bill.category, 'time': bill.time, 'remark': bill.remark }; return await this.rdbStore.insert('bill', valueBucket); } async queryBills(startTime: number, endTime: number): Promise<Bill[]> { const predicates = new relationalStore.RdbPredicates('bill'); predicates.between('time', startTime, endTime); const result = await this.rdbStore.query(predicates, ['id', 'amount', 'type', 'category', 'time', 'remark']); return result.allObjects() as Bill[]; } } ``` (三)UI界面示例 ```typescript // pages/AddBillPage.ets @Entry @Component struct AddBillPage { @State bill: Bill = new Bill(); build() { Column() { TextInput({ placeholder: '金额' }) .onChange((value: string) => { this.bill.amount = parseFloat(value) }) Picker({ range: ['餐饮', '交通', '购物', '工资'] }) .onChange((index: number) => { this.bill.category = ['餐饮', '交通', '购物', '工资'][index] }) DatePicker({ selected: new Date() }) .onChange((date: Date) => { this.bill.time = date.getTime() }) Button('保存账单') .onClick(async () => { await new BillDao().insertBill(this.bill) router.back() }) } } } ``` (四)主界面设计 ```typescript // pages/MainPage.ets @Entry @Component struct MainPage { @State bills: Bill[] = [] build() { Column() { TabContent() { // 统计页 TabContentItem() { PieChart({ values: this.getCategoryStats() }) } // 账单列表页 TabContentItem() { List({ space: 10 }) { ForEach(this.bills, (bill: Bill) => { ListItem() { BillItem({ bill: bill }) } }) } } } } .onPageShow(() => { this.loadBills() }) } private async loadBills() { const dao = new BillDao() await dao.initRdbStore() this.bills = await dao.queryBills( new Date().setHours(0, 0, 0, 0), new Date().setHours(23, 59, 59, 999) ) } } ``` 代码说明: 1. 数据层使用关系型数据库存储账单记录 2. UI层采用声明式开发范式,通过@State实现数据驱动视图更新 3. 使用TabContent实现多页面切换 4. 通过PieChart组件实现数据可视化 5. 遵循Stage模型的生命周期管理
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值