AsyncTaskでブレークポイントを指定する時の注意点

AsyncTask の中でブレークポイントを設定する場合は、doInBackground() の最初で

android.os.Debug.waitForDebugger();

を呼ぶ必要があります。
 
呼ばないとブレークポイントを無視してしまいます。
 
デバッガが居なくても以外もwaitForDebugger()で処理を停止してしまうので、
デバッグ実行が終わったらちゃんとコメントアウトしましょう。
 
#謎の不具合で丸一日はまった…
 
参考:
Debug#waitForDebugger())

Androidマーケットで公開キャリアを制限する

Android マーケットではSIMカードのキャリアで公開対象をフィルタリングすることができます。
 
■制限している例(2011-04-12現在):
– S-1バトル(Softbank限定)
– Skype(公開当初はau限定だった)
– spモードメールアプリ(NTTドコモ限定)
 
方法は簡単で、デベロッパーコンソール(Developer Console)からアプリapkをアップロードする際に以下の手順で設定します。
 
1.公開設定のオプション(Publishing options)内の「すべての国(All Country)」のチェックを外す。
2.制限対象国(日本)のリンクをクリック。
3.公開したい携帯キャリアだけにチェックをいれる。
 
設定したスクリーンショットがこちらになります。


 
簡単ですね。
その他のフィルタリング設定についてはマニュアルのMarket Filter(日本語訳)の項目が参考になります。
 
参考:
carrier targeting of apps(Android Developers)

MercurialEclipse+ADTで not in root エラー

ある時からMercurial Eclipse(v1.8)でコミットをしようとするとnot under rootというエラーが出るようになりました。
原因をググってみるとどうやら Android のライブラリプロジェクトとメインプロジェクトの両方でMercurialを使っていると出るらしい。
解決方法はAndroidライブラリの依存チェックを外すか、どちらかのリポジトリを切断するかで、どちらも場当たり的なのが悩ましい…。
 
参考として、スタックトレースは以下の通りでした(MercurialEclipse バージョン 1.8.0.v201103281715 で確認)

!ENTRY com.vectrace.MercurialEclipse 4 0 2011-04-11 12:24:47.074
!MESSAGE 中断: c:\path\to\android_project_dir not under root. コマンド行: c:\path\to\android_library_project_dir\hg -y status -marduc — c:\path\to\android_project_dir, error code: -1
!STACK 1
中断: D:\usr\eclipse\net.canp.android.purigaget not under root. コマンド行: D:\usr\eclipse\net.canp.android.common\hg -y status -marduc — D:\usr\eclipse\net.canp.android.purigaget, error code: -1
at com.vectrace.MercurialEclipse.commands.AbstractShellCommand.executeToStream(AbstractShellCommand.java:405)
at com.vectrace.MercurialEclipse.commands.AbstractShellCommand.executeToBytes(AbstractShellCommand.java:348)
at com.vectrace.MercurialEclipse.commands.AbstractShellCommand.executeToString(AbstractShellCommand.java:548)
at com.vectrace.MercurialEclipse.commands.AbstractShellCommand.executeToString(AbstractShellCommand.java:544)
at com.vectrace.MercurialEclipse.commands.HgStatusClient.getStatusWithoutIgnored(HgStatusClient.java:154)
at com.vectrace.MercurialEclipse.team.cache.MercurialStatusCache.updateStatusInRoot(MercurialStatusCache.java:1333)
at com.vectrace.MercurialEclipse.team.cache.MercurialStatusCache.refreshStatus(MercurialStatusCache.java:1287)
at com.vectrace.MercurialEclipse.team.cache.MercurialStatusCache.access$0(MercurialStatusCache.java:1273)
at com.vectrace.MercurialEclipse.team.cache.MercurialStatusCache$ProjectUpdateJob.updateProject(MercurialStatusCache.java:144)
at com.vectrace.MercurialEclipse.team.cache.MercurialStatusCache$ProjectUpdateJob.run(MercurialStatusCache.java:126)
at org.eclipse.core.internal.jobs.Worker.run(Worker.java:54)
!SUBENTRY 1 com.vectrace.MercurialEclipse 4 -1 2011-04-11 12:24:47.074
!MESSAGE 中断: c:\path\to\android_project_dir not under root. コマンド行: c:\path\to\android_library_project_dir\hg -y status -marduc — c:\path\to\android_project_dir

 
参考:
MercurialEclipseでちょっと困った(Naga Blog)

MapView で InflateException 例外が出る原因

com.google.android.maps.MapView 周りで

