README-CN.md 34.7 KB
Newer Older
C
cmj 已提交
1
# Android开发人员不得不收集的代码([持续更新中][update_log.md])
C
cmj 已提交
2

C
cmj 已提交
3
## [README of English][readme.md]
C
cmj 已提交
4

C
cmj 已提交
5
为方便查找,已进行大致归类,其目录如下所示:
C
cmj 已提交
6

C
cmj 已提交
7
> - **Activity相关→[ActivityUtils.java][activity.java]→[Demo][activity.demo]**
C
cmj 已提交
8
 ```
B
Blankj 已提交
9 10 11
isActivityExists   : 判断是否存在Activity
launchActivity     : 打开Activity
getLauncherActivity: 获取入口activity
C
cmj 已提交
12 13
 ```

C
cmj 已提交
14
> - **App相关→[AppUtils.java][app.java]→[Demo][app.demo]**
C
cmj 已提交
15
 ```
B
Blankj 已提交
16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
isInstallApp         : 判断App是否安装
installApp           : 安装App(支持6.0)
installAppSilent     : 静默安装App
uninstallApp         : 卸载App
uninstallAppSilent   : 静默卸载App
isAppRoot            : 判断App是否有root权限
launchApp            : 打开App
getAppPackageName    : 获取App包名
getAppDetailsSettings: 获取App具体设置
getAppName           : 获取App名称
getAppIcon           : 获取App图标
getAppPath           : 获取App路径
getAppVersionName    : 获取App版本号
getAppVersionCode    : 获取App版本码
isSystemApp          : 判断App是否是系统应用
isAppDebug           : 判断App是否是Debug版本
getAppSignature      : 获取App签名
getAppSignatureSHA1  : 获取应用签名的的SHA1值
isAppForeground      : 判断App是否处于前台
getForegroundApp     : 获取前台应用包名
getAppInfo           : 获取App信息
getAppsInfo          : 获取所有已安装App信息
cleanAppData         : 清除App所有数据
C
cmj 已提交
39
 ```
C
cmj 已提交
40 41

> - **栏相关→[BarUtils.java][bar.java]**
C
cmj 已提交
42
 ```
B
Blankj 已提交
43 44 45 46 47 48 49
setTransparentStatusBar: 设置透明状态栏(api大于19方可使用)
hideStatusBar          : 隐藏状态栏
getStatusBarHeight     : 获取状态栏高度
isStatusBarExists      : 判断状态栏是否存在
getActionBarHeight     : 获取ActionBar高度
showNotificationBar    : 显示通知栏
hideNotificationBar    : 隐藏通知栏
C
cmj 已提交
50 51
 ```

C
cmj 已提交
52
> - **清除相关→[CleanUtils.java][clean.java]→[Demo][clean.demo]**
C
cmj 已提交
53
 ```
B
Blankj 已提交
54 55 56 57 58 59 60
cleanInternalCache   : 清除内部缓存
cleanInternalFiles   : 清除内部文件
cleanInternalDbs     : 清除内部数据库
cleanInternalDbByName: 根据名称清除数据库
cleanInternalSP      : 清除内部SP
cleanExternalCache   : 清除外部缓存
cleanCustomCache     : 清除自定义目录下的文件
C
cmj 已提交
61 62
 ```

C
cmj 已提交
63
> - **剪贴板相关→[ClipboardUtils.java][clipboard.java]**
C
cmj 已提交
64
 ```
B
Blankj 已提交
65 66 67 68 69 70
copyText  : 复制文本到剪贴板
getText   : 获取剪贴板的文本
copyUri   : 复制uri到剪贴板
getUri    : 获取剪贴板的uri
copyIntent: 复制意图到剪贴板
getIntent : 获取剪贴板的意图
C
cmj 已提交
71 72
 ```

C
cmj 已提交
73
> - **关闭相关→[CloseUtils.java][close.java]**
C
cmj 已提交
74
 ```
B
Blankj 已提交
75 76
closeIO       : 关闭IO
closeIOQuietly: 安静关闭IO
C
cmj 已提交
77 78
 ```

79
> - **常量相关→[ConstUtils.java][const.java]**
C
cmj 已提交
80
 ```
B
Blankj 已提交
81 82 83
MemoryConst: 存储相关常量
TimeConst  : 时间相关常量
RegexConst : 正则相关常量
C
cmj 已提交
84 85
 ```

