Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

動作の変更点: Android 17 以上をターゲットとするアプリ

これまでのリリースと同様、Android 17 には、アプリに影響する可能性がある動作変更が含まれています。下記の動作変更は、Android 17 以上をターゲットとするアプリにのみ適用されます。アプリが Android 17 以上をターゲットとする場合は、必要に応じてアプリを変更し、下記の動作に適切に対応できるようにしてください。

アプリの targetSdkVersion に関係なく、Android 17 で実行されるすべてのアプリに影響する動作変更のリストも必ずご確認ください。

ユーザーエクスペリエンスとシステム UI

Android 17 には、より一貫性のある直感的なユーザーエクスペリエンスを実現するための変更が加えられています。

Beginning with Android 17, for apps targeting Android 17 (API level 37) or higher, the system enforces a strict memory limit (1.5 * screen width * screen height * 4) against the combined memory usage of both Bitmaps and Icons present in the RemoteViews parcel. Exceeding these limits throws a fatal IllegalArgumentException and crashes the app's process.

For more information, see UpdateAppWidget.

コア機能

Android 17 には、Android システムのさまざまなコア機能を変更または拡張する変更が加えられています。

MessageQueue の新しいロックフリー実装

Android 17 以降、Android 17（API レベル 37）以上をターゲットとするアプリは、android.os.MessageQueue の新しいロックフリー実装を受け取ります。新しい実装ではパフォーマンスが向上し、フレーム落ちが減少しますが、MessageQueue のプライベートフィールドとメソッドを反映するクライアントが破損する可能性があります。

軽減策など、詳しくは、MessageQueue の動作変更に関するガイダンスをご覧ください。

static final フィールドが変更不可になった

Android 17（API レベル 37）以上をターゲットとする Android 17 以上で実行されているアプリは、static final フィールドを変更できません。アプリがリフレクションを使用して static final フィールドを変更しようとすると、IllegalAccessException が発生します。JNI API（SetStaticLongField() など）を使用してこれらのフィールドのいずれかを変更しようとすると、アプリがクラッシュします。

ユーザー補助

Android 17 では、ユーザー補助を改善するために次の変更が加えられています。

This feature introduces new AccessibilityEvent and TextAttribute APIs to enhance screen reader spoken feedback for CJKV language input. CJKV IME apps can now signal whether a text conversion candidate has been selected during text composition. Apps with edit fields can specify text change types when sending text changed accessibility events. For example, apps can specify that a text change occurred during text composition, or that a text change resulted from a commit. Doing this enables accessibility services such as screen readers to deliver more precise feedback based on the nature of the text modification.

App adoption

IME Apps: When setting composing text in edit fields, IMEs can use TextAttribute.Builder.setTextSuggestionSelected() to indicate whether a specific conversion candidate was selected.
Apps with Edit Fields: Apps that maintain a custom InputConnection can retrieve candidate selection data by calling TextAttribute.isTextSuggestionSelected(). These apps should then call AccessibilityEvent.setTextChangeTypes() when dispatching TYPE_VIEW_TEXT_CHANGED events. Apps targeting Android 17 (API level 37) that use the standard TextView will have this feature enabled by default. (That is, TextView will handle retrieving data from the IME and setting text change types when sending events to accessibility services).
Accessibility Services: Accessibility services that process TYPE_VIEW_TEXT_CHANGED events can call AccessibilityEvent.getTextChangeTypes() to identify the nature of the modification and adjust their feedback strategies accordingly.

プライバシー

Android 17 には、ユーザーのプライバシーを強化するために次の変更が加えられています。

ECH（Encrypted Client Hello）が有効になった

Android 17 introduces platform support for Encrypted Client Hello (ECH), a TLS extension that enhances user privacy by encrypting the Server Name Indication (SNI) in the TLS handshake. This encryption helps prevent network observers from easily identifying the specific domain your app is connecting to.

For apps targeting Android 17 (API level 37) or higher, ECH is used for TLS connections. ECH is active only if the networking library used by the app (for example, HttpEngine, WebView, or OkHttp) has integrated ECH support and the remote server also supports the ECH protocol. If ECH cannot be negotiated, the client sends an ECH extension with randomized contents (a mechanism called ECH GREASE). See RFC 9849 for more details on how ECH GREASE works.

To allow apps to customize this behavior, Android 17 adds a new <domainEncryption> element to the Network Security Configuration file. Developers can use <domainEncryption> within <base-config> or <domain-config> tags to select an ECH mode (for example, "enabled" or "disabled") on a global or per-domain basis.

For more information, see the Encrypted Client Hello documentation.

Android 17 をターゲットとするアプリにローカルネットワーク権限が必要になった

