SDK Tools Revision 8とADT 8.0.0の変更点まとめ(Gingerbread)

トピック, Android | 23:01 |

SDKと共にバージョンアップした「SDK Tools Revision 8」と「ADT 8.0.0」の変更点をまとめました。原文はこちらとこちら。

SDK Tools Revision 8の変更点

依存関係

EclipseのADTを利用して開発している場合、SDK Tools r8は ADT8.0.0以降を対象としてデザインされていることに注意して下さい。SDK Tools r8のインストール後に、ADTプラグインを8.0.0に更新することを強くオススメします。

SDK Tools r7からの更新

SDK Tools r8を以前のバージョンから更新する場合、adbツールの配置場所が <SDK>/tools/adb から <SDK>/platform-tools/adb に変更になったことに注意して下さい。これが意味するところは、パスの設定を新しく追加する必要があることと、カスタムビルドスクリプトのパス参照を修正する必要があるということです。adbの実行ファイルを新しい場所から古い場所へコピーすることはオススメできません。何故なら、SDK Toolsの更新によって、コピーしたadbを削除するかもしれないからです。

主な変更点

• 全てのSDKプラットフォームがライブラリプロジェクトをサポートします。
• (本当の意味での)デバッグビルドをサポートします。デベロッパーはマニフェストファイルの<application>タグの属性に、android:debuggableを追記する必要がなくなりましたーこの属性は自動的にツールが付加します。
  • Eclipse/ADTでは、全てのインクリメンタルなビルドはデバッグビルドであると仮定し、android:debuggable="true"としてツールが付加します。署名済みリリースビルドとしてエクスポートした場合は、この属性は付加されません。
  • Antでは、ant debugコマンドを実行した場合に、同様の属性が付加され、ant releaseコマンドを実行した場合は付加されません。手動で android:debuggable="true"を追記した場合は、ant releaseコマンドを実行した場合においても、デバッグビルドとして動作するでしょう。
• リリースビルドにおいて自動的にProGuardをサポートします。デベロッパーは android ツールを用いてProGuardの設定を生成しますービルドツールがプロジェクトのソースのビルド中にProGuardを走らせます。
• 新しい上書き可能なAnt javacプロパティ： java.encoding, java.source　そして、java.target(デフォルト値は"ascii","1.5")
• ヒエラルキービューワーツールのための新しいUI

ADT(8.0.0)の変更点（SDK Toolsの変更点と重複する部分を除く）

• SDK Tools のリビジョン番号に従うように番号体系を変更。メジャーバージョンは常にSDK Toolsのリビジョン番号に一致するようになります。例えば、ADT 8.x は SDK Tools r8といった形です。
• ビジュアルレイアウトエディターが完全に書き換えられました（この作業はまだ進行中です）。現在含まれるもの：
  • 全てのレイアウトのクラスについて、パレットからドラッグアンドドロップでレイアウトが配置できます。
  • あるレイアウトビューから別のレイアウトビューへ、あるレイアウトファイルから別のレイアウトファイルへ、レイアウトビュー中のウィジェットの移動
  • enum/flagを有するコンテキストメニューの型プロパティ
  • 新しいズームコントロール
• ヒエラルキービューワープラグインがEclipseに統合されました
• もはや、Android起動コンフィグレーションは、起動時にワークスペース全体を再コンパイルしません。
• android.jar ソースとjavadocの配置場所を調整できるようになりました。

文責：技術部　瀬戸 直喜(前・日本Androidの会四国支部長/情報セキュリティスペシャリスト)

Androidとセキュリティ：Android 2.3(Gingerbread) SDKに標準搭載されたProGuardを試す

Android, Tips, SDK, セキュリティ | 15:07 |

はじめに

前回の記事ではAntを使う形で、難読化ツールであるProGuardの適用方法を紹介しました。*1

今回は本日(日本時間12/7)リリースされた Android 2.3(Gingerbread)のSDK（正確にはSDK Tools r8とADT8.0.0）に標準で搭載されたProGuardの適用方法について紹介します。

ProGuardとは