86
> - **转换相关→[ConvertUtils.java][convert.java]→[Test][convert.test]**
C
cmj 已提交
87
 ```
B
Blankj 已提交
88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
bytes2HexString, hexString2Bytes        : byteArr与hexString互转
chars2Bytes, bytes2Chars                : charArr与byteArr互转
memorySize2Byte, byte2MemorySize        : 以unit为单位的内存大小与字节数互转
byte2FitMemorySize                      : 字节数转合适内存大小
timeSpan2Millis, millis2TimeSpan        : 以unit为单位的时间长度与毫秒时间戳互转
millis2FitTimeSpan                      : 毫秒时间戳转合适时间长度
bytes2Bits, bits2Bytes                  : bytes与bits互转
input2OutputStream, output2InputStream  : inputStream与outputStream互转
inputStream2Bytes, bytes2InputStream    : inputStream与byteArr互转
outputStream2Bytes, bytes2OutputStream  : outputStream与byteArr互转
inputStream2String, string2InputStream  : inputStream与string按编码互转
outputStream2String, string2OutputStream: outputStream与string按编码互转
bitmap2Bytes, bytes2Bitmap              : bitmap与byteArr互转
drawable2Bitmap, bitmap2Drawable        : drawable与bitmap互转
drawable2Bytes, bytes2Drawable          : drawable与byteArr互转
view2Bitmap                             : view转Bitmap
dp2px, px2dp                            : dp与px互转
sp2px, px2sp                            : sp与px互转
C
cmj 已提交
106 107
 ```

C
cmj 已提交
108
> - **崩溃相关→[CrashUtils.java][crash.java]**
C
cmj 已提交
109
 ```
B
Blankj 已提交
110 111
getInstance: 获取单例
init       : 初始化
C
cmj 已提交
112 113
 ```

C
cmj 已提交
114
> - **设备相关→[DeviceUtils.java][device.java]→[Demo][device.demo]**
C
cmj 已提交
115
 ```
S
Subhrajyoti Sen 已提交
116
isDeviceRooted   : 判断设备是否rooted
B
Blankj 已提交
117 118 119 120 121 122 123 124 125
getSDKVersion    : 获取设备系统版本号
getAndroidID     : 获取设备AndroidID
getMacAddress    : 获取设备MAC地址
getManufacturer  : 获取设备厂商
getModel         : 获取设备型号
shutdown         : 关机
reboot           : 重启
reboot2Recovery  : 重启到recovery
reboot2Bootloader: 重启到bootloader
C
cmj 已提交
126 127
 ```

C
cmj 已提交
128
> - **判空相关→[EmptyUtils.java][empty.java]→[Test][empty.test]**
C
cmj 已提交
129
 ```
B
Blankj 已提交
130 131
isEmpty   : 判断对象是否为空
isNotEmpty: 判断对象是否非空
C
cmj 已提交
132 133
 ```

134
> - **编码解码相关→[EncodeUtils.java][encode.java]→[Test][encode.test]**
C
cmj 已提交
135
 ```
B
Blankj 已提交
136 137 138 139 140 141 142 143
urlEncode          : URL编码
urlDecode          : URL解码
base64Encode       : Base64编码
base64Encode2String: Base64编码
base64Decode       : Base64解码
base64UrlSafeEncode: Base64URL安全编码
htmlEncode         : Html编码
htmlDecode         : Html解码
C
cmj 已提交
144 145
 ```

146
> - **加密解密相关→[EncryptUtils.java][encrypt.java]→[Test][encrypt.test]**
C
cmj 已提交
147
 ```
B
Blankj 已提交
148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167
encryptMD2, encryptMD2ToString                        : MD2加密
encryptMD5, encryptMD5ToString                        : MD5加密
encryptMD5File, encryptMD5File2String                 : MD5加密文件
encryptSHA1, encryptSHA1ToString                      : SHA1加密
encryptSHA224, encryptSHA224ToString                  : SHA224加密
encryptSHA256, encryptSHA256ToString                  : SHA256加密
encryptSHA384, encryptSHA384ToString                  : SHA384加密
encryptSHA512, encryptSHA512ToString                  : SHA512加密
encryptHmacMD5, encryptHmacMD5ToString                : HmacMD5加密
encryptHmacSHA1, encryptHmacSHA1ToString              : HmacSHA1加密
encryptHmacSHA224, encryptHmacSHA224ToString          : HmacSHA224加密
encryptHmacSHA256, encryptHmacSHA256ToString          : HmacSHA256加密
encryptHmacSHA384, encryptHmacSHA384ToString          : HmacSHA384加密
encryptHmacSHA512, encryptHmacSHA512ToString          : HmacSHA512加密
encryptDES, encryptDES2HexString, encryptDES2Base64   : DES加密
decryptDES, decryptHexStringDES, decryptBase64DES     : DES解密
encrypt3DES, encrypt3DES2HexString, encrypt3DES2Base64: 3DES加密
decrypt3DES, decryptHexString3DES, decryptBase64_3DES : 3DES解密
encryptAES, encryptAES2HexString, encryptAES2Base64   : AES加密
decryptAES, decryptHexStringAES, decryptBase64AES     : AES解密
C
cmj 已提交
168 169
 ```