Android 17 では、ユーザーを不正なローカルネットワークアクセスから保護するために、ACCESS_LOCAL_NETWORK ランタイム権限が導入されました。これは既存の NEARBY_DEVICES 権限グループに該当するため、他の NEARBY_DEVICES 権限をすでに付与しているユーザーには、再度権限の付与を求めるプロンプトは表示されません。この新しい要件により、悪意のあるアプリが、無制限のローカルネットワークアクセスを利用してユーザートラッキングやフィンガープリント採取を密かに行うことを防ぐことができます。この権限を宣言してリクエストすることで、アプリはスマートホームデバイスやキャストレシーバーなどのローカルエリアネットワーク（LAN）上のデバイスを検出して接続できます。

Android 17（API レベル 37）以降を対象とするアプリは、LAN デバイスとの通信を維持するためのパスが 2 つになりました。システムが仲介するプライバシー保護デバイス選択ツールを採用して権限の付与を求めるプロンプトをスキップするか、この新しい権限をランタイム時に明示的にリクエストしてローカルネットワーク通信を維持します。

詳細については、ローカルネットワーク権限のドキュメントをご覧ください。

物理デバイスからパスワードを非表示にする

アプリが Android 17（API レベル 37）以降を対象としていて、ユーザーが物理入力デバイス（外付けキーボードなど）を使用している場合、Android オペレーティングシステムは、パスワードフィールドのすべての文字に新しい show_passwords_physical 設定を適用します。デフォルトでは、この設定によりすべてのパスワード文字が非表示になります。

Android システムは、ユーザーがパスワードを誤って入力したかどうかを確認できるように、最後に入力したパスワード文字を表示します。ただし、大型の外付けキーボードでは、この機能の必要性ははるかに低くなります。また、外付けキーボードを搭載したデバイスはディスプレイが大きいことが多く、入力したパスワードを誰かに見られる危険性が高まります。

ユーザーがデバイスのタッチスクリーンを使用している場合、システムは新しい show_passwords_touch 設定を適用します。

標準 SMS メッセージの OTP 保護

Android 17 以降、Android は SMS OTP 保護を拡張し、標準の SMS メッセージ（WebOTP または SMS Retriever 形式を使用しない OTP を含む SMS メッセージ）に適用します。Android 17（API レベル 37）以上をターゲットとするほとんどのアプリでは、これらの SMS メッセージは受信後 3 時間経過するまで利用できません。この遅延は、OTP のハイジャックを防ぐことを目的としています。3 時間の遅延の間、 SMS_RECEIVED_ACTION ブロードキャストは保留され、 SMS プロバイダデータベースクエリはフィルタリングされます。遅延後、これらのアプリで SMS メッセージを利用できるようになります。

デフォルトの SMS アシスタントアプリやコネクテッドデバイスコンパニオンアプリなど、一部のアプリは、この遅延の対象外です。OTP 抽出のために SMS メッセージの読み取りに依存するすべてのアプリは、引き続き機能するように、SMS Retriever API または SMS ユーザー同意 API を使用するように移行する必要があります。

セキュリティ

Android 17 では、デバイスとアプリのセキュリティが次のように改善されています。

アクティビティのセキュリティ

In Android 17, the platform continues its shift toward a "secure-by-default" architecture, introducing a suite of enhancements designed to mitigate high-severity exploits such as phishing, interaction hijacking, and confused deputy attacks. This update requires developers to explicitly opt in to new security standards to maintain app compatibility and user protection.

Key impacts for developers include:

BAL hardening & improved opt-in: We are refining Background Activity Launch (BAL) restrictions by extending protections to IntentSender. Developers must migrate away from the legacy MODE_BACKGROUND_ACTIVITY_START_ALLOWED constant. Instead, you should adopt granular controls like MODE_BACKGROUND_ACTIVITY_START_ALLOW_IF_VISIBLE, which restricts activity starts to scenarios where the calling app is visible, significantly reducing the attack surface.
Adoption tools: Developers should utilize strict mode and updated lint checks to identify legacy patterns and ensure readiness for future target SDK requirements.

CT がデフォルトで有効になった

アプリが Android 17（API レベル 37）以上をターゲットとしている場合、証明書の透明性（CT）はデフォルトで有効になっています。（Android 16 では CT は利用可能ですが、アプリはオプトインする必要があります）。

より安全なネイティブ DCL—C

アプリが Android 17（API レベル 37）以降をターゲットとしている場合、Android 14 で導入された DEX ファイルと JAR ファイルの動的コードのより安全な読み込み（DCL）保護がネイティブライブラリにも適用されるようになりました。

System.load() を使用して読み込まれるネイティブファイルはすべて読み取り専用としてマークする必要があります。そうしないと、システムは UnsatisfiedLinkError をスローします。

アプリでは可能な限り、コードを動的に読み込まないようにすることをおすすめします。コードを動的に読み込むと、コードインジェクションやコードの改ざんによってアプリが不正使用されるリスクが大幅に高まります。

CP2 データビューで機密データフィールドを制限する

For apps targeting Android 17 (API level Android 17 (API level 37)) and higher, Contacts Provider 2 (CP2) restricts certain columns containing Personally Identifiable Information (PII) from the data view. When this change is enabled, these columns are removed from the data view to enhance user privacy. The restricted columns include:

Apps that are using these columns from ContactsContract.Data can extract them from ContactsContract.RawContacts instead, by joining with RAW_CONTACT_ID.

CP2 で厳格な SQL チェックを適用する

For apps targeting Android 17 (API level Android 17 (API level 37)) and higher, Contacts Provider 2 (CP2) enforces strict SQL query validation when the ContactsContract.Data table is accessed without READ_CONTACTS permission.

With this change, if an app doesn't have READ_CONTACTS permission, StrictColumns and StrictGrammar options are set when querying the ContactsContract.Data table. If a query uses a pattern that isn't compatible with these, it will be rejected and cause an exception to be thrown.

インテリジェンス

Android 17 には、システムインテリジェンスに関する次の変更が加えられています。

setContentCaptureEnabled の非推奨

一部のデバイスでは、デバイス上の AI 機能が画面の内容を分析してインテリジェントなエクスペリエンスを提供できるように、コンテンツキャプチャがデフォルトで有効になっています。

Android 17 以降、 ContentCaptureManager.setContentCaptureEnabled(boolean) API メソッドは非推奨になりました。Android 17（API レベル 37）以上をターゲットとするアプリでは、setContentCaptureEnabled(false) を呼び出してもコンテンツキャプチャが無効になりません。

アプリでコンテンツキャプチャを無効にする必要がある場合や、画面のコンテンツがシステムによってキャプチャされないように制限する必要がある場合は、 FLAG_SECUREウィンドウレイアウトパラメータを使用するように移行する必要があります。

コンテンツキャプチャを無効にするには、次の例のように、ウィンドウに FLAG_SECURE フラグを設定します。

Kotlin

window.setFlags(
    WindowManager.LayoutParams.FLAG_SECURE,
    WindowManager.LayoutParams.FLAG_SECURE
)

Java

getWindow().setFlags(
    WindowManager.LayoutParams.FLAG_SECURE,
    WindowManager.LayoutParams.FLAG_SECURE
);

詳細については、 WindowManager.LayoutParams.FLAG_SECURE リファレンスドキュメントをご覧ください。

メディア

Android 17 には、メディアの動作に関する次の変更が加えられています。

バックグラウンドオーディオの強化

Android 17 以降では、オーディオフレームワークは、オーディオ再生、音声フォーカスリクエスト、音量変更 API などのバックグラウンドオーディオインタラクションに対する制限を適用し、これらの変更がユーザーによって意図的に開始されるようにします。

一部の音声制限はすべてのアプリに適用されます。ただし、アプリが Android 17（API レベル 37）をターゲットとしている場合、制限はより厳しくなります。これらのアプリのいずれかがバックグラウンドでオーディオを操作する場合は、フォアグラウンドサービスが実行されている必要があります。また、アプリは次の要件のいずれかまたは両方を満たす必要があります。

フォアグラウンドサービスには「使用中のみ許可」の機能が必要です。
アプリに正確なアラームの権限が付与されており、USAGE_ALARM 音声ストリームとやり取りしている必要があります。

軽減策など、詳しくは、バックグラウンド音声の強化をご覧ください。

デバイスのフォームファクタ

Android 17 には、さまざまなデバイスサイズとフォームファクタでユーザーエクスペリエンスを改善するための変更が加えられています。

大画面（画面幅 600 dp 以上）での画面の向き、サイズ変更、アスペクト比の制約を無視するためのプラットフォーム API の変更

We introduced Platform API changes in Android 16 to ignore orientation, aspect ratio, and resizability restrictions on large screens (sw >= 600dp) for apps targeting API level 36 or higher. Developers have the option to opt out of these changes with SDK 36, but this opt-out will no longer be available for apps that target Android 17 (API level 37) or higher.

For more information, see Restrictions on orientation and resizability are ignored.

接続

Android 17 では、一貫性を高め、Bluetooth RFCOMM ソケットの標準 Java InputStream 動作に合わせるために、次の変更が加えられています。

RFCOMM の BluetoothSocket read() 動作の一貫性

Android 17（API レベル 37）をターゲットとするアプリでは、RFCOMM ベースの BluetoothSocket から取得した InputStream の read() メソッドは、ソケットが閉じられたり接続が切断されたりすると、-1 を返すようになりました。

この変更により、RFCOMM ソケットの動作が LE CoC ソケットと一貫性を持つようになり、ストリームの終わりに達すると -1 が返されることを示す標準の InputStream.read() ドキュメントと整合性が取れるようになります。

IOException のキャッチのみに依存して読み取りループから抜け出すアプリは、この変更の影響を受ける可能性があります。BluetoothSocket の読み取りループを更新して、-1 の戻り値を明示的にチェックする必要があります。これにより、リモートデバイスが切断されたときやソケットが閉じられたときに、ループが正しく終了します。推奨される実装の例については、Bluetooth データを転送するガイドのコードスニペットをご覧ください。