android.view.InflateException: Binary XML file line #103: Error inflating class com.google.android.maps.MapView
<
 <
のようなエラー等が出る場合、次の原因が考えられます。
 
– MapView を使う Activity で MapActivity を継承していない。
 
– AndroidManifest.xml の <application> タグ内で

<uses-library android:name=”com.google.android.maps” />

 を定義していない。

SQLiteException – file is encrypted or is not a database

SQLiteOpenHelper で表題の例外が出てしまったので対策メモ。
 LogCat:

02-22 17:26:58.351: ERROR/Database(23305): Failed to setLocale() when constructing, closing the database
02-22 17:26:58.351: ERROR/Database(23305): android.database.sqlite.SQLiteException: file is encrypted or is not a database
02-22 17:26:58.351: ERROR/Database(23305): at android.database.sqlite.SQLiteDatabase.native_setLocale(Native Method)
02-22 17:26:58.351: ERROR/Database(23305): at android.database.sqlite.SQLiteDatabase.setLocale(SQLiteDatabase.java:1751)
02-22 17:26:58.351: ERROR/Database(23305): at android.database.sqlite.SQLiteDatabase.<init>(SQLiteDatabase.java:1701)
02-22 17:26:58.351: ERROR/Database(23305): at android.database.sqlite.SQLiteDatabase.openDatabase(SQLiteDatabase.java:739)
02-22 17:26:58.351: ERROR/Database(23305): at android.database.sqlite.SQLiteDatabase.openOrCreateDatabase(SQLiteDatabase.java:761)
02-22 17:26:58.351: ERROR/Database(23305): at android.database.sqlite.SQLiteDatabase.openOrCreateDatabase(SQLiteDatabase.java:754)
02-22 17:26:58.351: ERROR/Database(23305): at android.app.ApplicationContext.openOrCreateDatabase(ApplicationContext.java:497)
02-22 17:26:58.351: ERROR/Database(23305): at android.content.ContextWrapper.openOrCreateDatabase(ContextWrapper.java:193)
02-22 17:26:58.351: ERROR/Database(23305): at android.database.sqlite.SQLiteOpenHelper.getWritableDatabase(SQLiteOpenHelper.java:98)
// 以下アプリ内の getWritableDatabase() 参照箇所に続く

原因を調べたところ、どうもSQLiteのデータベースファイルが破損されているようなので、接続時にエラーの時はファイルをクリアして再接続するようにオーバーライド実装して対応しました。

@Override
public synchronized SQLiteDatabase getWritableDatabase() {
        try {
                return super.getWritableDatabase();
        } catch (SQLiteException e) {
                final File file = mContext.getDatabasePath(DATABASE_NAME);
                file.delete();
                return super.getWritableDatabase();
        }
}
 
@Override
public synchronized SQLiteDatabase getReadableDatabase() {
        try {
                return super.getReadableDatabase();
        } catch (SQLiteException e) {
                final File file = mContext.getDatabasePath(DATABASE_NAME);
                file.delete();
                return super.getReadableDatabase();
        }
}

参考:
http://d.hatena.ne.jp/esmasui/20091103/1257276598

端末ごとのBluetooth 仕様まとめ

各Android端末で対応しているBluetoothのバージョンとプロファイルの一覧です。
最終更新日:2011-02-17

機種

AndroidOSバージョン

Bluetoothバージョン

Bluetoothプロファイル

Nexus One

2.2

2.0+EDR

Nexus S

2.3

2.1+EDR

Xperia

2.1

2.1+EDR(Android2.1の場合)

A2DP,AVRCP,FTP(Server only),HFP,HSP,OPP

Xperia arc

2.3

2.1+EDR

A2DP,FTP

LYNX SH-10B

1.6

2.1+EDR

HSP,HFP,OPP,A2DP,AVRCP

LYNX 3D SH-03C

2.1

2.1+EDR

A2DP,AVRCP,HFP,HSP,OPP,PBAP,SPP

REGZA Phone T-01C

2.1

2.1+EDR

A2DP,AVRCP,HFP,HSP,HID,OPP,PBAP,SPP

GALAXY Tab SC-01C

2.2

3.0

HSP,HFP,HID,OPP,A2DP,AVRCP,SPP,PBAP,SAP,FTP

GALAXY S SC-02B

2.2

3.0+EDR

HSP,HFP,OPP,A2DP,AVRCP,SPP,SAP,FTP,BPP,PBAP

HTC Desire X06HT

2.2

2.1+EDR

