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

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

B
Blankj 已提交
5
## API
C
cmj 已提交
6

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

B
Blankj 已提交
14
* ### App相关→[AppUtils.java][app.java][Demo][app.demo]
B
Blankj 已提交
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所有数据
B
Blankj 已提交
39
```
C
cmj 已提交
40

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

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

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

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

B
Blankj 已提交
79
* ### 转换相关→[ConvertUtils.java][convert.java][Test][convert.test]
B
Blankj 已提交
80
```
B
Blankj 已提交
81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98
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互转
B
Blankj 已提交
99
```
C
cmj 已提交
100

B
Blankj 已提交
101
* ### 崩溃相关→[CrashUtils.java][crash.java]
B
Blankj 已提交
102
```
B
Blankj 已提交
103 104
getInstance: 获取单例
init       : 初始化
B
Blankj 已提交
105
```
C
cmj 已提交
106

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

B
Blankj 已提交
121
* ### 判空相关→[EmptyUtils.java][empty.java][Test][empty.test]
B
Blankj 已提交
122
```
B
Blankj 已提交
123 124
isEmpty   : 判断对象是否为空
isNotEmpty: 判断对象是否非空
B
Blankj 已提交
125
```
C
cmj 已提交
126

B
Blankj 已提交
127
* ### 编码解码相关→[EncodeUtils.java][encode.java][Test][encode.test]
B
Blankj 已提交
128
```
B
Blankj 已提交
129 130 131 132 133 134 135 136
urlEncode          : URL编码
urlDecode          : URL解码
base64Encode       : Base64编码
base64Encode2String: Base64编码
base64Decode       : Base64解码
base64UrlSafeEncode: Base64URL安全编码
htmlEncode         : Html编码
htmlDecode         : Html解码
B
Blankj 已提交
137
```
C
cmj 已提交
138

B
Blankj 已提交
139
* ### 加密解密相关→[EncryptUtils.java][encrypt.java][Test][encrypt.test]
B
Blankj 已提交
140
```
B
Blankj 已提交
141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160
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解密
B
Blankj 已提交
161
```
C
cmj 已提交
162

B
Blankj 已提交
163
* ### 文件相关→[FileUtils.java][file.java][Test][file.test]
B
Blankj 已提交
164
```
B
Blankj 已提交
165 166 167 168 169 170 171 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
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         : 根据全路径获取文件拓展名
B
Blankj 已提交
204
```
C
cmj 已提交
205

B
Blankj 已提交
206
* ### Fragment相关→[FragmentUtils.java][fragment.java][Demo][fragment.demo]
B
Blankj 已提交
207
```
B
Blankj 已提交
208
addFragment              : 新增fragment
B
Blankj 已提交
209
hideAddFragment          : 先隐藏后新增fragment
B
Blankj 已提交
210
addFragments             : 新增多个fragment
B
Blankj 已提交
211
removeFragment           : 移除fragment
B
Blankj 已提交
212 213 214
removeToFragment         : 移除到指定fragment
removeFragments          : 移除同级别fragment
removeAllFragments       : 移除所有fragment
B
Blankj 已提交
215
replaceFragment          : 替换fragment
B
Blankj 已提交
216 217
popFragment              : 出栈fragment
popToFragment            : 出栈到指定fragment
B
Blankj 已提交
218 219
popFragments             : 出栈同级别fragment
popAllFragments          : 出栈所有fragment
B
Blankj 已提交
220 221
popAddFragment           : 先出栈后新增fragment
hideFragment             : 隐藏fragment
B
Blankj 已提交
222
hideFragments            : 隐藏同级别fragment
B
Blankj 已提交
223 224
showFragment             : 显示fragment
hideShowFragment         : 先隐藏后显示fragment
B
Blankj 已提交
225 226
getLastAddFragment       : 获取同级别最后加入的fragment
getLastAddFragmentInStack: 获取栈中同级别最后加入的fragment
B
Blankj 已提交
227 228
getTopShowFragment       : 获取顶层可见fragment
getTopShowFragmentInStack: 获取栈中顶层可见fragment
B
Blankj 已提交
229 230
getFragments             : 获取同级别fragment
getFragmentsInStack      : 获取栈中同级别fragment
B
Blankj 已提交
231 232
getAllFragments          : 获取所有fragment
getAllFragmentsInStack   : 获取栈中所有fragment
B
Blankj 已提交
233
getPreFragment           : 获取目标fragment的前一个fragment
B
Blankj 已提交
234 235
findFragment             : 查找fragment
dispatchBackPress        : 处理fragment回退键
B
Blankj 已提交
236 237 238
setBackgroundColor       : 设置背景色
setBackgroundResource    : 设置背景资源
setBackground            : 设置背景
B
Blankj 已提交
239
```
B
Blankj 已提交
240

B
Blankj 已提交
241
* ### Handler相关→[HandlerUtils.java][handler.java][Demo][handler.demo]
B
Blankj 已提交
242
```
B
Blankj 已提交
243
HandlerHolder: 使用必读
B
Blankj 已提交
244
```
C
cmj 已提交
245

B
Blankj 已提交
246
* ### 图片相关→[ImageUtils.java][image.java][Demo][image.demo]
B
Blankj 已提交
247
```
B
Blankj 已提交
248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273
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            : 按采样大小压缩
B
Blankj 已提交
274
```
C
cmj 已提交
275

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

B
Blankj 已提交
289
* ### 键盘相关→[KeyboardUtils.java][keyboard.java][Demo][keyboard.demo]
B
Blankj 已提交
290
```
B
Blankj 已提交
291 292 293 294
hideSoftInput               : 动态隐藏软键盘
clickBlankArea2HideSoftInput: 点击屏幕空白区域隐藏软键盘
showSoftInput               : 动态显示软键盘
toggleSoftInput             : 切换键盘显示与否状态
B
Blankj 已提交
295
```
C
cmj 已提交
296

B
Blankj 已提交
297
* ### 定位相关→[LocationUtils.java][location.java][Demo][location.demo]
B
Blankj 已提交
298
```
B
Blankj 已提交
299 300 301 302 303 304 305 306 307
isGpsEnabled     : 判断Gps是否可用
isLocationEnabled: 判断定位是否可用
openGpsSettings  : 打开Gps设置界面
register         : 注册
unregister       : 注销
getAddress       : 根据经纬度获取地理位置
getCountryName   : 根据经纬度获取所在国家
getLocality      : 根据经纬度获取所在地
getStreet        : 根据经纬度获取所在街道
B
Blankj 已提交
308
```
B
Blankj 已提交
309

B
Blankj 已提交
310
* ### 日志相关→[LogUtils.java][log.java][Demo][log.demo]
B
Blankj 已提交
311
```
B
Blankj 已提交
312 313 314 315 316 317 318
Builder.setLogSwitch     : 设置log总开关
Builder.setGlobalTag     : 设置log全局tag
Builder.setLogHeadSwitch : 设置log头开关
Builder.setLog2FileSwitch: 设置log文件开关
Builder.setBorderSwitch  : 设置log边框开关
Builder.setLogFilter     : 设置log过滤器

