Android 4.3 API

API レベル: 18

Android 4.3(JELLY_BEAN_MR2)は、Jelly Bean リリースのアップデートであり、ユーザーとアプリ デベロッパー向けの新機能が追加されています。このドキュメントでは、特に注目すべき新しい API の概要を説明します。

アプリ デベロッパーは、できるだけ早く SDK Manager から Android 4.3 システム イメージと SDK プラットフォームをダウンロードする必要があります。アプリをテストするための Android 4.3 搭載デバイスがない場合は、Android 4.3 システム イメージを使用して Android Emulator でアプリをテストします。次に、Android 4.3 プラットフォームに対してアプリをビルドして、最新の API の使用を開始します。

対象 API レベルを更新する

Android 4.3 を搭載したデバイス向けにアプリを最適化するには、targetSdkVersion を "18" に設定し、Android 4.3 システム イメージにインストールしてテストしてから、この変更を含むアップデートを公開する必要があります。

Android 4.3 の API を使用しながら、古いバージョンもサポートするには、minSdkVersion でサポートされていない API を実行する前に、システム API レベルをチェックする条件をコードに追加します。下位互換性を維持する方法については、さまざまなプラットフォーム バージョンのサポートをご覧ください。

Android サポート ライブラリには、古いバージョンのプラットフォームに新機能を実装できるさまざまな API も用意されています。

API レベルの仕組みについて詳しくは、API レベルとはをご覧ください。

重要な動作の変更

以前に Android 向けアプリを公開したことがある場合は、Android 4.3 の変更によってアプリが影響を受ける可能性があることに注意してください。

アプリで暗黙的インテントを使用している場合

制限付きプロフィールの環境では、アプリが正常に動作しない可能性があります。

制限付きプロファイル環境のユーザーは、標準の Android アプリをすべて利用できるとは限りません。たとえば、制限付きプロファイルでは、ウェブブラウザとカメラアプリが無効になっている場合があります。したがって、アプリは、どのアプリが利用可能であるかを想定するべきではありません。Intent を処理できるアプリが利用可能かどうかを確認せずに startActivity() を呼び出すと、制限付きプロファイルでアプリがクラッシュする可能性があります。

暗黙的インテントを使用する場合は、resolveActivity() または queryIntentActivities() を呼び出して、インテントを処理できるアプリが利用可能であることを必ず確認する必要があります。次に例を示します。

Kotlin

val intent = Intent(Intent.ACTION_SEND)
...
if (intent.resolveActivity(packageManager) != null) {
    startActivity(intent)
} else {
    Toast.makeText(context, R.string.app_not_available, Toast.LENGTH_LONG).show()
}

Java

Intent intent = new Intent(Intent.ACTION_SEND);
...
if (intent.resolveActivity(getPackageManager()) != null) {
    startActivity(intent);
} else {
    Toast.makeText(context, R.string.app_not_available, Toast.LENGTH_LONG).show();
}

アプリがアカウントに依存している場合...

制限付きプロフィールの環境では、アプリが正常に動作しない可能性があります。

制限付きプロファイル環境内のユーザーは、デフォルトではユーザー アカウントにアクセスできません。アプリが Account に依存している場合、制限付きプロファイルで使用すると、アプリがクラッシュしたり、予期しない動作をしたりすることがあります。

アプリが機密性の高いアカウント情報に依存しているため、制限付きプロファイルがアプリをまったく使用できないようにするには、マニフェストの <application> 要素で android:requiredAccountType 属性を指定します。

制限付きプロファイルが独自のアカウントを作成できない場合でも、アプリの使用を継続できるようにするには、アカウントを必要とするアプリ機能を無効にするか、プライマリ ユーザーが作成したアカウントに制限付きプロファイルがアクセスできるようにします。詳しくは、下記の制限付きプロファイルでのアカウントのサポートをご覧ください。

アプリで VideoView を使用している場合

Android 4.3 では、動画が小さく表示されることがあります。

以前のバージョンの Android では、VideoView ウィジェットが layout_height と layout_width の "wrap_content" 値を "match_parent" と同じになるように誤って計算していました。そのため、以前は高さまたは幅に "wrap_content" を使用して、目的の動画レイアウトを実現できたかもしれませんが、Android 4.3 以降では、動画が非常に小さくなる可能性があります。この問題を解決するには、"wrap_content" を "match_parent" に置き換え、Android 4.3 とそれ以前のバージョンで動画が想定どおりに表示されることを確認します。

制限付きプロフィール

Android タブレットでは、メインユーザーに基づいて制限付きプロファイルを作成できるようになりました。ユーザーは制限付きプロファイルを作成する際に、プロファイルで使用できるアプリなどの制限を有効にできます。Android 4.3 の新しい API セットを使用すると、開発するアプリにきめ細かい制限設定を組み込むこともできます。たとえば、新しい API を使用すると、制限付きプロファイル環境で実行されているときに、アプリ内で利用できるコンテンツの種類をユーザーが制御できるようになります。

ユーザーが作成した制限を制御するための UI は、システムの設定アプリによって管理されます。アプリの制限設定をユーザーに表示するには、ACTION_GET_RESTRICTION_ENTRIES インテントを受信する BroadcastReceiver を作成して、アプリが提供する制限を宣言する必要があります。システムはこのインテントを呼び出して、利用可能な制限についてすべてのアプリにクエリを実行し、メインユーザーが制限付きプロフィールごとに制限を管理できるように UI を構築します。

