Infinito Nirone 7

白羽の矢を刺すスタイル

チームで育てるAndroidアプリ設計の一般販売が始まりました。

告知記事です。

Peaks のクラウドファンディングで執筆し先日電子版を先行リリースした「チームで育てるAndroidアプリ設計」の一般販売が始まりました。 これまではクラウドファンディングで出資いただいた方にのみ電子版・書籍の配送手続きをしていましたが、本日からクラウドファンディングに参加していない一般の方々にも電子版・物理本の購入をいただけるようになりました。

peaks.cc

チームで育てるAndroidアプリ設計とは

改めてこの書籍が何なのかを紹介すると、大小様々な規模のチームで継続的にAndroidアプリの開発をすすめていく中で直面するアーキテクチャの成長痛を乗り越えるためのノウハウを詰め込んだ本です。

アーキテクチャは一度整えればそれで終わるものではなく、プロダクトの成長やチームの成長とともに少しずつ形を変えていくものであるという考えのもと、最初の一歩としてどのようにアーキテクチャを選定しチームに根付かせていくか、またアプリの成長にともなって徐々に現れるひずみをどのように解消していくのか、実際の方法論を交えつつも根本にある思想や考え方、行動指針を示すことで、特定のチームにおける実例を他のチームにも活かせるプラクティスとしてまとめています。

新規事業の立ち上げから運用にいたるまでの比較的小規模なチームにおける事例を @kgmyshin さんが担当し、すでに成長を続けてきたサービスをさらに拡大していく比較的大規模なチームにおける事例を自分が担当しました。それぞれ4章分の内容があります。そして最後の章では大小それぞれの事例を振り返り、規模によらない共通点や規模によって異なるポイントをまとめています。

クラウドファンディング開始当初の意気込みなんかは次の記事に書いてありますのであわせてどうぞ。

blog.keithyokoma.dev

オンライン輪読会

実はこのプロジェクトはまだ続いていて、出版後にオンラインで輪読会を開催します。

techbookfest.connpass.com

全9回、各回で書籍の1章分の内容を輪読します。初回は早速明日4/27の22時からで、1週間ごとに読みすすめる予定です。 YouTube で配信予定で、アーカイブもあるので当日参加できない方もあとからご視聴いただけます。

BottomNavigationView で setupWithNavController と setOnNavigationItemSelectedListener を同時に使いたい

Android Jetpack の Navigation Component と BottomNavigationView を組み合わせる場合、setupWithNavController 拡張関数を呼びだすだけで nav graph と BottomNavigationView の menu を紐付けてくれるようになります。

val navView: BottomNavigationView = ...
val navController: NavController = ...

navView.setupWithNavController(navController)

ここで、BottomNavigationView の menu を選択したときにコールバックを受けたい場合、次のように setOnNavigationItemSelectedListener を使ったコードを書くと BottomNavigationView の menu と nav graph の紐付けが壊れて画面の切り替えができなくなります。 setupWithNavController 拡張関数は内部で setOnNavigationItemSelectedListener を使って BottomNavigationView の menu を選択したときの処理を記述しているため、次のコードはその処理を上書きしてしまい、その結果画面の切り替えができなくなります。

val navView: BottomNavigationView = ...
val navController: NavController = ...

navView.setupWithNavController(navController)
navView.setOnNavigationItemSelectedListener { menu ->
  // Callback
  Log.d("Sample", "$menu is selected!!!")
  true
}

NavController の addOnDestinationChangedListener を使って各 menu に対応する destination に切り替わったことを検知するロジックを作ると、BottomNavigationMenu の menu を選択したときのコールバックと同等の機能が実現できます*1。 もし setOnNavigationItemSelectedListener を使いたい場合は、次のように setupWithNavController の実装を持ってくる必要があります。

val navView: BottomNavigationView = ...
val navController: NavController = ...

navView.setupWithNavController(navController)
navView.setOnNavigationItemSelectedListener { menu ->
  // Callback
  Log.d("Sample", "$menu is selected!!!")  
  NavigationUI.onNavDestinationSelected(menu, navController) // この部分が setupWithNavController でやっていること
}

Hilt 1.0.0 へのマイグレーション

Google I/O 2021 で Hilt がついに安定版に到達し、1.0.0 がリリースとなったことが告知されました。

この記事を執筆時点で Dagger Hilt および AndroidX Hilt の最新版は次のとおりです。

Dagger Hilt: 2.36 AndroidX Hilt: 1.0.0