A2DP,FTP,OPP,AVRCP,GAP,GOEP,HFP,HSP,PBAP,SPP,SDAP

HTC Desire HD 001HT

2.2

2.1+EDR

A2DP,FTP,OPP,AVRCP, GAP, GOEP, HFP, HSP, PBAP, SPP, SDAP

GALAPAGOS 003SH

2.2

2.1+EDR

HFP, HSP, DUNP, A2DP, AVRCP, OPP, PBAP

GALAPAGOS 005SH

2.2

2.1+EDR

HFP, HSP, DUNP, A2DP, AVRCP, OPP, PBAP

DELL Streak 001DL

2.2

2.0+EDR

A2DP, AVRCP, HFP, OPP, BIP, HID, HSP

004HW

2.2

2.1+EDR

Libero 003Z

2.2

2.1+EDR

A2DP, AVRCP, SPP, OPP, HFP

IS01

1.6

2.0+EDR

HSP,HFP,A2DP,AVRCP,HID,SPP,OPP,DUN

IS03

2.1

2.1+EDR

A2DP,AVRCP,HSP,HFP,OPP,PBAP,SPP

IS04

2.1

2.1+EDR

A2DP,AVRCP,HID,HFP,HSP,OBEX,OPP

IS05

2.2

2.1+EDR

HSP,HFP,A2DP,AVRCP,OPP,SPP,PBAP

IS06

2.2

2.1+EDR

A2DP,AVRCP,HFP,HSP,OPP,PBAP,SPP

/system フォルダを書き込み可能にする

Android は標準の状態で /system フォルダは読み込み専用でマウントされていて root でも書き込めないようになっています。
ということで、root 状態で書き込めるようにするための手順をメモしておきます。
PCとUSB接続ADBで端末が認識されている状態で、PCから

$ adb shell
$ su
# mount -o rw,remount -t yaffs2 /dev/block/mtdblock3 /system

のように実行すると読み書き可能な状態でリマウントできます。
/dev/block/mtdblock3 の部分は引数なしの mount コマンドで自身の端末の /system マウントデバイスを確認して下さい。
Xperia であれば、下記を参考に /dev/block/mtdblock2 と指定します。

$ mount
mount
rootfs / rootfs ro 0 0
tmpfs /dev tmpfs rw,mode=755 0 0
devpts /dev/pts devpts rw,mode=600 0 0
proc /proc proc rw 0 0
sysfs /sys sysfs rw 0 0
tmpfs /sqlite_stmt_journals tmpfs rw,size=4096k 0 0
/dev/block/mtdblock2 /system yaffs2 ro 0 0
/dev/block/mtdblock3 /data yaffs2 rw,nosuid,nodev 0 0
/dev/block/mtdblock1 /cache yaffs2 rw,nosuid,nodev 0 0
DxDrmServerIpc /data/DxDrm/fuse fuse.DxDrmServerIpc rw,nosuid,nodev,user_id=0,gr
oup_id=0,allow_other 0 0
/dev/block//vold/179:1 /sdcard vfat rw,dirsync,nosuid,nodev,noexec,uid=1000,gid=
1015,fmask=0702,dmask=0702,allow_utime=0020,codepage=cp437,iocharset=iso8859-1,s
hortname=mixed,utf8,errors=remount-ro 0 0

参考:
Mount a filesystem read-write(ANDROID TRICKS)

SQLiteOpenHelper でテーブルカラム変更時にデータを引き継ぐ

SQLiteOpenHelper の実装サンプルです。
onUpgrade() の実装は DROP TABLE クエリを実行するのが簡単なのですが、
それだとDBバージョンアップごとにデータがリセットされてしまいます。
 
バージョンアップでカラム追加、削除を行った時も共通カラムについては引き継げるように、こちらの回答を参考に実装してみました。

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
 
import android.content.Context;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteDatabase.CursorFactory;
import android.database.sqlite.SQLiteOpenHelper;
 
