Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
本项目已经迁移到 git.oschina.net ,此处不再更新!
Java
tag: v1.7.1_beta2

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
.settings
libs
res
src
.classpath
.gitignore
.project
AndroidManifest.xml
LICENSE.txt
README.md
proguard.cfg
project.properties

README.md

android-app

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

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

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

target=android-15

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

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

一、项目的目录结构

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

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

下面是src目录的子目录:

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目录的子目录:

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包。

Something went wrong with that request. Please try again.