詳細は前回の記事を参照頂きたいのですが、ProGuardが初めての方の為に簡単に説明します。ProGuardはソースコードをコンパイルする際に処理を最適化したり、プログラム中の変数やメソッドを意味のない文字列に置き換え、逆コンパイルされた際に処理の中身をわかりにくくする、いわゆる「難読化」を行うツールです。

これまでもAntを使ってProGuardの適用は行えましたが、最新のSDKでは標準搭載され、Eclipse上から簡単に難読化が行えるようになりました。

GoogleがProGuardを標準搭載した理由

他者による解析を難しくさせるツールを標準機能として載せるということは、裏を返せば「Androidのアプリケーションは、リバースエンジニアリングが容易」ということでしょう。Google公式サイトの解説ページに「ProGuardは完全にオプションとして動作するが、適用を"強くおすすめする"」と書かれています。「Androidアプリ開発者はコードレベルで知的財産を守るべき」という、Googleからの静かなるメッセージなのかもしれません。

ProGuardを有効にする方法

それではどのようにProGuardを適用すればよいか、順を追って解説します。

プロジェクトの作成

Android 2.3のSDKを利用してEclipse上でプロジェクトを新規作成すると、ProGuardの設定が記述された「proguard.cfg」ファイルが自動的に生成されます。このファイルには予め、標準的に必要となる設定が記載されていますので、基本的に修正の必要はありません。

default.propertiesの修正

作成したプロジェクトのホーム直下に配置されているdefault.propertiesの最終行に、下記を追記します。

proguard.config = <proguard.cfgの絶対パス> または <proguard.cfgのプロジェクトホームからの相対パス>

以下はプロジェクトのホームにproguard.cfgが配置されている状態での、default.propertiesの設定の例です。

# This file is automatically generated by Android Tools.
# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
#
# This file must be checked in Version Control Systems.
#
# To customize properties used by the Ant build system use,
# "build.properties", and override values to adapt the script to your
# project structure.

# Project target.
target=android-9
proguard.config=proguard.cfg

基本的にはこの設定だけでProGuardが有効になります！*2

ProGuardの設定変更

基本的に前節の設定のみでProGuardが実行されますが、下記のような場合は実行に失敗することがあります。

• AndroidManifest.xmlファイルのみから参照されているクラス
• JNIから呼び出されるメソッド
• 動的参照される変数やメソッド

ProGuardの実行に失敗する場合は、proguard.cfgファイルに -keep オプションを付加した行を追記し、ProGuardの適用を除外する必要があります。

-keep public class <MyClass>

-keepオプションに関する詳しい情報は、前回の記事やProGuardのマニュアルを参照して下さい。

ProGuardを適用する

Antを使う

従来の方法と同様、ant release コマンドでProGuardを適用することが可能です。詳細は前回の記事を参照して下さい。

Eclipseのエクスポート機能を使う

メニューから、ファイル -> エクスポート -> Android -> Export Android application と選択して、アプリケーションへの署名を行い、apkファイルを出力します。

apkファイルの出力と同時に、下記のようなログがEclipseのコンソールビューに出力されているはずです。*3

