Skip to content

👀诗词笔记。使用Kotlin开发的Android App,实践了QMUI、ObjectBox、EventBus、Iconics、Picasso等技术的应用~

License

Notifications You must be signed in to change notification settings

Deali-Axy/PoemNote

Repository files navigation

PoemNote

一个简单的诗词笔记App,内置《唐诗三百首》和一千多条「一言」语录,完全使用Kotlin开发,之前用来完成某次作业 + 学习Kotlin

最近整理代码的时候发现了这份代码,感觉还可以,修修改改,把一些bug的坑给填上了,然后开源出来~

Features

  • 随机诗词卡片
  • 记录诗词笔记
  • 笔记分享广场
  • 多用户支持
  • ...

Dependencies

  • 腾讯的 QMUI 组件库
  • ObjectBox 数据库
  • Iconics 图标组件
  • Google Material Design 图标
  • Fontawesome 图标
  • EventBus
  • Picasso
  • ...

Screenshots

首页 诗词阅读 诗词列表
image-20220822222329166 image-20220822222404250 image-20220822222427931
笔记广场 用户中心 用户列表
image-20220822222453607 image-20220822222518613 image-20220822222537755

旧文

Kotlin好用的一批,继用Kotlin写Springboot之后,我又来试试Android开发……

App架构图~~(作业需要)~~

Activity 和 Fragment 的选择

换做以前肯定无脑上几十个Activity,然后页面跳来跳去的。

不过因为我们项目要用到QMUI,于是我认真读了QMUI在Github上的Wiki和作者的博客,看到作者在比较 Activity 和 Fragment,互有利弊,Fragment更加轻量,而且QMUI的示例项目里面也大量运用了Fragment,所以我就决定这个项目直接用上极端的单Activity多Fragment架构……

关于Activity还是Fragment,可以看QMUI作者的这篇博客:http://blog.cgsdream.org/2019/12/15/qmui-gank-02/

Fragment之间的切换用到QMUI的QMUIFragmentActivity这个工具,挺方便的,用起来和Flutter的路由跳转差不多吧:

// 跳转到 Home
val intent = QMUIFragmentActivity.intentOf(
    this,
    CommonHolderActivity::class.java,
    MainFragment::class.java
)
startActivity(intent)

全部的Fragment都是用CommonHolderActivity来承载,CommonHolderActivity的代码定义如下,可以看到需要在FirstFragments注解中先注册我们要用到的Fragment,是不是很像Flutter的路由注册?

@FirstFragments(
    value = [
        MainFragment::class,
        PoemListFragment::class,
        PoemFragment::class,
        SignUpFragment::class,
        SignInFragment::class
    ]
)
// 使用 @DefaultFirstFragment 来指定默认的 First Fragment,这时 new Intent(context, CommonHolderActivity::class.java) 就会启用默认的 First Fragment
@DefaultFirstFragment(MainFragment::class)
class CommonHolderActivity : QMUIFragmentActivity() {
    override fun getContextViewId(): Int {
        // 提供 FragmentContainer 的 id
        return R.id.app_common_holder_fragment_container
    }
}

QMUI

前面好像还没介绍到QMUI,这是腾讯开源的一个AndroidUI框架,可以用比较少的代码实现好看的界面,其实我很早就看到这个了,但是一直没有使用,为什么呢?因为它犯了国内开源项目的通病——文档资料匮乏、官方文档质量不高。

因为文档不是很好(看起来文档应该是停止维护了),对Android新手真的挺劝退的,一个简单的功能在QMUI开发者团队的大佬看来小菜一碟,但是新手总是会因为这样那样的细节问题没搞懂,卡在一个地方很久。没有一个Quick Start是真的难顶。

现在这个项目重新选择了QMUI,一方面是Android平台上好用的开源UI框架好像没有别的选择了?一方面是经过这些时间被Android的摧残,我已经上手这方面的开发,可以直接看QMUI的代码来撸一个界面出来了……

本文就来介绍几个组件的简单使用

Topbar

PagerSnapHelper

QMUITopBarLayout

QMUIViewPager

QMUITabSegment

相关文档:

ORM: ObjectBox

之前我用的是Greendao,性能蛮高的,数据库用的是SQLite,然后还是这个作者,出了新版的ObjectBox,100%适配Kotlin,舒服的一批,这东西准确说是个数据库

参考

EventBus

参考资料

图标组件

超好用的一款图标组件:https://github.com/mikepenz/Android-Iconics

附上我比较常用的Material Design图标库:https://material.io/resources/icons/

Kotlin Android开发资料

About

👀诗词笔记。使用Kotlin开发的Android App,实践了QMUI、ObjectBox、EventBus、Iconics、Picasso等技术的应用~

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages