android 开源项目再次统计

========================================================================================================================================================================================

（1）开源中国Android客户端 http://git.oschina.net/oschina/android-app

==============================================================================

android-app
开源中国社区 Android 客户端项目简析

注：本文假设你已经有Android开发环境

启动Eclipse，点击菜单并导入Android客户端项目，请确保你当前的Android SDK是最新版。
如果编译出错，请修改项目根目录下的 project.properties 文件。
推荐使用Android 4.0 以上版本的SDK,请使用JDK1.6编译：

target=android-15

本项目采用 GPL 授权协议，欢迎大家在这个基础上进行改进，并与大家分享。

下面将简单的解析下项目：

一、项目的目录结构

根目录
├ src
├ libs
├ res
├ AndroidManifest.xml
├ LICENSE.txt
├ proguard.cfg
└ project.properties

1、src目录
src目录用于存放项目的包及java源码文件。

src
├ com.weibo.net
├ greendroid.widget
├ net.oschina.app
├ net.oschina.app.adapter
├ net.oschina.app.api
├ net.oschina.app.bean
├ net.oschina.app.common
├ net.oschina.app.ui
└ net.oschina.app.widget

com.weibo.net — 新浪微博SDK源码包
greendroid.widget — 快捷菜单栏组件(国外UI库GreenDroid)
net.oschina.app — APP启动及管理包
net.oschina.app.adapter — APP列表适配器包
net.oschina.app.api — API访问包
net.oschina.app.bean — APP实体包
net.oschina.app.common — APP工具包
net.oschina.app.ui — APP界面包
net.oschina.app.widget — APP控件包

2、libs目录
libs目录用于存放项目引用到的jar包文件。

下面是libs目录里的jar包文件：

libs
└ commons-httpclient-3.1.jar

commons-httpclient-3.1.jar — Apache的HttpClient包

3、res目录
res目录用于存放项目的图片、布局、样式等资源文件。

res
├ anim
├ color
├ drawable
├ drawable-hdpi
├ drawable-ldpi
├ drawable-mdpi
├ layout
├ menu
├ raw
├ values
└ xml

anim — 动画效果
color — 颜色
drawable/drawable-hdpi/drawable-ldpi/drawable-mdpi — 图标、图片
layout — 界面布局
menu — 菜单
raw — 通知音
values — 语言包和样式
xml — 系统设置

4、AndroidManifest.xml
AndroidManifest.xml用于设置应用程序的版本、主题、用户权限及注册Activity等。

二、项目的功能流程

1、APP启动流程

AndroidManifest.xml注册的启动界面为"AppStart"，具体文件为net.oschina.app\AppStart.java文件。启动显示欢迎界面之后，通过意图(Intent)跳转到首页（net.oschina.app.ui\Main.java）。
注：除启动界面之外，其他所有界面都放在src\net.oschina.app.ui包中。

2、APP访问API流程

以首页资讯列表显示访问API数据为例：

1) 初始化控件
首页Activity(Main.java)在onCreate()方法里面加载布局文件(Main.xml)，对下拉刷新列表控件(PullToRefreshListView)进行了初始化，并设置了数据适配器(ListViewNewsAdapter)。
注：Main.xml布局文件在res\layout目录下；PullToRefreshListView控件在net.oschina.app.widget包；ListViewNewsAdapter适配器在net.oschina.app.adapter包。

2) 异步线程访问
列表控件初始化后，开启一个线程方法(loadLvNewsData())，该方法中调用全局应用程序类(AppContext)来访问API客户端类(ApiClient)。通过ApiClient以http方式请求服务器的API。返回响应的XML数据，再通过实体Bean(NewsList)解析XML，返回实体(NewsList)给UI控件(PullToRefreshListView)展示。
注：AppContext全局应用程序类在net.oschina.app包；ApiClient API客户端类在net.oschina.app.api包。

3) 解析数据显示
服务得到请求，将返回对应的资讯XML数据，再通过资讯实体类(NewsList)解析XML，返回实体(NewsList)给UI控件(PullToRefreshListView)展示。
注：NewsList实体类在net.oschina.app.bean包。

============================================================================================

（2）GitHub客户端 https://github.com/github/android

（3）看雪论坛：https://github.com/kanxue-team/kanxue-android-app

看雪安全论坛 Android 客户端

本项目基于看雪安全论坛开放的接口开发完成。可通过在看雪各页面url后添加styleid=12参数查看各页面返回的JSON数据。项目中采用了一些经过修改的第三方控件，如AmazingListView和XListView。

