androidComponts

大量android的基础框架架构，根据自己负责的公司项目，逐步形成的个人开发脚手架。 基于各个Module等基础模块可以快速开始大型项目开发。相信能在本工程中找到你感兴趣的点。

大致介绍框架：

Module-Android

MVVM框架

基于activity + Fragment + 泛型 + viewBinding + kotlin+ ShellFragmentActivity实现的一个快速开发的框架。

大量的android界面需要使用Activity来承载显示和跳转，如果每一个界面都添加一个Activity就有点太多。因此使用一个壳Activity作为基础，通过Intent传递Fragment的Class和其他参数。

通过泛型将ViewBinding实现界面自动创建到Fragment/Activity上。

涵盖了activity，fragment，dialog，dialogFragment等支持。

兼容android15+沉浸式，从框架上进行约束开发。

大量基础Widget

大量基础类。主要涉及文本封装类。自定义字体的需求。

BgBuildLayout，是实现了通过xml标签来设定background，cornerRadius等属性。这样就不用提供图片背景就实现背景。

附带可拷走的类：ViewBackgroundBuilder，通过链式调用创建一个背景。

init框架

• 兼容android12+的SplashScreen抽象类。参考文章：https://blog.csdn.net/jzlhll123/article/details/136628746

• Globals单例，持有大量全局需要使用的变量，比如：

  mainScope 
  mainHandler
  gson
  activityList //记录app的activity列表

• InitApplication 基类，用于提供给app主模块接入Application。

​ 初始化包括：自主黑白主题，自选语言框架，异常拦截框架，全局activity监听，前后台切换，screenAdapter适配，头条SPHook等。

日志框架

logd{} loge{}等打印需求，打印出线程和类名。

FileLog可以作为本地日志缓存框架。单文件实现简约不简单。

font & icon Font

font: 参考CustomFontText，TextView.checkBoldAndSetFont实现的加载特定的字体的font。做成基础封装类，便于公司快速开发使用。

iconFont: 有没有想过怎么将一些小图标变成字体库ttf，来实现当做文字显示？IconFontUtil来帮你。

Uncaught Exception

拦截未做处理导致的app crash。activity的实现，做到99%永不crash。参考module_android/crash。

原理:

Thread.setDefaultUncaughtExceptionHandler(UncaughtExceptionHandlerObj)
//主线程异常拦截
try {
    Looper.loop()
} catch (e: Throwable) {
    ...
}

通过自行追加Looper.loop()的方式来解决。网上会有很多帖子介绍该方案。

小数据KV缓存property

• AppDataStore
• SharedPreference
• MmkvUtil （目前逐步取消依赖，注释掉，现阶段推荐基于kotlin协程+DataStore✨）

另外提供类似变量的property代理AppDataStoreXXXCache和SharedPrefXXXCache，示例：

 private var lastCheckAndStartSystemTs by AppDataStoreLongCache("lastCheckAndStartSystemTs", System.currentTimeMillis())

//...
lastCheckAndStartSystemTs = curTs

Permissions框架

对于拍照，拍视频，申请权限，和启动activity for Result等代码kotlin框架实现。

参考module_android/permission。

非粘性LiveData和状态

实现了非粘性的LiveData分装NoStickLiveData。

实现原理参考我的帖子：https://blog.csdn.net/jzlhll123/article/details/133725302

StateFlow

StateFlow的最佳开发实践。

参考：simpleflow和FlowStudyFragment。

ImeUtil/ImeHelper

键盘弹起的回调监听。总所周知，android上通过xml布局的属性设定的效果比较差。View.onApplyWindowInsets, setOnApplyWindowInsetsListener等函数提供了更可靠和兼容更强的方案。

黑夜模式&多语言&自选

实现黑夜模式和自主选择。

实现自主选择当前语言环境。

参考:AndroidUi2Fragment

工具集

• 协程函数：常用的扩展。launchOnUi， launchOnIOThread等。

• onClick: 防抖；

• MediaHelper: 对于音视频文件的信息获取，比如时长，文件类型等；

• Uri工具类：android对于Uri的依赖越来越高，比如从picker拿到的图片、视频，都是uri。进行裁剪和压缩再上传等操作都依赖于Uri的解析。拷贝等操作。

• Glide简易封装使用，设置任意参数，比如File\Uri\String链接等，还可以附带默认显示的图片或颜色。支持简易的时间缓存过期，避免同链接图片永不替换新图的问题解决。参考GlideUtil。

• JSON/Bundle扩展。kotlin扩展，辅助解析类。使用gson，解析json string。参考JsonUtils, BundleUtil。

• Html text显示封装。参考TextView.useSimpleHtmlText扩展。

• 通知封装库。

• 反射类。ReflectionUtils。

• 状态栏沉浸式研究和总结最佳方案。SystemBarUtil。参考Activity.transparentStatusBar。

Module-AndroidColor

基于View项目，做的黑白模式兼容。

涉及了主题（activity/application的主题），背景色，

颜色盘涵盖了所有android开发涉及的色值，