170
> - **文件相关→[FileUtils.java][file.java]→[Test][file.test]**
C
cmj 已提交
171
 ```
B
Blankj 已提交
172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210
getFileByPath            : 根据文件路径获取文件
isFileExists             : 判断文件是否存在
rename                   : 重命名文件
isDir                    : 判断是否是目录
isFile                   : 判断是否是文件
createOrExistsDir        : 判断目录是否存在,不存在则判断是否创建成功
createOrExistsFile       : 判断文件是否存在,不存在则判断是否创建成功
createFileByDeleteOldFile: 判断文件是否存在,存在则在创建之前删除
copyDir                  : 复制目录
copyFile                 : 复制文件
moveDir                  : 移动目录
moveFile                 : 移动文件
deleteDir                : 删除目录
deleteFile               : 删除文件
listFilesInDir           : 获取目录下所有文件
listFilesInDir           : 获取目录下所有文件包括子目录
listFilesInDirWithFilter : 获取目录下所有后缀名为suffix的文件
listFilesInDirWithFilter : 获取目录下所有后缀名为suffix的文件包括子目录
listFilesInDirWithFilter : 获取目录下所有符合filter的文件
listFilesInDirWithFilter : 获取目录下所有符合filter的文件包括子目录
searchFileInDir          : 获取目录下指定文件名的文件包括子目录
writeFileFromIS          : 将输入流写入文件
writeFileFromString      : 将字符串写入文件
readFile2List            : 指定编码按行读取文件到链表中
readFile2String          : 指定编码按行读取文件到字符串中
readFile2Bytes           : 读取文件到字符数组中
getFileLastModified      : 获取文件最后修改的毫秒时间戳
getFileCharsetSimple     : 简单获取文件编码格式
getFileLines             : 获取文件行数
getDirSize               : 获取目录大小
getFileSize              : 获取文件大小
getDirLength             : 获取目录长度
getFileLength            : 获取文件长度
getFileMD5               : 获取文件的MD5校验码
getFileMD5ToString       : 获取文件的MD5校验码
getDirName               : 根据全路径获取最长目录
getFileName              : 根据全路径获取文件名
getFileNameNoExtension   : 根据全路径获取文件名不带拓展名
getFileExtension         : 根据全路径获取文件拓展名
C
cmj 已提交
211 212
 ```

B
Blankj 已提交
213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233
> - **Fragment相关→[FragmentUtils.java][fragment.java]→[Demo][fragment.demo]**
 ```
addFragment          : 新增fragment
popFragment          : 出栈fragment
popToFragment        : 出栈到指定fragment
popAddFragment       : 先出栈后新增fragment
hideFragment         : 隐藏fragment
showFragment         : 显示fragment
hideShowFragment     : 先隐藏后显示fragment
replaceFragment      : 替换fragment
getTopFragment       : 获得栈顶fragment
getTopShowFragment   : 获得栈顶可见fragment
getPreFragment       : 获取目标fragment的前一个fragment
findFragment         : 寻找fragment
getFragments         : 获取同级别的fragment
getAllFragments      : 获取所有fragment
setBackgroundColor   : 设置背景色
setBackgroundResource: 设置背景资源
setBackground        : 设置背景
 ```

C
cmj 已提交
234 235
> - **Handler相关→[HandlerUtils.java][handler.java]→[Demo][handler.demo]**
 ```
B
Blankj 已提交
236
HandlerHolder: 使用必读
C
cmj 已提交
237 238 239
 ```

> - **图片相关→[ImageUtils.java][image.java]→[Demo][image.demo]**
C
cmj 已提交
240
 ```
B
Blankj 已提交
241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266
bitmap2Bytes, bytes2Bitmap      : bitmap与byteArr互转
drawable2Bitmap, bitmap2Drawable: drawable与bitmap互转
drawable2Bytes, bytes2Drawable  : drawable与byteArr互转
getBitmap                       : 获取bitmap
scale                           : 缩放图片
clip                            : 裁剪图片
skew                            : 倾斜图片
rotate                          : 旋转图片
getRotateDegree                 : 获取图片旋转角度
toRound                         : 转为圆形图片
toRoundCorner                   : 转为圆角图片
fastBlur                        : 快速模糊
renderScriptBlur                : renderScript模糊图片
stackBlur                       : stack模糊图片
addFrame                        : 添加颜色边框
addReflection                   : 添加倒影
addTextWatermark                : 添加文字水印
addImageWatermark               : 添加图片水印
toAlpha                         : 转为alpha位图
toGray                          : 转为灰度图片
save                            : 保存图片
isImage                         : 根据文件名判断文件是否为图片
getImageType                    : 获取图片类型
compressByScale                 : 按缩放压缩
compressByQuality               : 按质量压缩
compressBySampleSize            : 按采样大小压缩
C
cmj 已提交
267 268
 ```

