Kotlin を使用した Android アプリの開発（Developing Android Apps with Kotlin）

ImageView クラスは、２つあります。
android.widget.ImageView
android.media.ImageView

このレッスンで使用するものは、android.widget.ImageView の方です。

途中で出題されるクイズの回答方法についてです。

青色の回答候補をドラッグして、下の回答欄にドロップします。

全て回答し終えたら submit ボタンを押下し、採点されます。

間違えていても次の教材には進めます。

各レッスンで使用されるサンプルプログラムは、GitHubで公開されています。

レッスンの途中で、サンプルプログラムのリンクが記載されています。

zipファイルも公開されていますが、git clone することをお勧めします。

git リポジトリでは、レッスン途中の状態がブランチ作成されており、ブランチ「Step…-Excercise…」はその課題の対応前、ブランチ「Step…-Solution…」はその課題の対応後のソースコードになっています。

課題対応前に、ブランチ「Step…-Excercise…」を checkout し、TODO 箇所を講義に沿ってコーディングすることで、実際にコードを作成しながら学習できます。

答え合わせは、git diff でブランチ比較を使用することで容易に行えます。

Android 端末で開発者向けオプションを有効にし、PCとUSB接続し実行すると、インストールされ確認できます。

1. 開発者向けオプションの有効化
   1. 設定 ⇒ バージョン情報 ⇒ ソフトウェア情報 ⇒ その他 ⇒ ビルド番号 を7回タップする（HTC U11）。
   2. 端末によって、ビルド番号までのメニュ選択は異なります。
2. 開発者向けオプションで、USB デバッグをオンにする
3. PC と端末をUSB接続する
4. Android Studio で実行ボタンを押すと、アプリがインストールされます

参考：Android アプリを実機でテストする方法（１） 実機の設定

レッスンで示されているレイアウト方法が、最新のレイアウト・エディタでは異なっている場合があります。

ここでは細かい点は気にせずに、おおよそ出来ていればそのまま進めることをお勧めします。

完全にサンプルと同じ手順で進めることは、古い手法なのかもしれません。

それなりのプログラム作成を行いますので、アプリらしさが分かってきます。

このレッスンのサンプルでは、ライフサイクルを正確に確認するために、Callback 関数で timber を使用してログ出力しています。

途中に、ADB (Android Debug Bridge) を使用して、プロセスを終了した際の挙動を確かめる講義があります。

普通の方の環境では、adb コマンドラインツールは動作しないと思いますので、記載内容に従って、各自環境で adb へのパスを設定すれば動作します。

このレッスンでは、Android のアーキテクチャについて、多くの情報が紹介されています。

Android Architecture Blueprints v2 が、比較的新しい情報があるようです。

• コードサンプル-Androidアーキテクチャブループリント
  • Android Architecture Blueprintsは、Androidアプリを開発するためのさまざまなアーキテクチャアプローチを紹介するプロジェクトです。異なるブランチには、同じアプリ（TODOアプリ）がわずかな違いで実装されています。このブランチには、次のものがあります。
  • バックグラウンドオペレーション用のKotlin Coroutines。
  • Navigation component を使用してfragment操作を管理する単一 Activity アーキテクチャ。
  • 画面（または機能）ごとに fragment （View）と ViewModel を含むプレゼンテーションレイヤー。
  • LiveData オブザーバブルと Data Binding を使用したリアクティブ UIs 。
  • データ層リポジトリと2つのデータソース（local using Room And remote）は、一つの動作（no listeners or data streams）として照会されます。
  • Two product flavors、mockそしてprod、開発とテストを容易にする（except the Dagger branch）。
  • ユニット、統合、e2e テストのコレクション。エミュレータ/デバイスまたは Robolectric で実行できる「共有」テストを含みます。
• コードサンプル-一目で比較できるブループリントアーキテクチャのサンプル ⇒資料は削除され、上のサンプルに統合されています。
• トーク-Android Jetpack：アーキテクチャコンポーネントの新機能（Google I / O ’18）
  • 新しいアーキテクチャコンポーネント（Lifecycles,  DataBinding, Room, Paging, Navigation, WorkManger,）の紹介
• トーク-Droidcon NYC 2016-MVワンダーランドの旅
  • MV ( C | P | VM ) の説明。Model-View-PresenterかModel-View-ViewModelが、Android での実装パターン 。
  • MVVM を推奨している。
• ブログ投稿-Androidアーキテクチャパターンパート2：Model-View-Presenter
• ドキュメント-アプリアーキテクチャのガイド
• ブログ投稿-Androidとアーキテクチャ

