头图

经过了一个月高强度爆肝开发原生鸿蒙HarmonyOS Next5聊天App软件HarmonyChat。

harmonyos-wechat自研原创纯血鸿蒙Next 5.0 API12 ArkUI+ArkTs仿微信App聊天实例。包括聊天、通讯录、我的、朋友圈等模块。

鸿蒙聊天app实现了类似微信消息UI布局、编辑器光标位置输入文字+emo表情图片和gif动图、图片预览、红包、语音/位置UI、长按语音面板等功能。

HarmonyOS-Chat聊天app项目已经同步到我的原创作品集。
https://gf.bilibili.com/item/detail/1107424011

项目结构框架

使用DevEco Studio 5.0.0 Release 构建版本:5.0.3.906 编辑器搭建项目模板。

想要更快进阶鸿蒙开发,先把官方文档撸一遍,然后找个实战项目学习。
图片

华为鸿蒙os开发官网
https://developer.huawei.com/consumer/cn/
ArkUI方舟UI框架
https://developer.huawei.com/consumer/cn/doc/harmonyos-refere...

f06d237ca238efb854979b678bac2e8f_1289798-20241119101035867-2063279756.png

路由json文件
df54138f7f1be6d6a7775b64705153d9_1289798-20241119111326298-202389965.png

鸿蒙os封装通用导航条

image.png

之前有写过一篇专门的分享介绍,感兴趣的可以去看看下面这篇文章。
https://segmentfault.com/a/1190000045431284

聊天入口文件

image.png

// 自定义页面
@Builder customPage() {
  if(this.pageIndex === 0) {
    IndexPage()
  }else if(this.pageIndex === 1) {
    FriendPage()
  }else if(this.pageIndex === 2) {
    MyPage()
  }
}

build() {
  Navigation() {
    this.customPage()
  }
  .toolbarConfiguration(this.customToolBar)
  .height('100%')
  .width('100%')
  .backgroundColor($r('sys.color.background_secondary'))
  .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])
}

6218fe40bb1013983d69189796a493d7_1289798-20241119110730117-75646064.png

// 自定义底部菜单栏
@Builder customToolBar() {
  Row() {
    Row() {
      Badge({
        count: 8,
        style: {},
        position: BadgePosition.RightTop
      }) {
        Column({space: 2}) {
          SymbolGlyph($r('sys.symbol.ellipsis_message_fill'))
          Text('聊天').fontSize(12)
        }
      }
    }
    .layoutWeight(1)
    .justifyContent(FlexAlign.Center)
    .onClick(() => {
      this.pageIndex = 0
    })

    Row() {
      Column({space: 2}) {
        SymbolGlyph($r('sys.symbol.person_2'))
        Text('通讯录').fontSize(12)
      }
    }
    .layoutWeight(1)
    .justifyContent(FlexAlign.Center)
    .onClick(() => {
      this.pageIndex = 1
    })

    Row() {
      Badge({
        value: '',
        style: { badgeSize: 8, badgeColor: '#fa2a2d' }
      }) {
        Column({space: 2}) {
          SymbolGlyph($r('sys.symbol.person_crop_circle_fill_1'))
          Text('我').fontSize(12)
        }
      }
    }
    .layoutWeight(1)
    .justifyContent(FlexAlign.Center)
    .onClick(() => {
      this.pageIndex = 2
    })
  }
  .height(56)
  .width('100%')
  .backgroundColor($r('sys.color.background_secondary'))
  .borderWidth({top: 1})
  .borderColor($r('sys.color.background_tertiary'))
}

harmonyos实现登录模板/倒计时验证码

/**
 * 登录模板
 * @author andy
 */

import { router, promptAction } from '@kit.ArkUI'

@Entry
@Component
struct Login {
  @State name: string = ''
  @State pwd: string = ''

  // 提交
  handleSubmit() {
    if(this.name === '' || this.pwd === '') {
      promptAction.showToast({ message: '账号或密码不能为空' })
    }else {
      // 登录接口逻辑...
      
      promptAction.showToast({ message: '登录成功' })
      setTimeout(() => {
        router.replaceUrl({ url: 'pages/Index' })
      }, 2000)
    }
  }

