eclipseのサンプル・プロジェクトと、APIレベルの話し


2014年4月6日現在の使い方です。
使い方は古くなる場合があります。

サンプル・プロジェクトを開く


SDKフォルダの中の「samples」にいろいろサンプルが入っている。
「android-10」は、android2.3.3に向けたサンプル。
SDKマネージャーで、android2.3.3をダウンロードすると、追加される。


サンプルを開くには、eclipseの「メニュー＞ファイル＞新規＞プロジェクト」を選択。



「Androidサンプル・プロジェクト」を選択。



ビルド・ターゲットに、「Android 2.3.3」か、「Android 4.4.2」を選択。
今回は、「Android 2.3.3」を選択してみる。



お好みで、サンプルを選択してみる。



プロジェクトが開いたら、実行してみる。



このアプリは、横長の画面だった。



「Ctrl+F11」か「Ctrl+F12」で画面回転。




サンプル・プロジェクトの対応するバージョンを確認

eclipseで、「AndroidManifest.xml」を開き、下のタブで、「AndroidManifest.xml」を選択。

次の行が見える。


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

「minSdkVersion="3"」とは、もともとこのパッケージがAPIレベル3以上向けで開発されたことを意味し、
それはつまり、android1.5未満のスマホにはインストールできないという宣言です。




また、「project.properties」を開いてみると、次の１行が見える。


target=android-10


これは、ビルド・ターゲットに、「Android 2.3.3」のライブラリを選択したことを意味する。




もし、プロジェクト作成時のビルド・ターゲットに、「Android 4.4.2」を選択するとこうなる。(eclipseが、ファイルの内容を自動的に書き換えている)
AndroidManifest.xmlの、「targetSdkVersion="11"」とは、このアプリが「APIレベル11」(android3.0)で動作を保障するという宣言。
project.propertiesの、「target=android-19」は、ビルド・ターゲットに、「APIレベル19」(Android 4.4.2)のライブラリを選択したことを意味する。

AndroidManifest.xml

<uses-sdk android:minSdkVersion="3" android:targetSdkVersion="11"/>

project.properties

target=android-19



この場合は、android1.5未満のスマホは対象外で、android3.0を動作保障しており、
android4.4.2のライブラリを使用してビルドしたアプリという意味になります。



もともと、このサンプルアプリは、APIレベル3(android1.5)以上で動くように設計されているので、
ビルド・ターゲットは、「android1.5」以上なら、「Android 2.3.3」でも「Android 4.4.2」でもかまわないわけです。
対応するバージョンが無いとエラーになったりしますので、そのときは、必要なバージョンをSDKマネージャーでダウンロードします。
外部でつくられたサンプルなどを使うときは、
AndroidManifest.xmlや、project.propertiesのAPIレベルの記述を、自分で書き換える必要がある場合があるかもしれません。



APIレベルが高いアプリ＝最新のandroidの機能を使用するアプリは、いろんな新しい機能を組み込めますが、
新機種のスマホを持つユーザーがまだ多くないため、多くの人に見てもらえないというデメリットがあります。
バランスをみながら、ターゲットとするプラットフォームを考えてアプリを作ったほうがよさそうです。
とりあえず、APIレベル10、android2.3.3向けのアプリを基本に考えてみようかと思います。
というか、私が持ってるスマホが、XPERIAのarc(SO-01C)なので。



プラットフォームと、APIレベルの関係

プラットフォームのバージョンと、APIレベルの関係は、次のようなものです。

プラットフォーム API レベル
Android 4.4
Android 4.4.2		 19
Android 4.3 18
Android 4.2
Android 4.2.2		 17
Android 4.1
Android 4.1.1		 16
Android 4.0.3 15
Android 4.0
Android 4.0.1
Android 4.0.2		 14
Android 3.2 13
Android 3.1 12
Android 3.0 11
Android 2.3.3
Android 2.3.4		 10
Android 2.3
Android 2.3.1
Android 2.3.2		 9
Android 2.2 8
Android 2.1 7
Android 2.0.1 6
Android 2.0 5
Android 1.6 4
Android 1.5 3
Android 1.1 2
Android 1.0 1










戻る