辛すぎるAndroidのApp開発を、Kotlinとコルーチンで楽にする

import ...

class MyActivity: AppCompatActivity() {
    ...

    // カメラを使いたいなら……
    fun usingCamera() {
        // パーミッションをすでに持っているか確認します。
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) == PackageManager.PERMISSION_GRANTED) {
            // パーミッションを持っているなら、実際にカメラを使う処理のuseCameraを呼び出します。
            useCamera()
            return
        }

        // 過去にパーミッションのリクエストを蹴られていて、「今後表示しない」が選択されていない場合は……
        if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA)) {
            // パーミッションが必要な理由を訴えた上で、パーミッションをリクエストします。
            AlertDialog.Builder(this)
                    .setMessage("インスタで意識高い系をやるにはカメラが必要なの")
                    .setPositiveButton(android.R.string.ok, { dialog, which ->
                        // [OK]ボタンがタップされたら、パーミッションをリクエストします。
                        // 1234はonRequestPermissionsResultでリクエストを判別するための数値。なんでもいいみたい。
                        ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.CAMERA), 1234)
                    })
                    .show()
                    return
        }

        // パーミッションをリクエストします。
        ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.CAMERA), 1234)
    }

    // パーミッションをリクエストした結果は、onRequestPermissionResultで受け取らなければなりません……。
    override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String>, grantResults: IntArray) {
        // 自分のコード以外がrequestPermissionsしているかもしれないので、requestCodeをチェックします。
        if (requestCode != 1234) {
            super.onRequestPermissionsResult(requestCode, permissions, grantResults)
            return
        }

        // リクエスト結果をチェック。
        if (grantResults.any { it != PackageManager.PERMISSION_GRANTED }) {
            // リクエストを蹴られた場合はどうしましょ？　今回は、単純にActivityを終了させます。
            finish()
            return
        }

        // 実際の処理をここに書くわけには行かない（だって、ここに来るかはcheckSelfPermission次第だから）ので、useCameraに移譲します。
        useCamera()
    }

    // やっとここで実際の処理。これより前はAndroidがやれっていうから書かなければならないだけの処理……
    fun useCamera() {
        // カメラを使って実際にやりたい処理……。
    }
}

fun useCamera() {
  if (!requestPermission(Manifest.permission.CAMERA, "インスタで意識高い系をやるにはカメラが必要なの")) {
    finish()
    return
  }

  // カメラを使って実際にやりたい処理。
}

package ...

import android.app.Activity
import android.app.AlertDialog
import android.app.Fragment
import android.content.pm.PackageManager
import android.support.v13.app.FragmentCompat
import android.support.v4.app.ActivityCompat
import android.support.v4.content.ContextCompat
import kotlinx.coroutines.experimental.android.UI
import kotlinx.coroutines.experimental.launch
import kotlin.coroutines.experimental.Continuation
import kotlin.coroutines.experimental.suspendCoroutine

suspend fun requestPermission(activity: Activity, permission: String, rationale: String): Unit? {  // エルビス演算子を使いたいので、戻り値はBooleanじゃなくてUnit?で。
    if (ContextCompat.checkSelfPermission(activity, permission) == PackageManager.PERMISSION_GRANTED) {
        return Unit
    }

    if (ActivityCompat.shouldShowRequestPermissionRationale(activity, permission)) {
        suspendCoroutine<Unit?> { cont ->  // suspendCoroutineでコルーチンの実行を中断して……
            AlertDialog.Builder(activity)
                    .setMessage(rationale)
                    .setOnCancelListener { cont.resume(null) }  // ここか……
                    .setPositiveButton(android.R.string.ok, { _, _ -> cont.resume(Unit) })  // ここで、再開します。
                    .show()
        } ?: return null
    }

    class RequestPermissionFragment : Fragment() {    // onRequestPermissionsResultが必要なので、Fragmentを継承したクラスを用意します。
        lateinit var cont: Continuation<Unit?>

        override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String>, grantResults: IntArray) {
            cont.resume(Unit.takeIf { grantResults.all { it == PackageManager.PERMISSION_GRANTED } })

            // 処理を閉じ込めているので、requestCodeのチェックはたぶん不要じゃないかなぁと。
        }
    }

    return RequestPermissionFragment().let { fragment ->  // Kotlinのスコープ関数は、スコープを小さくできるのでとても便利。
        try {
            activity.fragmentManager.beginTransaction().add(0, fragment).commit()  // Fragmentを追加します。

            suspendCoroutine<Unit?> { cont ->
                launch(UI) {  // Fragmentの追加が終わった後に実行させたい（launchしないとエラーになっちゃう）ので、launchします。
                    fragment.cont = cont

                    FragmentCompat.requestPermissions(fragment, arrayOf(permission), 0)  // パーミッションをリクエストします。

                    // onRequestPermissionsResultでresumeされるまで、コルーチンは中断されます。
                }
            }

        } finally {
            activity.fragmentManager.beginTransaction().remove(fragment).commit()  // Fragmentを削除します。
        }
    }
}

fun useCamera() = launch(UI) {
    // パーミッションをリクエスト。
    if (!requestPermission(Manifest.permission.CAMERA, "インスタで意識高い系をやるにはカメラが必要なの")) {
        // パーミッションを貰えなかった場合の処理。
        finish()
        return
    }

    // カメラを使って実際にやりたい処理。
}