HN 日本語サマリー

← 一覧へ戻る
オープンソース

StreetComplete on iOS がパブリックベータ版になりました

StreetComplete on iOS is now in public beta (github.com)

624 pointsby Snowly172 コメント

要約

人気のオープンソースマッピングアプリ「StreetComplete」のiOS版が、現在パブリックベータとして公開されています。この移植は、Kotlin MultiplatformとCompose Multiplatformを使用して開発されており、単一のコードベースでAndroidとiOSの両方のプラットフォームをサポートすることを目指しています。開発は現在約50%完了しており、コミュニティからの貢献を歓迎しています。

全文翻訳

iOS #5421

UI側の作業について:

要約:

(免責事項:私も、まだ作業したことのないJetpackフレームワーク、特にComposablesとNavigationについては、自分で理解を深める必要があります。以下は、いくつかの調査やサンプルコードの参照結果に基づいていますので、もし私が説明している内容に誤解があれば、遠慮なく指摘してください!)

現在のUIアーキテクチャ

[画像: current_arch]

AndroidのActivityは主にコンテナとして機能し、Fragmentがビューのコンポーネントの大部分を定義し、その動作、状態、ライフサイクル管理、データ(更新)および親・子コンポーネントとの通信・ナビゲーションを担っています。

ビューは一般的にAndroid XMLレイアウトで定義されており、再利用可能なビュー構造の動作を定義する「*ViewController」クラスがいくつか存在します。一部の複合ビューやカスタムビューも(まだ)存在する可能性があります。

計画されているUIアーキテクチャ

Androidでは、以下のような形になるでしょう:

[画像: target_arch]

ビューのレイアウト、動作、および(UI)状態は、Jetpack Compose / Compose MultiplatformのComposableによって行われます。

UIでの表示に使用されるデータは、ViewModelを介してアクセスされます。ViewModel内のフィールドには、最初からLiveDataの代わりにKotlinのStateFlowを使用する方が良いでしょう。なぜなら、前者は既にマルチプラットフォームだからです。

最後に、異なるComposable間のナビゲーションは、何らかの方法でJetpack NavigationのNavHostを使用して管理されます(まだあまり調べていません)。これは、Activityがアプリのエントリーポイントに過ぎず、実際にはFragmentは残らず、すべてがComposableとViewModelになることを意味します。つまり、すべてを共有できます。(やった!)

UIアーキテクチャのステップ

さて、一度に多くの工事現場を開くことは絶対に避けなければなりません。現在のアーキテクチャから一度にすべてを移行することは現実的ではありません。代わりに、コードベースが一貫性を保つように、できるだけ多くの自己完結したステップに分割する必要があります。

ステップ1. ViewModel

スリムなFragment:データアクセスとビューの状態管理は、Fragmentが所有するViewModelに移行します。これには既にチケットがあります:#5530。iOSとは無関係に、これはビューロジックをデータアクセス/状態管理から適切にカプセル化するため、理にかなっています。

ステップ2. Jetpack Compose

[画像]

UIレイアウト定義と動作コードをボトムアップで変換します(移行ガイド、移行チュートリアルを参照)。これには、Android XMLレイアウトをComposeコードに変換するだけでなく、「*ViewController」クラスのコード、RecyclerViewのビューホルダー、そして最終的にはFragment(ビューの動作の大部分が現在定義されている場所)のコードも含まれます。


[画像: current_view_arch drawio]
(ステップ1と2の後)

ステップ3. Compose Multiplatform

[画像]

Jetpack ComposeからCompose Multiplatformへの(おそらく小規模な)ステップを進めます。ここでの最大の課題は、リソースをマルチプラットフォームでどのようにアクセスするかでしょう。MOKO resourcesのようなライブラリが既に存在しますが、人気があり安定したソリューションが登場することを期待しています。JetBrainsからの公式なものが出ることを強く願っています。(彼らはこれを発表しました。)

ステップ4. Multiplatform ViewModel / Navigation

編集 2024-09: エコシステムが変化しました!AndroidのViewModelsとAndroid Navigationもマルチプラットフォームで使用できるようになるため、以下の調査は不要になりました。現在使用しているものをそのまま使い続けることができます。

ステップ2の終わりまでには、Fragmentは非常にスリムになるでしょう。UIアーキテクチャ的にはここで止める選択肢もあります。そして、これらのFragmentに残っている残りのコードを、Swiftで定義されたUIViewControllersにiOS側で複製します。これらのステップがそれぞれ非常に大きいので、これらのステップを完了した後に再検討したいと思います。