class DatabaseHelper extends SQLiteOpenHelper {
/**
 * DBファイル名
 */
private static final String DATABASE_NAME = “sample.db”;
/**
 * DBバージョン
 * (既存のDBとバージョン値が異なる時だけ onUpgrade()が呼ばれる)
 */
private static final int DATABASE_VERSION = 1;
/**
 * コンストラクタ
 */
public DatabaseHelper(Context context) {
super(context, DATABASE_NAME, null, DATABASE_VERSION);
}
 
@Override
public void onCreate(SQLiteDatabase db) {
db.execSQL(“CREATE TABLE table1 (”
+ “name text NOT NULL, ”
+ “birthdate INTEGER NOT NULL”
+ “)”);
}
 
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// 指定したテーブルのカラム構成をチェックし、
// 同名のカラムについてはアップグレード後もデータを引き継ぎます。
// 同名のカラムで型に互換性がない場合はエラーになるので注意。

// 更新対象のテーブル
final String targetTable = “table1”;
db.beginTransaction();
try {
// 元カラム一覧
final List<String> columns = getColumns(db, targetTable);
// 初期化
db.execSQL(“ALTER TABLE ” + targetTable + ” RENAME TO temp_”
+ targetTable);
onCreate(db);
// 新カラム一覧
final List<String> newColumns = getColumns(db, targetTable);
 
// 変化しないカラムのみ抽出
columns.retainAll(newColumns);
 
// 共通データを移す。(OLDにしか存在しないものは捨てられ, NEWにしか存在しないものはNULLになる)
final String cols = join(columns, “,”);
db.execSQL(String.format(
“INSERT INTO %s (%s) SELECT %s from temp_%s”, targetTable,
cols, cols, targetTable));
// 終了処理
db.execSQL(“DROP TABLE temp_” + targetTable);
db.setTransactionSuccessful();
} finally {
db.endTransaction();
}
}
 
/**
 * 指定したテーブルのカラム名リストを取得する。
 *
 * @param db
 * @param tableName
 * @return カラム名のリスト
 */
private static List<String> getColumns(SQLiteDatabase db, String tableName) {
List<String> ar = null;
Cursor c = null;
try {
c = db.rawQuery(“SELECT * FROM ” + tableName + ” LIMIT 1″, null);
if (c != null) {
ar = new ArrayList<String>(Arrays.asList(c.getColumnNames()));
}
} finally {
if (c != null)
c.close();
}
return ar;
}
 
/**
 * 文字列を任意の区切り文字で連結する。
 *
 * @param list
 * 文字列のリスト
 * @param delim
 * 区切り文字
 * @return 連結後の文字列
 */
private static String join(List<String> list, String delim) {
final StringBuilder buf = new StringBuilder();
final int num = list.size();
for (int i = 0; i < num; i++) {
if (i != 0)
buf.append(delim);
buf.append((String) list.get(i));
}
return buf.toString();
}
 
}

SQLiteOpenHelper(Android Developers)
SQLiteOpenHelper onUpgrade() Confusion Android

Android で System.exit() を使ってはいけない理由と、終了方法のまとめ

Androidではアプリを終了させる場合、System.exit(0) でもアプリを終了することができますが、この方法ではVMごと強制終了させるため、アクティビティのライフサイクルを無視することになる上メモリなどのリソース解放に失敗するおそれがあり、安全ではありません。
適切な終了方法はどれか、ということでアプリケーションを終了させる方法をまとめてみました。

■Activity#finish()
アクティビティを閉じる際の最良の終了方法です。
現在のアクティビティを閉じて前のアクティビティに戻ります。
アプリケーションの起動アクティビティで呼び出した場合はアプリケーションを終了します。
バックボタンを押した時と同じ動きで、実行すると onPause(), onDestroy()が順番に呼ばれます。
復帰時は新規生成となり onCreate(), onStart(), onResume() の順でイベントが発生します。
 
■Activity#moveTaskToBack (boolean nonRoot)
アプリケーション全体を終了する際の推奨される終了方法です。
アプリケーションを中断状態にします。
引数に false を指定した場合、アプリケーションの開始アクティビティ以外の呼び出しでは何もしなくなるため、通常は引数にtrueを指定して呼び出します。
ホームボタンを押した時の動作と同じ動きで、実行するとonPause()イベントが発生します。
次の再開までバックグラウンドで待機状態になり、メモリ不足になった時はOSにより自動でonDestroy()イベントが発生してアプリケーションの全てのタスクが終了します。
onDestroy()が呼ばれる前に復帰した時は最後のアクティビティから再開し、onRestart(), onStart(), onResume() の順でイベントが発生します。
 
例:

this.moveTaskToBack(true);

ドキュメントより引用:

public boolean moveTaskToBack (boolean nonRoot)
 
Since: API Level 1
Move the task containing this activity to the back of the activity stack.
The activity’s order within the task is unchanged.
If the task was moved (or it was already at the back) true is returned, else false.
 
訳:このアクティビティを含むタスク全体のアクティビティスタックの順番を後ろに移動させます。
タスク内のアクティビティの順番は変更されません。
 