C
cmj 已提交
269
> - **意图相关→[IntentUtils.java][intent.java]**
C
cmj 已提交
270
 ```
B
Blankj 已提交
271 272 273 274 275 276 277 278 279
getInstallAppIntent        : 获取安装App(支持6.0)的意图
getUninstallAppIntent      : 获取卸载App的意图
getLaunchAppIntent         : 获取打开App的意图
getAppDetailsSettingsIntent: 获取App具体设置的意图
getShareTextIntent         : 获取分享文本的意图
getShareImageIntent        : 获取分享图片的意图
getComponentIntent         : 获取其他应用组件的意图
getShutdownIntent          : 获取关机的意图
getCaptureIntent           : 获取拍照的意图
C
cmj 已提交
280 281
 ```

C
cmj 已提交
282
> - **键盘相关→[KeyboardUtils.java][keyboard.java]→[Demo][keyboard.demo]**
C
cmj 已提交
283
 ```
B
Blankj 已提交
284 285 286 287
hideSoftInput               : 动态隐藏软键盘
clickBlankArea2HideSoftInput: 点击屏幕空白区域隐藏软键盘
showSoftInput               : 动态显示软键盘
toggleSoftInput             : 切换键盘显示与否状态
C
cmj 已提交
288 289
 ```

C
cmj 已提交
290
> - **定位相关→[LocationUtils.java][location.java]→[Demo][location.demo]**
B
Blankj 已提交
291
 ```
B
Blankj 已提交
292 293 294 295 296 297 298 299 300
isGpsEnabled     : 判断Gps是否可用
isLocationEnabled: 判断定位是否可用
openGpsSettings  : 打开Gps设置界面
register         : 注册
unregister       : 注销
getAddress       : 根据经纬度获取地理位置
getCountryName   : 根据经纬度获取所在国家
getLocality      : 根据经纬度获取所在地
getStreet        : 根据经纬度获取所在街道
B
Blankj 已提交
301 302
 ```

C
cmj 已提交
303
> - **日志相关→[LogUtils.java][log.java]→[Test][log.test]**
C
cmj 已提交
304
 ```
B
Blankj 已提交
305 306 307 308 309 310 311
init      : 初始化函数
getBuilder: 获取LogUtils建造者
v         : Verbose日志
d         : Debug日志
i         : Info日志
w         : Warn日志
e         : Error日志
C
cmj 已提交
312 313
 ```

C
cmj 已提交
314
> - **网络相关→[NetworkUtils.java][network.java]→[Demo][network.demo]**
C
cmj 已提交
315
 ```
B
Blankj 已提交
316 317 318 319 320 321 322 323 324 325 326 327 328 329
openWirelessSettings  : 打开网络设置界面
isConnected           : 判断网络是否连接
isAvailableByPing     : 判断网络是否可用
getDataEnabled        : 判断移动数据是否打开
setDataEnabled        : 打开或关闭移动数据
is4G                  : 判断网络是否是4G
getWifiEnabled        : 判断wifi是否打开
setWifiEnabled        : 打开或关闭wifi
isWifiConnected       : 判断wifi是否连接状态
isWifiAvailable       : 判断wifi数据是否可用
getNetworkOperatorName: 获取移动网络运营商名称
getNetworkType        : 获取当前网络类型
getIPAddress          : 获取IP地址
getDomainAddress      : 获取域名ip地址
C
cmj 已提交
330 331
 ```

C
cmj 已提交
332
> - **手机相关→[PhoneUtils.java][phone.java]→[Demo][phone.demo]**
C
cmj 已提交
333
 ```
B
Blankj 已提交
334 335 336 337 338 339 340 341 342 343 344 345 346 347 348
isPhone            : 判断设备是否是手机
getIMEI            : 获取IMEI码
getIMSI            : 获取IMSI码
getPhoneType       : 获取移动终端类型
isSimCardReady     : 判断sim卡是否准备好
getSimOperatorName : 获取Sim卡运营商名称
getSimOperatorByMnc: 获取Sim卡运营商名称
getPhoneStatus     : 获取手机状态信息
dial               : 跳至拨号界面
call               : 拨打phoneNumber
sendSms            : 跳至发送短信界面
sendSmsSilent      : 发送短信
getAllContactInfo  : 获取手机联系人
getContactNum      : 打开手机联系人界面点击联系人后便获取该号码
getAllSMS          : 获取手机短信并保存到xml中
C
cmj 已提交
349 350
 ```