すべてのコードを１つの Activity や Fragment に記載するのでなく、これらは UI や OS とのやり取りのみに限定して、クラスをシンプルに保つことが、関心の分離として推奨されています。

ただし、この記事では、ViewModel と onSaveInstanceState の組み合わせになっていますが、2019年5月の時点では ViewModel と SavedStateHandle で実装するように改善されているようです。

課題のStep.11 では、ゲームの残り10秒を着ると、スマホを振動させる動きをさせます。

ただし、エミュレータでは振動しないようなので、振動させるAPIを呼び出しているか Log で確認すると良いです。

GameFragment.kt で、下記 Log をコーディングすると、"buzzer 1″ が Logcat に表示されます。

   private fun buzz(pattern: LongArray) {
        val buzzer = activity?.getSystemService<Vibrator>()
        buzzer?.let {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                buzzer.vibrate(VibrationEffect.createWaveform(pattern, -1))
                Log.i("GameFragment", "buzzer 1")
            } else {
                //deprecated in API 26
                buzzer.vibrate(pattern, -1)
                Log.i("GameFragment", "buzzer 2")
            }
        }
    }

この教材では、android.arch.persistence.room.RoomDatabase を使用しているが、現在は androidx.room.RoomDatabase が推奨されています。

現時点では、旧クラスでもビルドは可能であり、教材は進められます。

Unit Test が初めて出てきます。Unit Test については、このレッスンだけでは不足する内容ですので、別途学習することをお勧めします。

Android でアプリをテストする
Robolectricは、Androidに高速で信頼性の高い単体テストを提供するフレームワークです。

Coroutins (コルーチン)は、コールバックの必要性を減らすことでコードを簡略化できるバックグラウンドスレッドを管理する新しい方法です。Coroutines は、データベースやネットワークアクセスなどの実行時間の長いタスクの非同期コールバックを順次コードに変換する Kotlin の機能です。

概観 コルーチン
言語ガイド コルーチン
Android アプリで Kotlin コルーチンを使用する (Codelabs)

教材に誤りがありますので、気をつけましょう

「3. Add a TextView to the right of quality_image and set its id to sleep_length:」　⇒　quality_string

「4. 」 R.layout.text_item_view 　⇒　R.layout.list_item_sleep_night

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
        val layoutInflater = LayoutInflater.from(parent.context)
        val view = layoutInflater.inflate(R.layout.list_item_sleep_night, parent, false)
        return ViewHolder(view)
    }

教材に誤りがありますので、気をつけましょう

holder.bind(nightItem.sleepNight, clickListener) ⇒ holder.bind(clickListener, nightItem.sleepNight)

    override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) {
        when (holder) {
            is ViewHolder -> {
                val nightItem = getItem(position) as DataItem.SleepNightItem
                holder.bind(clickListener, nightItem.sleepNight)
            }
        }
    }

adapterScope.launch と list.map の {} の位置は、下記コードが正解です

    fun addHeaderAndSubmitList(list: List<SleepNight>?) {
        adapterScope.launch {
            val items = when (list) {
                null -> listOf(DataItem.Header)
                else -> listOf(DataItem.Header) + list.map { DataItem.SleepNightItem(it) }
            }
            withContext(Dispatchers.Main) {
                submitList(items)
            }
        }
    }

なぜか販売価格より賃貸価格の方が安いです。多分、データのステータスが間違っています。
どちらにしろ、仮定の話ですが…。
プログラムが間違っているのではないかと、ハマらないで下さい。

Android パーミッションを扱う際は、次の原則に従うことが推奨されています。

※このレッスンでは、インターネット接続のためにアプリに権限をつけます。

1: アプリの動作に必要なパーミッションだけを使用する。パーミッションの使用方法によっては、機密情報にアクセスすることなく、別の方法（システム インテント、識別子、通話時のバックグラウンド移行）で必要な処理を実行できる場合があります。

2: ライブラリが必要とするパーミッションに注意する。 ライブラリを追加すると、パーミッション要件も継承します。追加する要素、その要素が必要とするパーミッション、そのパーミッションの用途について注意する必要があります。

3: 透明性を確保する。 パーミッションをリクエストするときは、アクセス対象とアクセス理由を明確にし、ユーザーが十分な情報に基づいて判断できるようにする必要があります。インストール時や実行時、パーミッション更新時のダイアログなど、パーミッションのリクエストとともにこの情報を表示してください。

4: システム アクセスを明示的にする。 機密性の高い機能（カメラ、マイクなど）にアクセスするときは、継続的に通知を表示することで、データ収集のタイミングをユーザーに明確に示し、データをひそかに収集しているという疑いをもたれないようにします。