BroadcastReceiver の onReceive() メソッドで、アプリが提供する制限ごとに RestrictionEntry を作成する必要があります。各 RestrictionEntry は、制限のタイトル、説明、および次のいずれかのデータ型を定義します。

  • TYPE_BOOLEAN: true または false の制限。
  • TYPE_CHOICE: 相互に排他的な複数の選択肢(ラジオボタンの選択肢)がある制限。
  • TYPE_MULTI_SELECT: 相互に排他的でない複数の選択肢(チェックボックスの選択肢)がある制限。

次に、すべての RestrictionEntry オブジェクトを ArrayList に格納し、EXTRA_RESTRICTIONS_LIST エクストラの値としてブロードキャスト レシーバの結果に格納します。

システムは、設定アプリでアプリの制限の UI を作成し、各 RestrictionEntry オブジェクトに指定された一意のキーを使用して各制限を保存します。ユーザーがアプリを開いたときに、getApplicationRestrictions() を呼び出して現在の制限をクエリできます。これにより、RestrictionEntry オブジェクトで定義した各制限の Key-Value ペアを含む Bundle が返されます。

ブール値、単一選択値、複数選択値では処理できない、より具体的な制限を指定する場合は、ユーザーが制限を指定できるアクティビティを作成し、ユーザーが制限設定からそのアクティビティを開けるようにします。ブロードキャスト レシーバで、結果の Bundle に EXTRA_RESTRICTIONS_INTENT エクストラを含めます。このエクストラでは、起動する Activity クラスを示す Intent を指定する必要があります(putParcelable() メソッドを使用して、インテントとともに EXTRA_RESTRICTIONS_INTENT を渡します)。プライマリ ユーザーがアクティビティに入ってカスタム制限を設定すると、アクティビティは、RestrictionEntry オブジェクトまたは Key-Value ペアのどちらを指定するかに応じて、EXTRA_RESTRICTIONS_LIST キーまたは EXTRA_RESTRICTIONS_BUNDLE キーを使用して、制限値を含む結果をエクストラで返す必要があります。

制限付きプロファイルでのアカウントのサポート