しかし、少なくともViewModelをマルチプラットフォームにする必要があります。興味深いことに、ViewModelの概念を提供しつつマルチプラットフォームでもあるライブラリの多くは、Fragmentを完全に廃止するためのソリューション(つまり、Navigationおよび関連事項の代替)も提供しています。

ViewModelのみのマルチプラットフォーム代替を提供するものには、KMM-ViewModel、MOKO MVVM、Summer、kmp-viewmodelなどがありますが、これらのほとんどはアルファ版であったり、古いか、かなり非アクティブです。

以下は、私が少し長く調べたフレームワークのリストです。これらはすべてViewModelのようなものを提供し、ナビゲーションのためのグルーも提供します。

PreCompose

PreComposeは、ViewModelとNavigationの両方を提供しており、そのAPIはAndroidの同等のものと非常に似ています。プロジェクトのREADME自体には次のように書かれています...

Jetpack Lifecycle, ViewModel, Navigationに慣れているなら、何も学ぶ必要はありません。

さらに、Koinとの連携もあります。これは私たちが使用している依存性注入フレームワークです。

プロジェクトは2021年から存在し、2022年半ばから継続的にアクティブで、GitHubでのスター数は0.6kです。

Voyager

[画像]

VoyagerもViewModelとナビゲーションの両方を提供します。

特に、Screenという概念を導入しています。Screenは概念的にはActivityまたはフルスクリーンFragmentの代替です。

ViewModelの代わりに、ScreenModelがあり、これはViewModelと同じ目的を持っています。良い点:ScreenModelは単なるインターフェースです。また、私たちが使用している依存性注入フレームワークであるKoinとの連携もあります。

さらに、ボトムシート(広範囲に使用しています)およびタブナビゲーション(プロフィール画面で使用)とのナビゲーションのためのセットアップもあります。

プロジェクトは2021年末から存在し、非常にアクティブであり続けています(GitHubでのスター数は1.8k)。バージョン1.0.0は2023年12月にリリースされ、APIの安定性をもたらすはずで、ドキュメントはかなり良いです。私が調べた3つのプロジェクトの中で最も新しいものです。

Decompose

[画像]

Decomposeも説明された機能の代替として機能しますが、3つのライブラリの中で、Android Jetpackの用語、概念、APIから最も大きく離れています。

  • Componentは、Fragment/Activityのロジック/ナビゲーション部分の代替として理解しています。これらは、ライフサイクルを意識し、設定変更中に状態を保持し、バックボタンイベントを処理する必要がある場合、オプションで関連するComponentContext(ViewModelのようなもの)を持つことができます。
  • Valueはコンポーネント内の観測可能なフィールドで、LiveDataやStateFlowのようなものです。
  • Child StackはFragmentManagerの代替、つまりナビゲーションのようなものです。
  • ...

Decomposeの機能の1つは、ComposeだけでなくSwiftUIや他のUIフレームワークともうまく連携することですが、これは必要ないと思います。しかし、これはDecomposeが特定のUIフレームワークに依存せず、より汎用的なフレームワークとして設計されていることを意味します。
代わりに、Decomposeは同じ作者による別のフレームワークであるMVIKotlinと相性が良いと書かれています。

プロジェクトは2020年(最も古い)から存在し、それ以来継続的に非常にアクティブ(比較対象の中で最もアクティブ)です。GitHubでのスター数は1.7k以上です。2023年12月以降、新しいメジャーバージョンの開発が行われています。オープンなイシューが非常に少ないのが顕著です。

結論

正直なところ、Decomposeの概念を完全に理解できたわけではありません。Compose Multiplatformからの独立性は、私たちが要求するものではありません。ViewModel + Composables + Navigationへの移行は、それ自体で十分な作業量であり、さらに新しい(関連性があるとしても)概念を学ぶことは助けになりません。

そのため、現時点ではVoyagerをわずかに支持しています。なぜなら、PreComposeと同様に、Android Jetpackの概念に非常に忠実でありながら、PreComposeよりも人気があり、より多くのドキュメントと有用なコンポーネントを提供しているからです。

ただし、これに関する最終的な決定は、いくらか将来のことになります。この予備調査の目標は、まずViewModel + Navigationの概念をマルチプラットフォームにも転送できるかどうかを確認することでした。これにより、ステップ1と2(ステップ3と4の前)が可能になります。結果:はい、可能です。概念とAPIがAndroid Jetpackのものと非常に似ているフレームワークが存在します。