AndroidでViewを他のアプリの上に表示する (APIバージョン別 対応方法まとめ)

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
LayoutParams生成時のレイヤータイプ(コンストラクタのint _type変数)に、WindowManager.LayoutParams.TYPE_SYSTEM_ALERT を渡す。
参考サイト : 画面上にアプリの情報を常時表示する
Android 6.0 ～ 7.1.1 (APIレベル 23～25)
Android 5.0までの対応に加えて以下の対応が必要。
RuntimePermissionに対応させる
APIが更新され、一部のパーミッションは個別にユーザが許可を出すことを求められるようになった。
まずは、Settings#canDrawOverlays を呼び出して、アプリの権限をチェックする。
権限がない場合は、オーバーレイ権限を変更する為の画面を呼び出す。

Intentには Settings.ACTION_MANAGE_OVERLAY_PERMISSION と、自アプリのパッケージ名を指定する。

(ユーザに対して表示して、利用開始時に権限設定を許可してもらう)
権限設定画面から自アプリに制御が戻ったら再度権限を確認し、権限が有効になっていたらAndroid 5.0までと同じ方法でビューを追加する。
参考サイト : MarshmallowでSYSTEM_ALERT_WINDOWの権限の扱いが変わった
Android 8.0 ～  (APIレベル 26～)
Android 7.1.1までの対応に加えて以下の対応が必要。
WindowManagerでTYPE_APPLICATION_OVERLAYレイヤーを使う
APIが更新され、TYPE_SYSTEM_ALERTレイヤーは利用できなくなった。

よって、今まで通りのレイヤータイプ WindowManager.LayoutParams.TYPE_SYSTEM_ALERT を使用するとエラーとなる。

(下記の例外が発生する。この例外で検索しても情報が見つからなくて困った)

java.lang.RuntimeException: Unable to start service com.example.app.TestService@57b8b88 with Intent { cmp=com.example.app/.TestService }: android.view.WindowManager$BadTokenException: Unable to add window android.view.ViewRootImpl$W@4938b2b -- permission denied for window type 2003
これを回避する為にはAPIレベルが26以上の場合に、LayoutParams生成時のレイヤータイプに WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY を渡すようにする。
参考サイト : Android O で WindowManager の振る舞いが変わる