[2010-12-07 13:05:28 - HelloAndroid] Refreshing resource folders.
[2010-12-07 13:05:28 - HelloAndroid] Starting incremental Pre Compiler: Checking resource changes.
[2010-12-07 13:05:28 - HelloAndroid] Nothing to pre compile!
[2010-12-07 13:05:28 - HelloAndroid] /android-sdk-mac_x86/platform-tools/aapt package -f -v -M /Users/seto/Documents/workspace/HelloAndroid/AndroidManifest.xml -S /Users/seto/Documents/workspace/HelloAndroid/res -A /Users/seto/Documents/workspace/HelloAndroid/assets -I /android-sdk-mac_x86/platforms/android-9/android.jar -F /var/folders/cb/cb2FqG62E5izgbafkF4ouE++--U/-Tmp-/android_1153826279934575801.ap_ 
[2010-12-07 13:05:28 - HelloAndroid] Found 0 custom asset files in /Users/seto/Documents/workspace/HelloAndroid/assets
[2010-12-07 13:05:28 - HelloAndroid] Locale/Vendor pairs:
[2010-12-07 13:05:28 - HelloAndroid]    /
[2010-12-07 13:05:28 - HelloAndroid]    /
[2010-12-07 13:05:28 - HelloAndroid]    /
[2010-12-07 13:05:28 - HelloAndroid]    /
[2010-12-07 13:05:28 - HelloAndroid] 
[2010-12-07 13:05:28 - HelloAndroid] ファイル:
[2010-12-07 13:05:28 - HelloAndroid]   drawable-hdpi/icon.png
[2010-12-07 13:05:28 - HelloAndroid]       Src: /Users/seto/Documents/workspace/HelloAndroid/res/drawable-hdpi/icon.png
[2010-12-07 13:05:28 - HelloAndroid]   drawable-ldpi/icon.png
[2010-12-07 13:05:28 - HelloAndroid]       Src: /Users/seto/Documents/workspace/HelloAndroid/res/drawable-ldpi/icon.png
[2010-12-07 13:05:28 - HelloAndroid]   drawable-mdpi/icon.png
[2010-12-07 13:05:28 - HelloAndroid]       Src: /Users/seto/Documents/workspace/HelloAndroid/res/drawable-mdpi/icon.png
[2010-12-07 13:05:28 - HelloAndroid]   layout/main.xml
[2010-12-07 13:05:28 - HelloAndroid]       Src: /Users/seto/Documents/workspace/HelloAndroid/res/layout/main.xml
[2010-12-07 13:05:28 - HelloAndroid]   values/strings.xml
[2010-12-07 13:05:28 - HelloAndroid]       Src: /Users/seto/Documents/workspace/HelloAndroid/res/values/strings.xml
[2010-12-07 13:05:28 - HelloAndroid]   AndroidManifest.xml
[2010-12-07 13:05:28 - HelloAndroid]       Src: /Users/seto/Documents/workspace/HelloAndroid/AndroidManifest.xml
[2010-12-07 13:05:28 - HelloAndroid] Including resources from package: /android-sdk-mac_x86/platforms/android-9/android.jar
[2010-12-07 13:05:28 - HelloAndroid] applyFileOverlay for drawable
[2010-12-07 13:05:28 - HelloAndroid] applyFileOverlay for layout
[2010-12-07 13:05:28 - HelloAndroid] applyFileOverlay for anim
[2010-12-07 13:05:28 - HelloAndroid] applyFileOverlay for xml
[2010-12-07 13:05:28 - HelloAndroid] applyFileOverlay for raw
[2010-12-07 13:05:28 - HelloAndroid] applyFileOverlay for color
[2010-12-07 13:05:28 - HelloAndroid] applyFileOverlay for menu
[2010-12-07 13:05:28 - HelloAndroid]     (processed image /Users/seto/Documents/workspace/HelloAndroid/res/drawable-hdpi/icon.png: 95% size of source)
[2010-12-07 13:05:28 - HelloAndroid]     (processed image /Users/seto/Documents/workspace/HelloAndroid/res/drawable-ldpi/icon.png: 89% size of source)
[2010-12-07 13:05:28 - HelloAndroid]     (processed image /Users/seto/Documents/workspace/HelloAndroid/res/drawable-mdpi/icon.png: 85% size of source)
[2010-12-07 13:05:28 - HelloAndroid]     (new resource id icon from drawable-hdpi/icon.png #generated)
[2010-12-07 13:05:28 - HelloAndroid]     (new resource id icon from drawable-hdpi/icon.png #generated)
[2010-12-07 13:05:28 - HelloAndroid]     (new resource id icon from drawable-hdpi/icon.png #generated)
[2010-12-07 13:05:28 - HelloAndroid]     (new resource id main from /Users/seto/Documents/workspace/HelloAndroid/res/layout/main.xml)
[2010-12-07 13:05:28 - HelloAndroid] Opening '/var/folders/cb/cb2FqG62E5izgbafkF4ouE++--U/-Tmp-/android_1153826279934575801.ap_'
[2010-12-07 13:05:28 - HelloAndroid] Writing all files...
[2010-12-07 13:05:28 - HelloAndroid]       'res/layout/main.xml' (compressed 49%)
[2010-12-07 13:05:28 - HelloAndroid]       'AndroidManifest.xml' (compressed 61%)
[2010-12-07 13:05:28 - HelloAndroid]       'resources.arsc' (not compressed)
[2010-12-07 13:05:28 - HelloAndroid]       'res/drawable-hdpi/icon.png' (not compressed)
[2010-12-07 13:05:28 - HelloAndroid]       'res/drawable-ldpi/icon.png' (not compressed)
[2010-12-07 13:05:28 - HelloAndroid]       'res/drawable-mdpi/icon.png' (not compressed)
[2010-12-07 13:05:28 - HelloAndroid] Generated 6 files
[2010-12-07 13:05:28 - HelloAndroid] Included 0 files from jar/zip files.
[2010-12-07 13:05:28 - HelloAndroid] Checking for deleted files
[2010-12-07 13:05:28 - HelloAndroid] 終了!
[2010-12-07 13:05:28 - HelloAndroid] ProGuard, version 4.4
[2010-12-07 13:05:28 - HelloAndroid] Reading input...
[2010-12-07 13:05:28 - HelloAndroid] Reading program jar [/private/var/folders/cb/cb2FqG62E5izgbafkF4ouE++--U/-Tmp-/android_16917046672536715.jar]
[2010-12-07 13:05:28 - HelloAndroid] Reading library jar [/android-sdk-mac_x86/platforms/android-9/android.jar]
[2010-12-07 13:05:30 - HelloAndroid] 初期化中...
[2010-12-07 13:05:30 - HelloAndroid] 注: the configuration refers to the unknown class 'com.android.vending.licensing.ILicensingService'
[2010-12-07 13:05:30 - HelloAndroid] 注: there were 1 references to unknown classes.
[2010-12-07 13:05:30 - HelloAndroid]       You should check your configuration for typos.
[2010-12-07 13:05:30 - HelloAndroid] Ignoring unused library classes...
[2010-12-07 13:05:30 - HelloAndroid]   Original number of library classes: 2750
[2010-12-07 13:05:30 - HelloAndroid]   Final number of library classes:    148
[2010-12-07 13:05:30 - HelloAndroid] Printing kept classes, fields, and methods...
[2010-12-07 13:05:30 - HelloAndroid] Shrinking...
[2010-12-07 13:05:30 - HelloAndroid] Printing usage to [/Users/seto/Documents/workspace/HelloAndroid/proguard/usage.txt]...
[2010-12-07 13:05:30 - HelloAndroid] Removing unused program classes and class elements...
[2010-12-07 13:05:30 - HelloAndroid]   Original number of program classes: 8
[2010-12-07 13:05:30 - HelloAndroid]   Final number of program classes:    2
[2010-12-07 13:05:30 - HelloAndroid] Optimizing...
[2010-12-07 13:05:30 - HelloAndroid]   Number of finalized classes:                 0
[2010-12-07 13:05:30 - HelloAndroid]   Number of vertically merged classes:         0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of horizontally merged classes:       0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed write-only fields:         0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of privatized fields:                 0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined constant fields:           0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of privatized methods:                0
[2010-12-07 13:05:30 - HelloAndroid]   Number of staticized methods:                2
[2010-12-07 13:05:30 - HelloAndroid]   Number of finalized methods:                 0
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed method parameters:         2
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined constant parameters:       1
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined constant return values:    0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined short method calls:        0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined unique method calls:       0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined tail recursion calls:      0
[2010-12-07 13:05:30 - HelloAndroid]   Number of merged code blocks:                0
[2010-12-07 13:05:30 - HelloAndroid]   Number of variable peephole optimizations:   1
[2010-12-07 13:05:30 - HelloAndroid]   Number of arithmetic peephole optimizations: 0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of cast peephole optimizations:       0
[2010-12-07 13:05:30 - HelloAndroid]   Number of field peephole optimizations:      0
[2010-12-07 13:05:30 - HelloAndroid]   Number of branch peephole optimizations:     0
[2010-12-07 13:05:30 - HelloAndroid]   Number of simplified instructions:           0
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed instructions:              19
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed local variables:           6
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed exception blocks:          0
[2010-12-07 13:05:30 - HelloAndroid]   Number of optimized local variable frames:   1
[2010-12-07 13:05:30 - HelloAndroid] Shrinking...
[2010-12-07 13:05:30 - HelloAndroid] Removing unused program classes and class elements...
[2010-12-07 13:05:30 - HelloAndroid]   Original number of program classes: 2
[2010-12-07 13:05:30 - HelloAndroid]   Final number of program classes:    2
[2010-12-07 13:05:30 - HelloAndroid] Optimizing...
[2010-12-07 13:05:30 - HelloAndroid]   Number of finalized classes:                 0
[2010-12-07 13:05:30 - HelloAndroid]   Number of vertically merged classes:         0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of horizontally merged classes:       0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed write-only fields:         0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of privatized fields:                 0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined constant fields:           0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of privatized methods:                0
[2010-12-07 13:05:30 - HelloAndroid]   Number of staticized methods:                0
[2010-12-07 13:05:30 - HelloAndroid]   Number of finalized methods:                 0
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed method parameters:         0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined constant parameters:       0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined constant return values:    0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined short method calls:        0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined unique method calls:       0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined tail recursion calls:      0
[2010-12-07 13:05:30 - HelloAndroid]   Number of merged code blocks:                0
[2010-12-07 13:05:30 - HelloAndroid]   Number of variable peephole optimizations:   0
[2010-12-07 13:05:30 - HelloAndroid]   Number of arithmetic peephole optimizations: 0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of cast peephole optimizations:       0
[2010-12-07 13:05:30 - HelloAndroid]   Number of field peephole optimizations:      0
[2010-12-07 13:05:30 - HelloAndroid]   Number of branch peephole optimizations:     0
[2010-12-07 13:05:30 - HelloAndroid]   Number of simplified instructions:           0
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed instructions:              2
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed local variables:           0
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed exception blocks:          0
[2010-12-07 13:05:30 - HelloAndroid]   Number of optimized local variable frames:   0
[2010-12-07 13:05:30 - HelloAndroid] Shrinking...
[2010-12-07 13:05:30 - HelloAndroid] Removing unused program classes and class elements...
[2010-12-07 13:05:30 - HelloAndroid]   Original number of program classes: 2
[2010-12-07 13:05:30 - HelloAndroid]   Final number of program classes:    2
[2010-12-07 13:05:30 - HelloAndroid] Optimizing...
[2010-12-07 13:05:30 - HelloAndroid]   Number of finalized classes:                 0
[2010-12-07 13:05:30 - HelloAndroid]   Number of vertically merged classes:         0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of horizontally merged classes:       0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed write-only fields:         0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of privatized fields:                 0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined constant fields:           0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of privatized methods:                0
[2010-12-07 13:05:30 - HelloAndroid]   Number of staticized methods:                0
[2010-12-07 13:05:30 - HelloAndroid]   Number of finalized methods:                 0
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed method parameters:         0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined constant parameters:       0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined constant return values:    0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined short method calls:        0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined unique method calls:       0
[2010-12-07 13:05:30 - HelloAndroid]   Number of inlined tail recursion calls:      0
[2010-12-07 13:05:30 - HelloAndroid]   Number of merged code blocks:                0
[2010-12-07 13:05:30 - HelloAndroid]   Number of variable peephole optimizations:   0
[2010-12-07 13:05:30 - HelloAndroid]   Number of arithmetic peephole optimizations: 0   (使用不可)
[2010-12-07 13:05:30 - HelloAndroid]   Number of cast peephole optimizations:       0
[2010-12-07 13:05:30 - HelloAndroid]   Number of field peephole optimizations:      0
[2010-12-07 13:05:30 - HelloAndroid]   Number of branch peephole optimizations:     0
[2010-12-07 13:05:30 - HelloAndroid]   Number of simplified instructions:           0
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed instructions:              0
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed local variables:           0
[2010-12-07 13:05:30 - HelloAndroid]   Number of removed exception blocks:          0
[2010-12-07 13:05:30 - HelloAndroid]   Number of optimized local variable frames:   0
[2010-12-07 13:05:30 - HelloAndroid] Obfuscating...
[2010-12-07 13:05:30 - HelloAndroid] Printing mapping to [/Users/seto/Documents/workspace/HelloAndroid/proguard/mapping.txt]...
[2010-12-07 13:05:30 - HelloAndroid] Writing output...
[2010-12-07 13:05:30 - HelloAndroid] Preparing output jar [/private/var/folders/cb/cb2FqG62E5izgbafkF4ouE++--U/-Tmp-/android_2607110758288445210.jar]
[2010-12-07 13:05:30 - HelloAndroid]   Copying resources from program jar [/private/var/folders/cb/cb2FqG62E5izgbafkF4ouE++--U/-Tmp-/android_16917046672536715.jar]
[2010-12-07 13:05:30 - HelloAndroid] Printing classes to [/Users/seto/Documents/workspace/HelloAndroid/proguard/dump.txt]...

下記のように出力されていれば、難読化がされています。

[2010-12-07 13:05:30 - HelloAndroid] Obfuscating...
[2010-12-07 13:05:30 - HelloAndroid] Printing mapping to [/Users/seto/Documents/workspace/HelloAndroid/proguard/mapping.txt]...

ProGuard有効時に出力されるファイル/ディレクトリ

ProGuardが適用されると、<プロジェクトのホーム>/proguard/ にディレクトリが生成され、その中に下記のようなファイルが出力されます。*4

• dump.txt：.apkファイル中のクラスの内部構造が記載されています。
• mapping.txt：難読化前と難読化後のクラス、メソッド、変数の対応リスト
• seed.txt：難読化されていないクラスやメンバのリスト
• usage.txt：.apkファイルから外されたコードのリスト

特に、mapping.txtは、リリースビルドしたapkから送られる難読化されたバグリポート（スタックトレース）を可読化するために必要となります。

ProGuard利用時の注意点

proguardディレクトリは、リリースビルドの際に上書きされます。これらを失うと、リリース後のバグレポートから原因を調査することが困難になりますので、proguardディレクトリの中身（特にmapping.txtファイル）は、リリースバージョン毎に保存しておく必要があります。

Android開発者サイトでは、保存の方法として下記のようなものが推奨されています。

• リリース時のバージョンまたはビルド番号を、フォルダやファイル名に追記する
• バージョン管理システムにファイルを登録する

難読化されたスタックトレースをデコードする方法

ProGuardは難読化において相応の効果を発揮するツールではありますが、反面、デバッグに必要な情報までをも難読化させてしまう欠点があります。そのため、最新のAndroid SDKには、難読化されたスタックトレースを可読化するための、シェルスクリプトが付属されています。<sdk_root>/tools/proguard/ ディレクトリにretrace.sh（Windowsの場合、retrace.bat）が格納されていますので、このスクリプトを使用します。

コマンドの書式：

retrace.bat|retrace.sh [-verbose] mapping.txt [<stacktrace_file>]

使用例：

retrace.sh -verbose mapping.txt obfuscated_trace.txt

例のmapping.txtは、リリース時に保存しておいたファイル、obfuscated_trace.txtは、難読化されたバグリポート中のスタックトレースを記載したファイルです。

ちなみに、スタックトレースを記載したファイルを省略した場合、標準入力からスタックトレースを読み込んで、デコードします。

より簡単に使えるようになったProGuardで、あなたのアプリケーションを守りましょう！

文責：技術部 植物工場研究G 瀬戸 直喜

Android SDK 2.3(GingerBread)リリースまとめ(API編)

トピック | 07:39 |

ついに待ちに待ったAndroid SDK 2.3のGingerBreadがリリースされたので、早速その新機能をまとめてみました。

今回は見た目の変更が多いという噂でしたが、そうでもなかったようです。しかし、今までにないくらい新機能が増えたように思います。

まずは2.3で追加された新APIを見ていきましょう。

Android SDK 2.3からのAPI

SIPベースのVoIP

フレームワークにSIPプロトコルスタックが搭載され、インターネット電話を扱えるようになりました。SIPのサンプルアプリケーションはココにあります。以下は実際にSipDemoを動かしてみたところ。

　

NFC

NFC(Near Field Communications)のAPIが追加され、ハードウェアが搭載されていれば、FeliCaのように近距離通信を行うことができるようになりました。NFCのサンプルコードはココです。現時点ではまだNFCのハードウェアが搭載されたAndroid 2.3の端末がないため、試せません。エミュレータで実行すると、当然のようにExceptionが発生してしまいました。

ジャイロスコープとその他のセンサー

ジャイロスコープ、回転速度、直線加速、重力、バロメーターのセンサーが増え、センサーAPIから使用できるようになりました。センサーAPIの詳細はココです。

複数のカメラのサポート

アプリケーションから複数のカメラが利用できるようになりました。フロントカメラを利用するサンプルコードはココです。APIDemoのCameraPreviewを試してみましたが、「カメラが一個しか搭載されてないよ！」と怒られてしまいました。

オーディオ効果のミキシング

オーディオにバスブーストやリバーブなどの様々なエフェクトを掛けることのできるAPIが追加されました。オーディオエフェクトのサンプルコードはココです。以下は実際にAPIDemoを動かしてみたところ。

その他のメディア関連の新機能

JPEG画像のEXIF情報の中のaltitude(高度)の値が取得できるようになりました。また、ビデオ撮影中のオリエンテーション情報をsetOrientationHint()メソッドでMediaRecorderに通知することができるようになりました。

ダウンロードマネージャ

DownloadManagerが追加され、長期間動作するHTTPダウンロードをアプリケーションから要求することができるようになりました。

制限モード

StrictModeと呼ばれる制限モードが追加されました。ANRを発生させないために、UIスレッドで時間のかかる処理を使った場合に検知してくれるモードです。検知した場合はHandler、AysncTask、IntentServiceなどを使って回避するようにコードを書き換えることを推奨します。

UIフレームワーク

overscrollのサポート

限界までスクロールしても、余分にスクロールさせることができるようになりました。余分にスクロールさせる量などは制御することができます。

タッチフィルタリング

マルウェアなどから購入ボタンやパーミッション許可を与えるボタンなどを押させることがないように、タッチフィルタリングを使ってセキュリティを強化することができるようになりました。サンプルコードはココです。

イベント管理の改善

InputEventが新しく追加されました。

モーションイベントの改善

MotionEventにポインタIDが追加されました。それによって、アプリケーションから個々の指の動きを捕捉することができるようになりました。

テキスト選択コントロール

setComposingRegionメソッドにより、アプリケーションから編集中のテキスト領域を設定できるようになりました。TextViewに新しい属性も追加されました。

アクティビティの制御

ActivityInfoクラスにアクティビティの向きを管理する定数が追加されました。画面の回転に合わせてすべての向きに画面表示を合わせることが可能になったようです。

ノティファケーションのテキストとアイコンスタイル

ノティファケーションスタイルを管理する新しい属性が追加されました。

WebView

setUseWebViewBackgroundForOverscrollBackground()メソッドを使ってoverscrollの背景を指定することができるようになりました。

超大型スクリーン

タブレットデバイスなどに見られる超大型スクリーンに対応しました。超大型スクリーンの対応方法はココを参照してください。

グラフィック

OpenGL ES 2.0の残りのglDrawElements()、glVertexAttribPointer()メソッドに対応しました。また、YV12の画像フォーマットに対応しました。

コンテントプロバイダ

• AlarmClockプロバイダが追加されました。
• MediaStoreがPLAY_FROM_SEARCHの新しいインテントアクションに対応しました。検索されると、自動的に音楽が再生されるインテントです。
• MediaStoreが新しいMEDIA_IGNORE_FILENAMEフラグによって無視するファイル名を指定できるようになりました。
• SettingsプロバイダにAPPLICATION_DETAILS_SETTINGSとMANAGE_ALL_APPLICATIONS_SETTINGSのアクションが増えました。前者はアプリケーションの詳細設定画面、後者はアプリケーション管理画面となります。
• ContactsContractプロバイダにSIPアドレスを格納するためのContactsContract.CommonDataKinds.SipAddressが追加されました。

Location

• LocationManagerはシステムに管理されたWorkSourceクラスにしたがって、wake locks と wifi locksを要求するアプリケーションを追跡し、バッテリ使用量のパラメータに追加するようになりました。
• LocationManagerに周期的または1回だけ位置情報を受け取る新しいメソッドが追加されました。

ストレージ

OBB (Opaque Binary Blob)をサポートするStorageManagerが新しく追加されました。2011年の初頭までにAndroid 2.3の開発ツールでOBBファイルを管理することができるようになる予定です。

パッケージマネージャ

PackageInfoクラスにfirstInstallTimeとlastUpdateTimeが追加されました。前者はパッケージのインストール日時で、後者は更新日時です。また、新しいgetProviderInfo()メソッドで独自のコンテントプロバイダクラスの情報も取得できるようになりました。

Telephony

TelephonyManagerにCDMA EVDO Rev BのネットワークタイプのためのNETWORK_TYPE_EVDO_Bの定数が追加されました。また、新しいgetPsc()メソッドを使用してUMTSネットワーク上のスクランブルコードを取得できるようになりました。

アクティビティ、ウインドウのライフサイクルのネイティブアクセス

• 新しいNativeActivityクラスを使ってネイティブコードにライフサイクルのコールバックを直接実装することができるようになりました。
• InputQueueクラスのコールバックインターフェースでネイティブコードからイベントキューを管理できるようになりました。
• SurfaceHolder.Callback2インターフェースでネイティブコードからSurfaceHolderを管理できるようになりました。
• Windowクラスの新しいメソッドのtakeInputQueueとtakeSurface()メソッドでネイティブコードからイベントとサーフェースを管理できるようになりました。
• NativeActivityについてはココに詳細があります。

Dalvikランタイム

• dalvik.systemから、いくつかの非推奨クラスを削除
• 新しいコレクションの追加。ArrayDeque, NavigableMap, ConcurrentSkipListMap, LinkedBlockingDeque
• 新しいArraysユティリティの追加。binarySearch(), copyOf(), copyOfRange(), 他。
• HttpURLConnectionのためのCookieManagerの追加。
• もっと下回りをカバーしたネットワークAPIの追加。InterfaceAddress, NetworkInterface, IDN
• Fileクラスの読み書きアクセスメソッドの追加。
• String.isEmpty()クラスのサポート。
• NormalizerとNormalizer.Formクラスのサポート。
• javax.net.sslのサーバソケットの改善。

マニフェストの新しい要素と属性

• supports-screens要素へのxlargeScreens属性の追加。超大型スクリーンをサポートするための物。
• <activity>要素へのandroid:screenOrientation属性の値の追加。
  • reverseLandscape
    • アクティビティが通常のランドスケープモードの上下反対の画面を持つ。
  • reversePortait
    • アクティビティが通常のポートレートモードの上下反対の画面を持つ。
  • sensorLandscape
    • アクティビティがランドスケープモード画面を持つが、センサーの検知により、持っている向きに合わせて画面の向きが入れ替わる。
  • sensorPortrait
    • アクティビティがポートレートモード画面を持つが、センサーの検知により、持っている向きに合わせて画面の向きが入れ替わる。
  • fullSensor
    • アクティビティがユーザーが動かした端末の向きに合わせて画面の向きが入れ替わる。

新しいパーミッション

• com.android.permission.SET_ALARM
  • アプリケーションからSET_ALARMのインテントをbroadcastできるようになる。
• android.permission.USE_SIP
  • アプリケーションから、SIP APIを使ってインターネット電話を使えるようにする。
• android.permission.NFC
  • アプリケーションから、NFC APIを使えるようにする。

新機能の定数

• android.hardware.audio.low_latency
  • アプリケーションは低待ち時間のオーディオパイプラインを利用して、音声の入出力を細かく扱います。
• android.hardware.camera.front
  • アプリケーションはフロントカメラを使います。
• android.hardware.nfc
  • アプリケーションはNFC機能を使います。
• android.hardware.sensor.barometer
  • アプリケーションは端末のバロメーターを使います。
• android.hardware.sensor.gyroscope
  • アプリケーションはジャイロスコープセンサーを使います。
• android.software.sip
  • アプリケーションはSIP APIを使っています。
• android.software.sip.voip
  • アプリケーションはSIPベースのVOIPサービスを使います。
• android.hardware.touchscreen.multitouch.jazzhand
  • アプリケーションは進歩したマルチポイントのマルチタッチ性能を使って、5点まで独立して追跡することができます。
• 詳細はuses-featureを見てください。

APIの新機能をひと通り列挙してみました。かなりの変更量でしたね。

API Level 8からの差分はココにまとまっています。

API以外にも変わっている部分があります。

引き続き、ハイライト編でお伝えします。