Android API Demoプログラムフレームワーク

前言
Android API Demoプログラムは主にAndroidの一般的なAPIの使用方法を実証し、本稿ではこのプログラムのフレームワークを抽出し、Androidプログラミングの研究と学習の一例としてフレームワークを収集し、自分が研究したすべての例を分類して収集し、後で検索しやすいようにした.
 
本文
以下にフレーム関連のファイル内容のみを貼り付け、最後に自分の例をフレームに入れると説明します.
 
フレームワークのプロジェクトのソースディレクトリ構造は次のとおりです.
コアパッケージ
com.fyj.demoは3つのファイルを含むjava MyAppDemoActivity.java MyAppDemoApplication.JAva、ファイルの内容は以下の通りです.
 
Globals.java
 

package com.fyj.demo;

public class Globals {

	public static final String CATEGORY_MYAPP_DEMO = "android.intent.category.MYAPP_DEMO";
}

このファイルは主にいくつかのグローバル変数を定義し、上記のように独自のCATEGORYを定義します.
 
MyAppDemoApplication.java

package com.fyj.demo;

import android.app.Application;
import android.util.Log;

public class MyAppDemoApplication extends Application {
	private static final String TAG = "MyAppDemoApplication";

	@Override
	public void onCreate() {
		Log.i(TAG, "My App Demo is running...");
	}
}

このクラスには、グローバル初期化のコードがいくつか追加されます.
 
MyAppDemoActivity.java

package com.fyj.demo;

import java.text.Collator;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import android.app.ListActivity;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.content.pm.ResolveInfo;
import android.os.Bundle;
import android.view.View;
import android.widget.ListView;
import android.widget.SimpleAdapter;

public class MyAppDemoActivity extends ListActivity {

	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);

		Intent intent = getIntent();
		String path = intent.getStringExtra("com.fyj.demo.Path");

		if (path == null) {
			path = "";
		}

		setListAdapter(new SimpleAdapter(this, getData(path),
				android.R.layout.simple_list_item_1, new String[] { "title" },
				new int[] { android.R.id.text1 }));
		getListView().setTextFilterEnabled(true);
	}

	protected List<Map<String, Object>> getData(String prefix) {
		List<Map<String, Object>> myData = new ArrayList<Map<String, Object>>();

		Intent mainIntent = new Intent(Intent.ACTION_MAIN, null);
		mainIntent.addCategory(Globals.CATEGORY_MYAPP_DEMO);

		PackageManager pm = getPackageManager();
		List<ResolveInfo> list = pm.queryIntentActivities(mainIntent, 0);

		if (null == list)
			return myData;

		String[] prefixPath;
		String prefixWithSlash = prefix;

		if (prefix.equals("")) {
			prefixPath = null;
		} else {
			prefixPath = prefix.split("/");
			prefixWithSlash = prefix + "/";
		}

		int len = list.size();

		Map<String, Boolean> entries = new HashMap<String, Boolean>();

		for (int i = 0; i < len; i++) {
			ResolveInfo info = list.get(i);
			CharSequence labelSeq = info.loadLabel(pm);
			String label = labelSeq != null ? labelSeq.toString()
					: info.activityInfo.name;

			if (prefixWithSlash.length() == 0
					|| label.startsWith(prefixWithSlash)) {

				String[] labelPath = label.split("/");

				String nextLabel = prefixPath == null ? labelPath[0]
						: labelPath[prefixPath.length];

				if ((prefixPath != null ? prefixPath.length : 0) == labelPath.length - 1) {
					addItem(myData,
							nextLabel,
							activityIntent(
									info.activityInfo.applicationInfo.packageName,
									info.activityInfo.name));
				} else {
					if (entries.get(nextLabel) == null) {
						addItem(myData, nextLabel,
								browseIntent(prefix.equals("") ? nextLabel
										: prefix + "/" + nextLabel));
						entries.put(nextLabel, true);
					}
				}
			}
		}

		Collections.sort(myData, sDisplayNameComparator);

		return myData;
	}

	private final static Comparator<Map<String, Object>> sDisplayNameComparator = new Comparator<Map<String, Object>>() {
		private final Collator collator = Collator.getInstance();

		public int compare(Map<String, Object> map1, Map<String, Object> map2) {
			return collator.compare(map1.get("title"), map2.get("title"));
		}
	};

	protected Intent activityIntent(String pkg, String componentName) {
		Intent result = new Intent();
		result.setClassName(pkg, componentName);
		return result;
	}

	protected Intent browseIntent(String path) {
		Intent result = new Intent();
		result.setClass(this, MyAppDemoActivity.class);
		result.putExtra("com.fyj.demo.Path", path);
		return result;
	}

	protected void addItem(List<Map<String, Object>> data, String name,
			Intent intent) {
		Map<String, Object> temp = new HashMap<String, Object>();
		temp.put("title", name);
		temp.put("intent", intent);
		data.add(temp);
	}

	@Override
	@SuppressWarnings("unchecked")
	protected void onListItemClick(ListView l, View v, int position, long id) {
		Map<String, Object> map = (Map<String, Object>) l
				.getItemAtPosition(position);

		Intent intent = (Intent) map.get("intent");
		startActivity(intent);
	}
}

このクラスはフレームワークの主なアクティビティクラスであり、フレームワークに追加されたいくつかの例を起動します.
 
拡張パッケージ
コアパッケージを除くコードは、例の分類に従って異なる拡張パッケージに配置され、例として、本稿では拡張パッケージcomを作成する.fyj.demo.app
このパッケージでは、HelloWorldという例を作成しました.JAva、その内容は以下の通りです.

package com.fyj.demo.app;

import android.app.Activity;
import android.os.Bundle;

import com.fyj.demo.R;

public class HelloWorld extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		// TODO Auto-generated method stub
		super.onCreate(savedInstanceState);
		setContentView(R.layout.hello);
	}
}

次にresディレクトリの下に入ります.ここで主に注目しているのはlayout、valuesサブディレクトリです.layoutはいくつかのレイアウトファイルで、valuesディレクトリの下のstringsです.xmlは、サンプルアプリケーションの文字列を定義します.ここではstringsを主に見ます.xmlファイルの内容:
 

<?xml version="1.0" encoding="utf-8"?>
<resources>

    <string name="hello">Hello World, MyAppDemoActivity!</string>
    <string name="app_name">MyAppDemo</string>    
    
    <string name="activity_hello_world">App/Activity/<b>Hello <i>World</i></b></string>

</resources>

ここで、サンプルプログラムのタイトル文字列を定義する際には、上記のフォーマットに従って定義し、上記名称はHelloWorldサンプルプログラムがApp分類の下のActivityサブ分類に分類され、何個の'/'が何個の分類階層を表すかを表す.
 
最後にAndroidManifestを見てみましょうxmlファイルの内容:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.fyj.demo"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk android:minSdkVersion="15" />

    <application
        android:name="MyAppDemoApplication"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >
        <activity
            android:name=".MyAppDemoActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <!-- Activity Samples -->
        <activity
            android:name=".app.HelloWorld"
            android:label="@string/activity_hello_world" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.MYAPP_DEMO" />
            </intent-filter>
        </activity>
    </application>

</manifest>

なお、例のActivityではcategoryはandroidに設定.intent.category.MYAPP_DEMO.