有时候我们在GitHub上面看到的一些开源项目(Projects from Eclipse with ADT)并非是一个完整的Android Project,而只是一个Library Project,我们应该怎样去引用这些Library Project到我们自己的Android Project上呢?其实官网里面也介绍得蛮清楚的,只不过作为初学者真的需要一个比较完整的引导,这样可以避免浪费太多时间。下面就结合一个引用开源库工程项目实例,简单翻译一下官方文档,http://developer.android.com/tools/projects/projects-eclipse.html#ReferencingLibraryProject
0、首先我们需要在https://github.com/chrisbanes/Android-PullToRefresh下载工程,上不了的话也可以在CSDNAndroid-PullToRefresh-master下载。
1、将Library Project解压拷贝到Android Project所属的文件夹下,在Eclipse里导入到工作区间:import - Android - Existing Android... - browse - 选中解压后的文件夹 - finish
2、右击自己的Android Project选中Properties、然后选择Android、点击Add将所有工程选中后点击OK
3、接下来是比较关键的一步,在Android Project中声明所有要用到的组件,还有权限,而且必须用完整的包名来声明。以上述工程为例,需要将其他库工程的组件如Activity声明在Android Project的Manifest文件中,注意必须要完整包名!
<activity
android:name="com.handmark.pulltorefresh.samples.LauncherActivity"
android:label="PullToRefresh Samples" >
</activity>
<activity
android:name="com.handmark.pulltorefresh.samples.PullToRefreshListActivity"
android:label="PtR ListView" >
</activity>
到此,我们就引用Library Project完毕了。不过我们还是完整的把这个流程走完,这个开源项目怎么用呢?可以参考https://github.com/chrisbanes/Android-PullToRefresh/wiki/Quick-Start-Guide
1、布局文件
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" >
<com.handmark.pulltorefresh.library.PullToRefreshListView
android:id="@+id/pull_to_refresh_listview"
android:layout_width="fill_parent"
android:layout_height="fill_parent" />
</LinearLayout>
2、MainActivity
package com.example.test;
import java.util.ArrayList;
import java.util.List;
import android.app.Activity;
import android.os.AsyncTask;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import com.handmark.pulltorefresh.library.PullToRefreshBase;
import com.handmark.pulltorefresh.library.PullToRefreshBase.OnRefreshListener;
import com.handmark.pulltorefresh.library.PullToRefreshListView;
public class MainActivity extends Activity {
private PullToRefreshListView pullToRefreshView;
private List<String> list;
private ArrayAdapter<String> adapter;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
init();
pullToRereshViewSetting();
}
private void init() {
pullToRefreshView = (PullToRefreshListView) findViewById(R.id.pull_to_refresh_listview);
list = new ArrayList<String>();
list.add("北京");
list.add("上海");
list.add("广州");
adapter = new ArrayAdapter<String>(MainActivity.this,
android.R.layout.simple_list_item_1, list);
pullToRefreshView.setAdapter(adapter);
}
private void pullToRereshViewSetting() {
pullToRefreshView
.setOnRefreshListener(new OnRefreshListener<ListView>() {
@Override
public void onRefresh(
PullToRefreshBase<ListView> refreshView) {
// Do work to refresh the list here.
new GetDataTask().execute();
}
});
}
private class GetDataTask extends AsyncTask<Void, Void, String[]> {
@Override
protected void onPostExecute(String[] result) {
// Call onRefreshComplete when the list has been refreshed.
pullToRefreshView.onRefreshComplete();
if (!list.contains(result[0]))
list.add(result[0]);
adapter.notifyDataSetChanged();
super.onPostExecute(result);
}
@Override
protected String[] doInBackground(Void... arg0) {
// TODO Auto-generated method stub
// 模拟两秒的刷新
try {
Thread.sleep(2000);
} catch (InterruptedException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
String[] data = { "惠州" };
return data;
}
}
}
效果图:
这篇文章以GitHub上一个比较出名的开源项目为例讲解Eclipse下Library Project的引用,事实上这个项目也很老了,比较新的项目基本上都是from Android Studio的。虽然自己的渣机器跑起AS来还是很卡,不过做完最近的项目后,就全面迁移AS了(真的好卡啊!T_T),也是为了更好的学习开源项目吧!