パラメータ
nonRoot If false then this only works if the activity is the root of a task; if true it will work for any activity in a task.
  訳:falseの場合は現在のアクティビティがタスクのルートアクティビティ(アプリケーションの開始アクティビティ)の時だけ動作します。
     trueの場合はタスク内のどのアクティビティであっても動作します。

 
■android.os.Process.killProcess(int pid)
Process.myPid ()を引数に与えると現在のプロセスを強制終了します。
アクティビティが実行中のプロセスを対象に呼び出すと、finish()と同じくそのアクティビティを終了します。
ただし、onDestroy()などActivityのライフサイクルを全て無視して強制終了するため、通常は Activity.finish() が推奨されます。
例:

android.os.Process.killProcess(Process.myPid());

ドキュメントより引用:

public static final void killProcess (int pid)
 
Since: API Level 1
Kill the process with the given PID.
Note that, though this API allows us to request to kill any process based on its PID,
the kernel will still impose standard restrictions on which PIDs you are actually able to kill.
Typically this means only the process running the caller’s packages/application and any additional
processes created by that app; packages sharing a common UID will also be able to kill each other’s processes.
訳:指定したIDのプロセスを終了します。
このAPIでは指定のPIDに基づいてどんなプロセスでも終了することが許されていますが、
実際終了できるかどうかはカーネルの標準的な制限で決まる点に注意してください。
つまり、典型的には呼び出し元のパッケージやアプリケーションが実行しているプロセスと、そのアプリが作成した追加のプロセスに限られるという意味です。
UIDを共有しているパッケージもまたお互いのプロセスを終了させる事ができます。

 
■System.exit(int)
System.exit(RESULT_OK)のように実行することで実行中のプロセスを強制終了します。
android.os.Process.killProcess(Process.myPid()) と同じような動きになりますが、
安全ではないので使うべきではありません。
ドキュメントには、

public static void exit (int code)
 
Since: API Level 1
Causes the virtual machine to stop running and the program to exit.
If runFinalizersOnExit(boolean) has been previously invoked with a true argument, then all objects will be properly garbage-collected and finalized first.
訳:バーチャルマシンの実行を停止し、プログラムを終了させます。
runFinalizersOnExit(boolean) を事前に引数にtrueを指定して呼び出してれば、全てのオブジェクトは最初に適切にガベージコレクトされてファイナライズされます。

のように一見、runFinalizersOnExit(true)を設定しておけば問題ないかのように書かれていますが、
実際にはrunFinalizersOnExit(boolean)の説明に

This method is deprecated. this method is unsafe.

と、どちらにしても安全ではない事が明確に書かれているためです。
 
通常は finish() または moveTaskToBack(true)を使い、どうしてもプロセスを強制終了したい場合は、Process.killProcess(Process.myPid ()) を使いましょう。
 
■おまけ…
アプリ内の全てのタスク(アクティビティ,プロセス)を一度に即終了したい場合, moveTaskToBack(true) を使う以外の方法として次のようなものがあります。
 
・AndroidManifest.xml で <activity android:noHistory=”true”> オプションを指定して finish() する。
 noHistory=”true”を指定しておくとアクティビティのスタックがなくなる事を利用する方法です。
 
参考:
Activity(developer.android.com)
 アクティビティのライフサイクルについてなど。
アクティビティとタスクデザイン (ソフトウェア技術ドキュメントを勝手に翻訳)
Application Fundamentals(developer.android.com)
android close application
 Androidの強制終了の仕方についての議論。

Cygwinでも apt-get (apt-cyg) を使う

apt-cyg をインストールすることでパッケージインストールをCUIで行うことができるようになります。
 
apt-cyg プロジェクト
http://code.google.com/p/apt-cyg/
 
■インストール手順:

svn –force export http://apt-cyg.googlecode.com/svn/trunk/ /usr/local/bin/
chmod +x /usr/local/bin/apt-cyg

 

■使い方:

パッケージをインストールする。
apt-cyg install <package names>
 
パッケージを削除する。
apt-cyg remove <package names>
 
setup.ini を更新する。
apt-cyg update
 
インストールされているパッケージの一覧を表示する。
apt-cyg show
 
パターン(複数可)に一致するパッケージを探す。
apt-cyg find <pattern(s)>
 
パターン(複数可)に一致するパッケージの情報を表示する。
apt-cyg describe <pattern(s)>
 
指定したコマンドやファイルを含むパッケージを見つけ出す。
apt-cyg packageof <commands or files>