  build() {
    Column() {
      Column({space: 10}) {
        Image('pages/assets/images/logo.png').height(50).width(50)
        Text('HarmonyOS-Chat').fontSize(18).fontColor('#0a59f7')
      }
      .margin({top: 50})
      Column({space: 15}) {
        TextInput({placeholder: '请输入账号'})
          .onChange((value) => {
            this.name = value
          })
        TextInput({placeholder: '请输入密码'}).type(InputType.Password)
          .onChange((value) => {
            this.pwd = value
          })
        Button('登录').height(45).width('100%')
          .linearGradient({ angle: 135, colors: [['#0a59f7', 0.1], ['#07c160', 1]] })
          .onClick(() => {
            this.handleSubmit()
          })
      }
      .margin({top: 30})
      .width('80%')
      Row({space: 15}) {
        Text('忘记密码').fontSize(14).opacity(0.5)
        Text('注册账号').fontSize(14).opacity(0.5)
          .onClick(() => {
            router.pushUrl({url: 'pages/views/auth/Register'})
          })
      }
      .margin({top: 20})
    }
    .height('100%')
    .width('100%')
    .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])
  }
}

827ca3f17870dd64d47385a5b880e2a7_1289798-20241119113748951-657529179.png

Stack({alignContent: Alignment.End}) {
  TextInput({placeholder: '验证码'})
    .onChange((value) => {
      this.code = value
    })
  Button(`${this.codeText}`).enabled(!this.disabled).controlSize(ControlSize.SMALL).margin({right: 5})
    .onClick(() => {
      this.handleVCode()
    })
}

// 验证码参数
@State codeText: string = '获取验证码'
@State disabled: boolean = false
@State time: number = 60

// 获取验证码
handleVCode() {
  if(this.tel === '') {
    promptAction.showToast({ message: '请输入手机号' })
  }else if(!checkMobile(this.tel)) {
    promptAction.showToast({ message: '手机号格式错误' })
  }else {
    const timer = setInterval(() => {
      if(this.time > 0) {
        this.disabled = true
        this.codeText = `获取验证码(${this.time--})`
      }else {
        clearInterval(timer)
        this.codeText = '获取验证码'
        this.time = 5
        this.disabled = false
      }
    }, 1000)
  }
}

harmonyos实现下拉刷新/微信九宫格图/右键菜单

00cf7d864fd4985c00ce2972a2daee85_1289798-20241119115109602-1001433050.png

  • 下拉刷新功能

    Refresh({
    refreshing: $$this.isRefreshing,
    builder: this.customRefreshTips
    }) {
    List() {
      ForEach(this.queryData, (item: RecordArray) => {
        ListItem() {
          // ...
        }
        .stateStyles({pressed: this.pressedStyles, normal: this.normalStyles})
        .bindContextMenu(this.customCtxMenu, ResponseType.LongPress)
        .onClick(() => {
          // ...
        })
      }, (item: RecordArray) => item.cid.toString())
    }
    .height('100%')
    .width('100%')
    .backgroundColor('#fff')
    .divider({ strokeWidth: 1, color: '#f5f5f5', startMargin: 70, endMargin: 0 })
    .scrollBar(BarState.Off)
    }
    .pullToRefresh(true)
    .refreshOffset(64)
    // 当前刷新状态变更时触发回调
    .onStateChange((refreshStatus: RefreshStatus) => {
    console.info('Refresh onStatueChange state is ' + refreshStatus)
    this.refreshStatus = refreshStatus
    })
    // 进入刷新状态时触发回调
    .onRefreshing(() => {
    console.log('onRefreshing...')
    setTimeout(() => {
      this.isRefreshing = false
    }, 2000)
    })
    
    @State isRefreshing: boolean = false
    @State refreshStatus: number = 1
    
    // 自定义刷新tips
    @Builder customRefreshTips() {
    Stack() {
      Row() {
        if(this.refreshStatus == 1) {
          SymbolGlyph($r('sys.symbol.arrow_down')).fontSize(24)
        }else if(this.refreshStatus == 2) {
          SymbolGlyph($r('sys.symbol.arrow_up')).fontSize(24)
        }else if(this.refreshStatus == 3) {
          LoadingProgress().height(24)
        }else if(this.refreshStatus == 4) {
          SymbolGlyph($r('sys.symbol.checkmark')).fontSize(24)
        }
        Text(`${
          this.refreshStatus == 1 ? '下拉刷新' :
            this.refreshStatus == 2 ? '释放更新' :
              this.refreshStatus == 3 ? '加载中...' :
                this.refreshStatus == 4 ? '完成' : ''
        }`).fontSize(16).margin({left:10})
      }
      .alignItems(VerticalAlign.Center)
    }
    .align(Alignment.Center)
    .clip(true)
    .constraintSize({minHeight:32})
    .width('100%')
    }
  • 长按右键菜单
    53ed82dfd0d8bc4bdfb0d5f84848ac41_1289798-20241119115230213-1785508169.png
    .bindContextMenu(this.customCtxMenu, ResponseType.LongPress)
