android-utils

Android 工具类库 (Android Utils)

本项目囊括了 Android 应用开发过程中常用的绝大部分工具类。这些工具类部分整理自网络，部分由开发者自行编写，旨在提高开发效率，减少重复造轮子。

✨ 核心特性

• 丰富全面：包含文件、网络、图片、设备信息、加密解密等数十个常用工具类。
• 轻量易用：无过多第三方依赖，即插即用。
• 兼容性好：最低支持 API 15+。

如何使用 (How to install)

注意：由于 Bintray / JCenter 服务已下线，原有的 Maven 仓库引入方式已失效。建议通过 JitPack 引入，或直接将 util 模块作为本地 Library 导入到您的项目中。

方式一：本地模块导入 (推荐)

1. 下载或 Clone 本仓库代码。
2. 将 util 文件夹复制到您的项目中。
3. 在项目根目录的 settings.gradle 中包含该模块：

   include ':util'
   

4. 在您 app 模块的 build.gradle 中添加依赖：

   dependencies {
       implementation project(':util')
   }
   

方式二：通过 JitPack 引入

如果您已将此项目 Fork 并推送到 GitHub，可以通过 JitPack 引入：

allprojects {
    repositories {
        // ...
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.您的用户名:android-utils:Tag版本号'
}

所有的工具类简介 (A - Z)

类 介绍 AnimationUtils Animation 工具类 AppUtils APP 相关信息工具类 AssetDatabaseOpenHelper 读取 Asset 目录中数据库工具类 BitmapUtil Bitmap 工具类主要包括获取 Bitmap 和对 Bitmap 的操作 CipherUtils 加密与解密的工具类 (MD5, AES, DES, RSA 等) Colors 常用颜色色值工具类 CommonUtil 一些通用的方法 ChannelUtil 为打包而生的渠道工具类 DataCleanManager 应用数据清除类（内/外缓存，数据库，SharedPreference，files 及自定义目录） DatabaseExportUtils 导出应用数据库工具类 DateUtils 日期时间格式化与解析工具类 DeviceStatusUtils 手机状态工具类（网络、蓝牙、屏幕亮度、飞行模式、音量等） DeviceUtils 获取设备唯一标志 DisplayUtils 系统显示相关工具类 (dp/px 转换等) DoubleKeyValueMap 双键值对数据结构 DownloadManagerPro 下载管理工具类 FileUtils 文件操作工具类（读写、复制、删除等） HanziToPinyin 汉字转拼音工具类 ImsiUtil IMSI 获取工具类 JSONUtils Json 解析与封装工具类 LocationUtils 经纬度与地址信息互转工具 LogUtils Log 日志打印工具类，支持统一控制日志级别 NetUtil 网络状态检测与类型判断工具类 PackageUtils 应用安装下载相关工具类 (静默安装等) PhoneUtil 手机组件调用工具类（拨打电话、发短信等） PollingUtils 轮询服务工具类（开启/停止轮询服务） PreferencesCookieStore Cookie 存储工具类 RUtils 反射获取 R 资源 ID 工具类 RandomUtils 随机数生成工具类 RegUtils 数据校验（正则表达式）工具类（手机号、邮箱、身份证等） ResourceUtils 文件资源读取工具类 (assets/raw) SDCardUtils SD 卡状态与路径操作工具类 SettingUtils 应用系统设置工具类 SharesUtils 调用手机自带的分享（字符串或图片） ShellUtils Shell 命令行执行工具类（支持 root） ShortCutUtils 桌面快捷方式工具类 Singleton 单例模式抽象基类 StringUtils 字符串操作辅助包 ToastsUtils Toast 统一管理与弹框工具 ViewAnimationUtils 视图动画工具箱 ViewFinder findViewById 替代工具类 ViewUtils View 测量与操作相关工具类 WindowUtils 窗口与屏幕工具类 BaseApplication 基础 Application（内置全局异常捕获处理） BaseCrashHandler 统一捕获异常并保存到文件，下次打开时可上传 RebootThreadExceptionHandler 重启线程异常处理器，发生未知异常时自动重启应用 StartAppReceiver 重启应用广播接收器

需要的权限 (Permissions)

在您的 AndroidManifest.xml 中按需添加以下权限：

⚙️ 配置 (Configuration)

全局崩溃捕获 (可选)

如果需要全局的异常捕获与应用重启功能，可在 AndroidManifest.xml 中配置内置的 Application：

日志输出控制

发布正式版本时，若想关闭或过滤 Log 日志，只需在代码初始化处设置：

LogUtils.DEBUG_LEVEL = Log.ASSERT;

混淆 (Proguard)

如果您的项目启用了代码混淆，请在 Proguard 规则文件 (proguard-rules.pro 或 proguard.cfg) 中添加如下代码以防止工具类被错误混淆：

-keep class com.ihongqiqu.** { *; }
-keepclassmembers class com.ihongqiqu.** { *; }
-dontwarn com.ihongqiqu.**

Framework 内置工具类参考

在造轮子之前，也可以参考 AOSP 源码中自带的一些常用 Util 类（部分列出）：

// 系统
android.database.DatabaseUtils
android.transition.TransitionUtils
android.view.animation.AnimationUtils
android.view.ViewAnimationUtils
android.webkit.URLUtil
android.bluetooth.le.BluetoothLeUtils
android.gesture.GestureUtils
android.text.TextUtils
android.text.format.DateUtils
android.os.FileUtils
android.net.NetworkUtils
android.util.MathUtils
android.util.TimeUtils
android.util.ExceptionUtils
android.telephony.PhoneNumberUtils
// ...

‍ 开发者 (Developer)

• Zhenguo Jin -

License

Copyright 2014-2017 Zhenguo Jin

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

   http://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.