刚开始学习 Kotlin 其实挺痛苦的，相关的书籍或视频偏向于知识点的讲解看完好像还是不会做项目，开源的项目内容太多用来上手实在不合适。
多希望有个代码简单，内容全面，知识详细，快速上手的项目，于是便有了 fragmject 项目。
在此感谢 玩Android 提供的 开放API 。
一个入门级的项目，通过对 Kotlin 和 Jetpack 全家桶的系统运用，实现的一个功能完备符合主流市场标准App。
代码简单，内容全面，知识详细，快速上手，对理解其他项目设计思想和封装技巧也很有帮助。
学习本项目你将有如下收获：
- Kotlin（函数进阶，泛型，反射，协程...）
- MVVM（ViewModel，LiveData...）
- 单Activity应用架构（Navigation...）
- 屏幕录制、图片编辑、字节码插桩...
 |
 |
 |
|---|
├── app app
| └── src
| └── main
| | └── java 源码目录
| | | ├── activity Activity目录
| | | | └── MainActivity 项目唯一Activity
| | | ├── adapter Adapter目录
| | | ├── fragment Fragment目录
| | | ├── model ViewModel目录
| | | └── App Application
| | |
| | └── res 资源目录
| | | └── navigation 导航图目录
| | |
| | └── AndroidManifest.xml 配置文件
| |
| └── build.gradle 模块构建配置
| └── channel 渠道配置文件
| └── dictionary 自定义混淆字典
| └── proguard-rules.pro 代码混淆配置文件
|
├── library-base 基础library（存放通用封装源码）
| └── src
| └── main
| | ├── assets 原生文件目录
| | └── java 源码目录
| | ├── bus 消息总线目录
| | ├── db Database目录
| | ├── dialog Dialog目录
| | ├── http 网络请求目录
| | ├── provider ContentProvider目录
| | ├── utils 工具类目录
| | └── view 自定义view目录
| |
| └── build.gradle 模块构建配置
|
├── library-common 公共library（存放各个 module 公用源码及资源）
| └── src
| └── main
| | └── java 源码目录
| | ├── bean 实体类目录
| | └── constant 常量配置目录
| |
| └── build.gradle 模块构建配置
|
├── miaow-picture 图片编辑器模块（目录同app，不再展开）
├── module-user 用户模块（目录同app，不再展开）
├── module-wan 玩Android功能模块（目录同app，不再展开）
|
├── plugin-privacy 隐私扫描模块（目录同统计插件模块，不再展开）
├── plugin-statistic 统计插件模块
| └── src
| └── main
| └── groovy 源码目录
| | ├── bp 埋点统计目录
| | └── mt 耗时统计目录
| |
| └── resources 配置目录
| └── statistic.properties 插件配置
|
├── repos 插件生成目录
|
├── build.gradle 项目构建配置
├── config.gradle gradle编译文件 gradle依赖配置
├── config.properties 项目配置
├── gradle.properties gradle配置
└── settings.gradle 项目依赖配置
Kotlin 是一种富有表现力且简洁的编程语言，不仅可以减少常见代码错误，还可以轻松集成到现有应用中。
通过视图绑定功能，您可以更轻松地编写可与视图交互的代码。与使用 findViewById 相比，视图绑定具有一些很显著的优点：
- Null安全
- 类型安全
LiveData 是一种可观察的数据存储器类，它具有生命周期感知能力，这种感知能力可确保 LiveData 仅更新处于活跃生命周期状态的应用组件观察者。
并且使用 LiveData 具有以下优势：
- 确保界面符合数据状态
- 不会发生内存泄漏
- 不会因Activity停止而导致崩溃
- 不再需要手动处理生命周期
- 数据始终保持最新状态
- 适当的配置更改
- 共享资源
ViewModel 类旨在以注重生命周期的方式存储和管理界面相关的数据。 ViewModel 类让数据可在发生屏幕旋转等配置更改后继续留存。
协程是我们在 Android 上进行异步编程的推荐解决方案。值得关注的特点包括：
- 轻量
- 内存泄漏更少
- 内置取消支持
- Jetpack集成
MVVM（Model-View-ViewModel） 最早由微软提出。ViewModel指 "Model of View"——视图的模型。
Navigation 是 Android Jetpack 组件之一，主要是用于 Fragment 路由导航的框架，通过 Navigation 我们可以设计出单 Activity 应用架构。
基于RoomDatabase封装，通过键值对的方式来存储数据，不用再去关心 RoomDatabase 的复杂操作。
// 存储数据
KVDatabase.set(key: String, value: String)
// 获取数据
KVDatabase.get(key: String)
基于SharedFlow封装的消息总线
SharedFlowBus：30行代码实现消息总线你确定不看吗
// 发送消息
SharedFlowBus.with(objectKey: Class<T>).tryEmit(value: T)
// 发送粘性消息
SharedFlowBus.withSticky(objectKey: Class<T>).tryEmit(value: T)
// 订阅消息
SharedFlowBus.on(objectKey: Class<T>).observe(owner){ it ->
println(it)
}
// 订阅粘性消息
SharedFlowBus.onSticky(objectKey: Class<T>).observe(owner){ it ->
println(it)
}
第 1 步:在工程的 build.gradle 中添加：
allprojects {
repositories {
...
mavenCentral()
}
}
第2步：在应用的 build.gradle 中添加：
dependencies {
implementation 'com.github.miaowmiaow.fragmject:miaow-picture:1.2.6'
}
PictureEditorDialog.newInstance()
.setBitmapPath(path)
.setEditorFinishCallback(object : EditorFinishCallback {
override fun onFinish(path: String) {
val bitmap = BitmapFactory.decodeFile(path, BitmapFactory.Options())
}
})
.show(childFragmentManager)
如上所示：
- 通过
PictureEditorDialog调用图片编辑器 - 通过
setBitmapPath(path)传入图片路径 - 通过
setEditorFinishCallback(callback)获取编辑后的图片地址
如果觉得 PictureEditorDialog 不能满足需求，还可以通过 PictureEditorView 来自定义样式
<com.example.miaow.picture.editor.PictureEditorView
android:id="@+id/pic_editor"
android:layout_width="match_parent"
android:layout_height="match_parent" />
picEditor.setBitmapPath(path)
picEditor.setMode(PictureEditorView.Mode.STICKER)
picEditor.setGraffitiColor(Color.parseColor("#ffffff"))
picEditor.setSticker(StickerAttrs(bitmap))
picEditor.graffitiUndo()
picEditor.mosaicUndo()
picEditor.saveBitmap()
如上所示：
- 通过
setBitmapPath(path)传入图片路径 - 通过
setMode(mode)设置编辑模式，分别有：涂鸦，橡皮擦，马赛克，贴纸 - 通过
setGraffitiColor(color)设置涂鸦画笔颜色 - 通过
setSticker(StickerAttrs(bitmap))设置贴纸 - 通过
graffitiUndo()涂鸦撤销 - 通过
mosaicUndo()马赛克撤销 - 通过
saveBitmap()保存编辑图片
PictureEditorView 就介绍到这里，具体使用请查看 PictureEditorDialog
<com.example.miaow.picture.editor.PictureClipView
android:id="@+id/clip"
android:layout_width="match_parent"
android:layout_height="match_parent" />
clip.setBitmapResource(bitmap)
clip.rotate()
clip.reset()
clip.saveBitmap()
如上所示：
- 通过
setBitmapResource(bitmap)传入裁剪图片 - 通过
clip.rotate()图片旋转 - 通过
clip.reset()图片重置 - 通过
clip.saveBitmap()保存裁剪框内图片
PictureClipView 就介绍到这里，具体使用请查看 PictureClipDialog
- coil-kt/coil
- google/gson
- Meituan-Dianping/walle
- sourceforge/pinyin4j
- square/okhttp
- square/retrofit
- tencent/x5
感谢所有优秀的开源项目 ^^
如果喜欢的话希望给个 Star 或 Fork ^^
谢谢~~
- QQ : 237934622
- WeChat : zst_1116
- Email : zst_1116@icloud.com
- JueJin：miaowmiaow
Copyright 2021 miaowmiaow
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.