zftlive/README.md

# 简介

   zftlive，顾名思义“曾繁添的生活”，我是一个追求技术的代码狂，我的生活很单纯，占据我大部分生活的是代码，在工作之余整理/沉淀自己所学、所能，一方面可以记录一下，方便日后使用、开发；另一方面开源共享可以帮助一些需要这方面资源的同学，两全其美的事情何乐而不为。

   本项目集成目前Android主流优秀第三方组件、优秀好用的自定义控件、实用工具类封装、以及一些APP共通模块（比如：版本更新、意见反馈、引导界面、基础的本地数据库操作、网络通信、图片加载等功能）。最新源码已推送[github][24]，演示apk请移步至[应用宝][25]、[360手机市场][26]。

   下图是最初建立项目需要集成功能的大致雏形图，当然目前有些功能还没集成进来，后续完成。毕竟个人工作之余时间精力有限，需要整理相关文档、调研相应的技术点，更新进度会有些缓慢，请大家理解。

![安卓架构雏形图](https://gitee.com/zftlive/zftlive/blob/master/docs/snapshot/Android-Framework-Desgin.jpg "安卓架构雏形图")
#如何使用

 1. 环境准备：Eclipse Kepler  + ADT23 + Android SDK 4.4.2 (19) + git 
   请确保本地含有Android SDK4.4.2，如果没有可以更新SDK，更新资源使用代理或者翻墙。[国内Android开发相关资源][15]，可以不用翻墙。懒得搭建环境的同学，可以去下载作者的[集成环境][16]，下载解压查看readme.txt

 2. 安装编译
    - 说明：
    - - zftlive最新版本将base/tools/widget等共性的内容(com.zftlive.android.library包下的内容)抽取成独立类库【AjavaAndroidLib】，主要是方便使用以及维护，sample引用该工程使用。开发者可以直接签出类库工程即可，查看具体如何使用以及相关写法可下载sample
    - 最新代码托管在OSC：
    - - zftlive这个是最初始版本，维护不是那么及时，请根据自己环境下载[Eclipse版本][17]，[AndroidStudio版本][18]；
    - - AjavaAndroidLib，工程引入该类库并且在**AndroidManifest.xml**配置自定义Application为*MApplication或其子类*即可使用，根据自己环境下载 [Eclipse版][19]，[AndroidStudio版][20]；
    - - AjavaAndroidLib使用Sample工程，请根据自己环境下载：[Eclipse版][21]，[AndroidStudio版][22]。
    - - 直接使用git签出到同一个workspace目录，git如何使用签出工程可以观看作者录制的[教程][23]
    - 更多项目文档/API/相关截图 [请点击这里][27]
    - 最近类库代码已经提交至[JCenter][30]和[Maven][31]仓库，使用以下代码即可集成引入类库


[JCenter][30]仓库

```javascript

    // 共通资源(可单独使用)
//    compile 'com.zftlive.android.library:common-resource:1.0.0'
    // 基础框架(依赖common-resource)
    compile 'com.zftlive.android.library:basic-framework:1.0.2'
    // 特性功能类库-基础自定义控件(可选)
    compile 'com.zftlive.android.library:widget:1.0.2'
    // 特性功能类库-常用工具开发包(可选)
    compile 'com.zftlive.android.library:tools:1.0.2'
    // 特性功能类库-ormlite数据库组件(可选)
    compile 'com.zftlive.android.library:db:1.0.1'
    // 特性功能类库-图片异步加载组件(可选)
    compile 'com.zftlive.android.library:imageloader:1.0.2'
    //高斯模糊库(可选)
    compile 'com.zftlive.android.library:blur:1.0.0'
    // 特性功能类库-地图组件(可选)
    compile 'com.zftlive.android.library:map:1.0.1'
    // 特性功能类库-HTTP/SOAP网络通信组件(可选)
    compile 'com.zftlive.android.library:network:1.0.1'
    // 特性功能类库-社会化分享-联合登陆组件(可选)
    compile 'com.zftlive.android.library:sharesdk:1.0.1'
    // 特性功能类库-腾讯信鸽/MTA/bugly错误收集(可选)
    compile 'com.zftlive.android.library:tencent:1.0.1'
    // 特性功能类库-zxing二维码/条形码扫描识别(可选)
    compile 'com.zftlive.android.library:zxing:1.0.1'

```

[Maven][31]仓库

```javascript

地址(自行查阅)：https://bintray.com/zengfantian/android

```


#集成组件

 - [√] 网络异步请求[android-async-http][1]
 - [√] 图片异步加载[universal-image-loader][2]
 - [√] 本地数据库操作[ormlite-android][3]
 - [√] 消息推送-[腾讯信鸽][4]
 - [x] 即时通讯-[环信][5]
 - [√] 地图基础+定位+LBS （LBS暂未完成）[百度地图][6]
 - [√] App埋点/崩溃异常跟踪/日活统计[腾讯MTA][7]
 - [√] 社会化分享/第三方账号联合登录/短信验证码[ShareSDK][8]
 - [√] 快速生成渠道包[MultiChannelBuildTool][9]
 - [√] 二维码/条形码扫描和生成[Zxing二维码库][10]
 - [√] 低版本动画兼容库[nineoldandroids][11]
 - [√] IOC注入布局layout/控件/事件/Android四大组件[RoboGuice][12]
 - [√] WebService异步请求接口调用库[ksoap2][13]
 - [√] JSON/Bean互转组件 [gson][14]
 - [√] 折线图/饼图/柱状图/图表控件AChartEngine

#样例锦集

 - 共通界面-引导界面
 - 共通界面-意见反馈
 - 共通界面-本地/服务器WEB页加载界面（带进度显示+获取网页标题+分享）
 - 共通机能-版本检测升级
 - 共通机能-消息推送
 - 共通机能-MTA埋点/异常崩溃监控
 - 共通机能-全程网络状态监听Service
 - 共通机能-手势解锁
 - 共通机能-可缩放图片查看器（支持项目工程assets/drawable/sd卡/网络类型的图片）
 - 样例-ActionBar标题栏
 - 样例-底部弹出泡泡菜单
 - 样例-Achartengine带泡泡提示的曲线图
 - 样例-异步加载图片+防错位DEMO
 - 样例-直接启动摄像头拍照
 - 样例-Sqlite增删改查操作
 - 样例-生成二维码/验证码（可带LOGO图片）
 - 样例-竖屏扫描二维码/条形码
 - 样例-调用WebService示例
 - 样例-发送手机短信验证码
 - 样例-垂直+水平+圆形进度条
 - 样例-自动获取表单数据示例
 - 样例-Activity切换过场动画示例
 - 样例-发送短信/拦截示例
 - 样例-基本常用操作-跳转至WIFI设置、联系人、相册选择等界面
 - 样例-DrawerLayout侧滑菜单
 - 样例-水平/垂直滚动+首行首列固定+翻页Listview
 - 样例-下拉背景回弹效果的ScrollView
 - 样例-FadingActionBar官方DEMO（随着滑动ActionBar背景渐变）
 - 样例-PullToReresh官方DEMO
 - 样例-任何设备正方形Item的网格
 - 样例-带进度显示文件上传/下载
 - 样例-JNI/Java实现图片高斯模糊
 - 样例-dialog各种特效DEMO
 - 样例-带数字的进度条
 - 样例-百度地图定位演示
 - 样例-控制系统音量
 - 样例-九宫格解锁
 - 样例-图片缩放查看器
 - 样例-拍照/相册选择+裁剪图片
 - 未完/待续，敬请关注...

#封装工具类

 - HTTP网络通信工具类（ToolHTTP.java）,get/post请求，支持多种接口回调
 - SOAP协议通信工具类（ToolSOAP.java）,基于异步回调请求WebService接口
 - Sqlite数据库操作工具类（ToolDatabase.java），获取DAO、创建表、删除表等API
 - 提示信息对话框工具类（ToolAlert.java）,已集成泡泡、土司、对话框三种提示
 - 文件操作工具类（ToolFile.java）,assets/raw/xml/shrePerface/等文件读写API
 - 地图定位工具类（ToolLocation.java）,读取GPS状态、请求定位、获取经纬度等方法
 - 社会化分享工具类（ToolShareSDK.java）,各大开发平台分享API操作
 - 短信验证码工具类（ToolMSM.java）,移动/联通/电信三网发送手机短信验证码、异步回调验证结果
 - 字符串操作工具类（ToolString.java）,生成UUID、非空非NULL逻辑判断、生成MD5等常用共通方法
 - 数据操作工具类（ToolData.java）,自动递归获取表单数据封装成Map、本地数据分页共通方法等
 - 图片操作工具类（ToolPicture.java）,生成二维码、验证码、灰度、合成、圆角、水印等操作
 - 读取本地资源工具类（ToolResource.java）,反射本地资源文件API，避免依赖R文件，方便jar形式发布
 - Android单位转换工具类（ToolUnit.java）,sp/dp/px互转
 - 自定义Toast工具类（ToolToast.java）,自定义背景色、字体颜色、大小、边框等
 - Properties操作工具类（ToolProperties.java）,读写Properties文件操作
 - 网络操作工具类（ToolNetwork.java）,获取网络信息、更改切换网络等相关操作
 - 日期操作工具类（ToolDateTime.java）,获取日期、日期加减、格式化日期、日期转换等操作
 - XML操作工具类（ToolXml.java）,基于DOM/XMLPullPaser模式解析、生成XML操作
 - 适配字体工具类（ToolAutoFit.java）,代码根据设备密度自动缩放View的字体大小
 - LOG相关工具类（ToolLog.java） 
 - 未完/待续，敬请关注...

#版权声明

本项目源代码开源共享，收集开源项目源代码，融入了个人的理解并给与加工封装，最新正版源代码托管在[OSC][29]，最近同步推送至[github][24]一份，除此之外其他任何渠道方式获取的源代码均不是作者本人共享，并不保证是原著，如需转载请标明出处。另外，项目中涉及第三方平台接入相关key（短信验证码、MTA统计、信鸽推送、百度地图、社会化分享等），由于免费试用的次数有限，为了方便更多的使用者体验，在投入自己APP或商业项目使用时，请自行到各自接入平台申请替换

#捐赠共勉

如果您觉得本项目的源代码对您的学习有所帮助，您可以支付宝(左)或微信(右)请我喝一杯咖啡 
![支付宝](http://git.oschina.net/uploads/images/2015/1007/130818_eb22faa0_132591.png "支付宝捐赠")     ![微信](http://git.oschina.net/uploads/images/2015/1007/130906_30154790_132591.png "微信捐赠")

----------
#关于作者

```javascript
var Author = {
    realName : '曾繁添',
    nickName : 'Ajava攻城师',
    job : 'Android研发工程师'
    qq : '1260128980',
    email : 'zftlive@163.com',
    website : 'http://www.zftlive.com',
    blog : 'http://www.cnblogs.com/fly100',
    github : 'https://github.com/zengfantian',
    oschina : 'http://git.oschina.net/zftlive',
    tags : '90后、IT男、J2EE、Web前端、Android、Flex、管理、技术控、代码洁癖',
    description : '爱技术、爱开源、也爱赚钱，对代码书写有严格规范要求洁癖，平时喜欢看看开源项目、SDK相关源代码'
}
```

使用过程中有什么问题大家可以加QQ交流群：497671525 ， 加我的QQ也可以，加的时候备注一下，好友有限。看到问题我会及时解答

[1]: https://github.com/loopj/android-async-http
[2]: https://github.com/nostra13/Android-Universal-Image-Loader
[3]: http://ormlite.com/
[4]: http://xg.qq.com/xg/
[5]: http://www.easemob.com/sdk/
[6]: http://developer.baidu.com/map/
[7]: http://mta.qq.com/
[8]: http://mob.com/
[9]: http://git.oschina.net/zftlive/zftlive/tree/master/python
[10]: https://github.com/zxing/zxing/
[11]: https://github.com/JakeWharton/NineOldAndroids
[12]: http://code.google.com/p/google-guice/
[13]: https://github.com/simpligility/ksoap2-android
[14]: code.google.com/p/google-gson/downloads/list
[15]: http://www.androiddevtools.cn/
[16]: http://yun.baidu.com/share/link?shareid=42299917&uk=705493881
[17]: http://git.oschina.net/zftlive/zftlive
[18]: http://git.oschina.net/zftlive/gradle-zftlive
[19]: http://git.oschina.net/zftlive/AjavaAndroidLib
[20]: http://git.oschina.net/zftlive/gradle-ajavasample/tree/master/AjavaAndroidLib
[21]: http://git.oschina.net/zftlive/AjavaAndroidSample
[22]: http://git.oschina.net/zftlive/gradle-ajavasample
[23]: http://yun.baidu.com/share/link?shareid=1394255543&uk=705493881
[24]: https://github.com/zengfantian/zftlive
[25]: http://android.myapp.com/myapp/detail.htm?apkName=com.zftlive.android
[26]: http://zhushou.360.cn/detail/index/soft_id/3022355?recrefer=SE_D_ajavasample
[27]: http://git.oschina.net/zftlive/zftlive/tree/master/doc
[28]: http://jr.jd.com/
[29]: http://git.oschina.net/zftlive/zftlive/
[30]: https://bintray.com/zengfantian/android/basic-framework
[31]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.zftlive.android.library%22