B
Blankj 已提交
351 352 353
> - **拼音相关→[PinyinUtils.java][pinyin.java]→[Test][pinyin.test]**
 ```
ccs2Pinyin           : 汉字转拼音
B
Blankj 已提交
354 355 356
ccs2Pinyin           : 汉字转拼音
getPinyinFirstLetter : 获取第一个汉字首字母
getPinyinFirstLetters: 获取所有汉字的首字母
C
cmj 已提交
357 358
getSurnamePinyin     : 根据名字获取姓氏的拼音
getSurnameFirstLetter: 根据名字获取姓氏的首字母
B
Blankj 已提交
359 360
 ```

C
cmj 已提交
361
> - **进程相关→[ProcessUtils.java][process.java]→[Demo][process.demo]**
C
cmj 已提交
362
 ```
B
Blankj 已提交
363 364 365
getForegroundProcessName  : 获取前台线程包名
killAllBackgroundProcesses: 杀死所有的后台服务进程
killBackgroundProcesses   : 杀死后台服务进程
C
cmj 已提交
366 367
 ```

368
> - **正则相关→[RegexUtils.java][regex.java]→[Test][regex.test]**
C
cmj 已提交
369
 ```
B
Blankj 已提交
370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385
isMobileSimple : 验证手机号(简单)
isMobileExact  : 验证手机号(精确)
isTel          : 验证电话号码
isIDCard15     : 验证身份证号码15位
isIDCard18     : 验证身份证号码18位
isEmail        : 验证邮箱
isURL          : 验证URL
isZh           : 验证汉字
isUsername     : 验证用户名
isDate         : 验证yyyy-MM-dd格式的日期校验,已考虑平闰年
isIP           : 验证IP地址
isMatch        : 判断是否匹配正则
getMatches     : 获取正则匹配的部分
getSplits      : 获取正则匹配分组
getReplaceFirst: 替换正则匹配的第一部分
getReplaceAll  : 替换所有正则匹配的部分
C
cmj 已提交
386 387
 ```

388
> - **屏幕相关→[ScreenUtils.java][screen.java]**
C
cmj 已提交
389
 ```
B
Blankj 已提交
390 391 392 393 394 395 396 397 398 399
getScreenWidth         : 获取屏幕的宽度(单位:px)
getScreenHeight        : 获取屏幕的高度(单位:px)
setLandscape           : 设置屏幕为横屏
setPortrait            : 设置屏幕为竖屏
isLandscape            : 判断是否横屏
isPortrait             : 判断是否竖屏
getScreenRotation      : 获取屏幕旋转角度
captureWithStatusBar   : 获取当前屏幕截图,包含状态栏
captureWithoutStatusBar: 获取当前屏幕截图,不包含状态栏
isScreenLock           : 判断是否锁屏
C
cmj 已提交
400 401
 ```

C
cmj 已提交
402
> - **SD卡相关→[SDCardUtils.java][sdcard.java]→[Demo][sdcard.demo]**
C
cmj 已提交
403
 ```
B
Blankj 已提交
404 405 406 407 408
isSDCardEnable: 判断SD卡是否可用
getSDCardPath : 获取SD卡路径
getDataPath   : 获取SD卡Data路径
getFreeSpace  : 计算SD卡的剩余空间
getSDCardInfo : 获取SD卡信息
C
cmj 已提交
409 410
 ```

C
cmj 已提交
411
> - **服务相关→[ServiceUtils.java][service.java]**
C
cmj 已提交
412
 ```
B
Blankj 已提交
413 414 415 416 417 418
getAllRunningService: 获取所有运行的服务
startService        : 启动服务
stopService         : 停止服务
bindService         : 绑定服务
unbindService       : 解绑服务
isServiceRunning    : 判断服务是否运行
C
cmj 已提交
419 420
 ```

421
> - **Shell相关→[ShellUtils.java][shell.java]**
C
cmj 已提交
422
 ```
B
Blankj 已提交
423
execCmd: 是否是在root下执行命令
C
cmj 已提交
424 425
 ```