B
Blankj 已提交
319 320 321 322 323 324 325 326 327
v   : Verbose日志
d   : Debug日志
i   : Info日志
w   : Warn日志
e   : Error日志
a   : Assert日志
file: log到文件
json: log字符串之json
xml : log字符串之xml
B
Blankj 已提交
328
```
C
cmj 已提交
329

B
Blankj 已提交
330
* ### 网络相关→[NetworkUtils.java][network.java][Demo][network.demo]
B
Blankj 已提交
331
```
B
Blankj 已提交
332 333 334 335 336 337 338 339 340 341 342 343 344 345
openWirelessSettings  : 打开网络设置界面
isConnected           : 判断网络是否连接
isAvailableByPing     : 判断网络是否可用
getDataEnabled        : 判断移动数据是否打开
setDataEnabled        : 打开或关闭移动数据
is4G                  : 判断网络是否是4G
getWifiEnabled        : 判断wifi是否打开
setWifiEnabled        : 打开或关闭wifi
isWifiConnected       : 判断wifi是否连接状态
isWifiAvailable       : 判断wifi数据是否可用
getNetworkOperatorName: 获取移动网络运营商名称
getNetworkType        : 获取当前网络类型
getIPAddress          : 获取IP地址
getDomainAddress      : 获取域名ip地址
B
Blankj 已提交
346
```
C
cmj 已提交
347

B
Blankj 已提交
348
* ### 手机相关→[PhoneUtils.java][phone.java][Demo][phone.demo]
B
Blankj 已提交
349
```
B
Blankj 已提交
350 351 352 353 354 355 356 357 358 359 360 361 362 363 364
isPhone            : 判断设备是否是手机
getIMEI            : 获取IMEI码
getIMSI            : 获取IMSI码
getPhoneType       : 获取移动终端类型
isSimCardReady     : 判断sim卡是否准备好
getSimOperatorName : 获取Sim卡运营商名称
getSimOperatorByMnc: 获取Sim卡运营商名称
getPhoneStatus     : 获取手机状态信息
dial               : 跳至拨号界面
call               : 拨打phoneNumber
sendSms            : 跳至发送短信界面
sendSmsSilent      : 发送短信
getAllContactInfo  : 获取手机联系人
getContactNum      : 打开手机联系人界面点击联系人后便获取该号码
getAllSMS          : 获取手机短信并保存到xml中
B
Blankj 已提交
365
```
C
cmj 已提交
366

B
Blankj 已提交
367
* ### 拼音相关→[PinyinUtils.java][pinyin.java][Test][pinyin.test]
B
Blankj 已提交
368
```
B
Blankj 已提交
369
ccs2Pinyin           : 汉字转拼音
B
Blankj 已提交
370 371 372
ccs2Pinyin           : 汉字转拼音
getPinyinFirstLetter : 获取第一个汉字首字母
getPinyinFirstLetters: 获取所有汉字的首字母
C
cmj 已提交
373 374
getSurnamePinyin     : 根据名字获取姓氏的拼音
getSurnameFirstLetter: 根据名字获取姓氏的首字母
B
Blankj 已提交
375
```
B
Blankj 已提交
376

B
Blankj 已提交
377
* ### 进程相关→[ProcessUtils.java][process.java][Demo][process.demo]
B
Blankj 已提交
378
```
B
Blankj 已提交
379 380 381
getForegroundProcessName  : 获取前台线程包名
killAllBackgroundProcesses: 杀死所有的后台服务进程
killBackgroundProcesses   : 杀死后台服务进程
B
Blankj 已提交
382
```
C
cmj 已提交
383

B
Blankj 已提交
384
* ### 正则相关→[RegexUtils.java][regex.java][Test][regex.test]
B
Blankj 已提交
385
```
B
Blankj 已提交
386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401
isMobileSimple : 验证手机号(简单)
isMobileExact  : 验证手机号(精确)
isTel          : 验证电话号码
isIDCard15     : 验证身份证号码15位
isIDCard18     : 验证身份证号码18位
isEmail        : 验证邮箱
isURL          : 验证URL
isZh           : 验证汉字
isUsername     : 验证用户名
isDate         : 验证yyyy-MM-dd格式的日期校验,已考虑平闰年
isIP           : 验证IP地址
isMatch        : 判断是否匹配正则
getMatches     : 获取正则匹配的部分
getSplits      : 获取正则匹配分组
getReplaceFirst: 替换正则匹配的第一部分
getReplaceAll  : 替换所有正则匹配的部分
B
Blankj 已提交
402
```
C
cmj 已提交
403

B
Blankj 已提交
404
* ### 屏幕相关→[ScreenUtils.java][screen.java]
B
Blankj 已提交
405
```
B
Blankj 已提交
406 407 408 409 410 411 412 413 414 415
getScreenWidth         : 获取屏幕的宽度(单位:px)
getScreenHeight        : 获取屏幕的高度(单位:px)
setLandscape           : 设置屏幕为横屏
setPortrait            : 设置屏幕为竖屏
isLandscape            : 判断是否横屏
isPortrait             : 判断是否竖屏
getScreenRotation      : 获取屏幕旋转角度
captureWithStatusBar   : 获取当前屏幕截图,包含状态栏
captureWithoutStatusBar: 获取当前屏幕截图,不包含状态栏
isScreenLock           : 判断是否锁屏
B
Blankj 已提交
416
```
C
cmj 已提交
417

B
Blankj 已提交
418
* ### SD卡相关→[SDCardUtils.java][sdcard.java][Demo][sdcard.demo]
B
Blankj 已提交
419
```
B
Blankj 已提交
420 421 422 423 424
isSDCardEnable: 判断SD卡是否可用
getSDCardPath : 获取SD卡路径
getDataPath   : 获取SD卡Data路径
getFreeSpace  : 计算SD卡的剩余空间
getSDCardInfo : 获取SD卡信息
B
Blankj 已提交
425
```
C
cmj 已提交
426

B
Blankj 已提交
427
* ### 服务相关→[ServiceUtils.java][service.java]
B
Blankj 已提交
428
```
B
Blankj 已提交
429 430 431 432 433 434
getAllRunningService: 获取所有运行的服务
startService        : 启动服务
stopService         : 停止服务
bindService         : 绑定服务
unbindService       : 解绑服务
isServiceRunning    : 判断服务是否运行
B
Blankj 已提交
435
```
C
cmj 已提交
436

B
Blankj 已提交
437
* ### Shell相关→[ShellUtils.java][shell.java]
B
Blankj 已提交
438
```
B
Blankj 已提交
439
execCmd: 是否是在root下执行命令
B
Blankj 已提交
440
```
C
cmj 已提交
441

B
Blankj 已提交
442
* ### 尺寸相关→[SizeUtils.java][size.java]
B
Blankj 已提交
443
```
B
Blankj 已提交
444 445 446 447 448 449 450
dp2px, px2dp     : dp与px转换
sp2px, px2sp     : sp与px转换
applyDimension   : 各种单位转换
forceGetViewSize : 在onCreate中获取视图的尺寸
measureView      : 测量视图尺寸
getMeasuredWidth : 获取测量视图宽度
getMeasuredHeight: 获取测量视图高度
B
Blankj 已提交
451
```
C
cmj 已提交
452

B
Blankj 已提交
453
* ### Snackbar相关→[SnackbarUtils.java][snackbar.java][Demo][snackbar.demo]
B
Blankj 已提交
454
```
B
Blankj 已提交
455 456 457 458 459
showShortSnackbar     : 显示短时snackbar
showLongSnackbar      : 显示长时snackbar
showIndefiniteSnackbar: 显示自定义时长snackbar
addView               : 为SnackBar添加布局
dismissSnackbar       : 取消snackbar显示
B
Blankj 已提交
460
```
C
cmj 已提交
461

B
Blankj 已提交
462
* ### SpannableString相关→[SpannableStringUtils.java][spannable.java][Demo][spannable.demo]
B
Blankj 已提交
463
```
B
Blankj 已提交
464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490
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            : 创建样式字符串
B
Blankj 已提交
491
```
B
Blankj 已提交
492

B
Blankj 已提交
493
* ### SP相关→[SPUtils.java][sp.java][Test][sp.test]
B
Blankj 已提交
494
```
B
Blankj 已提交
495
SPUtils   : SPUtils构造函数
B
Blankj 已提交
496
put       : SP中写入数据
B
Blankj 已提交
497 498 499 500 501 502 503 504 505 506 507 508 509
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中清除所有数据
B
Blankj 已提交
510
```
C
cmj 已提交
511

B
Blankj 已提交
512
* ### 字符串相关→[StringUtils.java][string.java][Test][string.test]
B
Blankj 已提交
513
```
B
Blankj 已提交
514
isEmpty         : 判断字符串是否为null或长度为0
B
Blankj 已提交
515 516
isTrimEmpty     : 判断字符串是否为null或全为空格
isSpace         : 判断字符串是否为null或全为空白字符
B
Blankj 已提交
517 518 519 520 521 522 523 524 525
equals          : 判断两字符串是否相等
equalsIgnoreCase: 判断两字符串忽略大小写是否相等
null2Length0    : null转为长度为0的字符串
length          : 返回字符串长度
upperFirstLetter: 首字母大写
lowerFirstLetter: 首字母小写
reverse         : 反转字符串
toDBC           : 转化为半角字符
toSBC           : 转化为全角字符
B
Blankj 已提交
526
```
C
cmj 已提交
527

B
Blankj 已提交
528
* ### 线程池相关→[ThreadPoolUtils.java][thread_pool.java]
B
Blankj 已提交
529
```
B
Blankj 已提交
530 531 532 533 534 535 536 537 538 539 540 541 542 543 544
ThreadPoolUtils       : ThreadPoolUtils构造函数
execute               : 在未来某个时间执行给定的命令
execute               : 在未来某个时间执行给定的命令链表
shutDown              : 待以前提交的任务执行完毕后关闭线程池
shutDownNow           : 试图停止所有正在执行的活动任务
isShutDown            : 判断线程池是否已关闭
isTerminated          : 关闭线程池后判断所有任务是否都已完成
awaitTermination      : 请求关闭、发生超时或者当前线程中断
submit                : 提交一个Callable任务用于执行
submit                : 提交一个Runnable任务用于执行
invokeAll, invokeAny  : 执行给定的任务
schedule              : 延迟执行Runnable命令
schedule              : 延迟执行Callable命令
scheduleWithFixedRate : 延迟并循环执行命令
scheduleWithFixedDelay: 延迟并以固定休息时间循环执行命令
B
Blankj 已提交
545
```
C
cmj 已提交
546

B
Blankj 已提交
547
* ### 时间相关→[TimeUtils.java][time.java][Test][time.test]
B
Blankj 已提交
548
```
B
Blankj 已提交
549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569
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               : 获取星座
B
Blankj 已提交
570
```
C
cmj 已提交
571

B
Blankj 已提交
572
* ### 吐司相关→[ToastUtils.java][toast.java][Demo][toast.demo]
B
Blankj 已提交
573
```
B
Blankj 已提交
574 575 576 577 578 579
init              : 吐司初始化
showShortToastSafe: 安全地显示短时吐司
showLongToastSafe : 安全地显示长时吐司
showShortToast    : 显示短时吐司
showLongToast     : 显示长时吐司
cancelToast       : 取消吐司显示
B
Blankj 已提交
580
```
C
cmj 已提交
581

B
Blankj 已提交
582
* ### 压缩相关→[ZipUtils.java][zip.java][Test][zip.test]
B
Blankj 已提交
583
```
B
Blankj 已提交
584 585 586 587 588 589 590 591
zipFiles          : 批量压缩文件
zipFile           : 压缩文件
unzipFiles        : 批量解压文件
unzipFile         : 解压文件
unzipFileByKeyword: 解压带有关键字的文件
getFilesPath      : 获取压缩文件中的文件路径链表
getComments       : 获取压缩文件中的注释链表
getEntries        : 获取压缩文件中的文件对象
B
Blankj 已提交
592
```
C
cmj 已提交
593

B
Blankj 已提交
594
* ### 更新Log→[update_log.md][update_log.md]
595 596

***
C
cmj 已提交
597

C
cmj 已提交
598
## About
C
cmj 已提交
599

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

C
cmj 已提交
604
## Download
C
cmj 已提交
605

606 607
Gradle:
``` groovy
B
Blankj 已提交
608
compile 'com.blankj:utilcode:1.3.8'
609 610
```

C
cmj 已提交
611
## How to use
C
cmj 已提交
612

C
cmj 已提交
613
```
C
cmj 已提交
614
Utils.init(context);
C
cmj 已提交
615 616
```

C
cmj 已提交
617
## Proguard
C
cmj 已提交
618

619 620
```
-keep class com.blankj.utilcode.** { *; }
C
cmj 已提交
621
-keepclassmembers class com.blankj.utilcode.** { *; }
622 623 624
-dontwarn com.blankj.utilcode.**
```

C
cmj 已提交
625
## License
C
cmj 已提交
626

627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642
```
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 已提交
643 644 645 646 647
[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

B
Blankj 已提交
648
[activity.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ActivityUtils.java
B
Blankj 已提交
649
[activity.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/ActivityActivity.java
C
cmj 已提交
650

B
Blankj 已提交
651
[app.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/AppUtils.java
B
Blankj 已提交
652
[app.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/AppActivity.java
653

B
Blankj 已提交
654
[bar.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/BarUtils.java
C
cmj 已提交
655

B
Blankj 已提交
656
[clean.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/CleanUtils.java
B
Blankj 已提交
657
[clean.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/CleanActivity.java
C
cmj 已提交
658

B
Blankj 已提交
659
[clipboard.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ClipboardUtils.java
C
cmj 已提交
660

B
Blankj 已提交
661
[close.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/CloseUtils.java
662

B
Blankj 已提交
663 664
[convert.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ConvertUtils.java
[convert.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/ConvertUtilsTest.java
665

B
Blankj 已提交
666
[crash.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/CrashUtils.java
C
cmj 已提交
667

B
Blankj 已提交
668
[device.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/DeviceUtils.java
B
Blankj 已提交
669
[device.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/DeviceActivity.java
670

B
Blankj 已提交
671 672
[empty.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/EmptyUtils.java
[empty.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/EmptyUtilsTest.java
C
cmj 已提交
673

B
Blankj 已提交
674 675
[encode.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/EncodeUtils.java
[encode.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/EncodeUtilsTest.java
676

B
Blankj 已提交
677 678
[encrypt.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/EncryptUtils.java
[encrypt.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/EncryptUtilsTest.java
679

B
Blankj 已提交
680 681
[file.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/FileUtils.java
[file.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/FileUtilsTest.java
682

B
Blankj 已提交
683
[fragment.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/FragmentUtils.java
B
Blankj 已提交
684
[fragment.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/FragmentActivity.java
B
Blankj 已提交
685

B
Blankj 已提交
686
[handler.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/HandlerUtils.java
B
Blankj 已提交
687
[handler.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/HandlerActivity.java
C
cmj 已提交
688

B
Blankj 已提交
689
[image.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ImageUtils.java
B
Blankj 已提交
690
[image.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/ImageActivity.java
691

B
Blankj 已提交
692
[intent.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/IntentUtils.java
C
cmj 已提交
693

B
Blankj 已提交
694
[keyboard.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/KeyboardUtils.java
B
Blankj 已提交
695
[keyboard.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/KeyboardActivity.java
696

B
Blankj 已提交
697
[location.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/LocationUtils.java
B
Blankj 已提交
698
[location.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/LocationActivity.java
B
Blankj 已提交
699

B
Blankj 已提交
700
[log.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/LogUtils.java
B
Blankj 已提交
701
[log.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/LogActivity.java
C
cmj 已提交
702

B
Blankj 已提交
703
[network.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/NetworkUtils.java
B
Blankj 已提交
704
[network.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/NetworkActivity.java
705

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

B
Blankj 已提交
709 710
[pinyin.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/PinyinUtils.java
[pinyin.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/PinyinUtilsTest.java
B
Blankj 已提交
711

B
Blankj 已提交
712
[process.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ProcessUtils.java
B
Blankj 已提交
713
[process.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/ProcessActivity.java
C
cmj 已提交
714

B
Blankj 已提交
715 716
[regex.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/RegexUtils.java
[regex.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/RegexUtilsTest.java
717

B
Blankj 已提交
718
[screen.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ScreenUtils.java
719

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

B
Blankj 已提交
723
[service.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ServiceUtils.java
C
cmj 已提交
724

B
Blankj 已提交
725
[shell.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ShellUtils.java
726

B
Blankj 已提交
727
[size.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/SizeUtils.java
728

B
Blankj 已提交
729
[snackbar.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/SnackbarUtils.java
B
Blankj 已提交
730
[snackbar.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/SnackbarActivity.java
C
cmj 已提交
731

B
Blankj 已提交
732
[spannable.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/SpannableStringUtils.java
B
Blankj 已提交
733
[spannable.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/SpannableActivity.java
B
Blankj 已提交
734

B
Blankj 已提交
735 736
[sp.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/SPUtils.java
[sp.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/SPUtilsTest.java
737

B
Blankj 已提交
738 739
[string.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/StringUtils.java
[string.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/StringUtilsTest.java
740

B
Blankj 已提交
741
[thread_pool.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ThreadPoolUtils.java
742

B
Blankj 已提交
743 744
[time.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/TimeUtils.java
[time.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/TimeUtilsTest.java
745

B
Blankj 已提交
746
[toast.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ToastUtils.java
B
Blankj 已提交
747
[toast.demo]: https://github.com/Blankj/AndroidUtilCode/blob/master/app/src/main/java/com/blankj/androidutilcode/activity/ToastActivity.java
748

B
Blankj 已提交
749 750
[zip.java]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/main/java/com/blankj/utilcode/util/ZipUtils.java
[zip.test]: https://github.com/Blankj/AndroidUtilCode/blob/master/utilcode/src/test/java/com/blankj/utilcode/util/ZipUtilsTest.java
751

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