// 自定义长按右键菜单
@Builder customCtxMenu() {
  Menu() {
    MenuItem({
      content: '标为已读'
    })
    MenuItem({
      content: '置顶该聊天'
    })
    MenuItem({
      content: '不显示该聊天'
    })
    MenuItem({
      content: '删除'
    })
  }
}
  • 下拉菜单
    40bf4bafa8a5de2cbd5880f81356e67e_1289798-20241119115302037-837203237.png

    Image($r('app.media.plus')).height(24).width(24)
    .bindMenu([
      {
        icon: $r('app.media.message_on_message'),
        value:'发起群聊',
        action: () => {}
      },
      {
        icon: $r('app.media.person_badge_plus'),
        value:'添加朋友',
        action: () => router.pushUrl({url: 'pages/views/friends/AddFriend'})
      },
      {
        icon: $r('app.media.line_viewfinder'),
        value:'扫一扫',
        action: () => {}
      },
      {
        icon: $r('app.media.touched'),
        value:'收付款',
        action: () => {}
      }
    ])
  • 自定义弹窗组件
    image.png

image.png

c831af8821f0fd1a261f869c0bb30b2f_1289798-20241119120902286-248268836.png

参数配置

// 标题(支持字符串|自定义组件)
@BuilderParam title: ResourceStr | CustomBuilder = BuilderFunction
// 内容(字符串或无状态组件内容)
@BuilderParam message: ResourceStr | CustomBuilder = BuilderFunction
// 响应式组件内容(自定义@Builder组件是@State动态内容)
@BuilderParam content: () => void = BuilderFunction
// 弹窗类型(android | ios | actionSheet)
@Prop type: string
// 是否显示关闭图标
@Prop closable: boolean
// 关闭图标颜色
@Prop closeColor: ResourceColor
// 是否自定义内容
@Prop custom: boolean
// 自定义操作按钮
@BuilderParam buttons: Array<ActionItem> | CustomBuilder = BuilderFunction

通过如下方式调用即可。

// 自定义退出弹窗
logoutController: CustomDialogController = new CustomDialogController({
  builder: HMPopup({
    type: 'android',
    title: '提示',
    message: '确定要退出当前登录吗?',
    buttons: [
      {
        text: '取消',
        color: '#999'
      },
      {
        text: '退出',
        color: '#fa2a2d',
        action: () => {
          router.replaceUrl({url: 'pages/views/auth/Login'})
        }
      }
    ]
  }),
  maskColor: '#99000000',
  cornerRadius: 12,
  width: '75%'
})

综上就是HarmonyOS Next5实战开发聊天app的一些分享,整个项目运用到的知识点还是很多,今天就先分享到这里,希望对大家有一些帮助!

https://segmentfault.com/a/1190000045381943
https://segmentfault.com/a/1190000045331960
https://segmentfault.com/a/1190000045245775
https://segmentfault.com/a/1190000045042968
https://segmentfault.com/a/1190000044899693


xiaoyan2017
765 声望318 粉丝

web前端开发爱好者,专注于前端h5、jquery、vue、react、angular等技术研发实战项目案例。