メインユーザーに追加されたアカウントは制限付きプロファイルで使用できますが、デフォルトでは AccountManager API からアカウントにアクセスできません。制限付きプロファイルで AccountManager を使用してアカウントを追加しようとすると、失敗します。これらの制限により、次の 3 つのオプションがあります。

  • 制限付きプロフィールから所有者のアカウントへのアクセスを許可する。

    制限付きプロファイルからアカウントにアクセスするには、android:restrictedAccountType 属性を <application> タグに追加する必要があります。

    <application ...
        android:restrictedAccountType="com.example.account.type" >

    注: この属性を有効にすると、制限付きプロファイルからプライマリ ユーザーのアカウントにアクセスできるようになります。したがって、アプリに表示される情報に、機密性の高い個人を特定できる情報(PII)が含まれていない場合にのみ、この設定を許可する必要があります。システム設定により、アプリが制限付きプロファイルにアカウントへのアクセスを許可していることがメインユーザーに通知されるため、アカウントへのアクセスがアプリの機能にとって重要であることをユーザーに明確に示す必要があります。可能であれば、アプリで許可されるアカウント アクセスの量を定義する、メインユーザー向けの適切な制限コントロールも提供する必要があります。

  • アカウントを変更できない場合は、特定の機能を無効にします。

    アカウントを使用したいが、アプリの主な機能にアカウントが必須ではない場合は、アカウントが利用可能かどうかを確認し、利用できない場合は機能を無効にできます。まず、利用可能な既存のアカウントがあるかどうかを確認する必要があります。存在しない場合は、getUserRestrictions() を呼び出して新しいアカウントを作成できるかどうかをクエリし、結果の DISALLOW_MODIFY_ACCOUNTS エクストラを確認します。true の場合は、アカウントへのアクセスを必要とするアプリの機能を無効にする必要があります。次に例を示します。

    Kotlin

    val um = context.getSystemService(Context.USER_SERVICE) as UserManager
    val restrictions: Bundle = um.userRestrictions
    if (restrictions.getBoolean(UserManager.DISALLOW_MODIFY_ACCOUNTS, false)) {
        // cannot add accounts, disable some functionality
    }

    Java

    UserManager um = (UserManager) context.getSystemService(Context.USER_SERVICE);
    Bundle restrictions = um.getUserRestrictions();
    if (restrictions.getBoolean(UserManager.DISALLOW_MODIFY_ACCOUNTS, false)) {
        // cannot add accounts, disable some functionality
    }

    注: このシナリオでは、マニフェスト ファイルで新しい属性を宣言しないでください。

  • 非公開アカウントにアクセスできない場合は、アプリを無効にします。

    アプリがアカウント内の機密性の高い個人情報に依存しているため、制限付きプロファイルではアプリを使用できないようにすることが重要な場合は(制限付きプロファイルでは現在、新しいアカウントを追加できないため)、<application> タグに android:requiredAccountType 属性を追加します。

    <application ...
        android:requiredAccountType="com.example.account.type" >

    たとえば、Gmail アプリはこの属性を使用して、制限付きプロファイルではアプリを無効にします。これは、オーナーの個人用メールを制限付きプロファイルで使用できないようにするためです。

  • ワイヤレスと接続

    Bluetooth Low Energy(Smart Ready)

    Android で、android.bluetooth の新しい API を使用して Bluetooth Low Energy(LE)がサポートされるようになりました。新しい API を使用すると、心拍数モニターや歩数計などの Bluetooth Low Energy 周辺機器と通信する Android アプリを構築できます。

    Bluetooth LE は、すべての Android 搭載デバイスで利用できるわけではないハードウェア機能であるため、マニフェスト ファイルで "android.hardware.bluetooth_le" の <uses-feature> 要素を宣言する必要があります。

    <uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />

    Android のクラシック Bluetooth API をすでに使い慣れている場合は、Bluetooth LE API の使用方法にいくつかの違いがあることに注意してください。最も重要なのは、BluetoothAdapter の取得、接続済みデバイスのリストの取得、デバイスの状態の確認など、一部の高レベルのオペレーションに使用する必要がある BluetoothManager クラスが追加されたことです。たとえば、BluetoothAdapter を取得する方法は次のようになります。

    Kotlin

    val bluetoothManager = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager
    bluetoothAdapter = bluetoothManager.adapter

    Java

    final BluetoothManager bluetoothManager =
            (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE);
    bluetoothAdapter = bluetoothManager.getAdapter();

    Bluetooth LE 周辺機器を検出するには、BluetoothAdapter で startLeScan() を呼び出し、BluetoothAdapter.LeScanCallback インターフェースの実装を渡します。Bluetooth アダプターが Bluetooth LE 周辺機器を検出すると、BluetoothAdapter.LeScanCallback 実装は onLeScan() メソッドの呼び出しを受け取ります。このメソッドは、検出されたデバイスを表す BluetoothDevice オブジェクト、デバイスの RSSI 値、デバイスのアドバタイズ レコードを含むバイト配列を提供します。

    特定の種類の周辺機器のみをスキャンする場合は、代わりに startLeScan() を呼び出し、アプリがサポートする GATT サービスを指定する UUID オブジェクトの配列を含めます。

    注: 以前の API を使用してスキャンできるのは、Bluetooth LE デバイスまたはクラシック Bluetooth デバイスのみです。LE デバイスとクラシック Bluetooth デバイスを同時にスキャンすることはできません。

    Bluetooth LE 周辺機器に接続するには、対応する BluetoothDevice オブジェクトで connectGatt() を呼び出し、BluetoothGattCallback の実装を渡します。BluetoothGattCallback の実装は、デバイスとの接続状態やその他のイベントに関するコールバックを受け取ります。メソッドが新しい状態として STATE_CONNECTED を渡した場合、onConnectionStateChange() コールバック中にデバイスとの通信を開始できます。

    デバイスの Bluetooth 機能にアクセスするには、アプリが特定の Bluetooth ユーザー権限をリクエストする必要もあります。詳細については、Bluetooth Low Energy API ガイドをご覧ください。

    Wi-Fi スキャン専用モード

    Android は、ユーザーの所在地を特定する際に、Wi-Fi を使用して付近のアクセス ポイントをスキャンすることで、位置情報の特定を支援することがあります。ただし、ユーザーはバッテリーを節約するために Wi-Fi をオフにしていることが多く、その結果、位置情報の精度が低下します。Android には、スキャン専用モードが追加されました。このモードでは、デバイスの Wi-Fi がアクセス ポイントをスキャンして位置情報を取得できます。アクセス ポイントに接続する必要がないため、バッテリー使用量を大幅に削減できます。

    ユーザーの位置情報を取得したいが、Wi-Fi が現在オフになっている場合は、アクション ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE を指定して startActivity() を呼び出すことで、Wi-Fi スキャン専用モードを有効にするようユーザーにリクエストできます。

    Wi-Fi の設定

    新しい WifiEnterpriseConfig API を使用すると、企業向けサービスで管理対象デバイスの Wi-Fi 構成を自動化できます。

    着信に対するクイック返信

    Android 4.0 以降では、「クイック返信」と呼ばれる機能により、ユーザーは電話に出たりデバイスのロックを解除したりすることなく、着信に対してすぐにテキスト メッセージで返信できます。これまで、これらのクイック メッセージは常にデフォルトのメッセージ アプリで処理されていました。今後は、ACTION_RESPOND_VIA_MESSAGE のインテント フィルタを使用して Service を作成することで、どのアプリでもこれらのメッセージを処理する機能を宣言できるようになります。

    ユーザーがクイック返信で着信に応答すると、電話アプリは、受信者(発信者)を記述する URI と、ユーザーが送信するメッセージを含む EXTRA_TEXT エクストラを含む ACTION_RESPOND_VIA_MESSAGE インテントを送信します。サービスがインテントを受信すると、メッセージを配信してすぐに停止します(アプリはアクティビティを表示しません)。

    このインテントを受信するには、SEND_RESPOND_VIA_MESSAGE 権限を宣言する必要があります。

    マルチメディア

    MediaExtractor と MediaCodec の機能強化

    Android では、MediaCodec と MediaExtractor の既存の API を使用して、ISO/IEC 23009-1 標準に準拠した独自の Dynamic Adaptive Streaming over HTTP(DASH)プレーヤーを簡単に作成できるようになりました。これらの API の基盤となるフレームワークは、断片化された MP4 ファイルの解析をサポートするように更新されていますが、MPD メタデータの解析と個々のストリームの MediaExtractor への受け渡しは、引き続きアプリ側で行う必要があります。

    暗号化されたコンテンツで DASH を使用する場合は、getSampleCryptoInfo() メソッドが、暗号化された各メディア サンプルの構造を記述する MediaCodec.CryptoInfo メタデータを返すことに注意してください。また、getPsshInfo() メソッドが MediaExtractor に追加され、DASH メディアの PSSH メタデータにアクセスできるようになりました。このメソッドは、UUID オブジェクトからバイトへのマップを返します。UUID は暗号化スキームを指定し、バイトはそのスキームに固有のデータです。

    メディア DRM

    新しい MediaDrm クラスは、DRM の問題をメディア再生から分離することで、メディア コンテンツのデジタル著作権管理(DRM)にモジュラー ソリューションを提供します。たとえば、この API 分離により、Widevine メディア形式を使用せずに Widevine で暗号化されたコンテンツを再生できます。この DRM ソリューションは DASH 共通暗号化もサポートしているため、ストリーミング コンテンツでさまざまな DRM スキームを使用できます。

    MediaDrm を使用すると、ライセンスの取得とプロビジョニングのために、不透明なキーリクエスト メッセージを取得し、サーバーからのキーレスポンス メッセージを処理できます。アプリは、サーバーとのネットワーク通信を処理する必要があります。MediaDrm クラスは、メッセージを生成して処理する機能のみを提供します。

    MediaDrm API は、Android 4.1(API レベル 16)で導入された MediaCodec API と組み合わせて使用することを目的としています。これには、コンテンツのエンコードとデコードを行う MediaCodec、暗号化されたコンテンツを処理する MediaCrypto、コンテンツの抽出とデマルチプレックスを行う MediaExtractor が含まれます。

    まず、MediaExtractor オブジェクトと MediaCodec オブジェクトを作成する必要があります。その後、通常はコンテンツのメタデータから DRM スキームを識別する UUID にアクセスし、そのコンストラクタを使用して MediaDrm オブジェクトのインスタンスを構築できます。

    Surface からの動画エンコード

    Android 4.1(API レベル 16)では、メディア コンテンツの低レベルのエンコードとデコードを行う MediaCodec クラスが追加されました。Android 4.1 では、動画をエンコードする際に ByteBuffer 配列をメディアに提供する必要がありましたが、Android 4.3 では、Surface をエンコーダへの入力として使用できるようになりました。たとえば、既存の動画ファイルからの入力や、OpenGL ES で生成されたフレームを使用した入力をエンコードできます。

    Surface をエンコーダへの入力として使用するには、まず MediaCodec に対して configure() を呼び出します。次に、createInputSurface() を呼び出して Surface を受け取り、メディアをストリーミングします。

    たとえば、指定された Surface を eglCreateWindowSurface() に渡すことで、OpenGL コンテキストのウィンドウとして使用できます。次に、サーフェスのレンダリング中に eglSwapBuffers() を呼び出して、フレームを MediaCodec に渡します。

    エンコードを開始するには、MediaCodec で start() を呼び出します。完了したら、signalEndOfInputStream() を呼び出してエンコードを終了し、Surface で release() を呼び出します。

    メディアの多重化

    新しい MediaMuxer クラスを使用すると、1 つの音声ストリームと 1 つの動画ストリームの間で多重化できます。これらの API は、Android 4.2 でメディアのデマルチプレックス(demuxing)のために追加された MediaExtractor クラスに対応するものです。

    サポートされる出力形式は MediaMuxer.OutputFormat で定義されています。現在、サポートされている出力形式は MP4 のみです。MediaMuxer は現在、一度に 1 つの音声ストリームまたは 1 つの動画ストリームのみをサポートしています。

    MediaMuxer は主に MediaCodec と連携するように設計されているため、MediaCodec で動画処理を実行し、MediaMuxer で出力を MP4 ファイルに保存できます。MediaMuxer を MediaExtractor と組み合わせて使用すると、エンコードやデコードを必要とせずにメディア編集を行うこともできます。

    RemoteControlClient の再生の進行状況とスクラブ

    Android 4.0(API レベル 14)では、ロック画面で利用可能なコントロールなど、リモート コントロール クライアントからメディア再生コントロールを有効にするために RemoteControlClient が追加されました。Android 4.3 では、このようなコントローラで再生位置を表示し、再生をスクラブするコントロールを表示できるようになりました。RemoteControlClient API を使用してメディアアプリのリモコンを有効にしている場合は、2 つの新しいインターフェースを実装することで、再生スクラブを許可できます。

    まず、FLAG_KEY_MEDIA_POSITION_UPDATE フラグを setTransportControlsFlags() に渡して有効にする必要があります。

    次に、以下の 2 つの新しいインターフェースを実装します。

    RemoteControlClient.OnGetPlaybackPositionListener
    これには、リモコンが UI の進行状況を更新する必要があるときにメディアの現在の位置をリクエストするコールバック onGetPlaybackPosition() が含まれます。
    RemoteControlClient.OnPlaybackPositionUpdateListener
    これには、コールバック onPlaybackPositionUpdate() が含まれます。このコールバックは、ユーザーがリモコン UI で再生をスクラブしたときに、メディアの新しいタイムコードをアプリに通知します。

    新しい位置で再生を更新したら、setPlaybackState() を呼び出して、新しい再生状態、位置、速度を示します。

    これらのインターフェースを定義したら、それぞれ setOnGetPlaybackPositionListener() と setPlaybackPositionUpdateListener() を呼び出して RemoteControlClient に設定できます。

    グラフィック

    OpenGL ES 3.0 のサポート

    Android 4.3 では、Java インターフェースと OpenGL ES 3.0 のネイティブ サポートが追加されています。OpenGL ES 3.0 で提供される主な新機能は次のとおりです。

    • 高度な視覚効果の高速化
    • 標準機能として高品質の ETC2 / EAC テクスチャ圧縮
    • 整数と 32 ビット浮動小数点をサポートする GLSL ES シェーディング言語の新しいバージョン
    • 高度なテクスチャ レンダリング
    • テクスチャ サイズとレンダリング バッファ形式の標準化の拡大

    Android の OpenGL ES 3.0 の Java インターフェースは、GLES30 で提供されています。OpenGL ES 3.0 を使用する場合は、<uses-feature> タグと android:glEsVersion 属性を使用して、マニフェスト ファイルで宣言してください。次に例を示します。

    <manifest>
        <uses-feature android:glEsVersion="0x00030000" />
        ...
    </manifest>

    また、setEGLContextClientVersion() を呼び出して、バージョンとして 3 を渡すことで、OpenGL ES コンテキストを指定してください。

    デバイスでサポートされている OpenGL ES バージョンを実行時にチェックする方法など、OpenGL ES の詳細な使用方法については、OpenGL ES API ガイドをご覧ください。

    ドローアブルのミップマッピング

    ビットマップまたはドローアブルのソースとして mipmap を使用すると、高品質の画像とさまざまな画像スケールを簡単に提供できます。これは、アニメーション中に画像がスケーリングされることが予想される場合に特に便利です。

    Android 4.2(API レベル 17)では、Bitmap クラスでミップマップのサポートが追加されました。ミップマップ ソースを指定して setHasMipMap() を有効にすると、Android は Bitmap 内のミップ画像をスワップします。Android 4.3 では、ミップマップ アセットを指定して、ビットマップ リソース ファイルで android:mipMap 属性を設定するか、hasMipMap() を呼び出すことで、BitmapDrawable オブジェクトのミップマップも有効にできます。

    ユーザー インターフェース

    オーバーレイの表示

    新しい ViewOverlay クラスは、View の上に透明なレイヤを提供します。このレイヤには、ビジュアル コンテンツを追加でき、レイアウト階層に影響を与えません。getOverlay() を呼び出すことで、任意の View の ViewOverlay を取得できます。オーバーレイは常にホストビュー(オーバーレイの作成元となるビュー)と同じサイズと位置を持ちます。これにより、ホストビューの前面に表示されるコンテンツを追加できますが、そのホストビューの境界を拡張することはできません。

    ViewOverlay を使用すると、ビュー階層に影響を与えることなく、ビューをコンテナの外にスライドさせたり、画面上でアイテムを移動させたりするなどのアニメーションを作成する場合に特に便利です。ただし、オーバーレイの使用可能な領域はホストビューと同じ領域に制限されるため、レイアウト内の位置の外側に移動するビューをアニメーション化する場合は、目的のレイアウト境界を持つ親ビューのオーバーレイを使用する必要があります。

    Button などのウィジェット ビューのオーバーレイを作成するときに、add(Drawable) を呼び出すことで、Drawable オブジェクトをオーバーレイに追加できます。RelativeLayout などのレイアウト ビューに対して getOverlay() を呼び出すと、返されるオブジェクトは ViewGroupOverlay になります。ViewGroupOverlay クラスは ViewOverlay のサブクラスであり、add(View) を呼び出すことで View オブジェクトを追加することもできます。

    注: オーバーレイに追加するドローアブルとビューはすべて、視覚的なもののみです。フォーカス イベントや入力イベントを受け取ることはできません。

    たとえば、次のコードは、ビューを親ビューのオーバーレイに配置し、そのビューで変換アニメーションを実行することで、右にスライドするビューをアニメーション化します。

    Kotlin

    val view: View? = findViewById(R.id.view_to_remove)
    val container: ViewGroup? = view?.parent as ViewGroup
    
    container?.apply {
        overlay.add(view)
        ObjectAnimator.ofFloat(view, "translationX", right.toFloat())
                .start()
    }

    Java

    View view = findViewById(R.id.view_to_remove);
    ViewGroup container = (ViewGroup) view.getParent();
    container.getOverlay().add(view);
    ObjectAnimator anim = ObjectAnimator.ofFloat(view, "translationX", container.getRight());
    anim.start();

    光学境界レイアウト

    9-patch 背景画像を含むビューについて、ビューの「クリップ」境界ではなく、背景画像の「オプティカル」境界に基づいて、隣接するビューと揃えるように指定できるようになりました。

    たとえば、図 1 と図 2 はそれぞれ同じレイアウトを示していますが、図 1 のバージョンはクリップ境界(デフォルトの動作)を使用し、図 2 は光学境界を使用しています。ボタンとフォトフレームに使用されている 9-patch 画像には、端にパディングが含まれているため、クリップ境界を使用すると、互いに、またはテキストと揃っていないように見えます。

    注: 図 1 と図 2 のスクリーンショットでは、開発者向け設定の [レイアウト境界を表示] が有効になっています。各ビューで、赤色の線は光学境界、青色の線はクリップ境界、ピンク色はマージンを示します。

    図 1. クリップ境界を使用したレイアウト(デフォルト)。

    図 2. 光学的境界を使用したレイアウト。

    オプティカル バウンズに基づいてビューを整列するには、親レイアウトのいずれかで android:layoutMode 属性を "opticalBounds" に設定します。次に例を示します。

    <LinearLayout android:layoutMode="opticalBounds" ... >

    図 3. 光学的境界を持つ Holo ボタンの 9-patch の拡大図。

    これを機能させるには、ビューの背景に適用される 9-patch 画像で、9-patch ファイルの下部と右側に沿って赤線を使用して光学境界を指定する必要があります(図 3 を参照)。赤色の線は、クリップ境界から差し引く必要がある領域を示しています。これにより、画像の光学境界が残ります。

    レイアウトで ViewGroup のオプティカル バウンズを有効にすると、android:layoutMode を "clipBounds" に設定してグループをオーバーライドしない限り、すべての子孫ビューがオプティカル バウンズ レイアウト モードを継承します。すべてのレイアウト要素は、子ビューのオプティカル境界も考慮し、内部のビューのオプティカル境界に基づいて独自の境界を調整します。ただし、レイアウト要素(ViewGroup のサブクラス)は、現在、独自の背景に適用される 9-patch 画像のオプティカル バウンズをサポートしていません。

    View、ViewGroup、またはそれらのサブクラスをサブクラス化してカスタムビューを作成すると、ビューはこれらの光学境界の動作を継承します。

    注: Holo テーマでサポートされているすべてのウィジェット(Button、Spinner、EditText など)が、オプティカル バウンズで更新されています。そのため、アプリが Holo テーマ(Theme.Holo、Theme.Holo.Light など)を適用している場合は、android:layoutMode 属性を "opticalBounds" に設定することで、すぐにメリットを得ることができます。

    Draw 9-patch ツールを使用して独自の 9-patch 画像の光学境界を指定するには、Ctrl キーを押しながら境界ピクセルをクリックします。

    Rect 値のアニメーション

    新しい RectEvaluator を使用して、2 つの Rect 値の間でアニメーション化できるようになりました。この新しいクラスは、ValueAnimator.setEvaluator() に渡すことができる TypeEvaluator の実装です。

    ウィンドウのアタッチとフォーカスのリスナー

    以前は、ビューがウィンドウにアタッチまたはデタッチされたとき、またはフォーカスが変更されたときにリッスンするには、View クラスをオーバーライドして、それぞれ onAttachedToWindow() と onDetachedFromWindow()、または onWindowFocusChanged() を実装する必要がありました。

    アタッチ イベントとデタッチ イベントを受け取るには、代わりに ViewTreeObserver.OnWindowAttachListener を実装し、addOnWindowAttachListener() を使用してビューに設定します。フォーカス イベントを受信するには、ViewTreeObserver.OnWindowFocusChangeListener を実装し、addOnWindowFocusChangeListener() を使用してビューに設定します。

    テレビのオーバースキャンへの対応

    アプリがすべてのテレビで全画面表示されるように、アプリのレイアウトでオーバースキャンを有効にできるようになりました。オーバースキャン モードは FLAG_LAYOUT_IN_OVERSCAN フラグによって決まります。このフラグは、Theme_DeviceDefault_NoActionBar_Overscan などのプラットフォーム テーマで有効にするか、カスタムテーマで windowOverscan スタイルを有効にすることで有効にできます。

    画面の向き

    <activity> タグの screenOrientation 属性が、自動回転に関するユーザーの設定を尊重する追加の値をサポートするようになりました。

    "userLandscape"
    ユーザーが自動回転を無効にした場合、通常の横向きにロックされ、反転しない点を除き、"sensorLandscape" と同じ動作になります。
    "userPortrait"
    ユーザーが自動回転を無効にした場合、通常の縦向きにロックされ、反転しない点を除き、"sensorPortrait" と同じ動作になります。
    "fullUser"
    "fullSensor" と同じ動作になり、4 つの方向すべてに回転できます。ただし、ユーザーが自動回転を無効にしている場合は、ユーザーが選択した向きにロックされます。

    さらに、"locked" を宣言して、アプリの向きを画面の現在の向きにロックすることもできるようになりました。

    回転アニメーション

    WindowManager の新しい rotationAnimation フィールドを使用すると、システムが画面の向きを切り替えるときに使用する 3 つのアニメーションのいずれかを選択できます。3 つのアニメーションは次のとおりです。

    注: これらのアニメーションは、アクティビティを「全画面表示」モードに設定している場合にのみ使用できます。このモードは、Theme.Holo.NoActionBar.Fullscreen などのテーマで有効にできます。

    たとえば、クロスフェード アニメーションを有効にする方法は次のとおりです。

    Kotlin

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    
        val params: WindowManager.LayoutParams = window.attributes
        params.rotationAnimation = WindowManager.LayoutParams.ROTATION_ANIMATION_CROSSFADE
        window.attributes = params
        ...
    }

    Java

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    
        WindowManager.LayoutParams params = getWindow().getAttributes();
        params.rotationAnimation = WindowManager.LayoutParams.ROTATION_ANIMATION_CROSSFADE;
        getWindow().setAttributes(params);
        ...
    }

    ユーザー入力

    新しいセンサータイプ

    新しい TYPE_GAME_ROTATION_VECTOR センサーを使用すると、磁気干渉を気にすることなくデバイスの回転を検出できます。TYPE_ROTATION_VECTOR センサーとは異なり、TYPE_GAME_ROTATION_VECTOR は磁北に基づいていません。

    新しい TYPE_GYROSCOPE_UNCALIBRATED センサーと TYPE_MAGNETIC_FIELD_UNCALIBRATED センサーは、バイアス推定を考慮せずに未加工のセンサーデータを提供します。つまり、既存の TYPE_GYROSCOPE センサーと TYPE_MAGNETIC_FIELD センサーは、それぞれデバイスのジャイロドリフトとハードアイアンから推定されるバイアスを考慮したセンサーデータを提供します。一方、これらのセンサーの新しい「未調整」バージョンでは、未加工のセンサーデータが提供され、推定バイアス値が個別に提供されます。これらのセンサーを使用すると、外部データで推定バイアスを強化することで、センサーデータに独自のカスタム キャリブレーションを提供できます。

    通知リスナー

    Android 4.3 では、新しいサービスクラス NotificationListenerService が追加されました。これにより、アプリはシステムによって投稿された新しい通知に関する情報を受け取ることができます。

    現在、アプリでユーザー補助サービス API を使用してシステム通知にアクセスしている場合は、代わりにこれらの API を使用するようにアプリを更新する必要があります。

    連絡先プロバイダ

    「contactables」のクエリ

    新しい連絡先プロバイダ クエリ Contactables.CONTENT_URI を使用すると、指定したクエリに一致するすべての連絡先に属するすべてのメールアドレスと電話番号を含む 1 つの Cursor を効率的に取得できます。

    連絡先の差分をクエリする

    連絡先プロバイダに新しい API が追加され、連絡先データの最近の変更を効率的にクエリできるようになりました。以前は、連絡先データに変更があったときにアプリに通知が届くものの、具体的に何が変更されたのかはわからず、すべての連絡先を取得して反復処理することで変更を検出する必要がありました。

    挿入と更新の変更を追跡するには、選択に CONTACT_LAST_UPDATED_TIMESTAMP パラメータを含めて、プロバイダに最後にクエリを実行してから変更された連絡先のみをクエリします。

    削除された連絡先を追跡するために、新しいテーブル ContactsContract.DeletedContacts には削除された連絡先のログが用意されています(ただし、削除された各連絡先はこのテーブルに一定期間保持されます)。CONTACT_LAST_UPDATED_TIMESTAMP と同様に、新しい選択パラメータ CONTACT_DELETED_TIMESTAMP を使用して、プロバイダに最後にクエリを実行した後に削除された連絡先を確認できます。このテーブルには、ログを保持する日数(ミリ秒単位)を含む定数 DAYS_KEPT_MILLISECONDS も含まれています。

    また、ユーザーがシステム設定メニューから連絡先ストレージを消去すると、連絡先プロバイダは CONTACTS_DATABASE_CREATED アクションをブロードキャストし、連絡先プロバイダ データベースを効果的に再作成するようになりました。これは、保存されているすべての連絡先情報を削除し、新しいクエリで再読み込みする必要があることをアプリに通知するためのものです。

    これらの API を使用して連絡先の変更を確認するサンプルコードについては、SDK サンプルのダウンロードで入手できる ApiDemos サンプルをご覧ください。

    ローカライズ

    双方向テキストのサポートを改善

    以前のバージョンの Android は、右から左(RTL)に表記する言語とレイアウトをサポートしていますが、方向が混在するテキストを適切に処理できないことがあります。そこで、Android 4.3 では、逆方向のコンテンツを含むテキストを、文字化けすることなく適切にフォーマットできる BidiFormatter API が追加されました。

    たとえば、「15 Bay Street, Laurel, CA のことですか?」など、文字列変数を含む文を作成する場合は、通常、ローカライズされた文字列リソースと変数を String.format() に渡します。

    Kotlin

    val suggestion = String.format(resources.getString(R.string.did_you_mean), address)

    Java

    Resources res = getResources();
    String suggestion = String.format(res.getString(R.string.did_you_mean), address);

    ただし、言語 / 地域がヘブライ語の場合、フォーマットされた文字列は次のようになります。

    ?Bay Street, Laurel, CAהאם התכוונת ל 15

    これは誤りです。「15」は「Bay Street」の左側に配置する必要があります。この問題を解決するには、BidiFormatter とその unicodeWrap() メソッドを使用します。たとえば、上記のコードは次のようになります。

    Kotlin

    val bidiFormatter = BidiFormatter.getInstance()
    val suggestion = String.format(
            resources.getString(R.string.did_you_mean),
            bidiFormatter.unicodeWrap(address)
    )

    Java

    Resources res = getResources();
    BidiFormatter bidiFormatter = BidiFormatter.getInstance();
    String suggestion = String.format(res.getString(R.string.did_you_mean),
            bidiFormatter.unicodeWrap(address));

    デフォルトでは、unicodeWrap() は最初の強い方向性推定ヒューリスティックを使用します。テキスト方向の最初のシグナルがコンテンツ全体に適切な方向を表していない場合、このヒューリスティックは誤った結果を返す可能性があります。必要に応じて、TextDirectionHeuristics から unicodeWrap() に TextDirectionHeuristic 定数のいずれかを渡すことで、別のヒューリスティックを指定できます。

    注: これらの新しい API は、Android サポート ライブラリの BidiFormatter クラスと関連 API を通じて、以前のバージョンの Android でも利用できます。

    ユーザー補助サービス

    キーイベントを処理する

    AccessibilityService は、onKeyEvent() コールバック メソッドを使用してキー入力イベントのコールバックを受信できるようになりました。これにより、ユーザー補助サービスは、キーボードなどのキーベースの入力デバイスの入力を処理し、それらのイベントを、以前はタップ入力またはデバイスの方向パッドでのみ可能だった特別なアクションに変換できます。

    テキストを選択してコピー / 貼り付け

    AccessibilityNodeInfo が、AccessibilityService がノード内のテキストを選択、切り取り、コピー、貼り付けできるようにする API を提供するようになりました。

    切り取りまたはコピーするテキストの選択を指定するには、ユーザー補助サービスで新しいアクション ACTION_SET_SELECTION を使用し、ACTION_ARGUMENT_SELECTION_START_INT と ACTION_ARGUMENT_SELECTION_END_INT で選択の開始位置と終了位置を渡します。または、既存のアクション ACTION_NEXT_AT_MOVEMENT_GRANULARITY(以前はカーソル位置の移動のみ)を使用してカーソル位置を操作し、引数 ACTION_ARGUMENT_EXTEND_SELECTION_BOOLEAN を追加することで、テキストを選択できます。

    ACTION_CUT、ACTION_COPY で切り取りまたはコピーし、後で ACTION_PASTE で貼り付けることができます。

    注: これらの新しい API は、Android サポート ライブラリの AccessibilityNodeInfoCompat クラスを介して、以前のバージョンの Android でも利用できます。

    ユーザー補助機能を宣言する

    Android 4.3 以降、ユーザー補助サービスで特定のユーザー補助機能を使用するには、メタデータ ファイルでユーザー補助機能を宣言する必要があります。メタデータ ファイルで機能がリクエストされていない場合、その機能は何も行いません。サービスのユーザー補助機能を宣言するには、AccessibilityServiceInfo クラスのさまざまな「機能」定数に対応する XML 属性を使用する必要があります。

    たとえば、サービスが flagRequestFilterKeyEvents 機能をリクエストしない場合、キーイベントは受信されません。

    テストとデバッグ

    自動 UI テスト

    新しい UiAutomation クラスには、テスト自動化のためにユーザー アクションをシミュレートできる API が用意されています。UiAutomation API は、プラットフォームの AccessibilityService API を使用して、画面コンテンツを検査し、任意のキーボード イベントとタッチイベントを挿入できます。

    UiAutomation のインスタンスを取得するには、Instrumentation.getUiAutomation() を呼び出します。これを機能させるには、adb shell から InstrumentationTestCase を実行するときに、instrument コマンドで -w オプションを指定する必要があります。

    UiAutomation インスタンスを使用すると、executeAndWaitForEvent() を呼び出し、実行する Runnable、オペレーションのタイムアウト期間、UiAutomation.AccessibilityEventFilter インターフェースの実装を渡すことで、任意のイベントを実行してアプリをテストできます。UiAutomation.AccessibilityEventFilter の実装内で、関心のあるイベントをフィルタして、特定のテストケースの成功または失敗を判断できる呼び出しを受け取ります。

    テスト中にすべてのイベントをモニタリングするには、UiAutomation.OnAccessibilityEventListener の実装を作成して setOnAccessibilityEventListener() に渡します。 イベントが発生するたびに、リスナー インターフェースは onAccessibilityEvent() の呼び出しを受け取り、イベントを記述する AccessibilityEvent オブジェクトを受け取ります。

    UiAutomation API が非常に低いレベルで公開するオペレーションは他にも多数あり、uiautomator などの UI テストツールの開発を促進しています。たとえば、UiAutomation では次のこともできます。

    • 入力イベントを挿入する
    • 画面の向きを変更する
    • スクリーンショットを撮る

    UI テストツールにとって最も重要なのは、UiAutomation API が Instrumentation の API とは異なり、アプリケーションの境界を越えて動作することです。

    アプリの Systrace イベント

    Android 4.3 では、2 つの静的メソッド beginSection() と endSection() を含む Trace クラスが追加されています。これらのメソッドを使用すると、systrace レポートに含めるコードブロックを定義できます。アプリ内にトレース可能なコードのセクションを作成することで、systrace ログから、アプリ内で速度低下が発生している場所をより詳細に分析できます。

    Systrace ツールの使用方法については、Systrace を使用したディスプレイとパフォーマンスの分析をご覧ください。

    セキュリティ

    アプリの秘密鍵用の Android キーストア

    Android では、KeyStore 機能に Android Key Store と呼ばれるカスタム Java セキュリティ プロバイダが用意されています。これにより、アプリのみが表示および使用できる秘密鍵を生成して保存できます。Android Key Store を読み込むには、"AndroidKeyStore" を KeyStore.getInstance() に渡します。

    Android キーストアでアプリの秘密認証情報を管理するには、KeyPairGeneratorSpec を指定した KeyPairGenerator で新しい鍵を生成します。まず、getInstance() を呼び出して KeyPairGenerator のインスタンスを取得します。次に、initialize() を呼び出し、KeyPairGeneratorSpec.Builder を使用して取得できる KeyPairGeneratorSpec のインスタンスを渡します。最後に、generateKeyPair() を呼び出して KeyPair を取得します。

    ハードウェア認証情報ストレージ

    また、Android は KeyChain 認証情報のハードウェア格納型ストレージもサポートするようになり、鍵を抽出できないようにすることでセキュリティを強化しています。つまり、鍵をハードウェア格納型キーストア(セキュア エレメント、TPM、TrustZone)に格納すると、暗号オペレーションに使用できますが、秘密鍵マテリアルをエクスポートすることはできません。OS カーネルでも、この鍵マテリアルにアクセスすることはできません。すべての Android 搭載デバイスがハードウェアでのストレージをサポートしているわけではありませんが、KeyChain.IsBoundKeyAlgorithm() を呼び出すことで、ハードウェア格納型のストレージが利用可能かどうかを実行時に確認できます。

    マニフェストの宣言

    宣言可能な必須機能

    <uses-feature> 要素で以下の値がサポートされるようになり、アプリが必要とする機能を提供するデバイスにのみアプリがインストールされるようにすることができます。

    FEATURE_APP_WIDGETS
    アプリがアプリ ウィジェットを提供し、ユーザーがアプリ ウィジェットを埋め込むことができるホーム画面または類似の場所を備えたデバイスにのみインストールされるようにすることを宣言します。例:
    <uses-feature android:name="android.software.app_widgets" android:required="true" />
    FEATURE_HOME_SCREEN
    アプリがホーム画面の代替機能として動作し、サードパーティのホーム画面アプリをサポートするデバイスにのみインストールされるようにすることを宣言します。 例:
    <uses-feature android:name="android.software.home_screen" android:required="true" />
    FEATURE_INPUT_METHODS
    アプリがカスタム入力方法(InputMethodService で構築されたキーボード)を提供し、サードパーティの入力方法をサポートするデバイスにのみインストールする必要があることを宣言します。例:
    <uses-feature android:name="android.software.input_methods" android:required="true" />
    FEATURE_BLUETOOTH_LE
    アプリが Bluetooth Low Energy API を使用し、Bluetooth Low Energy を介して他のデバイスと通信できるデバイスにのみインストールする必要があることを宣言します。例:
    <uses-feature android:name="android.software.bluetooth_le" android:required="true" />

    ユーザー権限

    <uses-permission> で、特定の API にアクセスするためにアプリが必要とする権限を宣言する、以下の値がサポートされるようになりました。

    BIND_NOTIFICATION_LISTENER_SERVICE
    新しい NotificationListenerService API を使用するために必要です。
    SEND_RESPOND_VIA_MESSAGE
    ACTION_RESPOND_VIA_MESSAGE インテントを受信するために必要です。

    Android 4.3 のすべての API の変更点について詳しくは、API 差分レポートをご覧ください。