426
> - **尺寸相关→[SizeUtils.java][size.java]**
C
cmj 已提交
427
 ```
B
Blankj 已提交
428 429 430 431 432 433 434
dp2px, px2dp     : dp与px转换
sp2px, px2sp     : sp与px转换
applyDimension   : 各种单位转换
forceGetViewSize : 在onCreate中获取视图的尺寸
measureView      : 测量视图尺寸
getMeasuredWidth : 获取测量视图宽度
getMeasuredHeight: 获取测量视图高度
C
cmj 已提交
435 436
 ```

C
cmj 已提交
437
> - **Snackbar相关→[SnackbarUtils.java][snackbar.java]→[Demo][snackbar.demo]**
C
cmj 已提交
438
 ```
B
Blankj 已提交
439 440 441 442 443
showShortSnackbar     : 显示短时snackbar
showLongSnackbar      : 显示长时snackbar
showIndefiniteSnackbar: 显示自定义时长snackbar
addView               : 为SnackBar添加布局
dismissSnackbar       : 取消snackbar显示
C
cmj 已提交
444 445
 ```

B
Blankj 已提交
446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476
> - **SpannableString相关工具类→[SpannableStringUtils.java][spannable.java]→[Demo][spannable.demo]**
 ```
getBuilder        : 获取建造者
setFlag           : 设置标识
setForegroundColor: 设置前景色
setBackgroundColor: 设置背景色
setQuoteColor     : 设置引用线的颜色
setLeadingMargin  : 设置缩进
setBullet         : 设置列表标记
setProportion     : 设置字体比例
setXProportion    : 设置字体横向比例
setStrikethrough  : 设置删除线
setUnderline      : 设置下划线
setSuperscript    : 设置上标
setSubscript      : 设置下标
setBold           : 设置粗体
setItalic         : 设置斜体
setBoldItalic     : 设置粗斜体
setFontFamily     : 设置字体
setAlign          : 设置对齐
setBitmap         : 设置图片
setDrawable       : 设置图片
setUri            : 设置图片
setResourceId     : 设置图片
setClickSpan      : 设置点击事件
setUrl            : 设置超链接
setBlur           : 设置模糊
append            : 追加样式字符串
create            : 创建样式字符串
 ```

477
> - **SP相关→[SPUtils.java][sp.java]→[Test][sp.test]**
C
cmj 已提交
478
 ```
B
Blankj 已提交
479
SPUtils   : SPUtils构造函数
B
Blankj 已提交
480
put       : SP中写入数据
B
Blankj 已提交
481 482 483 484 485 486 487 488 489 490 491 492 493
getString : SP中读取String
putInt    : SP中写入int类型value
getInt    : SP中读取int
putLong   : SP中写入long类型value
getLong   : SP中读取long
putFloat  : SP中写入float类型value
getFloat  : SP中读取float
putBoolean: SP中写入boolean类型value
getBoolean: SP中读取boolean
getAll    : SP中获取所有键值对
remove    : SP中移除该key
contains  : SP中是否存在该key
clear     : SP中清除所有数据
C
cmj 已提交
494 495
 ```

496
> - **字符串相关→[StringUtils.java][string.java]→[Test][string.test]**
C
cmj 已提交
497
 ```
B
Blankj 已提交
498 499 500 501 502 503 504 505 506 507 508
isEmpty         : 判断字符串是否为null或长度为0
isSpace         : 判断字符串是否为null或全为空格
equals          : 判断两字符串是否相等
equalsIgnoreCase: 判断两字符串忽略大小写是否相等
null2Length0    : null转为长度为0的字符串
length          : 返回字符串长度
upperFirstLetter: 首字母大写
lowerFirstLetter: 首字母小写
reverse         : 反转字符串
toDBC           : 转化为半角字符
toSBC           : 转化为全角字符
C
cmj 已提交
509 510
 ```

C
cmj 已提交
511
> - **线程池相关→[ThreadPoolUtils.java][thread_pool.java]**
C
cmj 已提交
512
 ```
B
Blankj 已提交
513 514 515 516 517 518 519 520 521 522 523 524 525 526 527
ThreadPoolUtils       : ThreadPoolUtils构造函数
execute               : 在未来某个时间执行给定的命令
execute               : 在未来某个时间执行给定的命令链表
shutDown              : 待以前提交的任务执行完毕后关闭线程池
shutDownNow           : 试图停止所有正在执行的活动任务
isShutDown            : 判断线程池是否已关闭
isTerminated          : 关闭线程池后判断所有任务是否都已完成
awaitTermination      : 请求关闭、发生超时或者当前线程中断
submit                : 提交一个Callable任务用于执行
submit                : 提交一个Runnable任务用于执行
invokeAll, invokeAny  : 执行给定的任务
schedule              : 延迟执行Runnable命令
schedule              : 延迟执行Callable命令
scheduleWithFixedRate : 延迟并循环执行命令
scheduleWithFixedDelay: 延迟并以固定休息时间循环执行命令
C
cmj 已提交
528 529
 ```