style(多种常用文案的style，比如标题，二级文字等，输入框，Tab...）。

Module-AndroidUi

类似IOS的toast风格实现。

各种常用Dialog显示，底部的，居中的。

其他控件。

Module-Nested

实现了基于recyclerView的大量框架。

下拉刷新，自动触底加载分页的框架。

ViewPager2的框架。

提供组合RecyclerView，indicator等的Layout。

实现了MVVM的recyclerView框架

• BindRcvAdapter

BindViewHolder<DATA:Any, BINDING: ViewBinding> : RecyclerView.ViewHolder(binding.root) 

abstract class BaseAdapter<DATA:Any, VH: BindViewHolder<DATA, *>> : RecyclerView.Adapter<VH>()
abstract class BindRcvAdapter<DATA:Any, VH: BindViewHolder<DATA, *>> : BaseAdapter<DATA, VH>(), IBindAdapter<DATA>

在不改变我们传统的写法的前提下：

onCreateViewHolder 和 getItemViewType的传统写法，避免框架使用者的不熟悉。

不支持DiffUtil算法。

• viewHolder

同时，给出BindViewHolder必须实现的函数体：

override fun bindData(bean: XXXBean) {
    super.bindData(bean)
    //ui绑定编写
}

• AutoLoadMoreBindRcvAdapter

  • 实现差异化更新

    override fun isSupportDiffer(): Boolean {
        return true
    }
    
    private class Differ(aList:List<Bean>?, bList:List<Bean>?) : DiffCallback<Bean>(aList, bList) {
        override fun compareContent(a: Bean, b: Bean): Boolean {
            return //todo a.index == b.index 
        }
    }
    
    override fun createDiffer(a: List<Bean>?, b: List<Bean>?): DiffCallback<Bean> {
          return Differ(a, b)
      }
    

    在adapter中，将isSupportDiffer()返回true，并实现createDiffer函数。就能在框架的指引下，进行解析。

  • 实现分页加载

    initDatas(datas: List<DATA>?, hasMore: Boolean, isTraditionalUpdate: Boolean) 
    appendDatas(appendList: List<DATA>?, hasMore: Boolean)
    

https://developer.android.google.cn/topic/libraries/architecture/paging/v3-overview?hl=zh-cn

Module-Okhttp

参考OkhttpGlobal。

接入该模块，初始化常用的okhttpClient，可以额外定制参数。

并加入了开发的拦截器，用于控制请求参数的变更，比如token的刷新，后台错误的拦截，时间戳修正，简化okhttp标准重试拦截器。

Module-ImageCompressed

基于android的ImageDecoder和BitmapFactory做压缩，效果Best！ 基于android photo picker;

以及基于module-android的permission请求和Uri处理。

还封装了弹窗选择拍照和选择图片，一直到请求权限，选择回来。

AppMultiMedia

Audio Recorders 4种

• MediaRecorder 录制

  android api24支持pause/resume。推荐使用。已经编码，可直接播放。格式多种多样。

  可以设置输出格式，编码格式，采样率等等。

  适用于简单录制，直接保存播放。

• AudioRecorder录制

  录制纯PCM数据，适用于得到以后，进行加工，边录边播等场景。

  PCM是什么：

  经过如下三步得到未经压缩的原始音频数据，音质最佳但体积较大：

  采样：以固定时间间隔（如44.1kHz）采样率和声道数（单/双声道），捕获模拟信号的瞬时值，将其离散化。

  量化：将采样值映射到最接近的数字层级（如16bit量化），引入量化噪声但保留信号特征。

  编码：将量化后的数值转换为二进制码流，形成最终的数字音频数据。

​ 参数可以设置编码的ENCODING_PCM_16BIT, 8BIT等；单声道还是立体声；采样率。

​ 通过简单的PCMToWavUtil实现封装成可播放的wav文件。

• openSL ES

  主要是JNI层，通过OpenSLES，slCreateEngine，开始录制。

  与java层AudioRecoder类似，最终都是产出PCM数据，都是调用android的AudioFlinger服务。

  适用于一些低延迟，实时要求更高，对接音频处理c/c++库更方便。

• tinyalsa

  有些厂商有特定的4mic，6mic音频输入。通过集成tinyalsa的JNI代码，实现采样PCM数据。

Audio Player 3种

1. SoundPool 适用于简短的音效播放, 比如游戏声音、按键声、铃声片段等等；

2. MediaPlayer 实现了简单的监听完成，监听拖动，暂停，恢复等基本使用；

   支持多种媒体类型；wav和各种压缩音频都能轻松播放；适合在后台长时间播放本地音乐文件或者在线的流式资源。（推荐）

   MediaPlayer可以播放多种格式MP3，AAC，WAV，OGG，MIDI等。MediaPlayer会在framework层创建对应的音频解码器。MediaPlayer在framework层还是会创建AudioTrack，把解码后的PCM数流传递给AudioTrack，再传递给AudioFlinger进行混音，然后才传递给硬件播放，所以是MediaPlayer包含了AudioTrack。

3. AudioTrack

   AudioTrack不创建解码器，只能播放已解码的PCM流，wav文件一般就是PCM原始数据；支持低延迟播放，适合流媒体和VoIP语音电话等场景。

   MyAudioTracker.java的定义中有详细说明。

   static模式：先全部导入buffer，再播放;

   stream模式：一边播放一边导入buffer。（可以玩一玩，目前可以做到暂停恢复。）

Camera1

Camera2

CameraX

UVCCamera

Module-Native

加密相关。

保护appId/AppKey。涉及到ndk读取sha1签名校验，移位算法，AES加密，字符串混淆还原等代码。

Module-AndroidLogSystem

一个日志系统。

基于单文件的自主实现FileLog。比较简化。

Gradle脚本

字符串混淆脚本。

蒲公英测试上传脚本。

assets文件混淆方案脚本。

内网下载文件脚本。方便减少集成仓库的大小。

其他

几个主工程的实现：

学习自定义编译时注解的方案。

基于之前的jsbridge2.0实现的学习。webView的通信。

学习ROOM数据库。

nanoHttpD实现局域网通信。

todo