それぞれにコンポーネントがあり別々のバージョン番号があるので少し分かりづらい状況になっていますが、少なくとも Hilt が安定版となったのは Dagger Hilt 2.35 からであることに特に注意します。

バージョンアップにともなうマイグレーション作業

ここでは主に Dagger Hilt 2.34 より前からのマイグレーション作業にフォーカスして記述します。

Dagger Hilt 2.34: @ViewModelInject の置き換え

@ViewModelInject が廃止され、@HiltViewModel に置き換わりました。これにともなって、コンストラクタに @Inject アノテーションをつける必要があります。

@HiltViewModel // @ViewModelInject ではなく @HiltViewModel を使い、コンストラクタに @Inject をつける
class SampleViewModel @Inject constructor(
  ...
) : ViewModel()

Dagger Hilt 2.34: SavedStateHandle のための @Assisted の削除

ViewModelSavedStateHandle を inject するために利用していた @Assisted が不要になりました。単純に削除するだけで OK です。

@HiltViewModel
class SampleViewModel @Inject constructor(
  ...
  savedStateHandle: SavedStateHandle, // @Assisted を消す
) : ViewModel()

Dagger Hilt 2.34: androidx.hilt:hilt-lifecycle-viewmodel への依存の削除

AndroidX Hilt には ViewModel 対応のためのアーティファクトとして androidx.hilt:hilt-lifecycle-viewmodel が用意されていますが、安定版では必要ないため削除します。Google Maven Repository には 1.0.0-alpha-03 までのバージョンがアップロードされていますが、純粋に必要なくなったため 1.0.0 のリリースはありません。依存を削除しましょう。 (AndroidX Hilt 側のリリースノートではなく Dagger Hilt 側のリリースノートに記述があるためすこし紛らわしいですが…… twitter を検索すると gerrit code review で androidx.hilt:hilt-lifecycle-viewmodel への依存を切るための差分がサブミットされている様子も見つかります。)

Dagger Hilt 2.36: Fragment#getContext の振る舞いの修正

これまで、Hilt において Fragment#getContext がうっかり Framgent が削除されたあとでもContext インスタンスを返していました。これは通常の Fragment とは異なる動きであり、通常の Fragment のように振る舞うことが本来の動作であったため、2.36 で修正が入ります。ただし、この修正には相当のインパクトが見込まれるため、 -Adagger.hilt.android.useFragmentGetContextFix=true をつかって feature flag を有効にしない限り、2.36 でも以前のバージョンと同じく Hilt の Fragment#getContextFragment が削除されたあとでも Context インスタンスを返します。

Deprecated アノテーションが deprecated になってしまったのを undeprecated した流れ

Android 12 の preview 段階で @Deprecated アノテーションが deprecated になったのがちょっと話題になりましたが、Android 12 Beta 1 では deprecated になったのを undeprecated にしたことが What's new in Android で語られました。

youtu.be

@Deprecated アノテーションは少し特殊で、Javadoc に @deprecated タグを記述することでもクラスやメソッドなどが非推奨であることを示します。 Android 12 では @Deprecated アノテーションに変更があり、forRemoval メソッドと since メソッドが増えています。これらを用いて、非推奨となったクラスやメソッドが将来的に削除予定かどうかを簡単に示せるようになります。

developer.android.com

このメソッドの追加にあわせて @Deprecated アノテーションの Javadoc も拡充されていて、より詳しく @Deprecated アノテーションの役割や挙動を説明するようになりました。 ここで Javadoc 内の @Deprecated アノテーションを表記するために {@code @Deprecated} と言う形でコードブロックの記法を使うようになりましたが、このコードブロック内の @Deprecated が Javadoc の @deprecated タグと解釈され、結果として @Deprecated アノテーションそのものが deprecated と解釈されてしまった、というのが @Deprecated アノテーションが deprecated となった経緯のようです。

うっかり deprecated になってしまった @Deprecated を undeprecated にするため、コードブロック内であっても @ をエスケープする(@にする)差分が作られ、晴れて undeprecated することができたようです。

val age = 0x20

やったね僕も二十歳(16進数)になりました!

去年の自分はなにか目標でも立ててたのかと思って振り返ったら何もありませんでした。代わりに DroidKaigi がコロナ禍の始まりとかちあって中止となったことで、それまでのいろいろな準備をせめて何らかの形でアウトプットしようという供養エントリを書いていました。

blog.keithyokoma.dev

