本期我們給大家帶來的是“畫圖”應用開發者Rick的分享,希望能給你的HarmonyOS開發之旅帶來啟發~ ...
本期我們給大家帶來的是“畫圖”應用開發者Rick的分享,希望能給你的HarmonyOS開發之旅帶來啟發~
介紹
2021年的華為開發者大會(HDC2021)上,HarmonyOS 發佈了新一代的聲明式UI框架——方舟開發框架(ArkUI)。ArkUI框架引入了基於TS擴展的聲明式開發範式,讓開發變得更加簡潔、高效!
已經有很多開發者在使用eTS(extended TypeScript)語言,基於聲明式開發範式開發應用了。本期我們要介紹的就是eTS開發先行者Rick的分享——100行代碼實現“畫圖”應用,帶大家一起領略eTS語言的簡潔之美~
一、實現效果
100行代碼實現的“畫圖”應用是怎樣的?我們先來看看實現效果吧:
圖1 實現效果
“畫圖”應用除了實現必須的畫圖功能外,還能夠設置畫筆的顏色和大小,且提供了撤銷功能,可謂短小而精美了。你心動了嗎?是否也想試試?趕緊跟隨Rick的開發過程,也來嘗試一下吧!
二、開發過程
1. 安裝DevEco Studio
eTS開發需安裝DevEco Studio V3.0.0.601 Beta1或更高版本。
DevEco Studio下載地址:https://developer.harmonyos.com/cn/develop/deveco-studio/
2. 創建eTS工程
(1) 打開DevEco Studio,在菜單欄選擇“File > New > New Project”。
(2) 選擇工程模板“Empty Ability”,然後點擊Next。
圖2 選擇工程模板
(3) 工程配置時,註意將“Language”配置為“eTS”。
圖3 工程配置
(4) 最後點擊Finish,DevEco Studio就會自動創建一個eTS工程。
3. 代碼實現
工程創建完成後,可以看到文件目錄結構如圖4所示。其中,“ets”為代碼實現目錄,聲明式UI實現的佈局及邏輯代碼都放在這個目錄裡面。
圖4 文件目錄結構
本次“畫圖”應用的代碼都放在“entry/src/main/ets/default/pages/index.ets”文件中。
完整的實現代碼可從華為開發者論壇獲取:
下麵為大家介紹兩段關鍵代碼:
(1) 畫圖功能實現代碼
// 畫布
@Builder Canvas() {
ForEach(this.pathInfoArray, (pathInfo) => OnePath({ pathInfo: pathInfo })) // 遍歷構建所有畫圖路徑
Stack() // 覆蓋層,用於接收觸摸事件,實現畫圖
.width('100%')
.height('100%')
.onTouch((event: TouchEvent) => {
switch (event.type) {
case TouchType.Down: // 按下時,新建一條畫圖路徑
this.pathInfoArray.push(new PathInfo(`M${event.touches[0].x} ${event.touches[0].y}`, this.paintSize, this.paintColor))
break
case TouchType.Move: // 移動或抬起時,補充畫圖路徑信息
case TouchType.Up:
this.pathInfoArray[this.pathInfoArray.length-1].commands += `L${event.touches[0].x} ${event.touches[0].y}`
break
}
})
}
以上代碼通過Canvas組件定義畫布,再通過onTouch組件監聽觸摸事件實現了畫圖功能。
(2) “設置畫筆”的界面和功能實現代碼
// 設置畫筆組件
@Builder SetPaint() {
Panel(this.showSetPaint) {
Column({ space: 30 }) {
Row() {
Text('畫圖效果:')
Path()
.width(200)
.height(50)
.backgroundColor(Color.White)
.fillOpacity(0) // 不填充,只要stroke
.commands(`M${vp2px(10)} ${vp2px(10)} S${vp2px(100)} ${vp2px(70)} ${vp2px(190)} ${vp2px(10)}`) // stroke路徑,弧線
.strokeWidth(this.paintSize) // stroke寬度
.stroke(this.paintColor) // stroke顏色
}
Row() {
Text('畫筆大小:')
Slider({ value: this.paintSize, min: this.PAINT_SIZE_MIN, max: this.PAINT_SIZE_MAX })
.onChange((value) => this.paintSize = value) // 改變畫筆大小
.width(200)
}
Row() {
Text('畫筆顏色:')
ForEach(this.COLORS, color => {
Stack() {
Stack()
.width(color == this.paintColor ? 26 : 20) // 若是當前畫筆顏色,則放大一點顯示
.height(color == this.paintColor ? 26 : 20)
.backgroundColor(color)
.onClick(() => this.paintColor = color) // 點擊改變畫筆顏色
}
.width(32)
.height(32)
})
}
}.width('100%').margin({ top: 30 })
}.onChange((value: any) => {
if (value.mode == 'mini') { // 最小顯示狀態時隱藏,不隱藏會阻擋觸摸事件
this.showSetPaint = false
}
})
}
以上代碼通過Panel、Column和Row等容器組件實現了“設置畫筆”界面的佈局。
此界麵包含三個部分:畫筆顏色、畫筆大小和畫圖效果。代碼中,通過Stack組件展示畫筆的顏色,通過Slider組件調整畫筆大小,通過Path組件繪製弧線來展示畫圖效果。最終實現效果如圖5所示。
圖5 “設置畫筆”界面
至此,“畫圖”應用就開發完成啦!感興趣的小伙伴也可以去嘗試開發哦~
三、學習資源
使用eTS語言開發,僅用短短100行左右的代碼就實現了“畫圖”應用的界面和功能。這正是eTS語言的魅力所在——簡潔、高效!感興趣的小伙伴也趕緊加入我們,開啟你的eTS開發之旅吧~
我們為大家彙總了以下eTS開發的學習資源,強烈建議收藏哦!
聲明式語法:
組件說明:
歡迎更多開發者與我們共用開發成果,分享技術解讀與經驗心得!