引言
面向即将出现的广阔市场,小编也开始了鸿蒙纯血NEXT
版本的应用开发。
本篇主要整理总结实战项目中遇到的问题及重点知识内容。适合使用ArkTS进行鸿蒙NEXT及以上版本开发的初学者、进阶学习者。
内容分为以下几个维度,欢迎大家一起交流学习。
ArkTS 语言
使用ArkTs语言进行开发,了解如下两点即可
1. 数据类型
ArkTS支持的数据类型如下:
Object、string、number、boolean、enum 、Array、union、void、aliases、Record、Map 等。
下面列举一些个例的特性:
// string
undefined == name?:string
// Array
let name: string[] = ['rex','bob']
// union | 联合类型
type Animal = Cat | Dog
let animal : Animal = new Cat()
animal = new Dog()
// aliases | 匿名类型
type Predicate <T> = (x: T) => Boolean;
type NullableObject = Object | null;
// Record<K,V> | Record 与 Map 的区别是 Record 不需要 new,Map 需要 new
let map: Record<string, number> = {
'John': 25,
'Mary': 21,
}
2. 语法特点
ArkTS的语法与其他前端语言大同小异,下面列举一些个例的特性:
// Rest参数
fun sum(...numbers: number[])
sum()
sum(1,2,3)
// 定义回调
type trigFunc = (x:number) => number
function do_action(f: trigFunc)
// 闭包
function f(): () => number {
let count = 0;
return (): number => { count++; return count; }
}
let z = f();
z(); // 返回:1
z(); // 返回:2
// 可选参数
function hello(name?: string) // name == undefined
function multiply(n: number, coeff: number = 2)
nultiply(1)
// 字段不复值时默认值是 undefined
// 构造函数需要使用关键字
constructor(n: string, a: number)
// 模块导出
export let Origin = new Point(0, 0);
export function Distance(p1: Point, p2: Point): number{ *** }
// 模块导入
import * as Utils from './utils' // Utils.X
import { X, Y } from './utils'
X // 表示来自utils的X
Y // 表示来自utils的Y
// 声明
readonly height : number = 1 //只读
let hi: string = 'hello' //变量
const hello: string = 'hello' //常量
// 空安全
let x: number | null = null
// 接口 interface
interface W {
bundleName: string
action: string
entities: string[]
}
let wantInfo: W = {
bundleName: 'com.huawei.hmos.browser',
action: 'ohos.want.action.viewData',
entities: ['entity.system.browsable']
}
PS:需要注意的是,字符串里插入变量要使用`符号而不是单引号或双引号,如下:
Text(`插入变量到字符串中的值为${this.number}`)
HarmonyOS 的项目结构
关于 HarmonyOS 的项目包结构,我们暂时不需要做到全盘掌握,了解如下几个知识点即可:
1. 项目类型
创建项目分为两种类型,分别是 app(应用)、atomicService(元服务)
这两种类型的项目创建后的包结构是一样的,代码编辑也一致。重点差异如下:
- 元服务类似于微信小程序,用户可直接在手机的负一层页面搜索使用,无需下载
- 元服务的开发api是应用的开发api的子集,即有些api在开发应用时可用,在开发元服务时不可用。
2. 模块类型
创建模块分为三种类型,分别是 hap、har、hsp
- HAP:应用安装和运行的基本单元,分为两种类型:entry和feature
- HAR:静态共享包 (可以理解为封装的 Library,里面可以存放代码和资源,提供给 hap 或者 har 模块进行引用)
- HSP:动态共享包(一般应用不常用)
3. 重点文件
- app.json5 :bundleType 标识 元服务(atomicService)或 应用(app)
- module.json5 :stage模型模块配置文件,type 标识模块类型(entry、hap、har、share)
- oh-package.json5 :配置三方包声明文件的入口及包名
最后展示一张项目的包结构截图:
UI 开发中的实用技巧
1. 单位
- fp: 字体像素单位,随系统字体大小设置变化
- vp: 密度像素单位
//使用示例
Text('示例').fontSize('16fp').widht('100vp')
2. @Extend
定义扩展组件样式
@Extend(Column)
function ColumnStyle() {
.width('100%')
.borderRadius(24)
.backgroundColor(Color.White)
.padding({ left: 12, right: 12, bottom: 4, top: 4 })
}
Column(){}.ColumnStyle()
3. @Styles
定义组件重用样式
@Styles fancy() {
.width(200)
.height(this.heightValue)
.backgroundColor(Color.Yellow)
.onClick(() => {
this.heightValue = 200
})
}
Text().fancy()
4. 自定义组件 @Builder 和 @BuilderParam
@Component
struct Child {
@Builder FunABuilder0() {}
@BuilderParam aBuilder0: () => void = this.FunABuilder0;
build() {
Column() {
this.aBuilder0()
}
}
}
@Entry
@Component
struct Parent {
@Builder componentBuilder() {
Text(`Parent builder `)
}
build() {
Column() {
Child({ aBuilder0: this.componentBuilder })
}
}
}
5. 生命周期
- 自定义组件:@Component装饰的UI单元,可以调用组件的生命周期。
- 页面:可以由一个或者多个自定义组件组成,只有被@Entry装饰的组件才可以调用页面的生命周期。
- onPageShow:页面每次显示时触发一次,包括路由过程、应用进入前台等场景,仅@Entry装饰的自定义组件生效。
- onPageHide:页面每次隐藏时触发一次,包括路由过程、应用进入后台等场景,仅@Entry装饰的自定义组件生效。
- onBackPress:当用户点击返回按钮时触发,仅@Entry装饰的自定义组件生效。
- aboutToAppear:组件即将出现时回调该接口,具体时机为在创建自定义组件的新实例后,在执行其build()函数之前执行。
- aboutToDisappear:aboutToDisappear函数在自定义组件析构销毁之前执行。不允许在aboutToDisappear函数中改变状态变量,特别是@Link变量的修改可能会导致应用程序行为不稳定。
HarmoneyOS 的状态管理
1. 组件的状态管理
建议看一遍官网的示例
2. 应用的状态管理
PS:重点提一下 LocalStorage 和 AppStorage 的区别,LocalStorage 是页面级存储、页面内共享,而 AppStorage 是可以跨 Ability 共享的。(即适用于多hap项目)
应用开发中常用方法
1. Toast 的使用
promptAction.showToast({
message: $r('app.string.success_message'),
duration: 2000
})
2. Preferences 的使用
import dataPreferences from '@ohos.data.preferences';
//声明
let dataPreferencesManager: dataPreferences.Preferences = {} as dataPreferences.Preferences;
//获取实例
let options: dataPreferences.Options = { name: 'myStore', dataGroupId:'myId' };
dataPreferences.getPreferences(this.context, options, (err: BusinessError, val: dataPreferences.Preferences) => {
if (err) {
return;
}
preferences = val;
})
//put
dataPreferencesManager.push(key,value)
dataPreferencesManager.flush()
3. Context
/// 实现全局Context
// 在 EntryAbility 的 create 方法中绑定上下文
AppStorage.setOrCreate('context', this.context);
//获取全局Context
AppStorage.get('context')
/// UI页面获取局部Context
const CONTEXT: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
4. JSON 与 Object 的转换
/// JSON to Object
/// 方案一:
class A {
v: number = 0
s: string = ''
fromJson (str: string) {
let tmpStr: Record<string, Object> = JSON.parse(str);
if (tmpStr.add != undefined) {
this.v = tmpStr.v as number;
this.s = tmpStr.s as string;
}
}
}
/// 方案二:
let json: string = '{"name":"rex","age":"10"}'
class Student {
name: string;
age: number;
constructor(name: string, age: number) {
this.name = name;
this.age = age;
}
}
let student = JSON.parse(json) as Student;
/// Object to Json(String)
JSON.stringify(any)
5. Http 的使用
使用官方提供的HTTP模块:
// 引入包名
import http from '@ohos.net.http';
import { BusinessError } from '@ohos.base';
// 每一个httpRequest对应一个HTTP请求任务,不可复用
let httpRequest = http.createHttp();
// 用于订阅HTTP响应头,此接口会比request请求先返回。可以根据业务需要订阅此消息
// 从API 8开始,使用on('headersReceive', Callback)替代on('headerReceive', AsyncCallback)。 8+
httpRequest.on('headersReceive', (header) => {
console.info('header: ' + JSON.stringify(header));
});
httpRequest.request(
// 填写HTTP请求的URL地址,可以带参数也可以不带参数。URL地址需要开发者自定义。请求的参数可以在extraData中指定
"EXAMPLE_URL",
{
method: http.RequestMethod.POST, // 可选,默认为http.RequestMethod.GET
// 开发者根据自身业务需要添加header字段
header: [{
'Content-Type': 'application/json'
}],
// 当使用POST请求时此字段用于传递内容
extraData: "data to send",
expectDataType: http.HttpDataType.STRING, // 可选,指定返回数据的类型
usingCache: true, // 可选,默认为true
priority: 1, // 可选,默认为1
connectTimeout: 60000, // 可选,默认为60000ms
readTimeout: 60000, // 可选,默认为60000ms
usingProtocol: http.HttpProtocol.HTTP1_1, // 可选,协议类型默认值由系统自动指定
usingProxy: false, //可选,默认不使用网络代理,自API 10开始支持该属性
}, (err: BusinessError, data: http.HttpResponse) => {
if (!err) {
// data.result为HTTP响应内容,可根据业务需要进行解析
console.info('Result:' + JSON.stringify(data.result));
console.info('code:' + JSON.stringify(data.responseCode));
// data.header为HTTP响应头,可根据业务需要进行解析
console.info('header:' + JSON.stringify(data.header));
console.info('cookies:' + JSON.stringify(data.cookies)); // 8+
// 当该请求使用完毕时,调用destroy方法主动销毁
httpRequest.destroy();
} else {
console.error('error:' + JSON.stringify(err));
// 取消订阅HTTP响应头事件
httpRequest.off('headersReceive');
// 当该请求使用完毕时,调用destroy方法主动销毁
httpRequest.destroy();
}
}
);
PS:后期小编会封装一个简化代码的静态库提供使用
6. 路由的选择与使用
路由提供两种选择方案:
组件 | 适用场景 | 特点 | 转场动画效果对比 |
---|---|---|---|
Router | 模块间与模块内页面切换 | 通过每个页面的url实现模块间解耦 | 页面平推转场效果 |
NavPathStack | 模块内页面切换 | 通过组件级路由统一路由管理 | 向右折叠转场效果 |
- Router的使用
router.pushUrl({
url: 'pages/routerpage2',
params: new routerParams('message' ,[123,456,789])
})
/// url 对应 resource - profile - mainpages.json
- NavPathStack的使用
小编使用的方案是 NavPathStack ,下面来重点说说使用方式。
NavPathStack
是配合 Navigation
一起使用的,
Navigation导航组件做统一的页面跳转管理,它提供了一系列属性方法来设置页面的标题栏、工具栏以及菜单栏的各种展示样式。
//第一步,需要在应用的根页面自行维护 navStack 实例,并传递给根节点 Navigation
@Provide('pageInfos') pageInfos: NavPathStack = new NavPathStack()
Navigation(this.pageInfos) {
Column() {}
}
.title('NavIndex')
.navDestination(this.PageMap)
// 统一管理维护路由跳转
@Builder
PageMap(name: string) {
if (name === 'pageOne') {
PageOneTmp()
} else if (name === 'pageTwo') {
pageTwoTmp({ names: name, values: this.pageInfos } as Pages)
}
}
// 第二步,注意,目标跳转页面节点需要使用 NavDestination 进行包裹
// 目标跳转页面,例如 PageOneTmp
@Component
export struct PageOneTmp {
build(){
NavDestination(){
Column(){
}
}
}
}
/// 如何跳转
// 方式一
this.pageInfos.pushPathByName('pageOne', null)
//方式二
//待跳转的页面需要在根节点使用 NavDestination(){}.title('pageOne'),方式一可以不设置title
this.pageInfos.pushPathByName('pageOne', null)
附注
Demo示例(基于API11开发,支持NEXT及以上版本运行)已上传可供参考,包含如下内容:
- 静态库+多模块设计
- 状态管理+统一路由管理
- 网络请求、Loading 等工具库封装
- 自定义组件
原文链接:https://juejin.cn/post/7344258231479369769 作者:李小轰_Rex