まだまだコロナ禍は収まる気配はなく、DroidKaigi も平年のような大きな会場を利用しての開催予定をたてるには難しい状況ですが、Podcast を始めたり2021年版公式アプリを公開したりと少しづつ活動の幅を広げてきています。

自分自身はというと、去年は思ってもいませんでしたが新しい会社で働いていて引き続き Android アプリをもりもり作っています。 今は Android エンジニアが自分ひとりということもあり、とにかく Android アプリの実装に必要な判断を自分ひとりでやっている状況なので、はやくコードそのものだけでなく設計やら作り方など含めてレビューしてくれる仲間を求めています。もちろん単にアプリを作るだけじゃなくて、いろんなアイディアを話し合う仲間でもあってほしいですが。 スタートアップということでまだまだ足りないものだらけですが、着実に前進していて楽しく仕事をしています。新しいもの、足りてないものをもりもり作るのが好きな人は声をかけてもらえれば、いつでもお話できます。

あとはクラウドファンディングでの技術書執筆プロジェクトもすすめています。リリースがだいぶ近づいており、佳境という感じです。絶対にリリースするぞ!

干し芋

ViewBinding を用いた View の操作をユニットテストする

ViewBinding を使うと View のアクセスを簡略化 & @NonNull を標準として堅牢にロジックを作れるようになります。 ここでこの ViewBinding を用いて次のような View の操作をメソッドとして定義したクラスを作ったとして、そのクラスにあるメソッドをユニットテストすることを考えてみます。

例えば、次のような TextView がおいてあるレイアウトを定義してみたとします。

<ConstraintLayout
  xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  >

  <TextView
    android:id="@+id/sample_text"
    android:layout_width="0dp"
    android:layout_height="0dp"
    app:layout_constraintTop_toTopOf="parent"
    app:layout_constraintBottom_toBottomOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    />

</ConstraintLayout>

ViewBinding では上記の XML から FragmentSampleBinding のような名前の ViewBinding クラスが生成されます。これをつかって View の操作を司るクラスを次のように定義してみます(特に MVP パターンを推奨するつもりはなく、ただ View の操作を司るクラスの命名として Presenter を用いています)。

class SamplePresenter(
  private val binding: FragmentSampleBinding
) {

  fun setSampleText(text: String) {
    binding.sampleText.text = text
  }
}

シンプルですね。findViewById の必要がなくなり、かつ Null Safe に View へアクセスできます。

ここで setSampleText 関数に渡した文字列が sample_text を ID とした TextView のテキストとして設定されることをユニットテストしてみます。 ユニットテストでは Robolectric を使わず、モックフレームワークとして mockk を使う場面を想定しています。

ユニットテストの準備として FragmentSampleBinding をうまくモックするとテストの見通しがよくなりますが、 ViewBinding で自動生成されるクラスの構成の問題で素直にモックが生成できません。

次にその自動生成コードを示しますが、モックの生成で問題となるのは各 View のフィールドです。 mockk ではモック対象のクラスが持っているフィールドを mock できず、かつ ViewBinding が持っている View のフィールドは final なのであとから代入することもできません。

(${module}/build/generated/data_binding_base_class_source_out/ 配下に生成されます)

public final class FragmentHomeBinding implements ViewBinding {
  @NonNull
  private final ConstraintLayout rootView;

  @NonNull
  public final TextView sampleText;
}

これを回避するには、ViewBinding クラスが持っている bind メソッドを経由して各フィールドに mock を差し込みます。

bind メソッドは次のような実装になっています。

public final class FragmentHomeBinding implements ViewBinding {

  @NonNull
  public static FragmentHomeBinding bind(@NonNull View rootView) {
    int id;
    missingId: {
      id = R.id.sample_text;
      TextView sampleText = rootView.findViewById(id);
      if (sampleText == null) {
        break missingId;
      }

      return new FragmentSampleBinding((ConstraintLayout) rootView, sampleText);
    }
    String missingId = rootView.getResources().getResourceName(id);
    throw new NullPointerException("Missing required view with ID: ".concat(missingId));
  }
}

この定義をもとに mock を差し込む方法を次に示します。 bind メソッドに渡す rootView は ConstraintLayout に明示的にキャストされるため、mock するときも ConstraintLayout としてモックを作ります。また基本的に XML 内の View はすべて rootView から探索するため、 XML 上の親子関係によらずレイアウト内の View をすべて rootView から返すようにモックします。