530
> - **时间相关→[TimeUtils.java][time.java]→[Test][time.test]**
C
cmj 已提交
531
 ```
B
Blankj 已提交
532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552
millis2String           : 将时间戳转为时间字符串
string2Millis           : 将时间字符串转为时间戳
string2Date             : 将时间字符串转为Date类型
date2String             : 将Date类型转为时间字符串
date2Millis             : 将Date类型转为时间戳
millis2Date             : 将时间戳转为Date类型
getTimeSpan             : 获取两个时间差(单位:unit)
getFitTimeSpan          : 获取合适型两个时间差
getNowTimeMills         : 获取当前毫秒时间戳
getNowTimeString        : 获取当前时间字符串
getNowTimeDate          : 获取当前Date
getTimeSpanByNow        : 获取与当前时间的差(单位:unit)
getFitTimeSpanByNow     : 获取合适型与当前时间的差
getFriendlyTimeSpanByNow: 获取友好型与当前时间的差
isSameDay               : 判断是否同一天
isLeapYear              : 判断是否闰年
getWeek, getWeekIndex   : 获取星期
getWeekOfMonth          : 获取月份中的第几周
getWeekOfYear           : 获取年份中的第几周
getChineseZodiac        : 获取生肖
getZodiac               : 获取星座
C
cmj 已提交
553 554
 ```

C
cmj 已提交
555
> - **吐司相关→[ToastUtils.java][toast.java]→[Demo][toast.demo]**
C
cmj 已提交
556
 ```
B
Blankj 已提交
557 558 559 560 561 562
init              : 吐司初始化
showShortToastSafe: 安全地显示短时吐司
showLongToastSafe : 安全地显示长时吐司
showShortToast    : 显示短时吐司
showLongToast     : 显示长时吐司
cancelToast       : 取消吐司显示
C
cmj 已提交
563 564
 ```

C
cmj 已提交
565
> - **压缩相关→[ZipUtils.java][zip.java]→[Test][zip.test]**
C
cmj 已提交
566
 ```
B
Blankj 已提交
567 568 569 570 571 572 573 574
zipFiles          : 批量压缩文件
zipFile           : 压缩文件
unzipFiles        : 批量解压文件
unzipFile         : 解压文件
unzipFileByKeyword: 解压带有关键字的文件
getFilesPath      : 获取压缩文件中的文件路径链表
getComments       : 获取压缩文件中的注释链表
getEntries        : 获取压缩文件中的文件对象
C
cmj 已提交
575 576
 ```

577 578 579
> - **更新Log→[update_log.md][update_log.md]**

***
C
cmj 已提交
580

C
cmj 已提交
581
## About
C
cmj 已提交
582

B
Blankj 已提交
583
* 做这份整理是想把它作为Android开发的小字典,当遇到一些琐碎问题时,不用再面向百度或者谷歌查询API的使用,费时费力,这里有的话,大家尽管撸走;同时也希望它能逐日壮大起来,期待大家的Star和完善,当然我也会一直更新发布版本和日志,为了方便大家导入,现已上传jcenter;其中很多代码也是汇四方之精华,谢谢前辈们的提供,当然最终还是要通过单元测试的,如有错误,请及时告之。
C
cmj 已提交
584
* QQ群提供讨论,1群:74721490(已满)2群:25206533,至于验证问题对大家来说肯定都是小case。关于群:[在别人生活里低调地做配角(我和466个程序员的故事)][group]
B
Blankj 已提交
585
* 我的[微博][weibo],求个关注哈。
586

C
cmj 已提交
587
## Download
C
cmj 已提交
588

589 590
Gradle:
``` groovy
B
Blankj 已提交
591
compile 'com.blankj:utilcode:1.3.6'
592 593
```

C
cmj 已提交
594
## How to use
C
cmj 已提交
595

C
cmj 已提交
596
```
C
cmj 已提交
597
Utils.init(context);
C
cmj 已提交
598 599
```

C
cmj 已提交
600
## Proguard
C
cmj 已提交
601

602 603
```
-keep class com.blankj.utilcode.** { *; }
C
cmj 已提交
604
-keepclassmembers class com.blankj.utilcode.** { *; }
605 606 607
-dontwarn com.blankj.utilcode.**
```

C
cmj 已提交
608
## License
C
cmj 已提交
609

610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625
```
Copyright 2016 Blankj

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.
```

C
cmj 已提交
626 627 628 629 630
[update_log.md]: https://github.com/Blankj/AndroidUtilCode/blob/master/update_log.md