源码结构

src
├ android.util
├ com.pediy.bbs.kanxue
├ com.pediy.bbs.kanxue.net
├ com.pediy.bbs.kanxue.util
├ com.pediy.bbs.kanxue.widget

android.util — 为了兼容低版本，从安卓sdk中复制出来的base64工具包
com.pediy.bbs.kanxue — 界面包
com.pediy.bbs.kanxue.net — 网络包
com.pediy.bbs.kanxue.util — 工具包
com.pediy.bbs.kanxue.widget — 控件包

libs
└ fastjson-1.1.26-android.jar

fastjson-1.1.26-android.jar — 快速的json数据解析包

（4）白宫网站客户端：https://github.com/WhiteHouse/wh-app-android

（5）eoe客户端：https://github.com/eoecn/android-app

android-app

本项目采用 GPL 授权协议，欢迎大家在这个基础上进行改进，并与大家分享。

如您感觉本项目中有不妥之处或者有不爽的地方，欢迎提交问题或更改方案，项目小组会及时的对您提交的修改给予反馈。希望能为开发者提供一款开源好用的Android版客户端产品。一款好产品需要大家共同努力，大家共勉！

eoe社区 Android 客户端项目简析

注：本文假设你已经有Android开发环境

本文以eclipse为例
启动Eclipse，导入Android客户端项目，请确保你当前的Android SDK是最新版。如果编译出错，请修改项目根目录下的 project.properties 文件。推荐使用Android 4.0 以上版本的SDK：

target=android-14

一、工程目录结构

根目录

├ source
├ LICENCE.txt
├ README.md

├ source --源代码
├ LICENCE.txt --开源协议
├ README.md --项目帮助及项目信息

二、源代码目录结构

source

├ src
├ libs
├ res
├ AndroidManifest.xml
├ proguard-project.txt
└ project.properties

1、src目录
src目录用于存放工程的包及java源码文件。

src

├ cn.eoe.app --存放程序全局性类的包
├ cn.eoe.app.adapter --存放适配器的实现类的包
├ cn.eoe.app.adapter.base --存放适配器基类的包
├ cn.eoe.app.biz --存放ＤＡＯ类的包
├ cn.eoe.app.config －－存放常量，配置和api接口等类的包
├ cn.eoe.app.db --关于sqlite操作相关的类的包
├ cn.eoe.app.db.biz --详细的增删改查类的包，暂时仅有一个类
├ cn.eoe.app.entity --实体类包
├ cn.eoe.app.entity.base --实体类基类包
├ cn.eoe.app.https --网络访问相关类的包
├ cn.eoe.app.indicator --导航相关的类包
├ cn.eoe.app.slidingmenu --滑动菜单相关类包
├ cn.eoe.app.ui --界面相关的包，activity的类
├ cn.eoe.app.ui.base --activity相关的基类包
├ cn.eoe.app.utils --工具类包
├ cn.eoe.app.view --Fragment相关类的包
├ cn.eoe.app.widget --自定义view组件包

├ com.google.zxing.camera --第三方定义，控制摄像头包
├ com.google.zxing.decoding -- 二维码图像解码包
├ com.google.zxing.view -- 自定义View，控制拍摄取景框和动画等

2、libs目录
libs目录用于存放项目引用的第三方jar包。

libs目录里的jar包文件：

libs

├ android-support-v4.jar --v4兼容包
├ jackson-all-1.9.2.jar --解析json的包
├ umeng_sdk.jar --友盟的sdk
├ zxing-1.6.jar --二维码处理的包

3、res目录
res目录存放工程用到的图片、布局、样式等资源文件。
res目录的子目录：

res

├ anim
├ color
├ drawable
├ drawable-hdpi
├ drawable-ldpi
├ drawable-mdpi
├ drawable-xhdpi
├ interpolator
├ layout
├ menu
├ raw
├ values
└ values-zh

4、AndroidManifest.xml
AndroidManifest.xml用于设置应用程序的版本、主题、用户权限及注册Activity等组件及其他配置。

三、程序功能流程

1、APP启动流程

AndroidManifest.xml注册的启动Activity是"cn.eoe.app.ui.SplashActivity"，然后进入到主界面，对应的

Activity是“cn.eoe.app.ui.MainActivity”

2.程序功能
(1)社区精选
(2)新闻资讯
(3)学习教程
(4)社区博客

========================================================================================================================================================================================