class SamplePresenterTest : BehaviorSpec() {
  init {
    Given("SamplePresenter") {
      val sampleText: TextView = mockk()
      val rootView: ConstraintLayout = mockk {
        every { findViewById<TextView>(eq(R.id.sample_text)) } returns sampleText
      }
      val binding = FragmentSampleBinding = FragmentSampleBinding.bind(rootView)
      val presenter = SamplePresenter()

      When("Set text to sample_text view") {
        presenter.setSampleText("foo")

        Then("`foo` is set") {
          verify { sampleText.text = eq("foo") }
        }
      }
    }
  }
}

レイアウト内にある要素が増えるとその分だけ View のモックが手間になりますが、モックを作るファクトリメソッドを定義しておき 必要に応じてテストケース固有のモックを差し込めるようにしておくと潰しの効く構成になります。

2020振り返り

なんやかんややってたら2020年も終わってしまうので振り返っておきます。来年になにか活かせるかどうかは分からない。

技術者視点で DX (Developer Experience) を上げていく活動

ここの DX はデジタルトランスフォーメーションではなく、デベロッパーエクスペリエンスのほうです。

技術を使ってサービスやプロダクトなど何らかの形のものを作るとき、作り始めた時点ではすごくモダンでイカした設計とツールで最高のプロダクトが作れる気になっていたものが、 日々普通に開発を進めているうちに、あるいは何もせず放っておいたとしても、気がつくとレガシーでちょっと身動きが取りづらいイケてない状態になっちゃうのはよくある話で、 まずは気がついたらそうなっちゃったっていう状況にはまらないためにどんなことをしたらいいんだっけっていうのをあれこれ試したのが2020年のはじまりでした。

いや本当はもっと前からそういうことはやっていたんだけど、DroidKaigi 2020 で予定していた発表はそのまとめとして、どんなことを見て考えて実行したのかを整理していました。

speakerdeck.com

その延長ってことを考えていたわけではないけれど、今もチームで育てる Android アプリ設計というクラウドファンディングプロジェクトで執筆をしています。絶賛原稿進捗中です。

リモートワーク環境の改善

当初は自宅の作業環境がキャンプチェアでしたが、いい加減なんとかしないと腰が爆発しそうだったのでデスクとチェアから揃えることにしました。 とりあえずチェアはリクライニングができてガッツリ背中を倒せるものであればいいやと思い、ニトリでちょうど良さそうなものを見繕ってきました。

ディスプレイは以前に使っていたものを使おうとしたところ、解像度が低すぎて使い物にならないことに気がついたので、LG 27UK650-W 27 インチ 4K UHD IPS LED モニターを買いました。 今の所特に不満なく使えていますが、デスクの場所が部屋の隅でシーリングライトの位置から遠くすこし暗く感じたため、ディスプレイの上に引っ掛ける BENQ のディスプレイライトを追加したり、 椅子をガッツリ倒したときの目線とディスプレイが合わせられるようにすることと、ディスプレイの下に空間を作って収納として使えるようにすることをねらって広めのディスプレイスタンドを置いたりしました。

その他、キヤノンの一眼レフをウェブカメラ化したり、良いマイクを買ったり、自宅に STF を建てて端末管理を一括化したり、Nest Hub Max をディスプレイ脇において作業用に活用したり、会社用と個人のMacBook Pro を並べて立てておけるようにしたりしてリモートワーク環境の改善をした結果、 こんなかんじで作業環境が整いました。

もうすこし欲を言うなら、作業専用の部屋を分けられるといいのですが、そうすると都内では家賃がマッハで上がっていくしかないので難しい…

ワーケーション

年末、軽井沢へワーケーションしに行きました。

blog.keithyokoma.dev

これがすごく良かった。自宅にあるような作業環境ではないものの、いい具合に速度の出るWiFiと電源があれば作業ができて、周りには美味しいものがたくさんあってリフレッシュも気軽にできる。疲れたらいつでも温泉とサウナに入れるのが最高です。 そしてなにより、スーパーのツルヤの品揃えが完璧を超えてきている…近所にツルヤがほしい…

運動

変わらずサイクリングは続けていて、今年は赤城山や霞ヶ浦などを走りました。

https://www.strava.com/activities/4239858105

ただ圧倒的に長距離を走る回数が減ってしまったのが残念。コロナ渦で仕方ないとはいえ、もう少し頑張りたいところです。

また最近はランニングもはじめました。走り込みが久しぶりすぎて、5~6km はしっただけで脚がパンパンになって筋肉痛が厳しいですが、もうすこし続けていけばいい具合に走れるようになると思っています。 ちゃんと痩せるぞ…

その他買ってよかったもの