[readme.md]: https://github.com/Blankj/AndroidUtilCode
[readme-cn.md]: https://github.com/Blankj/AndroidUtilCode/blob/master/README-CN.md

C
cmj 已提交
631
[activity.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ActivityUtils.java
B
Blankj 已提交
632
[activity.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/ActivityActivity.java
C
cmj 已提交
633

634
[app.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/AppUtils.java
B
Blankj 已提交
635
[app.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/AppActivity.java
636

C
cmj 已提交
637 638 639
[bar.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/BarUtils.java

[clean.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/CleanUtils.java
B
Blankj 已提交
640
[clean.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/CleanActivity.java
C
cmj 已提交
641 642 643 644 645

[clipboard.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ClipboardUtils.java

[close.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/CloseUtils.java

646 647 648 649 650
[const.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ConstUtils.java

[convert.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ConvertUtils.java
[convert.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/ConvertUtilsTest.java

C
cmj 已提交
651 652
[crash.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/CrashUtils.java

653
[device.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/DeviceUtils.java
B
Blankj 已提交
654
[device.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/DeviceActivity.java
655

C
cmj 已提交
656 657 658
[empty.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/EmptyUtils.java
[empty.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/EmptyUtilsTest.java

659 660 661 662 663 664 665 666 667
[encode.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/EncodeUtils.java
[encode.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/EncodeUtilsTest.java

[encrypt.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/EncryptUtils.java
[encrypt.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/EncryptUtilsTest.java

[file.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/FileUtils.java
[file.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/FileUtilsTest.java

B
Blankj 已提交
668
[fragment.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/FragmentUtils.java
B
Blankj 已提交
669
[fragment.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/FragmentActivity.java
B
Blankj 已提交
670

C
cmj 已提交
671
[handler.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/HandlerUtils.java
B
Blankj 已提交
672
[handler.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/HandlerActivity.java
C
cmj 已提交
673

674
[image.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ImageUtils.java
B
Blankj 已提交
675
[image.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/ImageActivity.java
676

C
cmj 已提交
677 678
[intent.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/IntentUtils.java

679
[keyboard.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/KeyboardUtils.java
B
Blankj 已提交
680
[keyboard.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/KeyboardActivity.java
681

B
Blankj 已提交
682
[location.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/LocationUtils.java
B
Blankj 已提交
683
[location.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/LocationActivity.java
B
Blankj 已提交
684

C
cmj 已提交
685 686 687
[log.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/LogUtils.java
[log.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/LogUtilsTest.java

688
[network.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/NetworkUtils.java
B
Blankj 已提交
689
[network.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/NetworkActivity.java
690 691

[phone.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/PhoneUtils.java
B
Blankj 已提交
692
[phone.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/PhoneActivity.java
693

B
Blankj 已提交
694 695 696
[pinyin.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/PinyinUtils.java
[pinyin.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/PinyinUtilsTest.java

C
cmj 已提交
697
[process.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ProcessUtils.java
B
Blankj 已提交
698
[process.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/ProcessActivity.java
C
cmj 已提交
699

700 701 702 703 704 705
[regex.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/RegexUtils.java
[regex.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/RegexUtilsTest.java

[screen.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ScreenUtils.java

[sdcard.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/SDCardUtils.java
B
Blankj 已提交
706
[sdcard.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/SDCardActivity.java
707

C
cmj 已提交
708 709
[service.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ServiceUtils.java

710 711 712 713
[shell.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ShellUtils.java

[size.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/SizeUtils.java

C
cmj 已提交
714
[snackbar.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/SnackbarUtils.java
B
Blankj 已提交
715
[snackbar.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/SnackbarActivity.java
C
cmj 已提交
716

B
Blankj 已提交
717
[spannable.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/SpannableStringUtils.java
B
Blankj 已提交
718
[spannable.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/SpannableActivity.java
B
Blankj 已提交
719

720 721 722 723 724 725 726 727 728 729 730
[sp.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/SPUtils.java
[sp.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/SPUtilsTest.java

[string.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/StringUtils.java
[string.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/StringUtilsTest.java

[thread_pool.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ThreadPoolUtils.java

[time.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/TimeUtils.java
[time.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/TimeUtilsTest.java

C
cmj 已提交
731
[toast.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ToastUtils.java
B
Blankj 已提交
732
[toast.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/ToastActivity.java
733 734 735 736

[zip.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/utils/ZipUtils.java
[zip.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/utils/ZipUtilsTest.java

C
cmj 已提交
737
[group]: http://www.jianshu.com/p/8938015df951
C
cmj 已提交
738
[weibo]: http://weibo.com/blankcmj