其他
写给Android开发者的HarmoneyOS入门指南
https://juejin.cn/user/4424090522225959/posts
以下内容都是基于已经搭建好 HarmonyOS 开发环境（DevEco Studio、HarmoneyOS SDK） DevEco Studio应用签名是和华为账号绑定的，所以开始前需要注册一个华为账号（首次运行失败会有提示） 运行 HarmoneyOS 项目需要一部鸿蒙系统的手机（目前仅Mate 50、60系列手机能正常使用，其它机型需要使用投屏工具进行操作，直接在手机上操作会卡死）
DevEco Studio
创建项目
项目结构
"app": {
"signingConfigs": [], // 签名配置
"compileSdkVersion": 9, // SDK 版本配置
"compatibleSdkVersion": 9, // SDK 版本配置
"products": [
{
"name": "default",
"signingConfig": "default",
}
]
},
"modules": [ // 模块配置
{
"name": "entry", // 模块名
"srcPath": "./entry", // 模块路径
"targets": [
{
"name": "default",
"applyToProducts": [
"default"
]
}
]
}
]
}
Demo/AppScope 存放全局资源及配置的路径； Demo/AppScope/resources 应用全局资源路径； Demo/AppScope/app.json5 应用配置，定义包名、版本、应用图标、名称等配置：
"app": {
"bundleName": "com.sample.demo", // 包名
"vendor": "example", // 供应商
"versionCode": 1000000, // 版本号
"versionName": "1.0.0", // 版本名
"icon": "$media:app_icon", // 应用图标，此处配置影响应用管理中显示
"label": "$string:app_name" // 应用名，此处配置影响应用管理中显示
}
}
"string": [
{
"name": "app_name",
"value": "Demo"
}
]
}
Demo/entry 应用主模块，应用入口，存放代码、资源的路径； Demo/entry/src/main/module.json5 模块配置文件，类似 Android 项目中的 AndroidManifest.xml：
"module": {
"name": "entry", // 当前module的名字，module打包成hap后，表示hap的名称，标签值采用字符串表示（最大长度31个字节），该名称在整个应用要唯一
"type": "entry", // 表示模块的类型，类型有三种，分别是entry、feature和har
"srcEntry": "./ets/DemoAbilityStage.ts", // 模块的入口文件路径，默认没有，需要手动创建，类似 Android 中的 Application
"description": "$string:module_desc", // 当前模块的描述信息
"mainElement": "EntryAbility", // 该标签标识hap的入口ability名称或者extension名称。只有配置为mainElement的ability或者extension才允许在服务中心露出
"deviceTypes": [ // 该标签标识hap可以运行在哪类设备上
"phone",
"tablet"
],
"deliveryWithInstall": true, // 该模块是否随应用一起安装
"installationFree": false, // 释放支持免安装
"pages": "$profile:main_pages", // ability 中使用的 page 信息配置
"abilities": [ // ability 配置列表，类似 Android 中的 Activity 列表
{
"name": "EntryAbility", // 逻辑名，整个应用要唯一
"srcEntry": "./ets/entryability/EntryAbility.ts", // 入口代码路径
"description": "$string:EntryAbility_desc", // 描述信息
"icon": "$media:icon", // 图标，如果为 MainElement，必填，此处配置影响应用列表显示及任务栈显示
"label": "$string:EntryAbility_label", // 标签名，此处配置影响应用列表显示及任务栈显示
"startWindowIcon": "$media:icon", // 启动页图标
"startWindowBackground": "$color:start_window_background", // 启动页背景颜色
"exported": true,
"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"action.system.home"
]
}
]
}
]
}
}
"string": [
{
"name": "EntryAbility_label",
"value": "Ability1"
}
]
}
{
"entities": [
"entity.system.home"
],
"actions": [
"action.system.home"
]
}
]
Demo/entry/src/main/ets 源码文件路径； Demo/entry/src/main/ets/entryability/EntryAbility.ts UI 组件，类似 Android 中的 Activity； Demo/entry/src/main/resources 资源文件路径；
生命周期
export default class DemoAbilityStage extends AbilityStage {
onCreate() {
// 应用启动回调
}
}
import hilog from '@ohos.hilog';
import window from '@ohos.window';
export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) {
// 组件创建
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
}
onDestroy() {
// 组件销毁
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onDestroy');
}
onWindowStageCreate(windowStage: window.WindowStage) {
// window 创建
// Main window is created, set main page for this ability
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
// 设置布局，显示 ets/pages/Index.ets 的布局
windowStage.loadContent('pages/Index', (err, data) => {
if (err.code) {
hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
return;
}
hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
});
}
onWindowStageDestroy() {
// window 销毁
// Main window is destroyed, release UI related resources
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
}
onForeground() {
// 进入前台
// Ability has brought to foreground
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onForeground');
}
onBackground() {
// 进入后台
// Ability has back to background
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onBackground');
}
}
windowStage.on('windowStageEvent', (event) => {
// event 取值为枚举类型 window.WindowStageEventType
if(event === window.WindowStageEventType.ACTIVE) {
// 获取焦点
} else {
// 失去焦点
}
})
}
布局
@Component // 声明这是一个UI组件
struct Index {
@State message: string = 'Hello World'
build() {
// 声明布局
Row() { // 横向布局
Column() { // 竖向布局
Text(this.message) // 文本控件
.fontSize(50)
.fontWeight(FontWeight.Bold)
}
.width('100%') // 宽度铺满
}
.height('100%') // 高度铺满
}
}
界面跳转
Pages 跳转
@Entry
@Component
struct Second {
@State message: string = 'Second Page'
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
// 添加按钮
Button("点击返回")
.onClick(() => {
// 按钮点击通过 router 返回上一级
router.back()
})
}
.width('100%')
}
.height('100%')
}
}
"src": [
"pages/Index",
"pages/Second"
]
}
@Entry
@Component
struct Index {
@State message: string = 'Hello World'
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
// 添加按钮
Button("点击跳转")
.onClick(() => {
// 按钮点击通过 router 跳转到 pages/Second
router.pushUrl({
url: "pages/Second"
})
})
}
.width('100%')
}
.height('100%')
}
}
UIAbility 跳转
虽然 HarmonyOS 官方提供的模板里面都只有一个 UIAbility，但是它还是支持多 UIAbility 的； 同样的在 ets 路径下参照 EntryAbility.ts 创建一个新的 SecondEntryAbility.ts，在 onWindowStageCreate 中加载布局 pages/SecondAblity，在 module.json5 中添加对应的配置即可，这里还是推荐使用 New -> Ability 进行创建；
@Preview
@Entry
@Component
struct SecondAbility {
@State message: string = 'Second Ability'
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
Button("点击返回")
.margin({ top: 30 })
.onClick(() => {
// 按钮点击关闭当前 UIAbility
let context = getContext(this) as unknown as common.UIAbilityContext
context.terminateSelf()
})
}
.width('100%')
}
.height('100%')
}
}
import Want from '@ohos.app.ability.Want'
@Entry
@Component
struct Index {
@State message: string = 'Hello World'
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
Button("点击跳转")
.onClick(() => {
// 按钮点击跳转到 SecondEntryAbility
let context = getContext(this) as unknown as common.UIAbilityContext
let want: Want = {
deviceId: "",
bundleName: "com.sample.demo",
abilityName: "SecondEntryAbility",
}
context.startAbility(want)
})
// 添加按钮
Button("点击跳转Ability")
.onClick(() => {
// 按钮点击跳转到 SecondEntryAbility
let context = getContext(this) as unknown as common.UIAbilityContext
let want: Want = {
deviceId: "",
bundleName: "com.sample.demo",
abilityName: "SecondEntryAbility",
}
context.startAbility(want)
})
}
.width('100%')
}
.height('100%')
}
}